Consultas

El campo status sirve como indicador para en caso que el dato enviado no cumpliese alguna validación (o en el caso de consulta de RUC y CDC, si hubiere inconvenientes con la SIFEN para obtener los datos solicitados)

Consultar RUC

Endpoint

• GET ip:puerto/consulta/ruc/[nro_documento] (sin dígito verificador)

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 CDC

Endpoint

• GET ip:puerto/consulta/cdc/[nro_cdc]

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

Consulta URL de documento

Endpoint

• GET ip:puerto/consulta/url//[nro_cdc]

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

Consulta de estado de documento

Endpoint

• GET ip:puerto/consulta/estado//[nro_cdc]

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)

Consulta cola de documentos

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

Endpoint

• GET ip:puerto/consulta/cola/conlote//[cantidad]

• GET ip:puerto/consulta/cola/sinlote//[cantidad]

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

Consulta últimos documentos

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

Endpoint

• GET ip:puerto/consulta/ultimos///[cantidad]

Respuesta

{
  "requestId": "a8ff3a30-1158-4dcc-965d-9dd1b7d4ddbc",
  "status": false,
  "found": false,
  "data": [],
  "message": "[ReKU] No se encontraron documentos pendientes sin nro de lote"
}

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