Millen-12292 - Integração UX – API - Envio de notas fiscais inutilizadas
Processo: Vendas
Nome do Processo: Movimentações
Motivação
Disponibilizar as notas fiscais inutilizadas no e-Millennium, para que sejam enviadas durante a integração com o Linx UX. Todos os status de NF geradas no e-Millennium devem ser disponibilizadas através da API, para que possam integrar as movimentações ao Linx UX e centralizar o controle para os usuários do sistema, possibilitando gestão e auditoria em um único local.
Para atender esta necessidade, foi desenvolvida uma API para listar as notas fiscais com status de inutilizada no e-Millennium, integrando as informações no Linx UX.
Parâmetros
Sem necessidade de parametrização.
Entradas
Inutilizando numeração de notas fiscais na Sefaz
Em Vendas\Status NFe\Outras Funções, selecione a opção Inutiliza NFes.
Preencha a tela com as informações das notas a serem inutilizadas, execute e aguarde a mensagem de comando executado com sucesso.
Validações e Saídas
Para validar se as notas estão realmente inutilizadas, será necessário consultar no banco de dados do e-Millennium.
Em C:\wts\ieditor
Millen-12326 - Danfe simplificado em nota de presente
Processo: Vendas
Nome do Processo: Emissão de Danfe simplificado
Motivação
Este recurso permite a impressão do Documento Auxiliar de Nota Fiscal Eletrônica – Danfe, layout simplificado, em notas de operações de venda.
Parâmetros
• Possuir o arquivo DANFESIMPLIFICADO1.ETQ em C:\wts\files\documentos\DANFESIMPLIFICADO.
Entradas
Configurando o sistema
Para configurar o Danfe Simplificado no sistema, siga os seguintes passos:
- Acesse a tela Formulários pelo caminho Utilitários > Formulários.
- Clique no ícone pasta para procurar o arquivo. Selecione-o em C:\wts\files\documentos\DANFESIMPLIFICADO. Veja na imagem abaixo.
Todos os dados contidos no arquivo foram selecionados para constar os principais dados da nota de presente.
Caso deseje fazer inclusões/exclusões dos campos, basta clicar, no menu superior, em Banco de Dados e em Incluir Campo.
Será aberta uma janela com as demais opções para inserção.
Ao finalizar os ajustes, você deve mesclar o arquivo com o NFe Layout Simplificado.
Após mesclar, salve as alterações e selecione o arquivo no evento utilizado para a emissão de nota fiscal de presente. Para isso:
- Acesse o caminho Vendas > Movimentações;
- Selecione o Evento: 09 - FATURAMENTO E-COMMERCE PRESENTE;
- Na aba Fiscal, selecione o arquivo em NFe Layout Simplificado;
- Salve a alteração.
Validações e Saídas
Imprimindo o Danfe Simplificado
Para imprimir o Danfe Simplificado, siga os seguintes passos:
- Acesse o caminho: Vendas > Status de NF-e;
- Selecione a Situação como Notas Processadas;
- Indique as datas inicial e final;
- Clique em Procurar;
- Selecione a nota (no nosso exemplo: nota 261000);
- Clique em Imprime Danfe.
Verifique que será impresso o Danfe Simplificado da NF-e 261001 que é a Nota de Presente correspondente a NF-e 261000.
Millen-12376 - Exibir tipo de empresa na lista de clientes
Processo: Vendas
Nome do Processo: Cadastro de clientes
Motivação
Disponibilizar a informação do tipo de empresa, preenchido no cadastro do cliente, no grid de resultados da tela de lista clientes e criar um campo de filtro na tela de consulta, permitindo que a filtragem da lista possa ser feita por tipo de empresa como parâmetro.
Parâmetros
Em Vendas\Cadastros\Clientes, na guia Geral, o campo Tipo Empresa deverá estar preenchido com uma das opções disponíveis.
Entradas
Em Vendas\Cadastros\Clientes, na tela de consulta, clique em Procurar, para visualizar todos os clientes cadastrados e o tipo de empresa vinculado.
Para fazer uma busca pelo tipo de empresa cadastrado, preencha o campo de filtro e clique em Procurar.
Validações e Saídas
Visualização do tipo de empresa na tela de consulta de clientes, com a possibilidade de filtrar por tipo, visualizando somente as empresas de um tipo específico.
Millen-12827 - MILLEN-9361 - Cancelamento e divergência em pré-faturamento
Processo: Vendas
Nome do Processo: Faturamento automático
Motivação
Este recurso complementa as funcionalidades apresentadas no projeto Millen-9361 - Redução do tempo de Faturamento Automático por API, o qual permite dividir as operações de faturamento via API, agilizando o processo de faturamento, transmissão de dados para a Sefaz e emissão da nota fiscal.
Lembrando que, quando o volume de emissão de notas fiscais via API é muito alto, conferir pré-faturamento, criar a movimentação e transmitir para a Sefaz, em uma única API, tornava o processo muito lento. Para agilizá-lo, foram desenvolvidas três APIs, que podem ser chamadas em momentos diferentes, por exemplo:
1ª. Criar a movimentação. Pode ser executada logo após a emissão do pedido;
2ª. Conferir o pré-faturamento e informar os volumes. Pode ser feito no ato da conferência;
3ª. Transmitir a nota fiscal para a Sefaz. Pode ser feita logo após a segunda ou quando a empresa decidir.
Neste manual você verá como proceder no caso de um pré-faturamento com divergências, devido, por exemplo, a falta de estoque. Para isso, foram implementados os recursos abaixo:
1º. Na API MILLENIUM_LOG.PICKING.LiberaParaConferenciaAutomatica, caso o pedido de venda não esteja aprovado, o sistema travará o processo, não permitindo liberar para conferência;
2º. Na API MILLENIUM_LOG.PICKING.FINALIZACONFERENCIA, antes da exclusão do movimento, a baixa dos títulos será cancelada automaticamente pelo sistema.
Parâmetros
- Consulte o manual Millen-9361 - Redução do tempo de Faturamento Automático por API, sobre 'Faturamento Automático via API', com o passo a passo para executar as etapas: 'Configurando o tipo de pedido', 'Incluindo o pedido de venda', Incluindo o pré-faturamento', Procurando o pré-faturamento', 'Finalizando a conferência', 'Faturamento – Aguardando Envio Sefaz' e 'Enviando a nota para a Sefaz'.
- Na etapa 'Incluindo o pedido de venda', o pedido de venda deve estar com a flag Aprovado marcada. Do contrário, na etapa da 'Liberação para Conferência Automática', o sistema apresentará mensagem de erro, informando que o pedido de venda não foi aprovado.
Entradas
Liberando para conferência automática
Nesta etapa, a API MILLENIUM_LOG.PICKING.LiberaParaConferenciaAutomatica deve chamar o método que irá marcar esse pré-faturamento como conferido e alterar o status dele para Aguardando Conferência Automática. Também criará uma movimentação de venda no evento definido no tipo de pedido.
Porém, caso o pedido de venda não esteja aprovado, em função de alguma divergência, o sistema travará o processo, não permitindo liberar para conferência e apresentará a seguinte mensagem: "Pré-faturamento xyz ainda não foi conferido... Existem divergências; necessário executar uma ação sobre essa divergência".
O alerta, portanto, informará a divergência no pré-faturamento e que será necessário resolvê-la manualmente. Para isso, acompanhe as etapas abaixo.
Finalizando a conferência com divergência
A API MILLENIUM_LOG.PICKING.FINALIZACONFERENCIA é chamada na etapa Finalizando a Conferência. Após isso, o pré-faturamento fica com o status Aguardando Envio Sefaz, recebe as informações de volume e peso e está liberado para a emissão da nota fiscal (ver manual Millen-9361 - Redução do tempo de Faturamento Automático por API).
Mas, caso haja divergência, antes da exclusão do movimento, a baixa dos títulos será cancelada automaticamente pelo sistema. Consultando o pré-faturamento (no nosso exemplo, 00418), na tela Lista Pré-Faturamento de Saída (Logística > Expedição > Pré-Faturamento de Saída), veja que a caixa de seleção Divergência estará marcada.
Ações sobre divergência
Para definir uma determinada ação sobre a divergência, siga os seguintes passos:
- Acesse a tela Lista Pré-Faturamento de Saída (Logística > Expedição > Pré-Faturamento de Saída);
- Na tela Lista Pré-Faturamento de Saída, selecione o pré-faturamento (no nosso exemplo, 00418);
- Clique em Ações/Ações sobre Divergência;
- No campo Ação, selecione a ação Cancelar a divergência no pré-faturamento e no pedido;
5. Por fim, clique em Efetivar.
Consultando novamente, o pré-faturamento estará com a caixa de seleção Divergência desmarcada e com o valor da Quantidade alterada.
Siga com a etapa de Faturamento – Aguardando Envio Sefaz.
Observação: caso no campo Ação, você selecione a ação Cancelar o pedido inteiro, na tela Listar Pedidos de Venda e Listas de Casamento, na coluna Cancelado, o pedido aparecerá como Cancelado Total.
Validações e Saídas
Enviando a nota para a Sefaz
Neste momento, deverá ser chamada a terceira API MILLENIUM_LOG.PICKING.FATURAR, que irá gerar e transmitir a nota fiscal para a Sefaz.
Millen-13163 - Dev – Cancelamento via API
Processo: Vendas
Nome do Processo: Faturamento automático
Motivação
Este recurso complementa as funcionalidades apresentadas no projeto Millen-9361 - Redução do tempo de Faturamento Automático por API, o qual permite dividir as operações de faturamento via API, agilizando o processo de faturamento, transmissão de dados para a Sefaz e emissão da nota fiscal.
Lembrando que, quando o volume de emissão de notas fiscais via API é muito alto, conferir pré-faturamento, criar a movimentação e transmitir para a Sefaz, em uma única API, tornava o processo muito lento. Para agilizá-lo, foram desenvolvidas três APIs, que podem ser chamadas em momentos diferentes, por exemplo:
1ª. Criar a movimentação. Pode ser executada logo após a emissão do pedido;
2ª. Conferir o pré-faturamento e informar os volumes. Pode ser feito no ato da conferência;
3ª. Transmitir a nota fiscal para a Sefaz. Pode ser feita logo após a segunda ou quando a empresa decidir.
Porém, há casos em que há a necessidade do cancelamento da nota fiscal, devido, por exemplo, a uma tributação errada. O recurso demonstrado neste manual permite, ao cancelar a nota fiscal e o respectivo movimento (pelo método millenium.movimentacao.cancela), emitir a nota novamente pela API MILLENIUM_LOG.PICKING.FATURAR, "reaproveitando" todo o processo.
Lembrando que o sistema permite cancelar a nota fiscal e o movimento, porém impede que o processo seja refeito na API, pois, por default (padrão) o pré-faturamento passa a constar como já liberado para conferência automática e o status como 'enviado para a Sefaz'. Pelo recurso apresentado abaixo, mesmo após a geração e a transmissão da nota para a Sefaz, é possível reutilizar os parâmetros do faturamento, ajustar e reemitir a nota.
Parâmetros
Consulte o manual Millen-9361 - Redução do tempo de Faturamento Automático por API, sobre 'Faturamento Automático via API', com o passo a passo para executar as etapas: 'Configurando o tipo de pedido', 'Incluindo o pedido de venda', Incluindo o pré-faturamento', Procurando o pré-faturamento', 'Finalizando a conferência', 'Faturamento – Aguardando Envio Sefaz' e 'Enviando a nota para a Sefaz'.
Entradas
Cancelando o movimento
Para cancelar o movimento, siga os seguintes passos:
- Acesse a tela Listar Movimentações de Venda pelo caminho: Vendas > Consulta Movimentações;
- Busque a movimentação utilizando os seguintes filtros (os dados foram usados apenas como exemplo):
- Data Inicial: 18/04/2022
- Data Final: 18/04/2022
- Documento: 21519
3. Clique em Procurar e a movimentação será exibida;
- Selecione a movimentação;
- Clique em Ações/Cancela Movimento. Será aberta a nova tela;
- Informe o campo Motivo;
- Clique em Executar.
→ Após cancelar o movimento, fature novamente (API MILLENIUM_LOG.PICKING.FATURAR). Veja esta etapa no projeto Millen-9361 - Redução do tempo de Faturamento Automático por API.
Validações e Saídas
Consultando a movimentação
Para consultar a movimentação, siga os seguintes passos:
- Acesse a tela Listar Movimentações de Venda pelo caminho: Vendas > Consulta Movimentações;
- Busque a movimentação utilizando os seguintes filtros (os dados foram usados apenas como exemplo):
- Data Inicial: 18/04/2022
- Data Final: 18/04/2022
- Documento: 21520
3. Clique em Procurar e a movimentação será exibida;
