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 a la SIFEN por un documento electrónico 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 XML de un documento

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

tipo_documento: factura, autofactura notacredito, notadebito, notaremision
estado: aprobada, anulada, rechazada, encola

Estructura del content body

📄 Documentos electrónicos

{
  "cdc" : "12341234123412341234123412341234123412341234"
}

Ejemplo de la respuesta

{
  "status" : true,
  "requestId" : "4055fd8a-f79b-404c-b7e3-39990b688ff9",
  "data" : "contenido del xml"
}

{
  "status" : false,
  "requestId" : "4055fd8a-f79b-404c-b7e3-39990b688ff9",
  "message" : "Motivo del error"
}

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, 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
{
  "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
{
  "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
{
  "requestId": "1f8becb0-f4ee-4139-bc7f-ba064eb7c46d",
  "status": true,
  "found": true,
  "estado": "C",
  "codigoEstado": "ANULADO",
  "message": "El documento ha sido anulado con anterioridad."
}

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

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

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

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, autofactura

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, autofactura
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"
  ]
}