Consulta Devolução de Venda NF-e

Para consultar a devolução de venda de NF-e deve ser observado a documentação aqui descrita.    

Autenticação

Para utilizar a rota de consulta de devolução de venda NF-e é necessário realizar autenticação, conforme detalhado na documentação de Autenticação do Emissor

---

API Consulta da Devolução de Venda

• Endpoint: /nfemiddleware/Sale/Return?Cnpj={{SaleCnpj}}&Id={{SaleReturnId}}&TpDanfe=1 
• Método: GET
• Parâmetros:
  • CNPJ: CNPJ responsável pela emissão da devolução
  • ID: ID gerado para a devolução
  • TpDanfe: Tipo de DANFE de Retorno
• Header:
  • Authorization: Token de autorização
  • Content-Type: application/json 

Exemplo Payload de Retorno

{
"chNFe": "35250649792429000158550020004001961370973520",
"cStat": "100",
"danfe": "Base64",
"nNF": 400196,
"xMotivo": "Autorizado o uso da NF-e",
"xUrlDanfe": null
}

---

Detalhamento campo cStat

Neste campo poderão haver retornos de status da SEFAZ e da Solução Fiscal, conforme segue

Retornos da SEFAZ

• Autorização:
  • 100 – Autorizado
• Rejeições:
  • Consultar todos os códigos de rejeição vinculados a emissão de documento no manual de orientação ao contribuinte (MOC – Anexo I) disponível no item “4.4.2. Tabela de Códigos de Rejeição”

Retornos da Solução Fiscal

• Rejeição:
  • M0018 – Nota não encontrada. OBS: Nesse caso não existe documento atrelado a essa venda. 

Possíveis retornos HTTP

• 200 - Sucesso
• 400 – BadRequest
  • Caso tenha algum problema nas informações enviadas, causando falha na Solução Fiscal ou rejeição pela Sefaz
• 401 - Unauthorized
• 404 – NotFound
• 429 - TooManyRequests
• 500 - InternalServerError
• 503 - Service Unavailable