Nesse artigo você vai aprender

Como ligar o Pontta da fábrica ao Supplier Portal da Promob para que cada nova ordem de compra emitida pelas revendas vire, sozinha, um pedido de venda no Pontta. Você também vai ver o que cada campo da configuração define no pedido e como conferir se a integração está funcionando.

Descrição

O Supplier Portal é o portal da Promob em que as revendas enviam ordens de compra para a fábrica. Com a integração ligada, o Supplier Portal avisa o Pontta a cada nova ordem de compra. O Pontta busca a ordem e cria o pedido de venda, sem digitação.

Para não haver surpresa, vale saber o que a integração não faz:

• Não atualiza o pedido: depois que uma ordem de compra vira pedido, mudanças nessa mesma ordem no portal não chegam ao Pontta.
• Não vincula produtos: os itens entram com o código e o preço que vieram da ordem de compra, sem ligação com o cadastro de produtos do Pontta.
• Não cancela: cancelar a ordem no portal não cancela o pedido no Pontta.

Sumário

Utilize os links abaixo para ir diretamente à seção desejada:

• Pré-requisitos
• 1. Ativar a integração e criar a configuração
• 2. Conferir se a integração foi registrada
• Como a ordem de compra vira pedido de venda
• Alterar ou remover a configuração
• Dúvidas frequentes

⚓ 

Pré-requisitos

• Módulo Supplier Portal na assinatura. Sem ele, a seção do Supplier Portal não aparece em Integrações.
• Permissão Integrações no papel do colaborador que vai configurar.
• Os dados de acesso da fábrica no Supplier Portal, fornecidos pela Promob: o Account ID e as duas chaves de API (a do webhook e a do Supplier Portal).
• No Pontta: uma política de negociação com condição de pagamento, uma forma de pagamento, um colaborador para ser o responsável pelos pedidos e um fluxo de trabalho de pedido de venda.

Consulte também: Editar permissões do papel de colaborador

⚓ 

1. Ativar a integração e criar a configuração

Acesse Administração > Vendas > Integrações e desça até a seção Supplier Portal.

    1 - Ligue a chave Ativar integração com o Supplier Portal.

    2 - Clique em Adicionar, logo abaixo da chave. Abre a janela Configuração de integração com o Supplier Portal.

Preencha a janela. Todos os campos são obrigatórios:

    3 - Nome: um nome para identificar a configuração, por exemplo o nome da revenda ou da conta.

    4 - Unidade de negócio: a unidade da fábrica em que os pedidos serão criados. A configuração aceita uma unidade só.

    5 - Account ID: o identificador da conta da fábrica no Supplier Portal.

    6 - Api key webhook: a chave usada para registrar o aviso de novas ordens (webhook) no portal.

    7 - Api key supplier portal: a chave usada para buscar a ordem de compra e devolver o número do pedido.

    8 - Política de negociação e Condição de pagamento: a negociação aplicada ao pedido. Ao trocar a política, a condição é apagada e precisa ser escolhida de novo.

    9 - Responsável: o colaborador que fica como responsável pelos pedidos criados.

    10 - Forma de pagamento: usada nas parcelas quando a ordem de compra não informa uma forma de pagamento que exista no Pontta.

    11 - Fluxo de trabalho: o fluxo em que os pedidos entram. Só aparecem fluxos de pedido de venda.

    12 - Clique em Salvar.

A configuração aparece na tabela da seção, com as colunas Nome e Unidades de negócio. Para receber ordens em mais de uma unidade de negócio, crie uma configuração para cada unidade.

Nota: ao salvar, o Pontta registra no Supplier Portal o aviso de novas ordens de compra. Isso acontece em segundo plano, alguns segundos depois. A janela não mostra o resultado. Confira no passo 2.

⚓ 

2. Conferir se a integração foi registrada

Acesse Administração > Outros > Logs de integração e, no filtro, escolha o Módulo Supplier Portal. Procure, logo depois de salvar a configuração:

• Webhook criado para a conta <Account ID>: o aviso foi registrado e a integração está pronta para receber ordens.
• Falha ao criar webhook para a conta <Account ID>: o portal recusou o registro. Confira o Account ID e a Api key webhook.

