- 14.5. CriaProc
14.5.3. CriaProcCancNFe2G - 14.5.2. CriaProcNFe2G
« Anterior - 15. Converter um TXT em XML da NF-e
Próximo »
14.5.3. CriaProcCancNFe2G
Cria procCancNFe - estrutura de distribuição do Cancelamento de NF-e
Assinatura
string CriaProcCancNFe2G(string siglaWS, ref string cancNFe, 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 procCancNFe quando o pedido de cancelamento foi homologado pela SEFAZ, mas não houve retorno do Web Service ou houve uma falha na gravação do procCancNFe.
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 sigla do WS que deseja consultar, informar SVAN - SEFAZ Virtual do Ambiente Nacional (CE, ES, MA, PA, PI e RN) ou SVRS - SEFAZ Virtual do Rio Grande do Sul (AC, AL, AM, AP, DF, MS, PB, RJ, RO, RR, SC, SE e TO), caso a UF seja usuário da SEFAZ Virtual, em caso contrário informar a sigla da UF (AM, BA, CE, GO, MS, MT, MG, PE, PR, RS e SP). Em caso de contingência SCAN, informar a sigla SCAN. |
| cancNFe | string | entrada/saída | informar o pedido de cancelamento da NF-e, se não tiver o pedido de cancelamento, faça uma nova tentativa de cancelamento da NF-e para ter o pedido de cancelamento que é devolvido no parâmetro msgDados da funcionalidade de cancelamento. |
| Protocolo | string | saída | retorna o número do protocolo de homologação do cancelamento |
| retCancNFe | string | saída | retorna a data e hora de homologação do cancelamento |
| 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 é o procCancNFe que é a mensagem XML composta pelo pedido de cancelamento e respectivo protocolo de homologação do cancelamento da NF-e gerada de acordo com o leiaute de distribuição do Cancelamento de NF-e previsto no item 10.3 do Manual de Integração do Contribuinte.
O parâmetro resultado retorna um código numérico com os seguintes significados:
| código | Mensagem |
|---|---|
| 6801 | procCancNFe montado com sucesso |
| 6802 | Erro: Contéudo do XML informado como pedido de cancelamento de NF-e no parâmetro de entrada (cancNFe) mal formado [{0:0}] |
| 6803 | Erro: tag tpAmb inexistente no XML informado como pedido de cancelamento de NF-e no parâmetro de entrada (cancNFe) [{0:0}] |
| 6804 | Erro: tag chNFe inexistente no XML informado como pedido de cancelamento de NF-e no parâmetro de entrada(cancNFe) [{0:0}] |
| 6805 | Erro: tag cancNFe não localizada no XML informado como pedido de cancelamento de NF-e no parâmetro de entrada(cancNFe) [{0:0}] |
| 6806 | Erro: tag cStat não localizada na mensagem de retorno [{0:0}] |
| 6807 | Erro: tag xMotivo não localizada na mensagem de retorno [{0:0}] |
| 6808 | Erro: A NF-e não se encontra cancelada |
| 6809 | Erro: Falha no acesso ao retCancNFe do XML da resposta do WS [{0:0}] |
| 6810 | Erro: tag dhRecbto não localizada na mensagem de retorno (retCancNFe) [{0:0}] |
| 6811 | Erro: tag nProt não localizada na mensagem de retorno (retCancNFe) [{0:0}] |
| 6812 | Erro inesperado ao tratar o XML do retorno do WS[{0:0}] |
Histórico de atualização:
- 2010-08-01 - Versão preliminar.
Mensagens XML - versão 2.00:
procCancNFe
<?xml version="1.0" encoding="UTF-8"?> <procCancNFe xmlns="http://www.portalfiscal.inf.br/nfe" versao="2.00"> <cancNFe xmlns="http://www.portalfiscal.inf.br/nfe" versao="2.00"> <infCanc Id="ID35100610142785000190552000000000061062311555"> <tpAmb>2</tpAmb> <xServ>CANCELAR</xServ> <chNFe>35100610142785000190552000000000061062311555</chNFe> <nProt>135100021635460</nProt><xJust>NF-e emitida em duplicidade por engano.</xJust> </infCanc> <Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> <SignedInfo> <CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315" /> <SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1" /> <Reference URI="#ID35100610142785000190552000000000061062311555"> <Transforms> <Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature" /> <Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315" /> </Transforms> <DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" /> <DigestValue>wy82JRHX3y8iLYjlE8NiSBI32XY=</DigestValue> </Reference> </SignedInfo> <SignatureValue>39y2mEV2E91P2WsYahecKXgKyiR51Kbv/Cmr0SGSEjcHoFpEV6FDgBnVPGC6hl74D0ky7Asi65NdxZQV8WqYWUxJYo8ueFIC5bcJEqDWbUQAxMUuaygUUhOUI9DaxVZXs0NRqoX/FktRmvcF8ESS6viy2PHQQE2MKnAAYWDmRm8=</SignatureValue> <KeyInfo> <X509Data> <X509Certificate>MIIFujCCBKKgAwIBAgIEQeKR9TANBgkqhkiG9w0BAQUFADBaMQswCQYDVQQGEwJicjETMBEGA1UEChMKSUNQLUJyYXNpbDEgMB4GA1UECxMXQ2FpeGEgRWNvbm9taWNhIEZlZGVyYWwxFDASBgNVBAMTC0FDIENBSVhBIFBKMB4XDTA5MTAxNzAxNTcxN1oXDTEwMTAxNzAyMjcxN1owgYYxCzAJBgNVBAYTAmJyMRMwEQYDVQQKEwpJQ1AtQnJhc2lsMSAwHgYDVQQLExdDYWl4YSBFY29ub21pY2EgRmVkZXJhbDEUMBIGA1UECxMLQUMgQ0FJWEEgUEoxKjAoBgNVBAMTIU0gUiBNIEtBVE8gQVNBS1VSQSBNRTo2OTYyMTE4NzkxNTCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEA4aEFg7LqjS5kB3zqluXXQFgVbUuDnQEoDMy8rUMVReir7qSqRnSeW9QLzRh4SJ3vr+b2MR6DGzycvQZ5/K3AgYtf8HAG5tB0o73A6N6O1dvICKRctGsV/ZquMY2nZ6/QbUa+Lx2jzZVH+xHqnA2gaoUPEqKMuRW+2+oSLdm8Iz0CAwEAAaOCAt0wggLZMA4GA1UdDwEB/wQEAwIF4DBXBgNVHSAEUDBOMEwGBmBMAQIBCTBCMEAGCCsGAQUFBwIBFjRodHRwOi8vaWNwLmNhaXhhLmdvdi5ici9yZXBvc2l0b3Jpby9kcGNhY2NhaXhhcGoucGRmMCkGA1UdJQQiMCAGCCsGAQUFBwMCBggrBgEFBQcDBAYKKwYBBAGCNxQCAjCBxQYDVR0RBIG9MIG6gRZtcmVnaW5hLmthdG9AZ21haWwuY29toD4GBWBMAQMEoDUEMzE0MDkxOTcyNjk2MjExODc5MTUwMDAwMDAwMDAwMDAwMDAwMDI4OTc2ODM4WFNTUCBTUKAsBgVgTAEDAqAjBCFNQVJDSUEgUkVHSU5BIE1JWVVLSSBLQVRPIEFTQUtVUkGgGQYFYEwBAwOgEAQOMTAxNDI3ODUwMDAxOTCgFwYFYEwBAwegDgQMMDAwMDAwMDAwMDAwMIIBMgYDVR0fBIIBKTCCASUwga6ggauggaiGMmh0dHA6Ly9pY3AuY2FpeGEuZ292LmJyL3JlcG9zaXRvcmlvL0FDQ0FJWEFQSjEuY3JshjRodHRwOi8vaWNwMi5jYWl4YS5nb3YuYnIvcmVwb3NpdG9yaW8yL0FDQ0FJWEFQSjEuY3JshjxodHRwOi8vcmVwb3NpdG9yaW8uaWNwYnJhc2lsLmdvdi5ici9sY3IvY2FpeGEvQUNDQUlYQVBKMS5jcmwwcqBwoG6kbDBqMQswCQYDVQQGEwJicjETMBEGA1UEChMKSUNQLUJyYXNpbDEgMB4GA1UECxMXQ2FpeGEgRWNvbm9taWNhIEZlZGVyYWwxFDASBgNVBAMTC0FDIENBSVhBIFBKMQ4wDAYDVQQDEwVDUkwxNzAfBgNVHSMEGDAWgBSOQC8K/hPVqjmgdnSG07x9x/HlzzAJBgNVHRMEAjAAMBkGCSqGSIb2fQdBAAQMMAobBFY3LjEDAgOoMA0GCSqGSIb3DQEBBQUAA4IBAQBVKsyKzW6metQkz7xkgs+4eKu0KE89WiZhO27UTJfs0ZfcVR3kFvaManv3Tmz2Pmx23wdIIcvFhJ0bwPNiEQzTeTdzLIr63dK6Kf5szusmToHjig+JhjYPEcn/IU0wT00w6LdazQYTx0/zZlc6JOQ1K1dKHFyGfnpLsQ85tLYbof3mSO4UoyKjz+yVqwuQ3TFQZZv6w0WkueZMCFu/7bMZWRmbxAQ8zDPtGykGdOE1Rx4IW8MCjEQt0MeNutdBs1RPUl9dINiOFxDLOKYSrFBQJXxDzrM1dhaUzPGzoEAbFCeNqskH7EkkauyGZwoF73Go9ifYKrOChY5aPCNQz7Lw</X509Certificate> </X509Data> </KeyInfo> </Signature> </cancNFe> <retCancNFe versao="2.00" xmlns="http://www.portalfiscal.inf.br/nfe"> <infCanc> <tpAmb>2</tpAmb> <verAplic>SP_NFE_PL_006e</verAplic> <cStat>101</cStat> <xMotivo>Cancelamento de NF-e homologado</xMotivo> <cUF>35</cUF> <chNFe>35100610142785000190552000000000061062311555</chNFe> <dhRecbto>2010-06-14T01:15:48</dhRecbto> <nProt>135100021635462</nProt> </infCanc> </retCancNFe> </procCancNFe>
- 14.5.3. CriaProcCancNFe2G
14.5. CriaProc - « Anterior
14.5.2. CriaProcNFe2G - Próximo »
15. Converter um TXT em XML da NF-e