Função ConsultarEmissaoNotaNfe ( )
POST/ConsultarEmissaoNotaNfe/
Essa função tem o caráter de verificar o Status da emissão da Nota Fiscal. Os status que poderão retornar são:
Aguardando Processamento - A nota está na fila de processamento para o envio para a Sefaz.
Em andamento - A nota esta sendo processada Pela Sefaz.
Aprovada - A Nota está aprovada e protocolada pela Sefaz.
Aprovada com correção - A NFe foi aprovada e existe uma carta correção anexada a mesma.
Cancelada - A NFe foi cancelada pelo emitente. Ela não possui mais validade fiscal.
Denegada - O Sefaz identifica alguma irregularidade fiscal do seu emitente/destinatário. Por conta disso não é possivel Enviar uma carta Correção ou Cancelar a NFe.
Reprovada - A nota contem erros que impediram a aprovação pela Sefaz.
Segue abaixo os campos necessários para utilização da Função.
|
Campo |
Tipo |
Obrigatório |
Descrição |
|---|---|---|---|
| searchkey | Texto | Sim | Código gerado pela API ao enviar a NF-e |
Exemplo de JSon
{
"ApiKey":"xxxapikeyhashxxx",
"Cnpj":"00.000.000/0000-00",
"Dados":{
"searchkey":"xxxhashkeyxxx"
}
}
Retornos e Erros
Todos os códigos de erros com os três primeiros dígitos sendo 120 são associados a função: ConsultarEmissaoNotaNfe| Código | Campo | Mensagem de retorno |
|---|---|---|
| 1201 | searchkey | É preciso informar a Searckey da nota fiscal para consulta |
| 1202 | Retorno com erro | |
| 1203 | Retorno com sucesso | |
Retornos de JSON
| Retorno com erro de parametros |
|---|
| { "Status": "Erro", "codigo": "codigo_erro", "campo": "campo_com_erro", "descricao": "descricao_erro" } |
| Retorno com erro |
|---|
| { "status": "Erro", "codigo": "1202", "descricao": "descricao_erro" } |
| Retorno com sucesso Se a Nota Fiscal não estiver com status de: APROVADA, APROVADA COM CORRECAO ou CANCELADA |
|---|
| { "status": "OK", "codigo": "1203", "descricao": "Consulta realizada com sucesso!", "searchkey": "searchkey_gerado" } |
| Retorno com sucesso Se a Nota Fiscal não estiver com status de: APROVADA, APROVADA COM CORRECAO ou CANCELADA |
|---|
| { "status": "OK", "codigo": "1203", "descricao": "Consulta realizada com sucesso!", "resultado": { "status": "status_nfe", "numero": "numero_nfe", "serie": "serie_nfe", "destinatario": "nome_destinatario_nfe", "link_pdf": "link_pdf_nfe", "link_xml": "link_xml_nfe" } } |