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
Campo | Descrição | Ocorrência | Tipo | Observação |
---|---|---|---|---|
xml | XML da NFCe em contingência. | 1-1 | A | |
impressao | Objeto de informações de geração do PDF | 0-1 | O | Dados para Impressão |
Tipo | Tipo de Impressão | 1-1 | A | PDF ou ESCPOS |
ecologica | Se a impressão ecológica for habilitada (true) os produtos não serão impressos. | 0-1 | B | True ou False Valor padrão: False |
itemLinhas | Quantidade de linhas para cada produto | 0-1 | N | 1 ou 2 Valor padrão: 1 |
itemDesconto | Imprimir desconto do item abaixo do item | 0-1 | B | True ou False Valor padrão: True |
larguraPapel | Largura do papel | 0-1 | A | 58mm ou 80mm Valor padrão: 80mm |
modMiniImpressora | Modelo de impressora | 1-1 | A | Obrigató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
Campo | Descrição | Tipo | Ocorreência | Observações |
---|---|---|---|---|
status | Status do download | N | 1-1 | |
motivo | Literal do status de Download | A | 1-1 | |
pdf ou escpos | Base64 do PDF ou arquivo do escpos | A | 0-1 | Somente com Status = 200 |
Exemplos de retorno
Retorno com sucesso
{
"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ódigo | Descrição |
---|---|
200 | Impressao de contingencia gerada com sucesso! |
-997 | Campos obrigatórios não informados O campo motivo terá maiores informações |
-999 | Erro interno ao processar a requisição O campo motivo terá maiores informações |