Generar factura electrónica

Genera una factura electrónica a partir de un carrito finalizado. Crea el documento fiscal válido ante SIFEN con CDC y XML.

Entorno

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

Endpoint

POST /sifen/de/factura

Ejemplo de solicitud

curl -X POST "https://api.guarani.app/sifen/de/factura" \
  -H "Content-Type: application/json" \
  -H "x-api-key: Bearer <access_token>" \
  -d '{
    "carrito_id": "ejemplo-uuid-carrito-123",
    "numero_timbrado": "ejemplo-numero-timbrado",
    "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	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)

Ejemplo de respuesta

{
  "success": true,
  "codigo": "200",
  "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 almacenado en Firebase Storage.

Recursos adicionales

Para más información sobre posibles errores de carritos, consulta las siguientes secciones: errores.