Nesse artigo você vai aprender
Como ligar a integração com o Focco ERP, cadastrar os parâmetros de cada fábrica, preparar as variáveis e o mapeamento de propriedades e enviar uma ordem de compra do Pontta para virar um pedido de venda no Focco ERP da fábrica. Você também vai ver como acompanhar o pedido enviado e como usar o Focco ERP para precificar itens no Leitor de integração.
Descrição
O Focco ERP é o sistema de gestão usado por algumas fábricas fornecedoras. Com a integração, a loja envia a ordem de compra direto do Pontta e a fábrica recebe um pedido de venda pronto no Focco ERP, com os itens, as características de cada item e os dados do cliente final.
Depois do envio, o Pontta consulta o Focco ERP quando você pede e mostra o número do pedido na fábrica, a situação (Liberado, Bloqueado, Não analisado), os valores, os bloqueios, o transporte e a data de entrega de cada item.
A configuração é feita por fornecedor: cada fábrica que usa o Focco ERP tem o próprio cadastro, com as próprias chaves de acesso.
Sumário
Utilize os links abaixo para ir diretamente à seção desejada:
- Pré-requisitos
- 1. Ligar a integração
- 2. Cadastrar os parâmetros da fábrica
- 3. Cadastrar as variáveis do Focco ERP
- 4. Mapear as propriedades dos itens
- 5. Enviar uma ordem de compra para produção
- 6. Acompanhar o pedido na fábrica
- O que vai para o Focco ERP
- Precificar pelo Focco ERP no Leitor de integração
- Dúvidas frequentes
Pré-requisitos
- Módulo Focco ERP no plano. Ele precisa estar contratado de forma explícita: a opção Todos os módulos da assinatura não o inclui.
- Permissão Integrações para quem vai configurar.
- Permissão Ordem de compra para quem vai enviar e Atualizar ordem de compra para quem vai consultar a situação do pedido na fábrica.
- A fábrica cadastrada no Pontta como fornecedor.
- Dados fornecidos pela fábrica: a URL do serviço do Focco ERP, o Client key, o Secret key, o código da fábrica e os códigos das tabelas de venda, divisões de venda e condições de pagamento.
Consulte também: Editar permissões do papel de colaborador
1. Ligar a integração
Acesse Administração > Vendas > Integrações e localize a seção Integração com o Focco ERP.
1 - Ligue Habilitar integração com o Focco ERP. A chave é gravada assim que você clica.
2 - Clique em Configurar integração com o Focco ERP. Abre a lista de fábricas configuradas.
Nota: o menu Integrações só aparece quando a assinatura tem pelo menos um dos módulos de integração de vendas. Se o cliente tiver apenas o módulo Focco ERP, o menu fica escondido. Nesse caso, acione o suporte.
2. Cadastrar os parâmetros da fábrica
Na lista de fábricas, clique no botão + para abrir Cadastrar parâmetros de integração com o Focco ERP.
1 - Fornecedor: escolha a fábrica. Cada fornecedor só pode ter um cadastro.
2 - Fábrica: o código da fábrica no Focco ERP, informado por ela.
3 - Tipo de contato e Número do documento da fábrica: o CNPJ da fábrica.
4 - Tipo de contato e Número do documento da unidade padrão: veja a nota abaixo antes de preencher.
5 - URL, Client key e Secret key: os dados de acesso enviados pela fábrica.
6 - Nome da variável "código do item": a variável do item que guarda o código do produto no Focco ERP. Se ficar vazio, o Pontta usa CODIGO_ITEM.
7 - Número do pedido do representante padrão e Entrega acordada com o cliente padrão: valores que já vêm preenchidos na tela de envio.
8 - Clique em Salvar.
Nota: o Número do documento da unidade padrão, quando preenchido, é o CNPJ que vai para a fábrica em todos os envios, de qualquer unidade de negócio. Deixe vazio se cada unidade compra com o próprio CNPJ: o Pontta usa o documento da unidade da ordem de compra. Com o tipo Pessoa jurídica ou Pessoa física o campo fica obrigatório; para deixá-lo vazio, escolha Identificação Estrangeiro.
Depois de salvar e cadastrar as variáveis (próxima seção), abra o cadastro de novo em Alterar. Só na edição aparecem os campos Divisão de venda padrão, Divisão de venda de assistência técnica e Condição de pagamento padrão, porque eles dependem das variáveis.
Nota: na edição, esses campos padrão e o documento da unidade padrão não podem ser apagados, só trocados por outro valor. Se precisar esvaziar um deles, acione o suporte.
3. Cadastrar as variáveis do Focco ERP
As variáveis são as listas de códigos do Focco ERP que você vai escolher na hora de enviar. Na lista de fábricas, clique no menu de três pontos da linha e escolha Variáveis do Focco ERP.
1 - Em cada tipo, clique em Adicionar e informe o Código (o código no Focco ERP, que é o que vai para a fábrica) e a Descrição (o que aparece para o usuário).
2 - Cadastre pelo menos uma Tabela de venda. Ela é obrigatória no envio.
3 - Cadastre as Divisões de venda e as Condições de pagamento que a loja usa.
Nota: a tela também aceita Tipo de imposto, Tipo de nota fiscal, Representante e Portador, mas hoje esses tipos não são enviados ao Focco ERP. Só Tabela de venda, Divisão de venda e Condição de pagamento vão no pedido.
4. Mapear as propriedades dos itens
Os itens configurados (com cor, acabamento, medidas) levam as escolhas como características do item no Focco ERP. O mapeamento diz qual variável do Pontta corresponde a qual característica do Focco ERP.
Na lista de fábricas, clique no menu de três pontos da linha e escolha Mapeamento de propriedades.
1 - Em Código no Pontta, informe o nome da variável do item no Pontta, exatamente como ela está gravada (maiúsculas e minúsculas fazem diferença).
2 - Em Código no Focco ERP, informe o código da característica no Focco ERP.
3 - Clique em Adicionar.
Variáveis cujo nome começa com CARACTERISTICA_ não precisam de mapeamento: o Pontta envia o que vem depois do prefixo como código. Por exemplo, CARACTERISTICA_COR vai como COR.
Variáveis sem mapeamento e sem esse prefixo não vão para o Focco ERP.
5. Enviar uma ordem de compra para produção
Abra a ordem de compra em Compras > Ordens de compra. A opção de envio só aparece quando o fornecedor da ordem tem parâmetros do Focco ERP e a ordem ainda não foi enviada.
1 - No menu de três pontos do card da ordem, clique em Enviar para produção.
2 - Escolha a Tabela de venda (obrigatória). A Tabela de venda padrão mostrada no topo é só informativa: ela não preenche o campo.
3 - Confira a Divisão de venda e a Condição de pagamento, que vêm com os padrões da fábrica.
4 - Se quiser, informe o Número do pedido do representante e a Observação, e marque Entrega acordada com o cliente.
5 - Clique em Simular para ver como o pedido ficaria no Focco ERP sem gravar nada, ou em Enviar para produção para criar o pedido na fábrica.
O envio roda em segundo plano. Aparece a mensagem Enviando o pedido para produção. Os dados do envio estarão disponíveis em alguns instantes, e o andamento fica no painel de notificações.
Nota: o envio não muda a situação da ordem de compra no Pontta. Ele só grava o número do pedido na fábrica, que aparece na coluna Produção da lista de ordens de compra.
Nota: quando a ordem de compra vem de um item de assistência técnica e a fábrica tem Divisão de venda de assistência técnica, o campo Divisão de venda fica travado nela.
6. Acompanhar o pedido na fábrica
Depois do envio, o menu de três pontos da ordem de compra mostra Exibir pedido no Focco ERP. A tela traz o número e a situação do pedido, os valores, as datas, os descontos e acréscimos, os itens com a data de entrega, os bloqueios e o transporte.
1 - Clique em Atualizar para buscar a situação mais recente no Focco ERP.
Nota: o Pontta não atualiza esses dados sozinho. A situação mostrada é a da última vez que alguém clicou em Atualizar naquela ordem.
Para achar uma ordem pelo número do pedido na fábrica, use o filtro Número do pedido na fábrica na lista de ordens de compra.
O que vai para o Focco ERP
- Itens: só as requisições de itens compráveis avulsos da ordem de compra. Itens de produto comum do cadastro não entram no pedido da fábrica.
- Código do item: a variável configurada em Nome da variável "código do item". Se o item não tiver essa variável, vai o código da requisição.
- Características: as variáveis mapeadas e as que começam com CARACTERISTICA_.
- Cliente final: nome, CPF ou CNPJ, telefone e endereço do cliente das requisições. Todas as requisições da ordem precisam ter cliente final, e do mesmo cliente.
- Datas: a data de emissão e a data de entrega vão com a data do envio. A data de entrega da ordem de compra não é enviada; o prazo real vem da fábrica, item a item, na tela de acompanhamento.
- Número: o número da ordem de compra vai como ordem de compra do cliente no Focco ERP.
Precificar pelo Focco ERP no Leitor de integração
Com a integração ligada, o Leitor de integração (Administração > Vendas > Leitores de integração) mostra a opção Precificar pelo Focco ERP. Ao ler um arquivo de projeto, os itens das fábricas com parâmetros do Focco ERP são enviados como simulação, e o valor que a fábrica devolve vira o custo do item.
1 - Marque Precificar pelo Focco ERP.
2 - Em Markup para precificação com o Focco ERP, informe o fator aplicado sobre o custo. Sem valor, o preço fica igual ao custo.
Nota: se a fábrica tiver uma Composição de preço publicada, ela substitui o markup do leitor.
Nesse modo, a tabela de venda vem de uma variável do item principal do projeto (por padrão, tableErp) e é comparada pela descrição, não pelo código. Item sem essa variável gera a mensagem Tabela de venda não identificada.
Dúvidas frequentes
A opção Enviar para produção não aparece na ordem de compra.
Ou o fornecedor da ordem não tem parâmetros do Focco ERP cadastrados, ou a ordem já foi enviada. Se já foi, o menu mostra Exibir pedido no Focco ERP.
Aparece "Para criar itens de compra avulsos todas as requisições devem possuir dados do cliente final".
Alguma requisição da ordem está sem cliente. Confira o cliente das requisições ou do acompanhamento de pedido de origem.
Aparece "Não foi possível resolver o CNPJ da unidade para a integração com o Focco ERP".
O documento da unidade padrão está vazio nos parâmetros da fábrica e a unidade de negócio da ordem de compra não tem CNPJ no contato. Preencha um dos dois.
Aparece "Falha ao tentar obter a resposta do Focco ERP. Causa(s): ...".
O Focco ERP recusou o pedido. As causas que vêm depois do texto são da fábrica: em geral, código de item, tabela, divisão ou condição que não existem lá. Confira as variáveis e o mapeamento.
O envio falhou. Posso enviar de novo?
Sim, mas antes peça ao suporte para conferir no log de integração se o pedido chegou a ser criado na fábrica. Em algumas falhas o pedido é criado no Focco ERP, mas a ordem de compra não fica marcada como enviada, e um novo envio cria um segundo pedido.
Marquei Criar ordem de compra automaticamente e nenhuma ordem foi criada.
Essa opção ainda não tem efeito. Atenção ao campo Prazo de entrega da ordem de compra: ele vale para as ordens geradas a partir do acompanhamento de pedido para essa fábrica, mesmo com a opção desmarcada. Se ficar vazio, a data de entrega dessas ordens fica igual à data de criação.