M2 - E-Hub

Objetivo
Funcionalidade
Configurações

Objetivo

Este documento tem como propósito estabelecer um roteiro de ações destinado a orientar técnicos de implantação, suporte, desenvolvimento e clientes nas configurações e premissas necessárias para a utilização da integração entre o sistema Useall M2 e as plataformas de vendas em e-commerce.

Funcionalidade

O fluxo de integração entre os sistemas M2 (ERP), E-Hub (middleware de integração) e ANYMARKET (hub de marketplaces), resulta na distribuição de dados para diversas plataformas de e-commerce como Mercado Livre, Amazon, Shopify, Tray, entre outras. O ponto de partida é um fluxograma técnico que representa visualmente o caminho dos dados desde sua origem no ERP até sua publicação nos canais de venda.

A partir desse fluxo, será apresentada uma abordagem modular, dividida em três etapas principais:

ANYMARKET → Plataformas de E-commerce: foco na distribuição multicanal, controle de campanhas, sincronização de produtos e pedidos;
E-Hub → ANYMARKET: foco na transformação, validação e encaminhamento dos dados para o hub de marketplaces;
M2 → E-Hub: foco na extração e padronização dos dados operacionais e comerciais a partir do ERP.

M2 → ANYMARKET

A integração M2 > AnyMarket foi desenvolvida para oferecer um fluxo de comunicação padronizado entre o M2 e os canais de venda gerenciados pelo AnyMarket.

O M2 atua como sistema de origem, responsável por gerar e disponibilizar as informações de produtos, clientes, estoque e pedidos.
O E-Hub realiza o processamento, conversão e validação dos dados antes de repassá-los ao AnyMarket, que distribui as informações para os canais de venda conectados.

Cada sistema mantém responsabilidade sobre seus próprios dados — o M2 sobre informações fiscais e comerciais, o E-Hub sobre o transporte e validação, e o AnyMarket sobre a sincronização e publicação nos marketplaces.

Por meio do e-Hub, o M2 envia dados fiscais e comerciais de forma automatizada, assegurando agilidade, segurança e rastreabilidade em todas as transações que envolvem produtos, clientes, pedidos e estoque.

Configurações

Regras de Negócio

Antes de enviar os dados ao E-Hub, o M2 aplica validações e regras de negócio para garantir a integridade da integração com marketplaces:

Estoque válido: apenas produtos com saldo disponível no almoxarifado configurado podem ser enviados;
Preços consistentes: produtos devem ter preço de venda ou preço promocional preenchido;
Campos obrigatórios preenchidos: SKU, descrição, categoria, marca e grupo do item;
Dimensões e cubagem informadas: altura, largura, profundidade, peso líquido e bruto;
Imagens obrigatórias: pelo menos uma imagem principal definida, imagens secundárias opcionais;
Descrição para marketplace: campo preenchido com informações técnicas e comerciais;
Atributos e características técnicas: vinculados corretamente para padronização do cadastro;
Controle de status de produto: itens desativados, sob encomenda ou em desativação não são enviados;
Variações e agrupamentos: caso existam, devem estar cadastrados e relacionados corretamente;
Cliente e operação fiscais consistentes: dados necessários para integração de pedidos e fulfillment.

O M2 garante que apenas produtos com informações completas e consistentes sejam publicados nos marketplaces, evitando erros de integração e inconsistências fiscais.

Parâmetros de Integração

Para utilizar a integração AnyMarket - M2, é necessário realizar a parametrização disponível em Início > parametrizações > Comum > Configurar integração.

Nessa parametrização, devem ser definidos todos os campos necessários para o funcionamento da integração, incluindo:

Origem e Filial da integração;
Parâmetros de importação e exportação;
Tempos de disparo para sincronização de dados;
Configurações de geração de pedidos ao importar informações;
Valores padrão para novos clientes;
Indicadores de intermediador e IPI, quando aplicável.

Importante

A configuração correta de todos os parâmetros é essencial para o correto funcionamento da integração.
Alterações incorretas podem gerar inconsistências fiscais ou comerciais, impactando estoque, pedidos e notas fiscais.

Autenticação Externa (OAuth2)

Para a comunicação segura entre o M2 e o E-Hub, é necessário configurar o acesso via protocolo OAuth2, que utiliza as credenciais Client ID e Client Secret.
Essas credenciais são geradas na tela Parametrização → Autenticação Externa, localizada no módulo Central.

Ao acessar a tela, serão exibidos os botões Pesquisar, Novo e Mais opções.

Botão Novo

Ao clicar no botão Novo, a tela Autenticação externa será exibida para o preenchimento dos seguintes campos:

Nome: identificação da autenticação (ex.: Integração AnyMarket);
Empresa: define a empresa vinculada à autenticação;
Filial: unidade associada, utilizada para controle e segregação de acesso;
Usuário: responsável pela autenticação, geralmente o usuário técnico do sistema;
Validade: define o período de vigência da credencial. Após o vencimento, é necessário gerar nova autenticação;
Sistema: define o sistema vinculado (ex.: M2 - Manufatura). Após selecionar o sistema, clicar em Adicionar para registrar.

