Como funciona a integração entre ANYMARKET e Sankhya?

A integração nativa entre o ANYMARKET e o ERP Sankhya conecta as duas plataformas e automatiza a troca de informações entre elas: envio de pedidos, atualização de status, sincronização de produtos, preços, estoques e notas fiscais. 

Assim, você elimina os processos manuais de importação e exportação, reduz erros de dados e deixa sua operação nos marketplaces mais rápida e confiável.

Este artigo explica como a integração funciona, o que ela sincroniza em cada área e o que você precisa configurar do seu lado.

Neste artigo:

• Como a integração funciona
• O que você precisa saber antes de habilitar
• Produtos
• Preços
• Estoque
• Pedidos
• Cancelamento de pedidos
• Dúvidas comuns

Como a integração funciona

De forma resumida, a integração:

• traz o catálogo de produtos, preços e estoques do Sankhya para dentro do ANYMARKET, mantendo tudo sincronizado ao longo do tempo;
• envia os pedidos feitos nos marketplaces para o Sankhya, cria o cliente final quando necessário e acompanha o pedido até a emissão da nota fiscal;
• devolve ao ANYMARKET a confirmação de faturamento e os cancelamentos ocorridos no ERP, mantendo o status do pedido igual nos dois sistemas.

O que você precisa saber antes de habilitar

A integração funciona apenas com os campos, tabelas e regras nativos do Sankhya. 

O Sankhya é uma plataforma muito personalizável, e é comum ter campos, tabelas ou telas criados sob medida para a operação, mas a integração não foi construída para reconhecer essas personalizações.

Na prática: se uma informação necessária para a integração estiver apenas em um campo, tabela ou tela personalizada, a integração não conseguirá ler nem gravar essa informação ali.

Produtos

• São sincronizados apenas produtos simples (sem variação/grade). Produtos com grade (por exemplo, tamanho ou cor) não são criados nem atualizados pela integração, considere isso ao planejar seu catálogo.
• O produto é relacionado entre os dois sistemas pelo código do produto no Sankhya (CODPROD), que corresponde ao SKU no ANYMARKET.
• No Sankhya, cada produto está vinculado a uma empresa e a um local de estoque. A importação pode considerar uma ou várias empresas, conforme a sua configuração.
• Carga inicial: importa todo o catálogo do Sankhya para o ANYMARKET, criando os produtos que ainda não existem.
• Importação pontual: você pode importar um único produto pelo código. Útil para corrigir um cadastro específico ou testar a integração sem rodar a carga completa.
• Atualização contínua: a cada execução, apenas os produtos alterados desde a última sincronização são atualizados, produtos novos encontrados também são criados automaticamente.
• Categorias: criadas e mantidas automaticamente a partir do grupo de produto do Sankhya, sem precisar montar esse mapeamento manualmente.
• Imagens: a imagem principal de cada produto é buscada no Sankhya e vinculada automaticamente ao produto no ANYMARKET.
• Você escolhe como a integração trata os produtos: ela pode criar e atualizar continuamente, ou apenas criar. A opção "apenas criar" existe porque o Sankhya normalmente não tem informações muito usadas nos marketplaces (descrições mais completas, atributos de anúncio etc.). Com "apenas criar", você enriquece o anúncio direto no ANYMARKET e a integração continua trazendo produtos novos do Sankhya sem sobrescrever o que você já enriqueceu.

Preços

• Os preços vêm de uma única tabela de preços do Sankhya, que você informa e cadastra no ANYMARKET. A sincronização acontece periodicamente. A integração não combina nem escolhe entre várias tabelas.
• O preço não varia por local de estoque: como o Sankhya não detalha o local na consulta de preço, a integração aplica o valor da tabela configurada e replica o mesmo preço para todos os locais.
• Se o Sankhya retornar mais de um preço para o mesmo produto dentro da tabela configurada, a integração usa o maior valor. Para garantir que o preço aplicado seja sempre o esperado, cadastre um único preço por produto nessa tabela.
• Você escolhe entre três formas de cálculo do preço final, cada uma tratando o valor do Sankhya de um jeito:
  • Automático: o valor do Sankhya entra como preço de custo, e o ANYMARKET aplica a sua regra de precificação para chegar ao preço de venda. Se preferir, você pode cadastrar no Sankhya o próprio preço de venda desejado.
  • SKU: o valor da tabela do Sankhya é replicado diretamente. Como o Sankhya não fornece dois valores diferentes, os preços "De" e "Por" do anúncio recebem o mesmo valor — ou seja, sem preço promocional "De/Por" automático.
  • Manual por anúncio: o valor do Sankhya forma apenas o preço base. O ajuste fino de cada anúncio continua sendo feito por você, diretamente no ANYMARKET.

