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:

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:

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

{
  "status": true,
  "requestId": "b617bec6-b95a-4977-b5e6-c75c23b027e3",
  "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

curl http://{ip}:{puerto}/consulta/estado/factura/13241324132413241324132413241324132413241324 \
  -H "Authorization: Bearer {tu_token}"

{
  "requestId": "b617bec6-b95a-4977-b5e6-c75c23b027e3",
  "status": true,
  "found": true,
  "estado": "A",
  "codigoEstado": "APROBADO",
  "message": "Documento aprobado."
}

Próximos pasos

• Manejo de Errores - cómo interpretar status, found y los códigos HTTP
• Parámetros SIFEN - catálogos de valores para cada campo (tipos de impuesto, formas de pago, unidades de medida, etc.)
• Referencia API - esquema completo de cada operación
• Documentos Electrónicos - Auto Factura, Nota Crédito/Débito, Nota Remisión