Generar nota crédito

Genera una nota crédito electrónica. Crea el documento fiscal válido ante SIFEN con CDC y XML.

Entorno

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

Endpoint

POST /sifen/de/notas/credito

Ejemplo de solicitud

curl -X POST "https://api.guarani.app/sifen/de/notas/credito" \
  -H "Content-Type: application/json" \
  -H "x-api-key: Bearer <access_token>" \
  -d '{
    "carrito_id":"8ce1f860-458c-4783-a476-10e00df1863b",
    "numero_timbrado":"80158040",
    "numero_establecimiento":"001",
    "punto_expedicion": "001",
    "motivo_emision": 5
  }' | 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	Tamaño	Descripción
carrito_id	uuid	Sí	36	ID del carrito. (ver carritos)
numero_timbrado	string	Sí	36	Número del timbrado. (ver timbrados)
numero_establecimiento	string	Sí	36	Número del establecimiento. (ver establecimientos)
punto_expedicion	string	Sí	36	Punto de expedición. (ver timbrados)
motivo_emision	number	Sí	1	Motivo de emisión. (ver tablas-referencias)

Ejemplo de respuesta

{
  "success": true,
  "codigo": "ORC1729127",
  "message": "Operación realizada correctamente.",
  "data": {
    "cdc": "{numero del cdc}",
    "xml": "{url del xml}"
  }
}

Descripción de campos de respuesta

Campos principales

Campo	Tipo	Descripción
cdc	string	Código de Control (CDC) generado por SIFEN. Identificador único del documento electrónico.
xml	string	URL del archivo XML firmado del documento electrónico.

Recursos adicionales

Para más información sobre posibles errores de nota de crédito, consulta las siguientes secciones: errores.