Botão Mais opções

Ao selecionar um registro da grid de informações, e clicar em Mais opções, serão exibidas as seguintes ações:

Chaves de segurança: exibe a tela com as credenciais de autenticação;

Nessa tela são exibidos os seguintes campos:
- Cliente Id: identificador público da integração;
- Cliente Secret: chave privada usada para autenticação segura com o E-Hub.
É possível copiar ou gerar novas chaves.

Ao gerar novas credenciais, as anteriores perdem a validade imediatamente, exigindo atualização no sistema integrado.
Ativar: habilita a autenticação selecionada para uso;
Bloquear: impede temporariamente o uso da autenticação sem removê-la;
Inativar: desativa definitivamente a autenticação, impedindo novas conexões.

Importante

Cada sistema de integração deve possuir suas próprias credenciais;
A regeneração das chaves deve ser feita somente em caso de revogação de acesso ou substituição de usuário técnico;
O Client ID e o Client Secret devem ser informados no E-Hub para permitir a comunicação com o M2.

Configurações de Integração

Para garantir a comunicação segura e o correto tratamento dos dados fiscais e comerciais, o M2 exige a configuração de credenciais e parâmetros específicos antes de iniciar o fluxo de exportação de produtos e importação de pedidos.

Com as permissões adequadas, o usuário pode acessar a ferramenta e-Hub pelo endereço: https://useallcloud.com.br/ecommhub/

Criação do Usuário de Integração (Pré-requisito)

A comunicação entre o M2, o E-Hub e o AnyMarket deve ser realizada por meio de um usuário técnico dedicado, criado exclusivamente para essa finalidade.

Ação: solicitar à equipe de Infraestrutura a criação de um usuário específico no M2 para controle de acesso externo;
Premissa: este usuário não pode representar uma pessoa física, pois a inativação do registro pode interromper o fluxo de integração;
Função: será o responsável pelos movimentos e pela comunicação entre o M2, o E-Hub e o AnyMarket.

O vínculo do usuário técnico com o ambiente é gerenciado pela equipe de Infraestrutura, que realiza a criação e manutenção deste recurso.

Operacional

O processo operacional marca o momento em que o M2 inicia o controle efetivo da integração com o e-commerce, permitindo a execução prática das configurações estabelecidas.

A seguir, são descritos os passos necessários para realizar esse movimento dentro do sistema.

Assistente para e-Commerce

O uso do Assistente para e-Commerce é fundamental para realizar a integração entre o M2 e o E-Hub, garantindo que todas as informações de produtos, pedidos e estoque sejam centralizadas e sincronizadas corretamente.

Por meio do assistente, é possível configurar a comunicação entre os sistemas, acompanhar o status da integração e validar dados antes do envio para as plataformas de venda.

Para mais detalhes sobre o funcionamento e parametrizações, deve-se consultar o manual completo do Assistente para e-Commerce.

Movimentos e Restrições em Pedidos

Essa função permite compreender como o M2 trata as ações possíveis sobre pedidos integrados ao AnyMarket via e-Hub. O recurso define quais operações são permitidas ou bloqueadas pelo sistema, assegurando a integridade das informações entre o ERP e o marketplace e evitando divergências fiscais ou comerciais.

Faturamento de Pedidos com Fulfillment

O M2 bloqueia a emissão de notas fiscais em pedidos classificados como Fulfillment, pois esses documentos já foram emitidos diretamente pelas plataformas de venda. Assim, ações como faturar pelo menu “Mais opções” ou pela caixa de faturamento (Novo > Faturar pedido) ficam desabilitadas para esse tipo de pedido.

Quando o faturamento é realizado, o M2 envia automaticamente uma notificação ao e-Hub, que atualiza o status do pedido no AnyMarket.

Para essa comunicação, o e-Hub disponibiliza três recursos:

Marcar faturado;
Marcar entregue;
Marcar enviado.

O M2 não controla o status de entrega ou envio ao cliente final, apenas o status de faturamento é atualizado na integração.

As informações transmitidas ao e-Hub incluem:

Código Origem: código da nota fiscal no M2;
Número da nota fiscal;
Série;
Chave de acesso;
Valor total;
XML;
Link para consulta do XML;
Data e hora do faturamento.

Essas informações garantem rastreabilidade fiscal completa, mantendo a consistência entre o M2, o e-Hub e o AnyMarket.

Cancelamento de Pedidos

O M2 não realiza o cancelamento automático de pedidos recebidos do AnyMarket, pois a plataforma não envia evento de cancelamento via e-Hub.

Quando for necessário cancelar uma venda, o procedimento deve ser executado manualmente no M2, garantindo que o controle fiscal e operacional permaneça consistente.

O cancelamento manual assegura que o M2 mantenha a integridade das informações de nota fiscal, estoque e pedidos, evitando divergências entre os sistemas.

Cópia de Registro

É permitido realizar a cópia de registro de pedidos dentro do M2. Contudo, a classificação do pedido original é descartada, e o novo registro seguirá as regras padrão do ERP.

Esse movimento é útil para agilizar cadastros ou reaproveitar informações de pedidos anteriores, mas requer atenção quanto à consistência dos dados fiscais e comerciais, evitando divergências na integração.

