- 13. Funcionalidades
13.5. CriaProcNFe2G [24-11-12] - 13.4.8. calcICMSUFDest400 [10-01-18]
« Anterior - 13.6. GNRE [08-12-18]
Próximo »
13.5. CriaProcNFe2G [24-11-12]
Cria o procNFe - estrutura de distribuição de NF-e composta pela NF-e e respectivo protocolo de autorização de uso.
Assinatura
string CriaProcNFe2G(string siglaWS, ref string NFeAssinada, out string protocolo, out string retCancNFe, out int resultado, string nomeCertificado, out string msgResultado, string proxy, string usuario, string senha)
Descrição:
A funcionalidade é útil para criar o procNFe quando a NF-e teve o uso autorizado pela SEFAZ, mas não houve retorno do Web Service ou houve uma falha na gravação do procNFe.
ATENÇÃO [24-11-12]
Esta funcionalidade utiliza a ConsultaNFe2G - consulta do status da NF-e para consultar a situação da NF-e na SEFAZ e criar o XML do procNFe quando a NF-e tiver um dos seguintes cStat:
- 100 - Autorizado o uso da NF-e;
- 150 - Autorizado o uso da NF-e, autorização concedida fora de prazo;
- 301 - Uso Denegado: Irregularidade fiscal do emitente;
- 302 - Uso Denegado: Irregularidade fiscal do destinatário;
CUIDADOS QUE DEVEM SER TOMADOS
- restringir o uso - a funcionalidade requer o uso da ConsultaNFe2G - consulta do status da NF-e, devendo ser utilizada somente em casos em que não temos o nroRecibo para consultar o lote da NF-e.
A montagem do procNFe deve ser feita sem o uso desta funcionalidade, quem faz o envio individual da NF-e já tem o procNFe como retorno da chamada e não precisa utilizar esta funcionalidade.- dependência da ConsultaNFe2G - quem utiliza esta funcionalidade deve estar sempre atento para as atualizações da DLL, pois qualquer alteração na ConsultaNFe2G - consulta do status da NF-e tem reflexo na funcionalidade.
A identificação do WS de acessado deverá ser informada no parâmetro siglaWS.
Preenchimento da siglaWS
- a sigla SVAN, caso a UF seja usuária da SEFAZ Virtual do Ambiente Nacional (CE, ES, MA, PA, PI e RN);
- a sigla SVRS, caso a UF seja usuária da SEFAZ Virtual do Rio Grande do Sul (AC, AL, AM, AP, DF, MS, PB, RJ, RO, RR, SC, SE e TO);
- a sigla da UF, caso a UF tenha aplicação própria (AM, BA, CE, GO, MS, MT, MG, PE, PR, RS e SP);
- a sigla SCAN, na emissão em contingência SCAN - Sistema de Contingência do Ambiente Nacional.
Preenchimento do nomeCertificado
informar o Nome do titular (campo Assunto) do certificado digital a ser utilizado na conexão SSL. Ex.: "CN=NFe - Associacao NF-e:99999090910270, C=BR, L=PORTO ALEGRE, O=Teste Projeto NFe RS, OU=Teste Projeto NFe RS, S=RS"
Parâmetros:
| nome | tipo | fluxo | descrição |
|---|---|---|---|
| siglaWS | string | entrada | informar a siglaWS |
| NFeAssinada | string | entrada/saída | informar a NF-e assinada |
| Protocolo | string | saída | retorna o número do protocolo de autorização de uso e respectiva data |
| retCancNFe | string | saída | retorna o XML da homologação de cancelamento se a NF-e estiver cancelada |
| resultado | inteiro | saída | retorna o código do resultado da chamada do WS |
| nomeCertificado | string | entrada | informar o Nome do titular (campo Assunto) do certificado digital a ser utilizado na conexão SSL. Ex.: "CN=NFe - Associacao NF-e:99999090910270, C=BR, L=PORTO ALEGRE, O=Teste Projeto NFe RS, OU=Teste Projeto NFe RS, S=RS" |
| msgResultado | string | saída | retorna a literal do resultado da chamada do WS |
| proxy | string | entrada | informar 'http://proxyserver:port' quando existir uso de proxy no ambiente. verificar com o cliente qual é o endereço do servidor proxy e a porta https, a porta padrão do https é 443, assim teríamos algo do tipo 'http://192.168.15.1:443' |
| usuario | string | entrada | informar o usuário para autenticação no proxy, se necessário |
| senha | string | entrada | informar a senha de autenticação no proxy, se necessário |
Retorno:
O resultado da chamada do CriaProcNFe é a mensagem XML composta pela NF-e e respectivo protocolo de autorização de uso da NF-e gerada de acordo com o leiaute de distribuição da NF-e previsto no item 10.2 do Manual de Integração do Contribuinte
O parâmetro resultado retorna um código numérico com os seguintes significados:
| código | Mensagem |
|---|---|
| 6201 | nfeProc montado com sucesso |
| 6202 | Erro: Contéudo do XML informado como NF-e no parâmetro de entrada (NFAssinada) mal formado [{0:0}] |
| 6203 | Erro: tag tpAmb inexistente no XML informado como NF-e no parâmetro de entrada(NFAssinada) [{0:0}] |
| 6204 | Erro: tag UF do emitente inexistente no XML informado como NF-e no parâmetro de entrada(NFAssinada) [{0:0}] |
| 6205 | Erro: chave da NFe não localizada no XML informado como NF-e no parâmetro de entrada(NFAssinada) |
| 6206 | Erro: tag infNFe não localizada no XML informado como NF-e no parâmetro de entrada(NFAssinada) [{0:0}] |
| 6207 | Erro: tag cStat não localizada na mensagem de retorno [{0:0}] |
| 6208 | Erro: tag xMotivo não localizada na mensagem de retorno [{0:0}] |
| 6209 | Erro: tag tpAmb não localizada na mensagem de retorno [{0:0}] |
| 6210 | Erro: tag verAplic não localizada na mensagem de retorno [{0:0}] |
| 6211 | Erro: tag dhRecbto não localizada na mensagem de retorno [{0:0}] |
| 6212 | Erro: tag nProt não localizada na mensagem de retorno [{0:0}] |
| 6213 | Erro: tag digVal não localizada na mensagem de retorno [{0:0}] |
| 6214 | Erro: |
| 6215 | Erro: Erro inesperado ao tratar o XML do retorno do WS[{0:0}] |
| 6216 | nfeProc da NF-e (situação Cancelada) montado com sucesso |
| 6217 | nfeProc da NF-e (situacação Denegada) montado com sucesso |
Histórico de atualização:
- 2010-08-01 - Versão preliminar.
Mensagens XML - versão 2.00:
ProcNFe2G
<?xml version="1.0" encoding="UTF-8"?> <nfeProc xmlns="http://www.portalfiscal.inf.br/nfe" versao="2.00"> <NFe xmlns="http://www.portalfiscal.inf.br/nfe"> <infNFe Id="NFe35100610142785000190552000000000011026974071" versao="2.00"> (…) detalhes da NF-e </NFe> <protNFe versao="2.00" xmlns="http://www.portalfiscal.inf.br/nfe"> <infProt> <tpAmb>2</tpAmb> <verAplic>SP_NFE_PL_006e</verAplic> <chNFe>35100610142785000190552000000000011026974071</chNFe> <dhRecbto>2010-06-14T00:24:36</dhRecbto> <nProt>135100021635445</nProt> <digVal>Eyds65vzt2RvoD+yIsoQLcMlRWc=</digVal> <cStat>100</cStat> <xMotivo>Autorizado o uso da NF-e</xMotivo> </infProt> </protNFe> </nfeProc>
- 13.5. CriaProcNFe2G [24-11-12]
13. Funcionalidades - « Anterior
13.4.8. calcICMSUFDest400 [10-01-18] - Próximo »
13.6. GNRE [08-12-18]