A integração entre o Eccosys e o BaseLinker foi desenvolvida para proporcionar uma comunicação completa e segura entre as duas plataformas, automatizando os principais processos operacionais de e-commerce.
Por meio dessa integração, o BaseLinker atua como o intermediador das operações, conectando o Eccosys aos marketplaces e concentrando as trocas de informações de forma centralizada. Essa comunicação ocorre em duas vias, garantindo que tanto o recebimento de pedidos quanto o envio de dados fiscais aconteçam de maneira sincronizada
Neste manual, você aprenderá:
Como funciona a comunicação entre Eccosys e BaseLinker
Como obter a chave de API do Eccosys para integração com o Baselinker.
Como configurar o retorno de etiquetas dos marketplaces para impressão no Eccosys.
Como funciona a comunicação entre Eccosys e BaseLinker
A integração entre as plataformas ocorre por meio de duas chamadas distintas, que garantem a troca completa de informações entre o Eccosys e o BaseLinker:
BaseLinker → Eccosys (via chave API Eccosys):
O BaseLinker utiliza a chave de API gerada no Eccosys para registrar e atualizar pedidos e produtos dentro do ERP.
Dessa forma, todas as informações de vendas e cadastros são enviadas automaticamente para o Eccosys.Eccosys → BaseLinker (via configuração com chave BaseLinker):
Já no sentido inverso, o Eccosys utiliza o token do BaseLinker configurado em Configurações > Configurações Gerais > Integração BaseLinker para enviar os dados fiscais da NF-e após o faturamento.
A partir desse envio, o BaseLinker processa as informações e retorna a etiqueta de transporte do marketplace, que pode ser impressa diretamente pelo Eccosys.
💡 Essa comunicação dupla garante o fluxo completo de integração — desde o recebimento do pedido até a geração e impressão da etiqueta oficial de envio.
Como obter a chave de API do Eccosys
A criação do token de acesso à API do Eccosys é o primeiro passo para estabelecer a integração com o Baselinker. Esse token é responsável por autenticar e permitir a troca de informações entre as plataformas de forma segura.
Para gerar o token, siga os passos abaixo:
Acesse o menu Configurações > Outros Aplicativos Externos.
Clique em “Incluir um Aplicativo”.
Preencha os campos conforme as orientações:
Descrição: informe uma breve descrição da integração, identificando sua finalidade (por exemplo, Integração Eccosys x Baselinker).
Tipo de integração: selecione o tipo correspondente à integração que está sendo configurada.
Nome do responsável: insira o nome da pessoa responsável pela manutenção da integração em seu ambiente.
E-mail do responsável: insira o e-mail do responsável pela atualização dos dados.
Após preencher todas as informações, clique em “Salvar”.
Em seguida, a função “Gerar Token” ficará disponível.
Clique em “Gerar Token” para criar a chave de acesso.
O token será exibido na tela e poderá ser copiado e encaminhado ao responsável pela integração — que utilizará essa chave para configurar a comunicação entre o Eccosys e o Baselinker.
Configuração para retorno de etiquetas dos Marketplaces
Após gerar o token de API no Eccosys, o próximo passo é configurar a integração diretamente no sistema, para que as etiquetas de envio dos marketplaces sejam corretamente retornadas e possam ser impressas pelo Eccosys.
Para isso, acesse o caminho:
Configurações > Configurações gerais > Integração BaseLinker
Essa tela concentra todos os parâmetros de conexão e sincronização entre o Eccosys e o Baselinker.
A seguir, confira o propósito de cada campo disponível na página:
Unidade de Negócio:
Define para qual unidade de negócio a integração será aplicada.
⚠️ Antes de alternar entre unidades, salve as configurações atuais para evitar a perda de dados não salvos.X-BLToken:
Campo destinado ao token de conexão gerado no painel do Baselinker.
Esse token é responsável por autenticar a comunicação entre as plataformas, permitindo a troca de informações.ID da Série de Numeração na Baselinker:
Indique o ID da série de numeração configurado no Baselinker, utilizado para o controle da emissão das notas fiscais.
Essa informação garante a correta associação entre os pedidos integrados e suas respectivas NFs.Enviar Nota Fiscal para os pedidos com Canal de venda:
Permite definir para quais canais de venda (ex.: Mercado Livre, Magazine Luiza, TikTok Shop, entre outros) o Eccosys deve enviar automaticamente a nota fiscal gerada.
É possível selecionar canais específicos ou marcar “Todos” para aplicar a configuração a todos os marketplaces vinculados.
Emissão da Nota Fiscal e Retorno da Etiqueta de Transporte
Após configurada a integração entre o Eccosys e o Baselinker, o processo de emissão e retorno das etiquetas de transporte passa a ocorrer de forma automatizada, conforme as etapas descritas abaixo.
Registro do Pedido no Eccosys
A BaseLinker, utilizando a API do Eccosys, realiza o registro dos pedidos diretamente no sistema.
Esses pedidos seguirão o fluxo operacional normal dentro do Eccosys, permitindo que o cliente realize o faturamento e a emissão da Nota Fiscal (NF-e).
Envio dos Dados Fiscais para o BaseLinker
Ao emitir a Nota Fiscal, o Eccosys sincroniza automaticamente os dados fiscais com o BaseLinker.
Caso seja necessário reenviar manualmente, basta:
Acessar a tela de Notas Fiscais.
Abrir o menu de contexto (ícone de três pontos à frente da Nota).
Selecionar a opção “Enviar para BaseLinker”.
Processamento e Retorno da Etiqueta
Assim que a Nota Fiscal é transmitida, o BaseLinker processa as informações fiscais e gera a etiqueta de transporte correspondente.
⚠️ Esse retorno pode levar alguns minutos, dependendo do volume de pedidos e da resposta do marketplace vinculado.
Impressão da Etiqueta de Transporte
Após o processamento e retorno da etiqueta, ela pode ser impressa diretamente no Eccosys, de duas formas:
Opção 1 – Impressão em lote:
Acesse Vendas > Notas Fiscais, selecione as notas desejadas e, no menu de ações, clique em “Imprimir etiqueta de transporte”.Opção 2 – Impressão individual:
Acesse o menu de contexto da NF-e desejada e selecione “Imprimir etiqueta de transporte”.
Com esse processo concluído, o Eccosys garante que os dados fiscais e logísticos sejam devidamente sincronizados com o BaseLinker, permitindo que a etiqueta oficial do marketplace seja impressa de forma simples, centralizada e segura dentro do ERP.
Conclusão
A integração entre o Eccosys e o BaseLinker oferece um fluxo de trabalho otimizado e totalmente automatizado, permitindo que os pedidos, notas fiscais e etiquetas de transporte sejam sincronizados de forma segura e eficiente.
Com a configuração correta da chave API, do token de conexão e dos parâmetros de envio de notas fiscais, o processo de retorno das etiquetas de marketplace torna-se simples e integrado ao faturamento realizado dentro do Eccosys.
Em caso de dúvidas, nosso time do suporte está à disposição para auxiliar.