SID.Nfv.AtualizarNFE (RFNF) - Atualização Da Situação Da Nfv Eletrônica
Detalhes de execução da AçãoSID e versões de web service
- Por padrão, a execução da AçãoSID SID.NFV.ATUALIZARNFE faz, internamente, a chamada ao web service com.senior.g5.co.int.eletronicos.documentos, porta ImportarRetornos, nas versões 2, 4 ou 6, a depender dos parâmetros e do uso de um identificador. A ação SID apresenta como retorno as mesmas consistências do web service/porta que ela utiliza, com o padrão sendo a utilização da porta 2 ou 4, dependendo dos parâmetros enviados.
- A partir das versões 5.10.3.81 e 5.10.4.27, o identificador de regras GER-140ALTVSID está disponível, permitindo alterar o comportamento padrão do sistema e direcionar a ação SID para a porta ImportarRetornos, versão 6. Esse direcionamento para a versão 6 ocorrerá apenas quando o Identificador de Regras estiver ativo e o campo SitNel for enviado com o valor "9 - Cancelada" ou "11 - Erro Solicitação Cancelamento".
- A mudança efetuada nas versões 5.10.3.81 e 5.10.4.27 mencionada acima não sobrepõe a recomendação da Senior de que a integração entre o ERP e o sistema de mensageria seja baseada no web service com.senior.g5.co.int.eletronicos.documentos para atualização de status de documentos, uma vez que Ações SID não recebem mais implementações.
- A ativação do identificador de regras exige a reinicialização do SeniorMiddleware.
Aplicação:
Mercado - Nota fiscal de venda.
Parâmetros obrigatórios para NF-e:
Nome | Descrição |
---|---|
ChvNel ¹ ² | Número da chave de acesso nota fiscal eletrônica. |
SitNel ¹ ² | Situação, sendo: 1=Não Enviada, 2=Enviada, 3=Autorizada, 4=Rejeitada, 5=Denegada, 6=Solicitado Inutilização, 7=Solicitado Cancelamento, 8=Inutilizada, 9=Cancelada, 10=Erro Geração, 11-Erro Solicitação Cancelamento, 12-Erro Solicitação Inutilização, 13-Impressão em Modo Contingência, 16 – Autorização em Contingência. |
NumPrt ¹ | Número do protocolo da nota fiscal eletrônica. |
DatHor ¹ | Data e Hora de Autorização da NF-e (ex: AAAA-MM-DDTHH:MM; ex2: 2008-10-30T09:28). |
1 - Campos obrigatórios de um retorno de NF-e autorizada, cancelada, denegada ou inutilizada.
2 - Campos obrigatórios de um retorno de problema na solicitação de autorização/cancelamento/inutilização.
Parâmetros obrigatórios para CC-e (Carta de correção NFe e Cte):
Nome | Descrição |
---|---|
SeqEve | Sequência do evento da carta de correção eletrônica. |
Ao informar SeqEve assume-se que a solicitação se trata de uma CC-e. No retorno da CC-e só poderão ser informadas as situações: 3- Autorizada, 4 – Rejeitada , 5 – Denegada e 10=Erro Geração.
Parâmetros obrigatórios para MD-e:
Nome | Descrição |
---|---|
TipDoe | Tipo do evento de Manifestação do Destinatário.** |
**TipDoe pode ser 5 – Evento de Cancelamento, 6 – Ciência da Operação, 7 – Confirmação da Operação, 8 – Operação não Realizada ou 9 – Manifesto Eletrônico de Documentos Fiscais.
Parâmetros opcionais:
Nome | Descrição |
---|---|
ChvNov | Nova chave de acesso da nota fiscal eletrônica. |
DesMot[x] | Onde “x” é a Sequência da observação. Exemplo: DesMot1, DesMot2, Desmot3... |
TipDoe | Tipo do Documento.** |
TipCtg | Tipo de Contingência (1 = DPEC, 2 = EPEC, 3 = SCAN, 4 = SVC, 5 = FS-IA, 6 = FS-DA).*** |
ChvCtg | Chave de Contingência.³ |
* DesMot[x] só é válido para retorno de problema na solicitação de autorização ou problema na solicitação de cancelamento/inutilização.
**TipDoe pode ser 5 – Evento de Cancelamento, 6 – Ciência da Operação, 7 – Confirmação da Operação, 8 – Operação não Realizada ou 9 – Manifesto Eletrônico de Documentos Fiscais.
*** TipCtg é de preenchimento obrigatório quando for autorização em contingência (SitNel = 16 – Autorização em Contingência).
3 - ChvCtg é de preenchimento obrigatório quando for autorização em contingência (SitNel = 16 – Autorização em Contingência) e o TipCtg for igual a 5 – FS-IA ou 6 – FS-DA. O uso desta ação SID é exclusivo para clientes que possuem a integração “IENF” (Nota Fiscal Eletrônica) ativada em sua proprietária.
4 - Para que seja feito o retorno de uma contingência via ação SID é necessário que seja informado a Chave da Contingência(ChvCtg) e o Tipo de Contingência(|TipCtg) pois quando esses campos são informados é utilizado o webservice de Importação de Retorno versão 4. Quando esses campos não são informados o sistema utiliza a versão 2.
Retorno:
"OK".
Informações adicionais:
Retornos esperados na NF-e | ||
---|---|---|
Situação do documento no Gestão Empresarial | ERP | Retorno esperado | Mensagem de retorno quando não está nas situações esperadas |
2 = Enviada | 3 = Autorizada | Documento aguardando autorização. Somente são válidos os retornos de documento eletrônico autorizado(3), rejeitado(4), denegado(5) ou erro de geração (10). Foi informado a situação do documento eletrônico como = X. |
4 = Rejeitada | ||
5 = Denegada | ||
10 = Erro Geração | ||
6 = Solicitado Inutilização | 8 = Inutilizada | Documento aguardando inutilização. Somente são válidos os retornos de documento eletrônico inutilizado(8) ou erro na solicitação de inutilização(12). Foi informado a situação do documento eletrônico como = X. |
12 = Erro Solicitação Inutilização | ||
7 = Solicitado Cancelamento | 9 = Cancelada | Não haverá mensagem de retorno. A situação do documento será atualizada conforme retorno do evento de cancelamento: |
11 = Erro Solicitação Cancelamento | Evento retorno 3 (autorizado) atualiza NFe com 9 (cancelada) Evento retorno 4 ou 11 (rejeitado,erro geração) atualiza NFe com 11 (erro solicitação cancelamento). |
Retornos esperados na CC-e | ||
---|---|---|
Situação do documento no Gestão Empresarial | ERP | Retorno esperado | Mensagem de retorno quando não está nas situações esperadas |
2 = Enviada | 3 = Autorizada | Carta de correção aguardando autorização. Somente são válidos os retornos de autorizado(3), rejeitado(4), denegado(5) ou erro geração(10). Foi informada a situação da carta de correção eletrônica como = X. |
4 = Rejeitada | ||
5 = Denegada | ||
10 = Erro Geração |
Retornos esperados no Evento de Cancelamento | ||
---|---|---|
Situação do documento no Gestão Empresarial | ERP | Retorno esperado | Mensagem de retorno quando não está nas situações esperadas |
2 = Enviada | 3 = Autorizada | Documento aguardando evento de cancelamento. Somente são válidos os retornos de autorizado(3), rejeitado(4) ou erro de geração(10). Foi informada a situação do evento de cancelamento como = X. |
4 = Rejeitada | ||
10 = Erro de geração |
Retornos esperados na MD-e | ||
---|---|---|
Situação do documento no Gestão Empresarial | ERP | Retorno esperado | Mensagem de retorno quando não está nas situações esperadas |
2 = Enviada | 3 = Autorizada | Manifestação do Destinatário aguardando autorização. Somente são válidos os retornos de autorizado(3), rejeitado(4) ou erro de geração(10). Foi informada a situação da manifestação do destinatário como = X |
4 = Rejeitada | ||
10 = Erro geração |
Observação
Caso ocorra uma situação totalmente incomum, como por exemplo a situação do documento no Gestão Empresarial | ERP ser 3 = Autorizada, e receber um retorno 3 = Autorizada será retornada a mensagem "Não foi solicitado um retorno para esse documento eletrônico. ".