Millen-32579 - E-commerce API - Alterar API Millennium_eco!mmormaii

Release - 105
Versão  - 5
Autor    - Jaciara Silva

Caminho:

Vendas > Pedidos de Venda

Vendas > Movimentações de Venda

Vendas > Devolução

Objetivo

A empresa desenvolveu a Api "Millennium_eco!mmormaii" para que seus parceiros licenciados inserirem o estoque de seus produtos no e-Millennium para integração com a Vtex e, posteriormente, buscar pedidos e enviar informações de faturamento.

Na integração temos:

• Recurso para que as notas fiscais integradas pela API sejam listadas na tela "Status de NFe", além de ser possível salvar o XML e exportá-lo para o contador.
• Tela de logs para exibir informações sobre pedidos, seus faturamentos (notas), erros e logs da integração (será gravado um log quando o rastreio estiver vazio).  
• Validação dos pedidos, usuários e o envio de estoque somente pela filial, não mais filial+fornecedor, como ocorria (a ligação deverá ser na filial de estoque, a informada no pedido).
• Validação de faturamento (Nota fiscal) por filial, série e número.
• Recebimento de notas devoluções das vendas realizadas aos consumidores
• Na API, deverá gravar essas mensagens, que no final do processo, alimentarão uma tabela no banco de dados.

Pré-requisitos

1 - Instalar o módulo “millenium!mmormaii.minst” e “millenium_eco!mmormaii.minst”. Para informações sobre como fazer a instalação de módulos no e-Millennium acesse o Manual de instalação de módulos no e-Millennium.

Parâmetros

1 - Em Utilitários\Administrador:

• Eventos, deve ter dois eventos configurados:
  • Um para faturamento dos pedidos de venda;
  • Um para dar entrada nas devoluções de vendas dos consumidores.
• Configurações Gerais, na seção MORMAII:
  • Selecionar o evento para devolução de venda de mercadorias;
  • Ligar os parâmetros para gravação dos logs de erros:
    • Operação – Estoque
    • Operação – Pedido de Venda
    • Operação – Nota Fiscal
    • Operação – Devolução de Venda
• Empresa\Filiais, na aba e-Commerce, selecione o evento de faturamento de vendas.

Entradas

Configurando Gerenciador de Usuários

• Selecione um Grupo;
• Libere os links: Mormaii \ Visualizador de Logs;
• Cadastre um usuário para cada Licenciado;
• Na guia Acesso a Dados, selecione Filiais;
• Vincule a Filial ao Licenciado.

Inclusão de Pedido de Venda

Os pedidos de vendas que forem incluídos pelos licenciados da marca, serão enviados via API para o e-Millennium e faturados automaticamente pelo sistema.

Em Vendas\Status NFe, faça uma busca e observe que é possível:

• Imprimir o Danfe;
• Visualizar o Danfe;
• Salvar XML.

Visualizando os logs das operações realizadas

No menu principal do sistema, localize o link Mormaii e acesse o visualizador.

Todos os resultados das operações de integração serão armazenados e os erros ocorridos apresentarão uma descrição, para que o usuário possa identificar com facilidade e tomar as medidas adequadas para sua solução.

Inclusão de pedido de venda com produtos de fornecedores diferentes

Consulta no cadastro de produtos para localizar dois fornecedores de produtos.

Consulta do código de barras do produto 216

Consulta do código de barras do produto 217

Inclusão de pedido de venda com os dois produtos

Emissão de duas notas fiscais com mesmo número, mesma série e filiais diferentes

XML da primeira nota emitida para a filial Padrão.

E, a seguir, um pedido integrado e faturado para a filial SAT, como a mesma numeração de nota e de série.

Entrada de nota de devolução de venda a cliente

Em Vendas\Movimentações, selecione o evento configurado para dar entrada nas devoluções dos clientes:

• Preencha o cabeçalho do evento;
• Preencha a coluna Nota Ref., selecionando a nota de venda referente ao produto que está sendo devolvido;
• Preencha os dados de finalização do evento;
• Efetive;
• Preencha os dados da nota para impressão (número e série);
• Próximo, para imprimir a nota.

Em Vendas\Consulta Movimentações, faça uma busca para visualizar o registro do evento e a nota emitida.

Em Vendas\Status NFe, faça uma busca para visualizar a nota fiscal gerada e que poderá ser impresso e/ou visualizado o Danfe e salvar o XML para enviar ao contador, por exemplo.

Em Utilitários\Mormaii\Visualizar logs, pode ser consultado o resultado da integração, que nesse caso obteve sucesso.

Em Logística\Estoque\Consulta Estoque, é possível verificar as movimentações de saída (venda) e de entrada (devolução).

Validações e Saídas

Emissão de nota fiscal com mesmo número, série e filial

Será emitida mensagem de alerta, informando sobre a duplicidade de informações na base de dados do e-Millennium.