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.
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#
- No Eccosys, gere o token em Configurações › Outros Aplicativos Externos.
- No Hub, vá em Configurações › Loja, desça até ERP para Recebidos e clique em Conectar Eccosys.
- Em Ambiente, digite só o nome antes de
.eccosys.com.br(o endereço que você usa para entrar no Eccosys). Exemplo:minhaempresa. - Em Token de API, cole o token.
- Clique em Conectar. O Hub testa o acesso e procura a operação fiscal de bonificação.
- 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#
| Mensagem | Por 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.

