Consulta Venda NF-e

Esta API é responsável por realizar a consulta do documento fiscal vinculado a venda. Essa API deve ser autenticada pelo Emissor (Autenticação do Emissor)

---

Cancelamento de Venda NF-e

• Endpoint: /nfemiddleware/Sale?Id=XX&GeraDanfe=true&Cnpj=XX&tpDANFE=1
• Método: GET
• Parâmetros:
  • Id= ID da venda
  • GeraDanfe = true|false. Caso desejar retornar o DANFE
  • Cnpj = CNPJ do Emissor
  • TpDanfe = = Tipo de DANFE
    ▪ Retrato= 1 (Padrão)
    ▪ Resumido = 3 
    ▪ Simplificado = 5
    ▪ Simplificado SC = 6 
    ▪ Etiqueta = 7 
    ▪ Paisagem = 8 
• Header:
  • Authorization: Token de autorização

Dados dos parâmetros de envio:

Tag	Descrição	Obrig
Id	Mesmo ID enviado na venda	Sim
Cnpj	CNPJ do emissor	Sim
GeraDanfe	Retornar o DANFE (true ou false)	Não

---

Exemplo Payload de Envio

{
 "cnpj": "50354031000119",
 "id": "6D7CBDB0-0D72-4BD2-B7EC-61CF5D5FC836
 "GerDanfe": "True",
}

---

Exemplo Payload de Retorno

{
 "chNFe": "43241050354031000119650020000001061877367321",
 "cStat": 100,
 "danfe": "Base64",
 "nNF": 106,
 "xUrlDanfe":"https://www.sefaz.rs.gov.br/NFCE/NFCECOM.aspx?p=43241050354031000119650020000001061877367321|2|2|1|4ff5c319975092c18f30a768b3c1d7fa81cd61f3"
}

---

Abaixo segue o detalhamento dos possíveis retornos no parâmetro cStat

Detalhamento campo cStat

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

Retornos da SEFAZ

• Documento Autorizado
  • 100 – Autorizado o uso da NF-e
  • 150 - Autorizado o uso da NF-e, autorização fora de prazo
• Documento Cancelado
  • 135 – Cancelado (Evento registrado e vinculado a NF-e)
  • 151 - Cancelado (Cancelamento de NF-e homologado fora de prazo)
  • 102 – Inutilização de número homologado
• Documento Denegaddo
  • 110 – Uso Denegado
    • Nesse caso o emissor está com alguma pendência com a SEFAZ do estado em que está estabelecido e deverá regularizar a situação junto a SEFAZ para seguir realizando suas emissões. 
• Documento Rejeitado
  • 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ções

Retorno	Como Resolver
M0001 - O CNPJ não está cadastro para emissão.	Necessário cadastrar o CNPJ emissor na Solução Fiscal (Cadastro Emissor/Empresa). Após cadastrar o Emissor e gerar chave para ele autenticar, basta realizar a venda novamente.
M0002 - O CNPJ está inativo para emissão.	Necessário vincular produto de emissão no cadastro do CNPJ emissor na Solução Fiscal. Campos Produto e Produtos ID. (Cadastro Emissor/Empresa). Após realizar este ajuste, basta realizar a venda novamente.

Possíveis retornos HTTP

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