Appearance

Consultas ​

Consultar RUC ​

Obtener información básica del contribuyente según la base de datos de Marangatú


GET ip:puerto/consulta/ruc/{nroDocumento} *sin dígito verificador

Ejemplos de la respuesta ​

json
{
  "status": true,
  "found": false,
  "requestId": "4055fd8a-f79b-404c-b7e3-39990b688ff9",
  "message": "[0500] RUC no existe"
}
json
{
  "status": true,
  "found": true,
  "requestId": "4055fd8a-f79b-404c-b7e3-39990b688ff9",
  "message": "Dato encontrado",
  "data": {
    "ruc": 123456,
    "razon_social": "Nombre Empresa SRL",
    "estado": "ACTIVO",
    "factElec": "N"
  }
}

Referencia API: consultarRuc

Consultar documento por CDC ​

Consultar a la SIFEN por un documento electrónico por número de CDC


GET ip:puerto/consulta/cdc/{nroCdc}

Ejemplos de la respuesta ​

json
{
  "status": true,
  "found": false,
  "requestId": "4055fd8a-f79b-404c-b7e3-39990b688ff9",
  "message": "[0500] Documento No Existe en SIFEN o ha sido Rechazado"
}
json
{
  "status": true,
  "found": false,
  "requestId": "4055fd8a-f79b-404c-b7e3-39990b688ff9",
  "message": "Dato encontrado",
  "data": {
    "cod": "0422",
    "message": "CDC Encontrado",
    "fechaProcesado": "2024-06-27T16:54:53-04:00",
    "xml": "el contenido del XML recibido por la SIFEN"
  }
}

Referencia API: consultarCdc

Consultar URL de documento ​

Consultar en ReKU el enlace (a SIFEN) de un documento electrónico por número de CDC


GET ip:puerto/consulta/url/{tipoDocumento}/{nroCdc}

tipoDocumento: factura, notacredito, notadebito

Ejemplos de la respuesta ​

json
{
  "status": true,
  "found": false,
  "requestId": "4055fd8a-f79b-404c-b7e3-39990b688ff9",
  "message": "No se encontró el documento con el CDC indicado"
}
json
{
  "status": true,
  "found": true,
  "rechazado": false,
  "anulado": false,
  "message": "Documento Encontrado",
  "hasUrl": true,
  "data" : {
    "url": "https://ekuatia.set.gov.py/...",
    "base64": "data:image/gif;base64,... base64 del qr para el enlace"
  }
}

⚠️ En caso de no poder obtener el enlace del documento, se remitirá el enlace default del módulo de consultas de documentos de la SIFEN

Referencia API: consultarUrlDocumento

Consultar estado de documento ​

Consultar el estado actual de un documento enviado a ReKU por número de CDC


GET ip:puerto/consulta/estado/{tipoDocumento}/{nroCdc}

tipoDocumento: factura, notacredito, notadebito, notaremision, autofactura

Códigos de estados: ​

  • Aprobado: A
  • Inutilizado: I
  • Anulado: C
  • Rechazado: R
  • En Cola: P
  • No Encontrado: X (la única opción que puede devolver found: false)

Ejemplos de la respuesta ​

🔴 No encontrado

json
{
  "requestId": "1f8becb0-f4ee-4139-bc7f-ba064eb7c46d",
  "status": true,
  "found": false,
  "estado": "X",
  "codigoEstado": "NO_ENCONTRADO",
  "message": "No se encontró ese número de {nombre_tipo_documento}"
}

⌛ En cola

json
{
  "requestId": "1f8becb0-f4ee-4139-bc7f-ba064eb7c46d",
  "status": true,
  "found": true,
  "estado": "P",
  "codigoEstado": "PENDIENTE",
  "message": "El documento aún está en cola de procesado."
}

🟠 Anulado

json
{
  "requestId": "1f8becb0-f4ee-4139-bc7f-ba064eb7c46d",
  "status": true,
  "found": true,
  "estado": "C",
  "codigoEstado": "ANULADO",
  "message": "El documento ha sido anulado con anterioridad."
}

🔵 Inutilizado

json
{
  "requestId": "1f8becb0-f4ee-4139-bc7f-ba064eb7c46d",
  "status": true,
  "found": true,
  "estado": "I",
  "codigoEstado": "INUTILIZADO",
  "message": "El documento ha sido inutilizado con anterioridad."
}

🟢 Aprobado

json
{
  "requestId": "1f8becb0-f4ee-4139-bc7f-ba064eb7c46d",
  "status": true,
  "found": true,
  "estado": "A",
  "codigoEstado": "APROBADO",
  "message": "Documento aprobado."
}

❌ Rechazado

json
{
  "requestId": "1f8becb0-f4ee-4139-bc7f-ba064eb7c46d",
  "status": true,
  "found": true,
  "estado": "R",
  "codigoEstado": "RECHAZADO",
  "message": "El documento ha sido rechazado por la SIFEN",
  "motivo": "[xxxx] motivo del rechazo según SIFEN"
}

Referencia API: consultarEstadoDocumento

Consultar cola de documentos ​

Para recuperar los últimos documentos (hasta 200) que se encuentren en cola


GET ip:puerto/consulta/cola/{estadoCola}/{tipoDocumento}/{cantidad}

estadoCola: sinlote, conlote
tipoDocumento: factura, notacredito, notadebito, notaremision, autofactura

Ejemplos de la respuesta ​

json
{
  "requestId": "92eb0f85-9922-4b18-b6cf-3a3115ed9a02",
  "status": true,
  "found": false,
  "data": [],
  "message": "[ReKU] No se encontraron documentos pendientes"
}
json
{
  "requestId": "b617bec6-b95a-4977-b5e6-c75c23b027e3",
  "status": true,
  "found": true,
  "message": "[ReKU] Documentos recuperados",
  "data": [
    "12341234123412341234123412341234123412341234",
    "12341234123412341234123412341234123412341235",
    "12341234123412341234123412341234123412341236"
  ]
}

Referencia API: consultarColaConLote · consultarColaSinLote

Consultar últimos documentos ​

Para recuperar los últimos documentos (hasta 200) según el estado


GET ip:puerto/consulta/ultimos/{tipoDocumento}/{estado}/{cantidad}

tipoDocumento: factura, notacredito, notadebito, notaremision, autofactura
estado: aprobado, anulado, inutilizado, rechazado

Ejemplos de la respuesta ​

json
{
  "requestId": "a8ff3a30-1158-4dcc-965d-9dd1b7d4ddbc",
  "status": false,
  "found": false,
  "data": [],
  "message": "[ReKU] No se encontraron documentos con el estado solicitado"
}
json
{
  "requestId": "a8ff3a30-1158-4dcc-965d-9dd1b7d4ddbc",
  "status": false,
  "found": false,
  "message": "[ReKU] Documentos recuperados",
  "data": [
    "12341234123412341234123412341234123412341234",
    "12341234123412341234123412341234123412341235",
    "12341234123412341234123412341234123412341236"
  ]
}

Referencia API: consultarUltimosDocumentos

Copyright © 2026