Consultas

Consultar RUC

• [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

• [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

• [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

• [GET] ip:puerto/consulta/estado/{tipo_documento}/{nro_documento}

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}
• [GET] ip:puerto/consulta/ultimos/{tipo_documento}/estado/{cantidad}

tipo_documento: factura, notacredito, notadebito, notaremision

Ejemplos de la 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"
  ]
}