Pular para o conteúdo principal

Consulta Devolução de Venda NFC-e

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

Autenticação

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


API Consulta da Devolução de Venda

  • Endpoint: /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": "43XXXXXXXXXXXX000XXXXX0020000001XXXXXXXXXX90",
"cStat": "100",
"danfe": "Base64",
"nNF": 124,
"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

Este conteúdo foi útil para você?