O guia rápido “Integração das notas fiscais emitidas pelo Mercado Full do Mercado Livre” está subdividido nas seções:
O que é a integração de NF-e do Mercado Full do Mercado Livre?
Como funciona a importação de XML pelo Integrador E-commerce?
Como o Nomus cria o documento de saída e vincula ao pedido de venda?
O que é a integração de NF-e do Mercado Full do Mercado Livre?
Quando a venda é realizada pelo Mercado Livre utilizando o serviço Mercado Full, a NF-e de venda é emitida pelo próprio marketplace, e não pelo Nomus ERP.
A integração com o integrador E-commerce permite que o XML dessa NF-e emitida pelo Mercado Livre seja trazido automaticamente para o Nomus. A partir desse XML o sistema:
cria uma nota fiscal no Nomus na série correta;
gera o documento de saída;
vincula esse documento ao pedido de venda integrado;
atualiza o status dos itens do pedido conforme a emissão da NF-e.
O objetivo é manter o controle fiscal e de estoque centralizado no Nomus, mesmo quando a emissão da nota é feita fora do ERP.
Como funciona a importação de XML pelo Integrador E-commerce?
O Integrador E-commerce já possui um processo de integração que:
Consulta os pedidos no marketplace periodicamente.
Quando identifica que a NF-e foi emitida pelo marketplace, caso do Mercado Full, o integrador E-commerce consegue buscar o XML dessa NF-e.
-
Ao receber o pedido com o XML, o Nomus:
lê o arquivo;
valida dados essenciais (série, itens, CNPJ, etc.);
segue para a criação da nota fiscal e do documento de saída.
Esse fluxo acontece automaticamente em background, respeitando o intervalo configurado na central de integração.
Veja uma imagem da tela "Integração" referente ao integrador E-commerce:
Como contratar o Integrador E-commerce?
Para clientes da base é necessário enviar um email para financeiro@nomus.com.br para receber uma proposta comercial e fazer um termo aditivo antes de iniciar a implantação.
Para utilizar o Integrador E-commerce é necessário contratar:
Assinatura mensal por canal de venda em 1 CNPJ,
Contratar uma estimativa de 4 horas de implantação por canal de venda em 1 CNPJ.
Essa estimativa de 4 horas de implantação não prevê a importação de dados do e-commerce e marketplaces para o o sistema Nomus.
Quais são as configurações necessárias no Nomus ERP?
Habilitar importação de XML de NF-e emitida pelo marketplace
No cadastro da integração do e-commerce o sistema apresenta o campo:
“Habilitar importação de XML de NF-e emitida pelo marketplace?”: Para ativar essa funcionalidade, selecione "Sim". Por padrão, o sistema é configurado com o valor "Não".
Veja uma imagem abaixo da configuração "Habilitar importação de XML de NF-e emitida pelo marketplace":
Somente quando esse campo estiver marcado como “Sim” o Nomus :
buscar o XML da NF-e emitida pelo Mercado Livre;
tentar criar a nota fiscal e o documento de saída automaticamente.
Ao lado do campo, há um ícone de ajuda explicando que alguns marketplaces (como o Mercado Livre – Mercado Full) permitem essa integração de XML, e que a opção deve ser ativada apenas nesses casos.
Série específica para as NF-e do Mercado Livre
As notas fiscais emitidas pelo Mercado Livre devem utilizar uma série diferente da série utilizada nas emissões normais do ERP.
Por isso, é necessário:
Acessar a tela “Séries de nota fiscal”.
Cadastrar a mesma série que é utilizada no XML emitido pelo Mercado Livre (ex.: “2”, “3”, etc.).
Garantir que essa série esteja ativa e configurada corretamente para NF-e de venda.
Se, ao importar o XML, a série informada no arquivo não existir no Nomus, a integração registra com a mensagem de erro na tela de logs de integração de recebimento: “A série X, utilizada no xml, não foi localizada no Nomus. Cadastre essa série na tela de ‘Séries de nota fiscal’.”
Sem esse cadastro, a nota fiscal não é criada.
Segue abaixo uma imagem da tela de criação de série de nota fiscal:
Tipo de movimentação padrão para documentos de saída gerados via XML
Ainda no cadastro da integração do e-commerce foi criado o campo:
“Tipo de movimentação padrão para criação de documentos de saída a partir do XML da NF-e”: O sistema apresenta uma lista de todos os tipos de movimentação de natureza “Venda”. O sistema por padrão seleciona o valor “Selecione”.
Veja uma imagem abaixo da configuração "Tipo de movimentação padrão para criação de documentos de saída a partir do XML da NF-e":
Como o sistema decide o tipo de movimentação?
Ao importar o XML, o Nomus segue a seguinte lógica:
Comparar a “Natureza da Operação” do XML: Se existir um tipo de movimentação no Nomus com o mesmo nome, esse tipo é usado diretamente nos itens do documento de saída.
-
Se não encontrar um tipo de movimentação com o mesmo nome, o sistema usa a seguinte ordem de prioridade:
Pedido: Tipo de movimentação informado no próprio pedido de venda.
Cliente: Campo “Tipo de movimentação padrão para venda” na aba "Vendas" do cadastro da pessoa.
Produto: Campo “Tipo de movimentação padrão para venda do produto” na aba "Fiscal" do produto.
Central de integração: Campo “Tipo de movimentação padrão” da própria central de integração (configuração global do integrador).
Isso garante que sempre exista um tipo de movimentação coerente com a operação, mesmo quando o XML não traz um texto de natureza igual ao utilizado no ERP.
Veja uma imagem de um pedido de venda com o campo "Tipo de movimentação" em destaque:
Setor de saída padrão
Para que o documento de saída seja criado corretamente, cada item precisa de um setor de estoque.
No cadastro da integração foi criado o campo:
-
“Setor de saída padrão”: Nesse campo o sistema lista todos os setores de estoque habilitados para:
a empresa da integração;
o tipo de movimentação informado no campo anterior.
Se o tipo de movimentação for alterado, o Nomus revalida a lista de setores disponíveis para o “Setor de saída padrão”.
Como o sistema escolhe o setor de estoque ao importar o XML?
A lógica padrão é de acordo com a ordem abaixo:
Setor preenchido no pedido de venda: Se o item do pedido já tiver um setor de estoque definido, esse setor é mantido.
-
Setor não preenchido no pedido: O sistema identifica os setores que estão:
habilitados para o tipo de movimentação;
habilitados para o produto.
Se houver apenas um setor em comum, ele é selecionado automaticamente.
Se houver mais de um setor em comum, o Nomus verifica se o “Setor de Estoque Padrão” na aba "Empresas" do cadastro do produto está preenchido. Se estiver e fizer parte dos setores em comum, ele é utilizado. Caso contrário, o sistema verifica se o “Setor de saída padrão” da integração está entre os setores em comum. Se estiver, esse é o setor utilizado.
Nenhum setor em comum localizado: Se o sistema não encontrar nenhum setor que atenda às regras acima, o documento de saída não é criado para aquele pedido. Uma mensagem é registrada na tela de logs de integração de recebimento, indicando que não foi possível determinar o setor de estoque do item.
Resumo da ordem de preenchimento:
Item do pedido → Único setor em comum entre tipo de movimentação e produto → Setor padrão do produto → Setor de saída padrão da integração → erro (nenhum setor encontrado)
Veja uma imagem abaixo da configuração "Setor de saída padrão":
Como o Nomus cria o documento de saída e vincula ao pedido de venda?
Quando o XML da NF-e emitida pelo Mercado Livre é importado com sucesso e todas as validações são atendidas, o Nomus executa os seguintes passos:
Cria uma nota fiscal no Nomus: Utilizando a série específica cadastrada para NF-e do Mercado Livre. Preenche campos fiscais e de valores conforme o XML.
Gera o documento de saída: Utiliza o tipo de movimentação definido pela regra de prioridade (Natureza da Operação, Pedido, Cliente, Produto ou Central de integração). Preenche o setor de estoque conforme a lógica descrita anteriormente.
Vincula os itens do documento de saída aos itens do pedido de venda: Para garantir que cada item está sendo associado corretamente, o sistema compara o número do item na NF-e o código do produto no XML. Apenas quando esses campos coincidem com os itens do pedido, o vínculo é efetuado.
Atualiza o status dos itens do pedido de venda: O Mercado Livre (Mercado Full) não trabalha com faturamento parcial de pedidos: o pedido é faturado integralmente. Por isso:
Sempre que o documento de saída gerado a partir da NF-e do Mercado Livre for salvo, o pedido de venda é encerrado (status de itens atendidos).
Não há cenários de “atendido parcialmente” ou “atendido com corte” para esse fluxo.
Veja uma imagem da tela de pedidos de venda:
Mensagens de alerta e conferências recomendadas
Durante o processo de importação da NF-e do Mercado Livre pelo integrador E-commerce, algumas validações podem impedir a criação da nota/documento de saída. Exemplos:
Série da NF-e não cadastrada: Mensagem no log: “A série X, utilizada no xml, não foi localizada no Nomus. Cadastre essa série na tela de ‘Séries de nota fiscal’.”
Setor de estoque não encontrado: Mensagem indicando que não foi possível determinar um setor comum entre tipo de movimentação, produto e integração. Em caso de erro, recomendamos:
Verificar o log de integração de recebimento.
Ajustar a configuração correspondente (série, tipo de movimentação, setores, produtos ou cliente).
Reprocessar o pedido/nota conforme orientação da equipe de suporte.
DANFE das notas emitidas pelo Mercado Livre
O Integrador E-commerce não disponibiliza a DANFE pronta dessas NF-e emitidas pelo Mercado Livre.
A sua empresa pode acessar o painel do Mercado Livre e baixar a DANFE. Nesse caso, o fluxo padrão é:
XML da NF-e integrado e armazenado no Nomus;
DANFE obtida diretamente no Mercado Livre.
Com essas configurações e entendimentos, a integração das notas fiscais emitidas pelo Mercado Full do Mercado Livre passa a ser totalmente integrada ao Nomus ERP Industrial, garantindo:
rastreabilidade fiscal;
atualização correta de estoque;
encerramento automático dos pedidos de venda;
menos trabalho manual para a sua equipe.
#VamosEmFrente 🚀
Comentários
0 comentário
Por favor, entre para comentar.