Facturar carrito

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": {
    "numero_timbrado": "12345678",
    "numero_documento": "001-001-0000001",
    "serie": "AA",
    "cdc": "018015804040010020000182120251028149230824767",
    "estado_sifen": {
      "estado": "Pendiente",
      "mensaje": "Pendiente"
    },
    "xml": "https://api.guarani.app/sifen/xml/018015804040010020000182120251028149230824767",
    "qr": "https://ekuatia.set.gov.py/consultas-test/qr?nVersion=150&Id=018015804040010020000182120251028149230824767&dFeEmiDE=323032352d31302d32385430383a31383a3139&dRucRec=362889&dTotGralOpe=200000.00000000&dTotIVA=18181.81818182&cItems=2&DigestValue=724a4b68652f6635616934566442357036797070704b504b66736c514370696f554a2f3374676674484b453d&IdCSC=0001&cHashQR=90832ec96b3a6f8cd667640386206708099adf9af74bdea2116d30099897fecda"
  }
}

Recursos adicionales

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