Conectar o Eccosys

Conecte o Eccosys com o ambiente e o token de API, confira a operação fiscal de bonificação e escolha a unidade de negócio dos kits.

Atualizado em 09/11/2026Só o dono da marca

Com o Eccosys conectado, os kits de Recebidos viram pedidos no seu Eccosys com todos os itens marcados como bonificação. A nota e o rastreio voltam sozinhos para o Hub. Só o dono da marca pode conectar.

Antes de começar#

No Eccosys, cadastre uma operação fiscal de bonificação marcada como padrão (Configurações › Operações fiscais › "Padrão para bonificação"). É ela que define a natureza e o CFOP da nota. O Hub não escolhe a operação por pedido: usa a que está marcada como padrão.

Passo a passo#

  1. No Eccosys, gere o token em Configurações › Outros Aplicativos Externos.
  2. No Hub, vá em Configurações › Loja, desça até ERP para Recebidos e clique em Conectar Eccosys.
  3. Em Ambiente, digite só o nome antes de .eccosys.com.br (o endereço que você usa para entrar no Eccosys). Exemplo: minhaempresa.
  4. Em Token de API, cole o token.
  5. Clique em Conectar. O Hub testa o acesso e procura a operação fiscal de bonificação.
  6. Se a marca tem mais de uma filial, em Unidade de negócio dos kits clique no lápis, escolha a filial (CNPJ) que emite os pedidos e as notas e salve.

Pronto: aparece "Eccosys conectado. Operação de bonificação: (nome)." O token fica criptografado e não é exibido de novo.

Como o pedido chega no Eccosys#

  • Os produtos são encontrados pelo SKU.
  • Cada item vai marcado como bonificação, e o pedido leva a referência do kit (KIT-XXXXXX) como ordem de compra.
  • Se um pedido com essa referência já existe (e não está cancelado), o Hub reaproveita e não cria outro.

Para conferir antes, selecione kits em Recebidos e clique em Simular. Veja rastreio e status.

Erros comuns e o que fazer#

MensagemPor quêO que fazer
"Nenhuma operação fiscal de bonificação marcada como padrão no Eccosys. …"Falta a operação padrão de bonificação (na unidade escolhida).Marque uma operação como "Padrão para bonificação" no Eccosys e clique em Verificar operação de novo.
"Ambiente inválido: use só o nome antes de .eccosys.com.br."Você colou o endereço inteiro ou com caracteres a mais.Digite só o nome (ex.: minhaempresa).
"Não encontramos o ambiente "….eccosys.com.br". Confira o nome."O nome do ambiente está errado.Confira o endereço que você usa para entrar no Eccosys.
"Token do Eccosys inválido: o Eccosys recusou o acesso."O token está errado ou foi excluído.Gere um novo token e use Trocar token.
"Cole o token de API gerado no Eccosys."O campo está vazio ou incompleto.Cole o token inteiro.
"SKU … não encontrado no Eccosys"O produto não existe no Eccosys com esse código.Cadastre ou corrija o código do produto no Eccosys e tente de novo.
"Pedido … criado, mas o Eccosys não aceitou a unidade de negócio escolhida. Ajuste a unidade no pedido."O pedido foi criado, mas ficou na unidade padrão.Ajuste a unidade direto no pedido, no Eccosys.
"O Eccosys limitou as requisições (429). Tente de novo em alguns minutos."Muitas chamadas seguidas.Espere alguns minutos.

Perguntas frequentes#

Mudei a unidade de negócio. A operação muda também?

Sim. As operações fiscais são de cada unidade. Ao salvar a unidade, o Hub procura a operação de bonificação padrão dela. Se não houver, aparece "Unidade salva, mas ela não tem operação fiscal marcada como padrão de bonificação no Eccosys."

O que acontece se eu desconectar?

Os kits já enviados continuam no Eccosys, mas o Hub para de acompanhá-los. Para revogar o token de vez, exclua-o no Eccosys.

Este artigo ajudou?

Não resolveu?

Fale com a gente. A mensagem já vai com a tela e o artigo, para agilizar o atendimento.

Leia também