Appearance

Quickstart Técnico ​

Recorrido mínimo para hacer tu primer request real contra ReKU: autenticarte, emitir una factura y consultar su estado.

Tu instancia de ReKU (ip:puerto) y tu token de acceso son provistos por nuestro equipo al aprovisionar tu integración - nosotros gestionamos toda la infraestructura, los despliegues y las actualizaciones periódicas. Vos no necesitás instalar ni configurar nada de tu lado, solo consumir la API con las credenciales que te compartimos. Si todavía no tenés una instancia, contactanos para levantarla.

Paso 1 - Autenticación ​

Todos los requests llevan el token como header Authorization:

bash
curl -X POST http://{ip}:{puerto}/crear/factura/online \
  -H "Authorization: Bearer {tu_token}" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

Más detalle en Autenticación.

Paso 2 - Emitir una factura ​

Usamos el endpoint online (sincrónico) para ver el resultado de inmediato:

bash
curl -X POST http://{ip}:{puerto}/crear/factura/online \
  -H "Authorization: Bearer {tu_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "usuario": "juan_lopez",
    "returnQr": true,
    "documento": {
      "establecimiento": "001",
      "punto": "002",
      "numero": "0000123",
      "fecha": "2022-08-18T10:11:00",
      "tipoEmision": 1,
      "tipoTransaccion": 1,
      "tipoImpuesto": 1,
      "moneda": "PYG",
      "cambio": null,
      "codigoSeguridadAleatorio": 2,
      "cliente": { "contribuyente": false, "tipoOperacion": 2, "tipoContribuyente": 1, "pais": "PRY", "razonSocial": "Sin Nombre", "documentoTipo": 5, "documentoNumero": "0", "email": "correo@cliente.com" },
      "factura": { "presencia": 1 },
      "condicion": { "tipo": 1, "entregas": [{ "tipo": 1, "monto": 5500, "moneda": "PYG", "monedaDescripcion": "Guaranies", "cambio": 0 }] },
      "items": [
        { "codigo": "TEST001", "descripcion": "ARTICULO PRUEBA NRO 1", "unidadMedida": 77, "cantidad": 1.00, "precioUnitario": 5500, "descuento": 0, "ivaTipo": 1, "ivaBase": 100, "iva": 10 }
      ]
    }
  }'

Este ejemplo usa un cliente innominado para simplificar el primer request. El detalle completo de cada campo está en Factura y Ejemplos Clientes.

Paso 3 - Leer la respuesta ​

json
{
  "status": true,
  "requestId": "8bc559e0-0032-41d7-96fc-513650da9a39",
  "message": "La factura se ha generado y programado para su emisión a la SET.",
  "kude": {
    "CDC": "13241324132413241324132413241324132413241324",
    "formattedCDC": "1234 1234 1234 1234 1234 1234 1234 1234 1234 1234 12343544",
    "url": "https://ekuatia.set.gov.py/consultas/...",
    "base64": "data:image/gif;base64,..."
  }
}

Guardá el CDC - es el identificador del documento para todo lo que sigue (consultas, anulación, PDF, etc.). Si status viene en false, revisá Manejo de Errores.

Paso 4 - Consultar el estado del documento ​

bash
curl http://{ip}:{puerto}/consulta/estado/factura/13241324132413241324132413241324132413241324 \
  -H "Authorization: Bearer {tu_token}"
json
{
  "requestId": "1f8becb0-f4ee-4139-bc7f-ba064eb7c46d",
  "status": true,
  "found": true,
  "estado": "A",
  "codigoEstado": "APROBADO",
  "message": "Documento aprobado."
}

Próximos pasos ​

Copyright © 2026