NS NFCe

  1. Inicio
  2. Documentos
  3. NS NFCe
  4. Emissão NFCe Contingência...
  5. Download

Download

Download da NFC-e

O método de download é responsável por retornar o PDF da NFC-e a partir do XML recebido na requisição de emissão de contingência pela API. 

URL

Produção: POST https://nfce.ns.eti.br/v1/nfce/cont/print

Dados de entrada
CampoDescriçãoOcorrênciaTipoObservação
xmlXML da NFCe em contingência.1-1A
impressaoObjeto de informações de geração do PDF 0-1ODados para Impressão
TipoTipo de Impressão1-1APDF ou ESCPOS
ecologicaSe a impressão ecológica for habilitada (true)

os produtos não serão impressos.
0-1BTrue ou False

Valor padrão: False
itemLinhasQuantidade de linhas para cada produto0-1N1 ou 2

Valor padrão: 1
itemDescontoImprimir desconto do item abaixo do item0-1BTrue ou False

Valor padrão: True
larguraPapelLargura do papel0-1A58mm ou 80mm

Valor padrão: 80mm
modMiniImpressora Modelo de impressora1-1AObrigatório para tipo = ESCPOS

Possíveis valores:

BEMATECH MP-4200 TH
BEMATECH MP-2500 TH
DARUMA
EPSON T20
EPSON T70
ELGIN I9
Exemplo de requisição

Requisição de download de NFC-e Contingência

Requisição para PDF

curl -X POST \
    -H "Content-Type: application/json" \
    -d '{
    "xml": "<NFe xmlns=\"http://www.portalfiscal.inf.br/nfe\" ><infNFe versao=\"4.00\" Id=\"NFe43220807364617000135650800000000019000294836</infNFe><infNFeSupl><qrCode><![CDATA[https://www.sefaz.rs.gov.br/NFCE/NFCE-COM.aspx?p=43220807364617000135650800000000019000294836|2|2|17|4080.00|2f6d4f43766b624e3561777836346b5357386269786c362f324e6b3d|1|7d33242adae8d3ff531a195b536dee9cf6146d81]]></qrCode><urlChave>www.sefaz.rs.gov.br/nfce/consulta</urlChave></infNFeSupl></NFe>",
    "impressao": {
        "tipo": "PDF",
        "ecologica": false,
        "itemLinhas": "1",
        "itemDesconto": true,
        "larguraPapel": "80mm",
        "modMiniImpressora": null
    }
}' \
    https://nfce.ns.eti.br/v1/nfce/cont/print

Requisição para ESCPOS

curl -X POST \
    -H "Content-Type: application/json" \
    -d '{
    "xml": "<NFe xmlns=\"http://www.portalfiscal.inf.br/nfe\" ><infNFe versao=\"4.00\" Id=\"NFe43220807364617000135650800000000019000294836</infNFe><infNFeSupl><qrCode><![CDATA[https://www.sefaz.rs.gov.br/NFCE/NFCE-COM.aspx?p=43220807364617000135650800000000019000294836|2|2|17|4080.00|2f6d4f43766b624e3561777836346b5357386269786c362f324e6b3d|1|7d33242adae8d3ff531a195b536dee9cf6146d81]]></qrCode><urlChave>www.sefaz.rs.gov.br/nfce/consulta</urlChave></infNFeSupl></NFe>",
    "impressao": {
        "tipo": "ESCPOS",
        "ecologica": false,
        "itemLinhas": "1",
        "itemDesconto": true,
        "larguraPapel": "80mm",
        "modMiniImpressora": "BEMATECH MP-4200 TH"
    }
}' \
    https://nfce.ns.eti.br/v1/nfce/cont/print
Dados retornados
CampoDescriçãoTipoOcorreênciaObservações
statusStatus do downloadN1-1
motivoLiteral do status de DownloadA1-1
pdf ou escposBase64 do PDF ou arquivo do escposA0-1Somente com Status = 200
Exemplos de retorno

Retorno com sucesso

PDF

{
    "status": 200,
    "motivo": "Impressao de contingencia gerada com sucesso!",
    "pdf": "JVBERi0xLjQKJeLjz9MKNCAwIG9iago8PC9Db2xvclNwYWNlL0RldmljZUdyYXkvU3VidHlwZS9JbWFnZS9IZWlnaHQgNTAwL0ZpbHRlci9GbGF0ZURlY29kZS9UeXBlL1hPYmplY3QvRGVjb2RlUGFybXM8PC9Db2x1bW5zIDUwMC9Db2xvcnMgMS9QcmVkaWN0b3IgMTUvQml0c1BlckNvbXBvbmVudCAxPj4vV2lkdGggNTAwL0xlbmd0aCA5NDMvQml0c1BlckNvbXBvbmVudCAxPj5zdHJlYW0KeNrtnWGO3TAIhJG4/117ACTaJAYG5+2qVaVKprOtntLU3/tlYQYGr/hf/fwQ8uTJkydPnjx58n/Om9w/ej3q82+9X+r1wkSvj+eVttXkZ/D6fNq15lp2M/eiXy+fb7y/yteKZMjP4O1eup7Xk69l8RWaf2s1+Um8PTtmRYj1Ip7W7jIlP5V/ooJJbJh2rjygupOfx0fk8Hp4gkXFjHWg+HfnD/kz+QoTv/Pny/yT/Jm8Q7qAOWSqBcX48Z3+JH8iv6TCpiJjX5VyWNISUkzyQ/glE0IuhHhciQPqylxOfhAvij..."
}

ESCPOS

{
    "status": 200,
    "motivo": "Impressao de contingencia gerada com sucesso!",
    "escpos": "Hfk1ABt0CBszBRthARtXAU5GLUUgRU1JVElEQSBFTSBBTUJJRU5URQpERSBIT01PTE9HQUNBTyAtIFNFTQpWQUxPUiBGSVNDQUwNChtXAENOUEo6IDA3LjM2NC42MTcvMDAwMS0zNSBJRTogMTcwMTA4NzA4DQpSdWEgQmVudG8gT3N2YWxkbyBUcmlzY2gsNzc3LCAuLCAgQ1ggUE9TVEFMIDkxLApQZW5kYW5jaW5vLCBDYXhpYXMgZG8gU3VsIC0gUlMgLSAoMDApKDU0KTMyMjAtMDIwMA0KLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0NCkRvY3VtZW50byBBdXhpbGlhciBkYSBOb3RhIEZpc2NhbCBkZSBDb25zdW1pZG9yIEVsZXRyw7RuaWNhDQobYQAbYQEbRUVNSVRJREEgRU0gQ09OVElOR8OKTkNJQQ0KG0YbYQAtLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLQ0KGw9Db2RpZ28gRGVzY3JpY2FvICAgICAgICAgICAgICAgICAgICAgICAgICAgIFF0ZCBVbiAgICAgVmxVbiAgIFZsVG90DQoSLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0NChsPIDE0NjA2IE5PVEEgRklTQ0FMIEVNSVRJREEgRU0gQU1CSUVOVEUgREUgICAgIDEgcGMgICAgNjksMTAgICA2OSwxMA0KREVTQ09OVE8gICAgICAgICAgICAgICAgICAgICAgICAgI...
}"
Códigos de retorno
CódigoDescrição
200Impressao de contingencia gerada com sucesso!
-997Campos obrigatórios não informados

O campo motivo terá maiores informações
-999Erro interno ao processar a requisição

O campo motivo terá maiores informações

Como podemos ajudar?