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.
Saiba mais
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.
![](/download/attachments/305861109/worddava9815307e80602da3d85ba1053d6fca0.png?version=1&modificationDate=1654718052364&api=v2)
Preencha a tela com as informações das notas a serem inutilizadas, execute e aguarde a mensagem de comando executado com sucesso.
![](/download/attachments/305861109/worddave5e7760316cff0a33a3451b901ed71ad.png?version=1&modificationDate=1654718052196&api=v2)
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
![](/download/attachments/305861109/worddav1f0aa77522132c377cdc411ecea70b3a.png?version=1&modificationDate=1654718052039&api=v2)
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.
Saiba mais
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.
![](/download/attachments/305861109/worddavb7e7fee2df44a704a38c7a9fd8e6bdb6.png?version=1&modificationDate=1654718051887&api=v2)
Todos os dados contidos no arquivo foram selecionados para constar os principais dados da nota de presente.
![](/download/attachments/305861109/worddav7c58256194223e96f19c3f8ecbf300d5.png?version=1&modificationDate=1654718051770&api=v2)
Caso deseje fazer inclusões/exclusões dos campos, basta clicar, no menu superior, em Banco de Dados e em Incluir Campo.
![](/download/attachments/305861109/worddav7131a7b0ce15531780a6c2d08c9882bf.png?version=1&modificationDate=1654718051624&api=v2)
Será aberta uma janela com as demais opções para inserção.
![](/download/attachments/305861109/worddavf5a36c2aad0f53fe7a03adc6202c8e20.png?version=1&modificationDate=1654718051496&api=v2)
Ao finalizar os ajustes, você deve mesclar o arquivo com o NFe Layout Simplificado.
![](/download/attachments/305861109/worddav91725a1098f0d6f49e9df55eb136d8aa.png?version=1&modificationDate=1654718051378&api=v2)
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.
![](/download/attachments/305861109/worddavbbcead64d8bce745cce699bc57a4a300.png?version=1&modificationDate=1654718051224&api=v2)
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.
![](/download/attachments/305861109/worddav67e305b88d8d88ca73d21e939791f232.png?version=1&modificationDate=1654718051066&api=v2)
Verifique que será impresso o Danfe Simplificado da NF-e 261001 que é a Nota de Presente correspondente a NF-e 261000.
![](/download/attachments/305861109/image2022-10-13_22-46-36.png?version=1&modificationDate=1665712020594&api=v2)
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.
Saiba mais
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.
![](/download/attachments/305861109/worddav486dc88533aacd1a049b4667ad4039b7.png?version=1&modificationDate=1654718050835&api=v2)
Para fazer uma busca pelo tipo de empresa cadastrado, preencha o campo de filtro e clique em Procurar.
![](/download/attachments/305861109/worddav15b639033cbd0a8421ca337e53ac3330.png?version=1&modificationDate=1654718050714&api=v2)
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.
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.
Saiba mais
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.
![](/download/attachments/305861109/worddava2b4912917619e2d1220ad53c048ae3b.png?version=1&modificationDate=1654718050583&api=v2)
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.
![](/download/attachments/305861109/worddav990cf552ddef07ed3b96036fa8d206b4.png?version=1&modificationDate=1654718050375&api=v2)
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;
![](/download/attachments/305861109/worddavf02019bebed289d1e3b6d27578f69693.png?version=1&modificationDate=1654718050227&api=v2)
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.
![](/download/attachments/305861109/worddav9d696d289de6bffb2449bdc14fee36ee.png?version=1&modificationDate=1654718050110&api=v2)
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.
![](/download/attachments/305861109/worddav36dd563373dfa5798c1338dadb110e46.png?version=1&modificationDate=1654718049987&api=v2)
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.
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.
Saiba mais
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;
![](/download/attachments/305861109/worddavccb793cd64b6486f9a6b6591005a707a.png?version=1&modificationDate=1654718049892&api=v2)
- Selecione a movimentação;
- Clique em Ações/Cancela Movimento. Será aberta a nova tela;
- Informe o campo Motivo;
- Clique em Executar.
![](/download/attachments/305861109/worddav9cc2de72bc31051ccebff1bb35828177.png?version=1&modificationDate=1654718049746&api=v2)
→ 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;
![](/download/attachments/305861109/worddav7c4bba93f5a9e17201346543ff1603be.png?version=1&modificationDate=1654718049603&api=v2)