Desenvolvimento Millen-15006 - Devolução de Venda Loja-Site - Receber Devolução por API
Release 62_44
Versão 5
Autor Jaciara Silva
Processo: Vendas
Nome do Processo: Devolução de Venda
Motivação
Nos casos de empresas que contam com lojas físicas em sua estrutura e os clientes das lojas têm a possibilidade de comprar produtos pelo site e fazer as trocas na loja física, tornar-se necessária a realização de um acerto fiscal para que o produto trocado passe a constar no estoque da loja e que o produto devolvido fiscalmente passe pela empresa.
Estes acertos fiscais devem ser tratados via Api, que, ao serem acionadas, deverão desencadear a realização das movimentações no sistema.
Para atender esta necessidade, foi desenvolvido o serviço na Api "MILLENIUM_LOG" para receber informações de devoluções de venda a ser acionada pela aplicação de terceiros utilizada pela loja, utilizando recurso similar ao recurso de "Devolução Triangulada", existente em versões atuais do sistema.
Também foi criado método que, ao ser chamado, inclui uma movimentação de devolução de venda, utilizando um evento configurado para utilizar o recurso de devolução triangulada.
Parâmetros
Em Utilitários\Administrador\Configurações Gerais, em Logística, devem ser configuradas as filiais e os eventos de transferências.
Entradas
Configuração das filiais para transferência automática das devoluções
Em Utilitários\Administrador\Configurações Gerais, em Logística, selecione a opção Devolução de venda via API e configure os dados a serem usados na inclusão da movimentação de transferência entre as filiais:
Filial Origem – Deve ser a filial do pedido de venda. É aquela que enviará o produto para a loja onde a troca foi realizada. Essa transferência é necessária para que o produto dê entrada no estoque da loja.
Atenção! Não será permitido selecionar a mesma filial para mais de um evento de transferência. Caso isso ocorra, será emitida uma mensagem de alerta e o sistema não permitirá salvar a configuração.
Se nenhum evento de transferência for selecionado, na chamada da API será gerado o log de erro, informando que não foi localizado o evento.
Se a filial selecionada como origem da transferência não for a mesma filial do pedido de venda, também será gerado um log de erro
Preço para movimentação de transferência – Para emissão das notas de devolução e de transferência será necessário preencher os valores dos produtos. Para que o sistema preencha automaticamente, deve ser feita a parametrização indicando quais valores devem ser assumidos na movimentação a ser gerada:
Utiliza última nota de entrada/transferência (Emitir erro se não encontrar)
Utiliza última nota de entrada/transferência (Usar preço da devolução se não encontrar)
Sempre usar da devolução
Atenção! Ao selecionar a primeira opção, deverá existir obrigatoriamente uma movimentação de entrada, caso contrário, o processo será bloqueado e será gerado um log de erro.
Configuração dos eventos a serem usados no processo
Em Utilitários\Administrador\Eventos:
deve ser configurado um evento para recebimento da devolução da venda:
Evento para entrada de devolução de venda
Na guia Geral
- Tipo de evento: Entrada
- Tipo de entrada: Devolução Venda
Na guia Acessos
- Movimentação Entrada/Saída: Por Produto (esta opção insere a coluna Nota Ref. No grid de produtos, necessária para vincular a nota da venda respectiva)
Na guia Geradores
- Cliente: ligado
Na guia Fiscal
- NF: ligado
- NF Devolução: ligado
- Série NF Padrão: está série será usada pelo sistema para emissão de nota fiscal automática
- Modelo NF Padrão: 55 Nota Fiscal Eletrônica
- Tabela CFOP Padrão: deve ser preenchida com os CFOPs utilizados para emissões de notas das operações de devolução de vendas da empresa
Logs de erros gerados na chamada de API referentes ao evento de devolução:
O evento de devolução não estiver configurado com o tipo "entrada":
O evento de devolução não estiver configurado com o tipo de entrada "devolução de venda":
O evento de devolução não tiver como gerador a opção "cliente":
O evento de devolução não acessar nota de referência no grid de produtos:
Evento para transferência de estoque de produto acabado
Na guia Geral
- Tipo de evento: Transferência
- Tipo de transferência: Transferência
Na guia Geradores
- Cliente: desligado
- Fornecedor: desligado
- Tipo de Cliente/Fornecedor: Ambos
- Funcionário: desligado
- Ordem de produção: desligado
Atenção! Não é necessário um gerador por se tratar de transferência, onde haverá uma filial de origem e outra de destino.
Na guia Fiscal
- NF: ligado
- NF Devolução: desligado
- Série NF Padrão: está série será usada pelo sistema para emissão de nota fiscal automática
- Modelo NF Padrão: 55 Nota Fiscal Eletrônica
- Tabela CFOP Padrão: deve ser preenchida com os CFOPs utilizados para emissões de notas das operações de transferência de produtos da empresa
Logs de erros gerados na chamada de API referentes ao evento de transferência:
O evento de transferência não estiver configurado com tipo "transferência":
O evento de transferência estiver configurado com gerador "cliente" ou "fornecedor":
O evento de transferência não estiver acessando uma filial:
Validações e Saídas
Outros logs de erros que podem ocorrer durante as chamadas da API
Código do pedido não enviado na chamada
Código do pedido enviado, mas não existe no banco de dados
Evento de devolução não informado na API
Evento de devolução informado na API não existe no banco de dados
CNPJ da filial destino não informada na API
Registro de produto não enviado na API
Código de barras do produto informado na API não existe
Saldo em estoque do produto é insuficiente para a devolução
Código de barras do produto informado mais de uma vez na API
Atenção! No processo foi utilizado o método "MILLENIUM.MOVIMENTACAO.EXECUTA" e nesse método pode conter mais validações do processo que não foram criadas nessa customização.