Transferência de Pedidos

Pedidos não podem ser transferidos para outra filial, pois a emissão da nota fiscal deve ocorrer exclusivamente na filial de origem da integração. Essa regra garante que o vínculo fiscal e operacional do pedido com o e-Hub seja mantido corretamente.

A tentativa de transferir pedidos entre filiais pode gerar divergências fiscais e de estoque. Por esse motivo, o sistema restringe automaticamente essa operação.

Alterações em Registros

Movimentos que alteram o total a receber do pedido ou que possam gerar divergências entre o pedido de venda e nota fiscal não podem ser executados pelo menu Mais opções > Alterar.

As ações restritas incluem:

Alterar dados principais do pedido;
Tipo de pedido;
Previsão de entrega;
Inclusão de novos itens;
Edição de itens;
Alteração de almoxarifado;
Impostos;
Transporte;
Dados financeiros;
Cotação.

Essas restrições garantem que a integração entre M2 e e-Hub mantenha a consistência fiscal e operacional, evitando divergências entre os registros do ERP e os dados transmitidos ao AnyMarket.

Movimentação de Estoque e Fluxo Fiscal com Fulfillment

No modelo de Fulfillment, o gerenciamento de estoque e o processo de faturamento tradicionais são alterados.
A plataforma de marketplace ou um parceiro logístico é responsável por armazenar, separar e faturar a mercadoria em nome do vendedor.

Para garantir a consistência fiscal e contábil no M2, é fundamental acompanhar corretamente o fluxo de movimentação de estoque e a emissão das notas fiscais correspondentes.

Almoxarifado do Tipo "Operador Logístico"

Para gerenciar o estoque enviado a um centro de distribuição parceiro, é necessário configurar no M2 um almoxarifado específico, classificado como "Operador logístico".

Este almoxarifado funciona como uma unidade de estoque "Virtual" que representa as mercadorias que, embora ainda pertençam à sua empresa, estão fisicamente sob a guarda de terceiros. Todo movimento de produtos realizado neste almoxarifado é considerado estoque próprio para fins contábeis e deve integrar o SPED fiscal.

Configurar corretamente este almoxarifado é o primeiro passo para o controle de estoque em operações de Fulfillment e deve ser vinculado na tela de Configuração - E-Hub.

O Desdobramento Fiscal do Fulfillment

O ciclo de vida fiscal de um produto vendido via Fulfillment ocorre em três etapas principais, que devem ser seguidas para garantir a regularização do estoque e da receita no M2.

Remessa para Fulfillment
- Ação: envio das mercadorias da sua empresa para o centro de distribuição do parceiro logístico;
- Documento Fiscal: é obrigatória a emissão de uma Nota Fiscal de Remessa para Depósito de Terceiros, utilizando o CFOP 5.904/6.904;
- Impacto: movimenta o estoque para o almoxarifado do operador logístico, sem gerar receita.
Venda pelo Marketplace
- Ação: a plataforma de e-commerce realiza a venda e emite a Nota Fiscal diretamente para o consumidor final;
- Impacto no M2: recebe o XML da NF para apuração de tributos e receita, mas não deve ser faturada novamente.
Retorno Simbólico da Mercadoria
- Ação: após a venda ser confirmada pelo marketplace, deve-se emitir uma Nota Fiscal de Retorno Simbólico no M2 para regularizar o estoque fiscalmente;
- Documento Fiscal: utiliza-se o CFOP 5.905/6.905 de Retorno de mercadoria remetida para depósito de terceiros;
- Impacto: baixa o estoque do almoxarifado "Operador logístico" e regulariza a receita do ponto de vista contábil e fiscal no M2.

Importante

A não emissão das NFs de Remessa e Retorno Simbólico pode gerar divergências graves no controle de estoque, inconsistências no inventário e problemas na apuração fiscal (SPED).

Monitoramento de Integrações

O M2 disponibiliza uma tela de acompanhamento que permite monitorar, em tempo real, o status das integrações realizadas com o E-Hub.

Por meio dessa tela, é possível identificar falhas, verificar o volume de dados processados e garantir a rastreabilidade das informações trocadas entre os sistemas.

O acesso está disponível em Início > Integrações.

Ao acessar a funcionalidade de Integrações, o sistema exibe a tela com indicadores organizados por tipo de movimentação:

Disparos últimas 24h: total de dados recebidos e erros ocorridos;
Clientes últimas 24h: registros de clientes processados com sucesso ou com falha;
Pedidos últimas 24h: pedidos integrados e pendências encontradas;
CT emitidos últimas 24h: conhecimentos de transporte recebidos ou com erro;
XMLs importados últimas 24h: documentos fiscais processados com sucesso;
Última exportação: data e hora da última ação de envio de dados.

Essa tela atua como um painel de monitoramento, garantindo que as integrações entre o M2, o E-Hub e o AnyMarket ocorram de forma estável e rastreável, facilitando a identificação de eventuais falhas de comunicação.

Documentos relacionados

Acesse a área de vídeos e confira os tutoriais!!

Voltar ao topo