Referencia API

Documentación completa de todos los endpoints de la API de ReKU, organizada por tipo de documento.

NOTE

Todos los endpoints requieren autenticación. Enviá el token como: Authorization: Bearer {token}

La URL base es http://{ip}:{puerto} - reemplazá con los datos de tu instancia.

Documentos Electrónicos (SIFEN)

Factura

Operación	Método	Ruta
Emitir factura por lote	POST	/crear/factura/lote
Emitir factura online (sincrónico)	POST	/crear/factura/online
Anular factura	POST	/anular/factura
Inutilizar factura	POST	/inutilizar/factura
Eliminar factura de la cola	POST	/eliminar/factura
Nominación de factura	POST	/evento/nominacion/factura

Auto Factura

Operación	Método	Ruta
Emitir auto factura por lote	POST	/crear/autofactura/lote
Emitir auto factura online (sincrónico)	POST	/crear/autofactura/online
Anular auto factura	POST	/anular/autofactura
Inutilizar auto factura	POST	/inutilizar/autofactura
Eliminar auto factura de la cola	POST	/eliminar/autofactura

Nota Crédito

Operación	Método	Ruta
Emitir nota de crédito por lote	POST	/crear/notacredito/lote
Emitir nota de crédito online (sincrónico)	POST	/crear/notacredito/online
Anular nota de crédito	POST	/anular/notacredito
Inutilizar nota de crédito	POST	/inutilizar/notacredito
Eliminar nota de crédito de la cola	POST	/eliminar/notacredito

Nota Débito

Operación	Método	Ruta
Emitir nota de débito por lote	POST	/crear/notadebito/lote
Emitir nota de débito online (sincrónico)	POST	/crear/notadebito/online
Anular nota de débito	POST	/anular/notadebito
Inutilizar nota de débito	POST	/inutilizar/notadebito
Eliminar nota de débito de la cola	POST	/eliminar/notadebito

Nota Remisión

Operación	Método	Ruta
Emitir nota de remisión por lote	POST	/crear/notaremision/lote
Emitir nota de remisión online (sincrónico)	POST	/crear/notaremision/online
Anular nota de remisión	POST	/anular/notaremision
Inutilizar nota de remisión	POST	/inutilizar/notaremision
Eliminar nota de remisión de la cola	POST	/eliminar/notaremision

Documentos Digitales

Recibo de Dinero

Operación	Método	Ruta
Crear recibo de dinero	POST	/crear/recibo
Anular recibo de dinero	POST	/anular/recibo

Utilidades

Consultas - Documentos

Operación	Método	Ruta
Consultar RUC	GET	/consulta/ruc/{nroDocumento}
Consultar documento por CDC	GET	/consulta/cdc/{nroCdc}
Consultar URL de documento	GET	/consulta/url/{tipoDocumento}/{nroCdc}
Consultar estado de documento	GET	/consulta/estado/{tipoDocumento}/{nroCdc}
Cola de documentos (con lote asignado)	GET	/consulta/cola/conlote/{tipoDocumento}/{cantidad}
Cola de documentos (sin lote asignado)	GET	/consulta/cola/sinlote/{tipoDocumento}/{cantidad}
Últimos documentos por estado	GET	/consulta/ultimos/{tipoDocumento}/{estado}/{cantidad}

Consultas - Sucursales

Operación	Método	Ruta
Consultar departamentos	GET	/consulta/sucursales/departamentos
Consultar distritos	GET	/consulta/sucursales/distritos
Consultar ciudades	GET	/consulta/sucursales/ciudades

PDF y QR

Operación	Método	Ruta
Generar PDF de documento	GET	/generar/pdf/{tipoDocumento}/{estado}
Generar código QR	GET	/generar/qr
Consultar XML de un documento	GET	/generar/xml/{tipoDocumento}/{estado}

Reenvío de Correo

Operación	Método	Ruta
Reenviar factura por correo	POST	/reenvio/documento/factura
Reenviar nota de crédito por correo	POST	/reenvio/documento/notacredito
Reenviar nota de débito por correo	POST	/reenvio/documento/notadebito
Reenviar recibo de dinero por correo	POST	/reenvio/documento/recibo

Certificado

Operación	Método	Ruta
Detalles del certificado digital	GET	/server/certificado/detalles
Expiración del certificado	GET	/server/certificado/expiracion

Empresas - Sucursales

Operación	Método	Ruta
Listar sucursales	GET	/empresa/sucursales
Registrar sucursal	POST	/empresa/sucursales
Actualizar sucursal	PATCH	/empresa/sucursales/{codigo}

Patrones de respuesta

Todas las operaciones de emisión retornan:

{
  "status": true,
  "requestId": "uuid-del-request",
  "message": "Descripción del resultado",
  "kude": {
    "CDC": "44 dígitos",
    "formattedCDC": "CDC formateado",
    "url": "https://ekuatia.set.gov.py/consultas/...",
    "base64": "QR en base64 (si returnQr: true)"
  }
}

Los eventos sincrónicos (anulación, inutilización, nominación) retornan:

{
  "requestId": "uuid-del-request",
  "status": true,
  "message": "Descripción del resultado"
}