Quando chegar a primeira ordem de compra, o log mostra Ordem de compra recebida e, em seguida, Pedido de venda processado com sucesso.

⚓ 

Como a ordem de compra vira pedido de venda

Cliente

• O Pontta procura o cliente pelo CPF ou CNPJ da ordem de compra.
• Se não achar, procura pelo e-mail. O e-mail só vale quando encontra um único cliente.
• Se ainda não achar, cria o cliente com nome, documento, telefone e e-mail da ordem. Se o contato com esse documento existir mas o cliente estiver excluído, o cliente é restaurado.

Itens

• Cada item da ordem entra como item de integração, com o nome, a referência como código, a quantidade e o preço da ordem. A unidade de medida é sempre UN.
• Se a ordem tiver o nome de uma opção de projeto, todos os itens entram dentro de um ambiente com esse nome.
• O pedido é criado mesmo com itens sem preço.

Negociação, entrega e fluxo

• A política, a condição, o responsável e o fluxo de trabalho vêm da configuração.
• As parcelas vêm da ordem de compra. A forma de pagamento de cada parcela é procurada pelo nome ou pelo código fiscal. Se não for encontrada, vale a Forma de pagamento da configuração.
• Se a ordem não tiver parcelas, o pedido recebe uma parcela única com o valor total, vencendo na data de criação da ordem.
• Se a ordem tiver endereço e data de entrega, eles vão para o pedido.

Mesmo projeto, nova ordem de compra

O Pontta guarda no pedido o identificador do projeto e o da ordem de compra. Quando chega uma ordem nova de um projeto que já tem pedido, o Pontta cria uma nova versão desse pedido, em vez de outro pedido, e atualiza a data de entrega.

Número do pedido devolvido ao portal

Quando a ordem de compra é do tipo Principal, o Pontta envia o número do pedido de venda de volta ao Supplier Portal.

⚓ 

Alterar ou remover a configuração

Use o menu de ações da configuração, na tabela da seção Supplier Portal:

• Alterar com troca do Account ID: o Pontta fecha o aviso da conta antiga e cria um novo para a conta nova.
• Alterar com troca da Api key webhook: o aviso é atualizado com a nova chave.
• Remover: o Pontta fecha o aviso no portal (o log mostra Webhook fechado para a conta <Account ID>) e deixa de receber ordens dessa conta.

Atenção: desligar a chave Ativar integração com o Supplier Portal só esconde a tabela. O aviso continua registrado e as ordens continuam virando pedidos. Para parar de receber, remova a configuração.

⚓ 

Dúvidas frequentes

A seção Supplier Portal não aparece em Integrações. Por quê?

A assinatura não tem o módulo Supplier Portal. Fale com o comercial da Pontta.

Salvei a configuração, mas nenhuma ordem chegou. O que conferir?

Abra os Logs de integração. Se não houver Webhook criado para a conta, o registro falhou: confira o Account ID e a Api key webhook e salve de novo. Se houver Ordem de compra recebida seguida de erro, leia a mensagem de erro (veja a próxima pergunta).

O que significam os erros no log?

• Ordem de compra recebida sem dados do cliente: a ordem veio sem cliente. Corrija no portal.
• Ordem de compra recebida sem identificador de projeto: a ordem veio sem projeto, e o Pontta precisa dele para saber se cria pedido ou nova versão.
• Ordem de compra <id> não encontrada: a chave Api key supplier portal não dá acesso a essa ordem, ou a ordem não existe mais.
• Ordem de compra com erro de validação, não será reprocessado: a ordem tem um dado que o Pontta não aceita. O texto depois dos dois-pontos diz qual. Essa ordem não é processada de novo sozinha.

Alterei a ordem de compra no portal. Por que o pedido não mudou?

A integração só recebe ordens novas. Uma ordem que já virou pedido não é lida de novo. Ajuste o pedido no Pontta ou emita uma nova ordem de compra para o mesmo projeto, que gera uma nova versão do pedido.

Por que o pedido entrou em uma nova versão e não como um pedido novo?

Porque a ordem é de um projeto que já tem pedido no Pontta. Veja Mesmo projeto, nova ordem de compra.