Obtendo XML e PDF

O PlugNotas fornece para você tanto o PDF da nota, quanto o XML da NFe.

Você consegue solicitar isso quantas vezes precisar e eles ficam armazenados no nosso banco de dados (confira o seu contrato sobre a disponibilidade dessas informações).

Para obter essas informações, você vai chamar as APIs e passar como filtro, o ID da nota que nós retornamos para você na requisição de envio do json. Seguindo o mesmo padrão de uma requisição do tipo GET, passe o API-KEY como Header e esse ID de filtro, para obter o retorno.

Mais uma vez, afim de não termos duplicação de documentações, segue locais onde você poderá encontrar a forma que será utilizado para obtenção do PDF você poderá encontrar aqui. 

Segue exemplo de requisição utilizada por meio do Postman:

curl --location --globoff 'https://api.plugnotas.com.br/nfe/{idNota}/pdf' \
--header 'x-api-key: {{x-api-key-key-prod}}' \
--header 'Content-Type: application/json' \
--data ''

E para obter o XML da NFe emitida você poderá encontrar aqui.

Segue exemplo de requisição utilizada por meio do Postman:

curl --location --globoff 'https://api.plugnotas.com.br/nfe/{idNotaorChave}/xml' \
--header 'x-api-key: {{x-api-key-key-prod}}' \
--data ''

Obs: Em caso de nota cancelada, o PDF retornado, será atualizado com as informações do cancelamento.

Pegando o link através do retorno

Os retornos tanto da consulta da nota, quanto do WebHook, possuem dois campos no json, que são as URLs de requisição, prontas, para PDF e para XML. Basta pegar elas ali, adicionar o API-KEY e disparar a requisção para o PlugNotas.

Um exemplo desse retorno, vem assim:

[
{
"id": "5f9ad47eff3b4d0d7b4994ea",
"idIntegracao": "XXX999",
"emissao": "29/10/2020",
"status": "CONCLUIDO",
"destinada": false,
"emitente": "29062609000177",
"destinatario": "08114280956",
"valor": 9.2,
"numero": "1000013",
"serie": "805",
"chave": "41201029062609000177558050010000131609769080",
"protocolo": "141200000956123",
"dataAutorizacao": "29/10/2020",
"mensagem": "Autorizado o uso da NF-e",
"pdf": "https://api.plugnotas.com.br/nfe/5f9ad47eff3b4d0d7b4994ea/pdf",
"xml": "https://api.plugnotas.com.br/nfe/5f9ad47eff3b4d0d7b4994ea/xml",
"cStat": 100
}
]

XML de Cancelamento

O XML de cancelamento da NF-e fica disponível por uma rota específica. Um POST onde você solicita o ID da nota e recebe como retorno a String do XML de cancelamento. Mais detalhes dessa rota, você encontra nessa documentação aqui.

< Antes