POST/nfse/cancelar/{idNota}

Solicitar la cancelación de la nota

Solicita la cancelación de una NFS-e por ID. Notas: - Solo se puede cancelar una nota en CONCLUIDO. - Si la cancelación tiene éxito, se dispara el webhook y el estado pasa a CANCELADO. - Algunas prefecturas exigen un código de cancelación en el body. Códigos de NFS-e Nacional: - 1 — Error en la emisión - 2 — Servicio no prestado - 9 — Otros

Producción: https://api.otentecnologia.com.brSandbox: https://api.sandbox.otentecnologia.com.br

Parámetros

Esta ruta no tiene parámetros de path o query.

Solicitud

cURL

curl -X POST 'https://api.otentecnologia.com.br/nfse/cancelar/{idNota}' \
  -H 'x-api-key: $OTEN_API_KEY' \
  -H 'Content-Type: application/json'

Respuestas

200OK

JSON

{
  "message": "Cancelamento em processamento",
  "data": {
    "protocol": "888738ef-e738-427f-a391-44ea7b497644"
  }
}

400Bad Request

JSON

{
  "error": {
    "message": "A ação de Cancelar NFSe é permitida apenas para notas com status CONCLUIDO",
    "data": {
      "id": "0000000000",
      "idIntegracao": "XXXYY999",
      "status": "PROCESSANDO"
    }
  }
}

401Unauthorized

JSON

{
  "error": {
    "message": "O token informado é inválido. Para o ambiente de produção, Acesse https://www.otentecnologia.com.br/, e gere o seu TOKEN de acesso"
  }
}

404Not Found

JSON

{
  "error": {
    "message": "Não localizamos qualquer NFSe com os parâmetros informados",
    "data": {
      "id": "0000000000"
    }
  }
}