Estoque

• Os saldos de estoque são consultados periodicamente no Sankhya e enviados ao ANYMARKET. A integração cria o local de estoque quando ele ainda não existe e atualiza o saldo quando já existe, inclusive quando o saldo é zero.
• O local de estoque no ANYMARKET é criado automaticamente conforme o local correspondente no Sankhya.

Atenção: Se você tem mais de uma empresa (CNPJ):

• A integração nasceu para operar com uma única empresa por painel do ANYMARKET. Ela pode comportar mais de uma empresa (CNPJ) no mesmo painel, mas isso só funciona com segurança se você seguir os cuidados abaixo.
• O Sankhya controla o estoque por produto, empresa e local; o ANYMARKET controla por produto e local, sem o conceito de empresa. Como o Sankhya exige uma empresa ao criar o pedido, a integração precisa sempre saber qual CNPJ deve receber cada venda.
• Para isso, cada local de estoque criado no ANYMARKET recebe automaticamente um nome padronizado que combina o código da empresa com o código do local no Sankhya (exemplo: 1 - 100200). Esse nome é gerado e controlado pela integração, você não precisa montá-lo manualmente. Quando uma venda acontece, a integração usa esse nome para identificar a empresa certa e criar o pedido no Sankhya nela.
• O ANYMARKET não sabe, sozinho, que locais como 1 - 200 e 2 - 300 são de empresas diferentes — essa separação existe só no nome. Se o mesmo SKU tiver saldo nesses dois locais e a associação com a conta de marketplace não for feita, o ANYMARKET soma os saldos e mistura o estoque de empresas diferentes no mesmo anúncio.
• O que você precisa fazer nesse cenário:
  • associar cada local de estoque à conta de marketplace correta no painel do ANYMARKET, para que cada conta veja apenas os locais da sua própria empresa;
  • sempre que surgir um novo local no Sankhya, ele será criado automaticamente no ANYMARKET. Associe-o à conta certa para que os saldos não se misturem;
  • nunca renomear manualmente os locais de estoque criados pela integração.

Pedidos

• Quando ocorre uma venda no ANYMARKET, a integração cria o pedido no Sankhya, identifica o cliente final por CPF ou CNPJ (pessoa física e jurídica são suportadas) e vincula o endereço de entrega.
• Se o cliente final ainda não existe no Sankhya, ele é criado automaticamente; se já existe, os dados cadastrais e endereços são mantidos atualizados.
• Você pode configurar a confirmação automática do pedido no Sankhya assim que o pagamento for confirmado no ANYMARKET.

Como os status se correspondem entre o ANYMARKET e o Sankhya

O Sankhya não tem, no pedido, um status equivalente ao status do ANYMARKET. Por isso, a integração adota a seguinte correspondência:

• Quando a nota fiscal (NF-e) é emitida no Sankhya, a integração identifica a emissão, coleta os dados e o XML da nota e atualiza o pedido no ANYMARKET como faturado, repassando essas informações ao marketplace.
• O número do pedido no Sankhya (NUNOTA) fica vinculado ao pedido no ANYMARKET, garantindo rastreabilidade entre os dois sistemas para consultas e suporte.
• Pedidos de fulfillment são identificados separadamente dos pedidos normais e criados no Sankhya com uma operação específica. Para isso, é preciso ter uma TOP (tipo de operação) diferente para pedidos convencionais e para pedidos de fulfillment, e essa TOP precisa ser mapeada por você para cada caso.
• O que você precisa configurar antes:
  • para pedidos convencionais: o de-para da forma de pagamento e o de-para da transportadora (com os códigos cadastrados no Sankhya);
  • para pedidos de fulfillment: o de-para relacionando a conta de marketplace à empresa correspondente no Sankhya. Isso é necessário porque pedidos de fulfillment não carregam a informação de local de estoque — então a integração não teria, por esse caminho, como saber em qual empresa criar o pedido.
