Como configurar a integração com o Sankhya
A integração entre a Base e o Sankhya permite sincronizar pedidos, produtos e notas fiscais entre as plataformas, centralizando a operação e automatizando processos do dia a dia.
Neste guia, você aprenderá os requisitos da integração, como realizar a autenticação e conhecerá os principais comportamentos e limitações da integração.
Requisitos
Antes de configurar a integração, verifique se sua empresa atende aos seguintes requisitos:
- Utilizar o SankhyaOM versão 4.34 ou superior;
- Possuir acesso ao ambiente de produção do Sankhya;
- Ter um usuário com todas as permissões necessárias para integração.
Importante: A versão mínima do Sankhya é obrigatória para o correto funcionamento da integração.
Como adicionar a integração
Na Base, acesse:
Integrações > Adicionar integração
Pesquise por Sankhya e selecione a integração disponível.
Ambiente disponível:
- Produção
Autenticação
A autenticação utiliza as credenciais fornecidas pelo próprio Sankhya.
Você deverá informar:
- Token da aplicação, criado nas Configurações de Gateway do Sankhya;
- Client ID;
- Client Secret, gerados na Área do Desenvolvedor (Área Dev) do Sankhya.
Importante: O usuário que criou o aplicativo na Área Dev deve ser o mesmo usuário configurado no Gateway com as permissões da integração. Caso sejam usuários diferentes, poderão ocorrer erros de autenticação.
Permissões necessárias
O usuário utilizado na integração deve possuir acesso aos principais módulos utilizados pela Base, incluindo:
- Pedidos;
- Produtos;
- Parceiros;
- Notas fiscais;
- Modelos de nota;
- Tipos de Operação (TOP);
- Estoque e locais de estoque.
Caso alguma dessas permissões esteja ausente, a integração poderá apresentar falhas durante o envio ou faturamento dos pedidos.
Configuração de estoque
O Sankhya trabalha com:
- Depósitos;
- Locais de estoque.
Para que a integração funcione corretamente, é necessário que o Código do Local de Estoque Padrão esteja preenchido diretamente no cadastro de cada produto.
Importante: Essa informação deve estar configurada no produto e não apenas na empresa.
Configuração da tabela de preços
Durante a configuração da integração, é obrigatório informar o ID da Tabela de Preços utilizada pelo Sankhya.
Essa informação será utilizada para importar corretamente os valores dos produtos.
Como funciona o envio de pedidos
Quando um pedido é recebido na Base:
- O pedido é enviado para o Sankhya;
- O ERP cria um Pedido de Venda;
- A emissão da Nota Fiscal acontece diretamente no Sankhya;
- Após o faturamento, a Base identifica automaticamente o XML da nota fiscal;
- O XML é enviado ao marketplace e fica disponível para download na Base.
Importante: A emissão da Nota Fiscal ocorre exclusivamente dentro do Sankhya.
Por uma limitação da API do ERP, a Base não consegue solicitar diretamente a emissão da nota fiscal.
Caso seja necessário automatizar esse processo, a configuração deverá ser realizada diretamente no Sankhya.
Configuração do Modelo de Nota e TOP
Para que os pedidos sejam enviados corretamente, o modelo de nota utilizado deve existir no Sankhya.
Além disso:
- o Tipo de Operação (TOP) vinculado ao modelo deve ser do tipo Pedido de Venda (P).
Caso contrário, poderão ocorrer erros durante a integração.
Importação de produtos
A integração permite importar automaticamente os produtos cadastrados no Sankhya.
Durante a importação:
- o CODPROD do Sankhya será utilizado como:
- SKU;
- ID interno do produto.
Também é possível utilizar configurações personalizadas para definir outro campo como SKU e importar campos adicionais como atributos da ficha técnica.
Integração com múltiplas empresas
A Base permite configurar múltiplas integrações com o Sankhya, possibilitando operar diferentes empresas ou bases de dados de forma independente.
Envio de XML para pedidos Fulfillment
A integração também permite enviar o XML de pedidos atendidos pelo Fulfillment ao Sankhya.
Importante: Após o envio do XML, o processamento deverá ser realizado manualmente na ferramenta de importação do Sankhya.
Caso o XML não seja processado corretamente, o ERP poderá criar um novo pedido em vez de importar a nota fiscal.
Limitações e observações importantes
Antes de utilizar a integração, considere os seguintes pontos:
- A emissão da Nota Fiscal é realizada exclusivamente pelo Sankhya;
- O faturamento automático depende das configurações do ERP;
- Algumas empresas utilizam conferência manual antes do faturamento;
- O processamento do XML pode exigir intervenção manual;
- O modelo da nota deve ser do tipo 55 para geração correta da DANFE;
- O usuário da integração deve possuir todas as permissões necessárias.
Principais erros
Erro relacionado ao Tipo de Operação (TOP)
Mensagem semelhante a:
“O tipo de movimento do tipo de operação deve ser P – Pedido de Venda.”
Esse erro indica que o TOP configurado no modelo de nota não corresponde a um Pedido de Venda.
A correção deve ser realizada diretamente no Sankhya.
Erro durante o faturamento
Em alguns ambientes, o ERP pode impedir o faturamento automático quando existe obrigatoriedade de conferência manual.
Nesses casos, o pedido será recebido normalmente pela Base, porém permanecerá aguardando o faturamento dentro do Sankhya.
Erro “NullPointerException”
Esse erro é interno do Sankhya.
Segundo a equipe do ERP, a correção depende da atualização para a versão mais recente disponibilizada pelo fabricante e, em alguns casos, da reinicialização da aplicação.
FAQ
A Base cadastra automaticamente clientes (parceiros) no Sankhya?
Sim. Os parceiros são criados ou atualizados automaticamente durante a integração.
A Base importa o custo dos produtos do Sankhya?
Não.
A integração importa apenas o valor de venda informado no ERP.
A Base envia taxas e comissões dos marketplaces para o Sankhya?
Não.
Atualmente essas informações não são integradas.
A Base realiza baixa financeira automática?
Não.
A integração não realiza conciliação financeira nem baixa automática de títulos.
É necessário criar um TOP diferente para cada marketplace?
Não obrigatoriamente.
Essa definição fica a critério da empresa e da estrutura utilizada no Sankhya.
O pedido é criado como Pedido de Venda ou Nota Fiscal?
Os pedidos são criados inicialmente como Pedido de Venda.
A Nota Fiscal é emitida posteriormente pelo próprio Sankhya.
Boas práticas
Para evitar problemas na integração, recomendamos:
- manter o Sankhya sempre atualizado para a versão mínima suportada;
- conferir se o usuário da integração possui todas as permissões necessárias;
- validar corretamente o Modelo de Nota e o TOP utilizados;
- configurar o Código do Local de Estoque nos produtos;
- verificar se a Tabela de Preços está corretamente informada;
- validar as configurações do ERP antes de iniciar a operação.
Dessa forma, a integração ocorrerá de maneira mais estável, reduzindo falhas durante o envio de pedidos e emissão de notas fiscais.