Função ConsultarEmissaoNotaNfce ( )
POST/ConsultarEmissaoNotaNfce/
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.
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 NFC-e |
Exemplo de JSon
{
"ApiKey":"xxxapikeyhashxxx",
"Cnpj":"00.000.000/0000-00",
"Dados":{
"searchkey":"xxxhashkeyxxxx"
}
}
Retornos e Erros
Todos os códigos de erros com os três primeiros dígitos sendo 310 são associados a função: ConsultarEmissaoNotaNfce| Código | Campo | Mensagem de retorno |
|---|---|---|
| 3101 | searchkey |
- É preciso informar a Searckey da nota fiscal para consulta - Não foi localizada nenhuma nota através da Searchkey informada |
| 3102 | Retorno com erro | |
| 3103 | 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": "3102", "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": "3103", "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": "3103", "descricao": "Consulta realizada com sucesso!", "resultado": { "status": "status_nfce", "numero": "numero_nfce", "serie": "serie_nfce", "destinatario": "nome_destinatario_nfce", "link_pdf": "link_pdf_nfce", "link_xml": "link_xml_nfce" } } |