O método de download da NFSe é responsável por retornar o XML e DANFSE (Documento Auxiliar da Nota Fiscal de Serviços Eletrônica) a partir do fornecimento da chave de acesso de uma NFSe autorizada.
URL
Produção: POST https://nfsenacional.ns.eti.br/nfse/get
Dados de entrada
| Campo | Ocorrência | Tipo | Descrição |
|---|---|---|---|
| X-AUTH-TOKEN | 1-1 | A | Token de acesso do usuário |
| chDPS | 1-1 | N | Chave de acesso da NFSe |
| chNFSe | 1-1 | N | Chave de acesso da DPs |
| tpAmb | 0-1 | N | Tipo de ambiente de autorização da NFSe 1 - Produção 2 - Homologação |
| CNPJ | 1-1 | N | CNPJ do emitente |
Exemplo de requisição
Requisição de download de NFSe
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"X-AUTH-TOKEN": "SEU_TOKEN",
"chDPS": "310620021327800500012200001000000000000017",
"chNFSe": "31062002213278005000122000000000001725121110930243",
"CNPJ": "13278005000122",
"tpDown": "xp",
"tpAmb": "2"
}' \
https://nfsenacional.ns.eti.br/nfse/get
Dados retornados
| Campo | Descrição | Observação |
|---|---|---|
| status | Código de status do processamento | |
| motivo | Descrição literal do status de processamento | |
| pdfDocumento | PDF da DANFSE | Base64 do PDF do DANFSe Apenas com status = 200 |
| xml | xml da NFSe | |
| erro | Objeto contendo informações de erro ao carregar a NFse | Apenas com status diferente de 200 |
| erro.cStat | Código do status de erro | |
| erro.xMotivo | Descrição literal do erro |
Exemplos de retorno
Retorno com sucesso
{
"status": 200,
"motivo": "Donwload Realizado com Sucesso",
"pdfDocumento": "JVBERi0xLjcKJdP0zOEKMSAwIG9iago8PAovQ3JlYXRp...
"xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><NFSe versao=\"1.01\" xmlns=\"http://www.sped.fazenda.gov.br/nfse\"><infNFSe Id=\"NFS31062002213278005000122000000000001725121110930243\..."
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | Download realizado com sucesso |
| -3 | Chave de acesso inválida |
| -4 | NFSe não encontrada com a chave de acesso informada |