Consultas

Consultar RUC

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

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

Ejemplos de la respuesta

{
  "status": true,
  "found": false,
  "requestId": "4055fd8a-f79b-404c-b7e3-39990b688ff9",
  "message": "[0500] RUC no existe"
}

{
  "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"
  }
}

Consultar documento por CDC

Obtener el XML de un documento electrónico (aprobado por la SIFEN) por número de CDC

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

Ejemplos de la respuesta

{
  "status": true,
  "found": false,
  "requestId": "4055fd8a-f79b-404c-b7e3-39990b688ff9",
  "message": "[0500] Documento No Existe en SIFEN o ha sido Rechazado"
}

{
  "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"
  }
}

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/{tipo_documento}/{nro_cdc}

tipo_documento: factura, notacredito, notadebito

Ejemplos de la respuesta

{
  "status": true,
  "found": false,
  "requestId": "4055fd8a-f79b-404c-b7e3-39990b688ff9",
  "message": "No se encontró el documento con el CDC indicado"
}

{
  "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

Consultar estado de documento

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

GET ip:puerto/consulta/estado/{tipo_documento}/{nro_cdc}

tipo_documento: factura, notacredito, notadebito, notaremision

Ejemplos de la respuesta

{
  "requestId": "1f8becb0-f4ee-4139-bc7f-ba064eb7c46d",
  "status": true,
  "found": true | false,
  "estado": "A",
  "message": "Documento encontrado."
}

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)

Consultar cola de documentos

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

GET ip:puerto/consulta/cola/conlote/{tipo_documento}/{cantidad}
GET ip:puerto/consulta/cola/sinlote/{tipo_documento}/{cantidad}

tipo_documento: factura, notacredito, notadebito, notaremision

Ejemplos de la respuesta

{
  "requestId": "92eb0f85-9922-4b18-b6cf-3a3115ed9a02",
  "status": true,
  "found": false,
  "data": [],
  "message": "[ReKU] No se encontraron documentos pendientes con/sin nro de lote."
}

{
  "requestId": "b617bec6-b95a-4977-b5e6-c75c23b027e3",
  "status": true,
  "found": true,
  "message": "[ReKU] Documentos recuperados",
  "data": [
    "12341234123412341234123412341234123412341234",
    "12341234123412341234123412341234123412341235",
    "12341234123412341234123412341234123412341236"
  ]
}

Consultar últimos documentos

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

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

tipo_documento: factura, notacredito, notadebito, notaremision
estado: aprobado, anulado, inutilizado, rechazado

Ejemplos de la respuesta

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

{
  "requestId": "a8ff3a30-1158-4dcc-965d-9dd1b7d4ddbc",
  "status": false,
  "found": false,
  "message": "[ReKU] Documentos recuperados",
  "data": [
    "12341234123412341234123412341234123412341234",
    "12341234123412341234123412341234123412341235",
    "12341234123412341234123412341234123412341236"
  ]
}