14.5. CriaProc
14.5.3. CriaProcCancNFe2G
14.5.2. CriaProcNFe2G [24-11-12]
« Anterior
14.6. GNRE [18-11-12]
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.

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:

  • cStat = 101 - Cancelamento de NF-e homologado;
  • cStat = 151 - Cancelamento de NF-e homologado fora de prazo.

CUIDADOS QUE DEVEM SER TOMADOS

  • não funciona com cancelamento por evento - a funcionalidade não funciona para NF-e canceladas com uso do cancelamento por Evento, se a nota foi cancelada como evento, basta consultar o status da NF-e e extrair procEventoNF;
  • dependência da ConsultaNFe2G - requer versão 2Gv1.1f ou superior da DLL, 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 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:

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 [24-11-12]
Próximo »
14.6. GNRE [18-11-12]