# GA # 1. Adição Evento
![Softensistemas Logo](https://www.softensistemas.com.br/assets/img/logo.webp) **Projeto/Sistema:** Evento Pedido de Prorrogação - NFe **Versão do *Template:*** 1.1
**Processo:** Adição Evento**Versão do Documento:** 1.2
**Responsável(eis):** Gustavo Fernandes**Data:** 14/10/2024
##### **1. Introdução** **Este processo visa exemplificar como deve funcionar o evento de prorrogação para NFe e exemplificar também um protótipo em tela inicial.** #### **Processos Relacionados** - - - - - - **2.** [Evento - Pedido de prorrogação](https://docs.softensistemas.com.br/books/evento-pedido-de-prorrogacao-nfe/page/2-evento-pedido-de-prorrogacao "Evento - Pedido de prorrogação") **3.** [Evento Cancelamento - Pedido de Prorrogação](https://docs.softensistemas.com.br/books/evento-pedido-de-prorrogacao-nfe/page/3-evento-cancelamento-pedido-de-prorrogacao "Evento Cancelamento - Pedido de Prorrogação") #### **Especificação Funcional** - - - - - - #### **PROC001 Adição Evento:** Este procedimento tem por objetivo a adição da funcionalidade Evento Pedido de Prorrogação. Segundo NT 2015.001:**[NT2015\_001\_v1\_20\_\_4\_](https://drive.google.com/file/d/15YHxcKD_72ATWS6G9lL-rEbXoXiWBfoo/view?usp=sharing "NT2015_001_v1_20__4_")** Versão nova da NT, atualizações de implementação SP e MG: **[NT 2015.001 - v 1.30](https://drive.google.com/file/d/1OGqtU9l4m4D5taHUpp-pUbuvGptfm6Fs/view?usp=sharing "NT 2015.001 - v 1.30")** ##### ***Protótipo de Tela:*** [![image-1728924215741.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-10/scaled-1680-/image-1728924215741.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-10/image-1728924215741.png) I - Exemplo da opção - Pedido de Prorrogação em tela ##### ***Regras de Interface:*** **1.** O campo só deve ser liberado para seleção, para uma NFe já autorizada no sistema, caso contrário, deverá ficar bloqueado e mais claro, assim como "Inutilizar NF-e" esta nesta imagem de cima. ##### ***Regras de Negócio:*** **1.** O registro dos novos eventos devem ser armazenados na tabela **nfeEventoProrrogacao** ##### ***Questões Técnicas:*** **1.** Exemplo em SQL da tabela que deve ser criada na base de dados**:** ```SQL CREATE TABLE `nfeEventoProrrogacao` ( `id` BIGINT(20) NOT NULl AUTO_INCREMENT, `idlote` BIGINT NOT NULL, `cOrgao` BIGINT, `tpAmb` INT DEFAULT NULL, `cnpj` CHAR(14), `chaveNFe` VARCHAR(44) NOT NULL, -- Chave de Acesso da NF-e `dhEvento` DATETIME NOT NULL, `tpEvento` INT DEFAULT NULL, `nSeqEvento` INT DEFAULT NULL, `descEvento` VARCHAR(60), `nProt` INT DEFAULT NULL, `itemPedido` INT DEFAULT NULL, `numItem` INT DEFAULT NULL, `qtdeItem` INT DEFAULT NULL, `empresaId` BIGINT DEFAULT NULL, `usuarioId` BIGINT DEFAULT NULL, PRIMARY KEY (`id`), KEY `FK_empresa` (`empresaId`), KEY `FK_usuario` (`usuarioId`), CONSTRAINT `FK_empresa` FOREIGN KEY (`empresaId`) REFERENCES `empresa` (`Id, CONSTRAINT `FK_usuario` FOREIGN KEY (`usuarioId`) REFERENCES `usuario` (`Id`) ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=latin1; ``` ©SOFTEN SISTEMAS 2024 # 2. Evento - Pedido de Prorrogação
![Softensistemas Logo](https://www.softensistemas.com.br/assets/img/logo.webp) **Projeto/Sistema:** Evento Pedido de Prorrogação - NFe**Versão do *Template:*** 1.1
**Processo:** Evento - Pedido de Prorrogação**Versão do Documento:** 1.3
**Responsável(eis):** Gustavo Fernandes**Data:** 15/10/2024
##### **1. Introdução** **Este processo visa exemplificar a geração do evento de prorrogação para NFe e alguns protótipos de tela iniciais.** ##### **2. Processo de comunicação entre o sistema e web-service da Sefaz.** [![image-1729015278506.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-10/scaled-1680-/image-1729015278506.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-10/image-1729015278506.png) [![image-1729015304754.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-10/scaled-1680-/image-1729015304754.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-10/image-1729015304754.png) I - Fluxograma da nota técnica [![image-1729015382776.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-10/scaled-1680-/image-1729015382776.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-10/image-1729015382776.png) II - Fluxograma da nota técnica
**Processo** **Envolvidos** **Dados de entrada** **Dados de saída**
(1) Emissão de eventoSistema (Empresa) e Sefaz Autorizada - Envio evento por XML
(2) CompartilhamentoSefaz Autorizada e Ambiente Nacional Compartilhamento, retorno Ambiente Nacional Compartilhamento Sefaz autorizada para Ambiente Nacional
(3) CompartilhamentoAmbiente Nacional e Sefaz jurisdição Evento do fisco, retorno para Sefaz Autorizada Compartilhamento Sefaz Nacional para Sefaz Jurisdição
(4) Evento do fiscoSefaz jurisdição e Sefaz Autorizada - Evento do fisco para Sefaz Autorizada
(5) CompartilhamentoAmbiente Nacional e Empresa (sistema) - Compartilhamento Ambiente Nacional para Empresa (sistema)
#### **Processos Relacionados** - - - - - - **1.** [Adição Evento](https://docs.softensistemas.com.br/books/evento-pedido-de-prorrogacao-nfe/page/1-adicao-evento "Adição Evento") **3.** [Evento Cancelamento - Pedido de Prorrogação](https://docs.softensistemas.com.br/books/evento-pedido-de-prorrogacao-nfe/page/3-evento-cancelamento-pedido-de-prorrogacao "Evento Cancelamento - Pedido de Prorrogação") #### **Especificação Funcional** - - - - - - #### **PROC002 Novo Pedido de Prorrogação:** ##### ***Protótipo de Tela:*** [![image-1730468342088.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730468342088.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730468342088.png) I - Exemplo tela para inserção das quantidades a serem prorrogadas ##### **Exemplo nota técnica:** [![image-1730463861881.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730463861881.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730463861881.png) [![image-1730463879612.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730463879612.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730463879612.png) ##### ***Descrição dos Campos:***
**Campo** **Tipo** **Tamanho** **Obrig. ?** **Observações**
Item Numérico 1-990 Sim Item do Pedido de Prorrogação. Recomenda-se agrupar a maior quantidade de itens em cada Pedido de Prorrogação
Quantidade Numérico Decimal p20 Sim Quantidade de comercialização do item que será solicitada a prorrogação de prazo
Prazo Prorrogação - - Sim Campo para seleção do prazo de prorrogação, no primeiro evento deverá puxar 1° prazo, após o usuário salvar e enviar, se ele for emitir outro evento, já puxa automático o 2° evento!
##### ***Regras de Interface:*** **1. Item:** Usuário deve preencher o campo com o número do item a ser prorrogado, campo numérico, com valores inteiros entre 1 e 990, deve-se bloquear digitar valores que não estão nesta regra, como "0" (zero) ou maior que 990. **2. Quantidade:** Usuário deve preencher o campo com a quantidade a ser prorrogada daquele item, campo numérico decimal, com até 20 caracteres, o valor precisa ser maior ou igual a 1, ou seja, quantidade mínima permitida é 1 (não pode ser zero ou negativo). **3. Prazo Prorrogação:** Usuário pode verificar as possibilidades, do 1° Prazo e 2° Prazo, contudo, deverá ficar bloqueado o 2° Prazo, na primeira emissão! e só poderá libera-lo, após a emissão do 1°, inclusive, ao abrir a tela, após já ter um evento gerado, ele poderá puxar automático o 2° Prazo. **4.** Conforme os itens forem preenchidos e inseridos, deve-se manter o comportamento do GA de inserção, padrão. **5. Excluir:** Exclusão também funcionar da forma padrão, caso exclua tudo, deverá aparecer a mensagem no lugar - "Nenhum registro foi encontrado" ou algo do tipo. ##### ***Regras de Negócio:*** **1*****.*** Os dados referentes as informações do evento devem ser salvas e consultadas da tabela **nfeEventoProrrogacao** **2. Prazo Prorrogação:** deverá vir por padrão - "Prorrogação 1° Prazo" ao gerar o evento pela primeira vez. **OBS:** O Pedido de Prorrogação é um evento para prorrogar o prazo de retorno de produtos de uma NF-e de remessa para industrialização por encomenda com suspensão do ICMS. O registro de um novo Pedido de Prorrogação não substitui o Pedido de Prorrogação anterior, ou seja, serão eventos cumulativos. Recomenda-se agrupar a maior quantidade de itens em cada Pedido de Prorrogação. Processo: síncrono. **3. Botão enviar:** O evento deve ser encaminhado no webservice de eventos mesmo - conforme o ESTADO: CONFORME O PORTAL DO GOVERNO DE CADA ESTADO: **SP:** [https://portal.fazenda.sp.gov.br/servicos/nfe/Paginas/URL-WEBSERVICES.aspx](https://portal.fazenda.sp.gov.br/servicos/nfe/Paginas/URL-WEBSERVICES.aspx) **MG:** [https://portalsped.fazenda.mg.gov.br/spedmg/nfe/webservices/](https://portalsped.fazenda.mg.gov.br/spedmg/nfe/webservices/) **MINAS GERAIS:** **HOMOLOGAÇÃO:** [https://hnfe.fazenda.mg.gov.br/nfe2/services/NFeRecepcaoEvento4](https://hnfe.fazenda.mg.gov.br/nfe2/services/NFeRecepcaoEvento4%20 "https://hnfe.fazenda.mg.gov.br/nfe2/services/NFeRecepcaoEvento4 ") **PRODUÇÃO:** [https://nfe.fazenda.mg.gov.br/nfe2/services/NFeRecepcaoEvento4](https://nfe.fazenda.mg.gov.br/nfe2/services/NFeRecepcaoEvento4 "https://nfe.fazenda.mg.gov.br/nfe2/services/NFeRecepcaoEvento4") **SÃO PAULO: HOMOLOGAÇÃO: ​**[https://homologacao.nfe.fazenda.sp.gov.br/ws/nferecepcaoevento4.asmx](https://homologacao.nfe.fazenda.sp.gov.br/ws/nferecepcaoevento4.asmx "​https://homologacao.nfe.fazenda.sp.gov.br/ws/nferecepcaoevento4.asmx") **PRODUÇÃO:** [https://nfe.fazenda.sp.gov.br/ws/nferecepcaoevento4.asmx](https://nfe.fazenda.sp.gov.br/ws/nferecepcaoevento4.asmx "https://nfe.fazenda.sp.gov.br/ws/nferecepcaoevento4.asmx")

**Por enquanto implementação será apenas no estado de MG e SP.**

[![image-1734357143476.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-12/scaled-1680-/image-1734357143476.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-12/image-1734357143476.png)Vale ressaltar que: [![image-1734357287828.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-12/scaled-1680-/image-1734357287828.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-12/image-1734357287828.png) ##### ***Questões Técnicas:*** **1.** Estrutura do arquivo XML do evento: **1.1 Leiaute Mensagem de Entrada** **Schema XML: envPProrrogNFe\_v1.0.xsd** [![image-1730470924570.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730470924570.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730470924570.png) [![image-1730470970878.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730470970878.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730470970878.png) [![image-1730471006784.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730471006784.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730471006784.png) [![image-1730471062345.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730471062345.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730471062345.png) [![image-1730471100354.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730471100354.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730471100354.png) **2.** Estrutura do arquivo XML de retorno: **2.1 Leiaute Mensagem de Retorno** **Schema XML: retPProrrogNFe\_v1.0.xsd** [![image-1730471480075.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730471480075.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730471480075.png) [![image-1730471551504.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730471551504.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730471551504.png) [![image-1730471599151.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730471599151.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730471599151.png) [![image-1730471635945.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730471635945.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730471635945.png) #### **PROC002.1 Pedido de Prorrogação Enviado:** ##### ***Protótipo de Tela:*** [![image-1730472290229.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730472290229.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730472290229.png) I - Exemplo tela evento enviado e autorizado [![image-1730473643851.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730473643851.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730473643851.png) II - Exemplo opções menu ##### ***Descrição dos Campos:*** **Obs:** Apenas foi descrito os campos diferentes do habitual, o restante seguir o padrão do sistema, assim como na tela de carta de correção de CTe por exemplo.
**Campo** **Tipo** **Tamanho** **Obrig. ?** **Observações**
Tipo - - Sim No exemplo acima "EPP1" seria de - "Evento Pedido de Prorrogação 1°"
Sequência - - Sim Seguir padrão
Data/Hora - - Sim Seguir padrão
Situação - - Sim Seguir Padrão
Menu - - Sim Seguir Padrão
##### ***Regras de Interface:*** **1. Tipo:** Sistema deverá puxar conforme o pedido de prorrogação, no exemplo é um do 1° prazo, caso fosse do 2°, seria "EPP2". **2. Menu:** Deve-se manter o "Editar" bloqueado se o evento estiver autorizado, só liberar caso de alguma rejeição ou erro, para ajuste. **3.** Demais campos seguir o padrão do sistema, que tem para gerar eventos, como CCe no módulo de CTe. ##### ***Regras de Negócio:*** **2.** Seguir padrão do GA para eventos, assim como CTe, CCe. ##### ***Questões Técnicas:*** **1*****.** Os dados referentes as informações do evento devem ser salvas e consultadas da tabela **nfeEventoProrrogacao*** ©SOFTEN SISTEMAS 2024 # 3. Evento Cancelamento - Pedido de Prorrogação
![Softensistemas Logo](https://www.softensistemas.com.br/assets/img/logo.webp) **Projeto/Sistema:** Evento Pedido de Prorrogação - NFe**Versão do *Template:*** 1.1
**Processo:** Evento Cancelamento - Pedido de Prorrogação**Versão do Documento:** 1.2
**Responsável(eis):** Gustavo Fernandes**Data:** 01/11/2024
##### **1. Introdução** **Este processo visa exemplificar a geração do evento de cancelamento de prorrogação para NFe e alguns protótipos de tela iniciais.** ##### **2. Processo para cancelamento do evento.** [![image-1734360097868.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-12/scaled-1680-/image-1734360097868.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-12/image-1734360097868.png) [![image-1730474894471.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730474894471.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730474894471.png) [![image-1730474922783.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730474922783.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730474922783.png) I - Exemplo de processo para cancelamento [![image-1734359182972.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-12/scaled-1680-/image-1734359182972.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-12/image-1734359182972.png) [![image-1734359217123.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-12/scaled-1680-/image-1734359217123.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-12/image-1734359217123.png) II - Exemplo de fluxograma #### **Processos Relacionados** - - - - - - **1.** [Adição Evento](https://docs.softensistemas.com.br/books/evento-pedido-de-prorrogacao-nfe/page/1-adicao-evento "Adição Evento") **2.** [Evento - Pedido de Prorrogação](https://docs.softensistemas.com.br/books/evento-pedido-de-prorrogacao-nfe/page/2-evento-pedido-de-prorrogacao "Evento - Pedido de Prorrogação") #### **Especificação Funcional** - - - - - - #### **PROC003 Adição Evento Cancelamento:** ##### ***Protótipo de Tela:*** [![image-1730726966080.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730726966080.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730726966080.png) I - Exemplo de opções - Cancelamento no Evento Prorrogação [![image-1730731595584.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730731595584.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730731595584.png) II - Tela de cancelamento do Evento de Prorrogação ##### ***Regras de Interface:*** **1.** O botão "Cancelamento" só deve ser liberado para seleção, para uma evento já autorizada no sistema, caso contrário, deverá ficar bloqueado e mais claro, assim como "Editar" nesta imagem de cima. **2.** O campo de "Justificativa" deve se manter bloqueado, já que não é necessário o preenchimento dele para cancelamento. ##### ***Regras de Negócio:*** **1.** Só será permitido cancelar o evento do 1° prazo, se antes for cancelado do 2° prazo, se no 2° prazo houve prorrogação de algum item que já foi prorrogado no 1°, conforme a nota técnica. ##### ***Questões Técnicas:*** ##### [![image-1730734031936.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730734031936.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730734031936.png) [![image-1730734070399.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730734070399.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730734070399.png) [![image-1730734094330.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730734094330.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730734094330.png) [![image-1730734148886.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730734148886.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730734148886.png) [![image-1730734176051.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730734176051.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730734176051.png) [![image-1730734216662.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730734216662.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730734216662.png) [![image-1730734242537.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730734242537.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730734242537.png) [![image-1730734267806.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730734267806.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730734267806.png) ##### #### **PROC003.1 Pedido Cancelado:** ##### ***Protótipo de Tela:*** [![image-1730733405788.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730733405788.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730733405788.png) I - Exemplo tela - Evento cancelado [![image-1730733712616.png](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/scaled-1680-/image-1730733712616.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2024-11/image-1730733712616.png) II - Exemplo de opções - Evento já cancelado ##### ***Regras de Interface:*** **1.** Segui padrão GA para cancelamento, assim como na imagem acima, deixar como "EVENTO CANCELADO" e coloração vermelha clara. **2.** Com evento já cancelado, manter o botão de "Editar" e "Cancelar" bloqueados. ##### ***Regras de Negócio:*** **1.** Ainda será possível gerar o PDF do comprovante do evento, após cancelado, porém mostrando a tarja de cancelamento. **2.** Ao baixar o XML, deve-se vir o XML do evento cancelado. ##### ***Questões Técnicas:*** **1.** O registro dos novos eventos devem ser armazenados na tabela **nfeEventoProrrogacao** ©SOFTEN SISTEMAS 2024