Finalizar nota de crédito

Finaliza una nota de crédito y genera el documento electrónico correspondiente. Una vez finalizada, la nota de crédito no puede ser modificada.

---

Entorno

URL Base: https://api.guarani.app

Endpoint

POST /notas/credito/finalizar

Ejemplo de solicitud

curl -X POST "https://api.guarani.app/notas/credito/finalizar" \
  -H "Content-Type: application/json" \
  -H "x-api-key: Bearer <access_token>" \
  -d '{
    "nota_credito_id": "ejemplo-uuid-nota-credito-123",
    "numero_timbrado": "12345678",
    "numero_establecimiento": "001",
    "punto_expedicion": "001"
  }' | jq

Nota: Asegúrate de reemplazar <access_token> con un token JWT válido proporcionado por el equipo Guarani.
Importante:
Es imprescindible incluir un token de acceso válido en el encabezado x-api-key para autenticar y autorizar el uso de este endpoint. Sin este token, la solicitud será rechazada.

---

Encabezados de la Solicitud

Encabezado	Valor	Descripción
Content-Type	application/json	Indica que los datos se envían en formato JSON.
x-api-key	Bearer <access_token>	Token de autenticación necesario para acceder al recurso.

Descripción de Campos

Campo	Tipo	Requerido	Descripción
nota_credito_id	uuid	Sí	ID de la nota de crédito a finalizar. (ver notas de crédito)
numero_timbrado	string	Sí	Número de timbrado para la nota de crédito. (ver timbrados)
numero_establecimiento	string	Sí	Número de establecimiento donde se emitirá la nota de crédito.
punto_expedicion	string	Sí	Punto de expedición donde se emitirá la nota de crédito.

Ejemplo de respuesta

{
  "success": true,
  "codigo": "200",
  "message": "Operación realizada correctamente.",
  "data": {
    "numero_timbrado": "80158040",
    "numero_documento": "001-002-0000145",
    "serie": "AA",
    "cdc": "05801580404001002000014512025111714729425743",
    "estado_sifen": {
      "estado": "Pendiente",
      "mensaje": "Pendiente"
    },
    "xml": "https://api.guarani.app/sifen/xml/05801580404001002000014512025111714729425743",
    "qr": "https://ekuatia.set.gov.py/consultas/qr?nVersion=150&Id=05801580404001002000014512025111714729425743&dFeEmiDE=323032352d31312d31375431343a32343a3232&dNumIDRec=5839704&dTotGralOpe=100000.00000000&dTotIVA=2727.27272750&cItems=1&DigestValue=42797674315949424f77354c4472467762372b36524c55316c3052724b5932447566553952765133654d513d&IdCSC=0001&cHashQR=92fe074db6d2a83e4f06a8fca51389f8e441ea1e4f79f133cb556998b254b7fc"
  }
}

Descripción de Campos de Respuesta

Campos principales

Campo	Tipo	Descripción
numero_timbrado	string	Número del timbrado utilizado para la emisión de la nota de crédito.
numero_documento	string	Número de documento generado (formato: establecimiento-punto-expedición-número secuencial, ej: 001-001-0000001).
serie	string	Serie utilizada en la nota de crédito electrónica.
cdc	string	Código de Control (CDC) del documento electrónico generado.
estado_sifen	object	Objeto con el estado del documento en SIFEN.
xml	string	URL para descargar el XML fiscal generado ante SIFEN.
qr	string	URL con el QR oficial de la SET para verificación y consulta del documento electrónico.

Campos del objeto estado_sifen

Campo	Tipo	Descripción
estado	string	Estado del documento en SIFEN.
mensaje	string	Mensaje descriptivo del estado del documento en SIFEN.

Notas importantes

• Una vez finalizada, la nota de crédito no puede ser modificada.
• La nota de crédito debe tener al menos un item antes de ser finalizada.
• El documento electrónico se genera automáticamente al finalizar la nota de crédito.