Buscar y validar comprobante electrónico

POST /api/consultas/search

Endpoint público para consulta y descarga de comprobantes electrónicos (factura, boleta, nota). Retorna enlaces de descarga de XML, PDF y CDR emitidos ante SUNAT.

Autenticación: ninguna.

Debes enviar ruc_emisor o tenant_slug para identificar al emisor.

Cuerpo

Content-Type: application/json

{
  "ruc_emisor": "20601234567",
  "series": "F001",
  "number": "142",
  "customer_number": "20555555551",
  "total": 118.00,
  "date_of_issue": "2026-09-12"
}

Respuestas

200 — Búsqueda realizada

{
  "success": true,
  "message": "Comprobante encontrado",
  "data": [
    {
      "customer": "20555555551",
      "number": "F001-142",
      "total": "118.00",
      "download_xml": "https://miempresa.pro.uio.la/downloads/document/xml/abc-123",
      "download_pdf": "https://miempresa.pro.uio.la/downloads/document/pdf/abc-123",
      "download_cdr": "https://miempresa.pro.uio.la/downloads/document/cdr/abc-123"
    }
  ]
}

Nombre en el SDK

El cuerpo de la consulta es el JSON de la sección Cuerpo. Si instalas el paquete generado en sdks/, esa misma petición es el método consultaPublicaDeComprobantes.