• Em quais status do ANYMARKET o pedido pode ser exportado para o Sankhya:
  • Convencional: Pendente e Pago.
  • Fulfillment: Pendente, Pago, Faturado, Enviado e Concluído.
• Anexos do pedido: além de você já consumir os documentos fiscais (XML) de fulfillment e as etiquetas de envio direto no ANYMARKET, a integração também disponibiliza esses arquivos no Sankhya, anexados ao pedido correspondente. A integração apenas deixa o arquivo disponível como anexo; o processamento do documento continua sendo feito por você, conforme a sua necessidade.
  • Etiqueta de marketplace: buscada e disponibilizada automaticamente após o faturamento do pedido, anexada ao pedido no Sankhya.
  • XML de venda do fulfillment: coletado desde a entrada do pedido até um período de 30 dias, anexado ao pedido no Sankhya conforme os XMLs vão sendo disponibilizados.
  • A forma como esses arquivos ficam disponíveis depende de o seu Sankhya ter ou não o módulo construtor de telas:
    • Sem construtor de telas: o arquivo é anexado ao pedido, mas não há uma tela no Sankhya para baixá-lo. Os arquivos ficam gravados no servidor do Sankhya e podem ser acessados pela sua equipe de TI.
    • Com construtor de telas: é disponibilizado um arquivo .zip que precisa ser carregado durante a implantação. Ele prepara, dentro do Sankhya, uma tabela de controle dos pedidos ANYMARKET x Sankhya, onde os arquivos ficam anexados e disponíveis para download por você.

Cancelamento de pedidos

• A integração consulta periodicamente o Sankhya em busca de pedidos cancelados no ERP e replica esse status no ANYMARKET. O cancelamento do pedido no marketplace ainda segue os critérios e as regras próprios de cada marketplace.
• No sentido inverso, quando você cancela um pedido no ANYMARKET:
  • se ele ainda estava pendente no Sankhya, é excluído do ERP;
  • se já estava pago/confirmado, é cancelado mantendo o histórico.

Dúvidas comuns

Meus produtos com variação (tamanho, cor) vão ser sincronizados?
Não. A integração sincroniza apenas produtos simples. Produtos com grade não são criados nem atualizados.

Como o ANYMARKET sabe qual produto é qual no Sankhya?
Pela ligação entre o código do produto no Sankhya (CODPROD) e o SKU no ANYMARKET.

A integração lê os campos personalizados que criei no meu Sankhya?
Não. Ela funciona apenas com campos e tabelas nativos do Sankhya. Informações que estejam só em campos ou tabelas personalizadas não serão lidas nem gravadas.

Consigo ter preços diferentes por local de estoque?
Não. A integração aplica o valor da tabela configurada e replica o mesmo preço para todos os locais.

E se o mesmo produto tiver mais de um preço na tabela?
A integração usa o maior valor. Para evitar surpresas, cadastre um único preço por produto na tabela apontada.

Posso integrar mais de um CNPJ no mesmo painel?
Sim, mas a integração foi feita para operar com uma empresa por painel. Para o cenário com vários CNPJs funcionar com segurança, associe cada local de estoque à conta de marketplace correta e nunca renomeie os locais criados pela integração.

Posso renomear os locais de estoque criados pela integração?
Não. O nome padronizado (código da empresa + código do local, ex.: 1 - 100200) é gerado e controlado pela integração. Renomear manualmente faz a integração perder a referência da empresa correta nos pedidos.

Marcar o pedido como "Faturado" no ANYMARKET cria a nota fiscal no Sankhya?
Não. É o contrário: a nota fiscal é emitida no Sankhya, e a integração identifica essa emissão para atualizar o pedido no ANYMARKET.

Preciso configurar algo específico para pedidos de fulfillment?
Sim. É necessário o de-para relacionando a conta de marketplace à empresa no Sankhya e uma TOP (tipo de operação) diferente da usada em pedidos convencionais.

O que acontece quando cancelo um pedido no ANYMARKET?
Se ele ainda estava pendente no Sankhya, é excluído do ERP. Se já estava pago/confirmado, é cancelado mantendo o histórico.