Nesse artigo você vai aprender
Como configurar a integração com a fábrica Bontempo, importar o projeto para um orçamento ou pedido com os preços da fábrica, liberar o pré-pedido, informar o pagamento, transmitir o pedido oficial e acompanhar a situação de cada ambiente.
Descrição
A integração cobre o ciclo inteiro entre a loja e a fábrica Bontempo, sempre por ambiente:
- Importação: o arquivo do projeto é enviado à Bontempo, que devolve os itens com preço, IPI, royalties e conta cooperada.
- Pré-pedido: ao criar o pedido de venda, o Pontta cria um pré-pedido por ambiente, que a loja libera para a fábrica.
- Pagamento: a loja informa à Bontempo o pagamento do pré-pedido, e o Pontta lança os adiantamentos.
- Pedido oficial: depois da revisão, a loja transmite o pedido oficial de cada ambiente.
- Situação: a loja consulta a situação de cada ambiente na fábrica quando precisar.
Sumário
Utilize os links abaixo para ir diretamente à seção desejada:
- Pré-requisitos
- 1. Configurar a integração
- 2. Publicar as composições de preço
- 3. Importar um projeto
- 4. Liberar o pré-pedido
- 5. Informar o pagamento
- 6. Transmitir o pedido oficial
- 7. Atualizar a situação
- Dúvidas frequentes
- Para o time de suporte
Pré-requisitos
- Módulo Integração Bontempo no plano. Ele precisa estar contratado de forma explícita: a opção Todos os módulos da assinatura não o inclui.
- Client ID e Client Secret fornecidos pela Bontempo, e o CNPJ de cada loja cadastrado na Bontempo.
- A Bontempo cadastrada como fornecedor, com o CNPJ preenchido.
- Os parceiros que aparecem nos projetos (fornecedores de itens de terceiros) cadastrados como fornecedores, com o Código de integração igual ao código do parceiro na Bontempo.
- Fornecedores de royalties e de conta cooperada cadastrados, com conta de despesa, centro de custo e conta-contato ativa (são usados nos lançamentos financeiros).
- Permissões de Pedidos para produção terceirizada para quem vai operar: Liberar pedidos para produção terceirizada, Informar pagamento de pré-pedidos para produção terceirizada e Aplicar desconto em pedidos para produção terceirizada.
Consulte também: Editar permissões do papel de colaborador
1. Configurar a integração
Acesse Administração > Vendas > Integrações e localize a seção Integração com Bontempo.
1 - Ligue Ativar integração com Bontempo. A chave é gravada assim que você clica.
2 - URL base: informe a URL de produção enviada pela Bontempo.
3 - Client ID e Client Secret: as credenciais da Bontempo.
4 - Prazo de pagamento do pré-pedido (em dias): prazo para pagar cada pré-pedido, contado a partir do envio à fábrica. O padrão é 75.
5 - Fornecedor padrão (composição de preço): o código de integração usado para escolher a composição de preço quando o item vem sem parceiro. Normalmente, o código da Bontempo.
6 - Fornecedor padrão (ordem de compra): a Bontempo. Veja a nota abaixo.
7 - Fornecedor de royalties e Fornecedor de conta cooperada: os contatos que recebem esses valores nas previsões, nas ordens de compra e nos adiantamentos.
8 - Em Adiantamentos, Conta de origem: a conta corrente ou caixa debitada nos adiantamentos automáticos.
9 - Clique em Salvar.
Nota: se a URL base ficar vazia, o Pontta usa o ambiente de teste da Bontempo, sem nenhum aviso. Os preços e pedidos não chegam à fábrica de verdade.
Nota: apesar do nome, o Fornecedor padrão (ordem de compra) é usado em todas as chamadas à Bontempo, inclusive na importação: o CNPJ dele identifica a fábrica. Sem esse fornecedor ou sem o CNPJ dele, nenhuma operação funciona.
Nota: a Conta de origem vale para todas as unidades de negócio da assinatura, embora a ajuda do campo fale em "desta filial".
Parâmetros complementares
- Compra de fábrica externa: em Administração > Produção > Parâmetros. Libera a opção Transmitir para fábrica no acompanhamento de pedido.
- Limite máximo de desconto fábrica (%): em Administração > Vendas > Parâmetros, seção Integração com terceiros. Teto do desconto por fornecedor no pedido oficial. Vazio, o desconto não fica disponível.
- Liberar revisões quando o pedido possuir uma das etiquetas: em Administração > Vendas > Parâmetros. Quando a fábrica confirma todos os pré-pedidos, o Pontta adiciona ao pedido todas as etiquetas desta lista.
2. Publicar as composições de preço
O preço que a Bontempo devolve é o ponto de partida. Os preços de compra, custo e venda no Pontta são calculados pela composição de preço do fornecedor do item. Acesse Administração > Vendas > Composições de preços.
1 - Crie uma composição para cada fornecedor (a Bontempo e cada parceiro), no campo Fornecedor.
2 - Para royalties e conta cooperada, crie passos com os códigos royalties e contacoop. É deles que saem esses valores.
3 - Clique em Publicar. Alterações não publicadas não valem.
Nota: se o item tem parceiro, ou se o Fornecedor padrão (composição de preço) está preenchido, o Pontta usa só a composição publicada daquele fornecedor. Se ela não existir, o item entra com preço zero, sem nenhum erro. A composição sem fornecedor só é usada quando não há código nenhum.
3. Importar um projeto
Abra o orçamento, o pedido de venda ou a revisão de pedido e entre no ambiente que vai receber os itens.
1 - Clique no botão + (Adicionar produtos / serviços) e escolha Bontempo - Adicionar itens fábrica Bontempo. O atalho é shift n b.
2 - Na janela Integração Bontempo, arraste o arquivo do projeto (.pct ou .xml) ou clique em Selecionar arquivo.
3 - Clique em Importar.
Nota: no orçamento e no pedido de venda, a importação substitui todos os itens do ambiente. Se você selecionar vários arquivos, cada um substitui o anterior e só o último fica. Na revisão de pedido, os itens são acrescentados.
Cada item entra com o código, a descrição, a quantidade e a unidade da Bontempo, e guarda como variáveis a máscara, o parceiro e o NCM. O arquivo fica anexado ao documento.
4. Liberar o pré-pedido
Ao criar o pedido de venda, o Pontta cria em segundo plano um pré-pedido para cada ambiente, com as previsões de despesa do produto, dos royalties e da conta cooperada. Pedidos aditivos não geram pré-pedido.
Acesse Compras > Liberação do pedido (em lojas da rede, o menu se chama Pedidos para produção terceirizada), na visão Liberação por pedido.
1 - Localize o pedido e clique em Liberar pedido.
2 - Confirme. A liberação não pode ser desfeita.
Todos os ambientes pendentes do pedido vão juntos. A mensagem diz se a fábrica confirmou todos, parte ou nenhum. O vencimento do pré-pedido passa a ser a data do envio mais o prazo de pagamento.
Nota: o prazo de pagamento é gravado quando o pedido é criado. Mudar o parâmetro depois não altera pedidos que já existem.
5. Informar o pagamento
Na mesma tela, use Informar pagamentos (por pedido) ou, na Visão por status, selecione os ambientes e clique em Informar pagamento.
1 - Confira a Prévia à Bontempo: produto, royalties, conta cooperada e o total À Bontempo. Produtos de parceiros aparecem como Fora deste pagamento.
2 - Confirme.
Ao confirmar, o Pontta lança os adiantamentos debitando a Conta de origem e liquida os títulos correspondentes. Se a Bontempo rejeitar uma das ordens, nenhum pagamento da solicitação é confirmado.
Nota: cada solicitação aceita até 50 ambientes, todos da mesma loja.
6. Transmitir o pedido oficial
Depois da revisão, com o acompanhamento de pedido criado, abra o acompanhamento e, no menu de três pontos, clique em Transmitir para fábrica.
1 - Selecione os ambientes para o envio.
2 - Se houver desconto da fábrica, informe-o por fornecedor no detalhe do pedido antes de transmitir.
3 - Clique em Confirmar envio e confirme.
Nota: só abrir a tela Transmitir para fábrica já gera as ordens de compra do pedido: uma por ambiente e fornecedor, mais as ordens de Royalty e de Conta Cooperada.
Um ambiente só pode ser transmitido se tiver acompanhamento e se o pré-pedido estiver pago (quando há valor a pagar). Depois do envio, o desconto e a observação ficam bloqueados.
7. Atualizar a situação
O Pontta não consulta a Bontempo sozinho. Na tela de liberação, use Atualizar status de todos os ambientes, ou Atualizar status em um ambiente.
- A situação de pagamento aparece como Novo, Envio pendente, Prestes à vencer, Vencido ou Pago.
- Quando a fábrica informa a liberação financeira, o pré-pedido é marcado como pago.
- Quando o pedido oficial é liberado, os valores da fábrica são aplicados às ordens de compra.
Dúvidas frequentes
A opção Bontempo não aparece no botão +.
A chave Ativar integração com Bontempo está desligada em Administração > Vendas > Integrações.
Aparece "Fornecedor padrão não configurado" ou "Documento do fornecedor padrão não configurado".
Preencha o Fornecedor padrão (ordem de compra) com a Bontempo e confira se o cadastro dela tem CNPJ.
Aparece "Autenticação inválida na API Bontempo".
O Client ID ou o Client Secret estão errados. Depois de corrigir, a troca pode levar alguns minutos para valer, até o acesso anterior expirar.
Os itens importados vieram com preço zero.
Falta a composição de preço publicada do fornecedor do item. Confira o parceiro do item, o Código de integração do fornecedor e se a composição foi publicada.
Aparece "Ambiente não informado".
A importação precisa ser feita dentro de um ambiente. Abra o ambiente e use o botão + de novo.
Um pedido criado antes de ligar a integração não aparece na liberação.
Os pré-pedidos só são criados no momento em que o pedido é criado. Pedidos anteriores à integração não ganham pré-pedido; acione o suporte.
O Transmitir para fábrica não aparece no acompanhamento.
Confira se o parâmetro Compra de fábrica externa está marcado em Administração > Produção > Parâmetros.