/ Consultas y datos

Consultas

Consulta el estado oficial de un comprobante en SUNAT, recupera un CDR y busca datos por RUC o DNI.

Consultar un comprobante

GET/consultar-cpe

Verifica en SUNAT el estado real de un comprobante, propio o de un proveedor. Requiere las credenciales de API de SUNAT (client_id y client_secret) configuradas en tu empresa, generadas en Clave SOL con la URI «Consulta Integrada CPE».

Parámetros de consulta

ruc_emisorstring: RUC del emisor. Por defecto, el de tu empresa.
tipo_docstringObligatorio: 01, 03, 04, 07, 08, R1 o R7.
seriestringObligatorio: 4 caracteres.
correlativointegerObligatorio: Número del comprobante.
fecha_emisionstringObligatorio: Formato dd/mm/yyyy.
montonumberObligatorio: Total del comprobante.

Estado del comprobante (estado_cp)

Código	Significado
0	No existe: no fue informado
1	Aceptado
2	Anulado
3	Autorizado (imprenta)
4	No autorizado (imprenta)

SUNAT solo permite consultar comprobantes en los que tu RUC participó como emisor o receptor.

curl "https://apifact.gavi-cloud.com/api/v1/consultar-cpe?tipo_doc=01&serie=F001&correlativo=123&fecha_emision=02/10/2026&monto=5900.00" \
  -H "X-Api-Key: TU_API_KEY" \
  -H "X-Api-Secret: TU_API_SECRET"

Respuesta200 OK

{
  "estado": "exito",
  "datos": {
    "encontrado": true,
    "estado_cp": "1",
    "estado_cp_descripcion": "ACEPTADO",
    "estado_ruc": "00",
    "estado_ruc_descripcion": "ACTIVO",
    "cond_domi_ruc": "00",
    "cond_domi_ruc_descripcion": "HABIDO"
  }
}

Recuperar un CDR

POST/consultar-cdr

Si perdiste el CDR de un comprobante, esta consulta lo obtiene de nuevo desde SUNAT. Si lo tienes guardado, usa GET /facturas/{id}/cdr.

tipo_documentostringObligatorio: 01, 03, 07 u 08.
seriestringObligatorio: 4 caracteres.
correlativointegerObligatorio: Número del comprobante.

curl -X POST "https://apifact.gavi-cloud.com/api/v1/consultar-cdr" \
  -H "X-Api-Key: TU_API_KEY" \
  -H "X-Api-Secret: TU_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "tipo_documento": "01",
    "serie": "F001",
    "correlativo": 123
  }'

Respuesta200 OK

{
  "estado": "exito",
  "datos": {
    "accepted": true,
    "code": "0",
    "description": "La Factura numero F001-123 ha sido aceptada",
    "notes": [],
    "cdr_base64": "UEsDBBQAAAgI..."
  }
}

Buscar por RUC o DNI

GET/buscar-documento

Obtiene la razón social y la dirección de un RUC o el nombre de un DNI para llenar el cliente de tu comprobante. Primero busca en tus clientes guardados y, si no existe, consulta SUNAT o RENIEC. El campo fuente indica el origen (local o sunat).

tipostringObligatorio: 6 RUC, 1 DNI, 4, 7 o 0.
numerostringObligatorio: Número del documento.

Responde 404 si no existe.

curl "https://apifact.gavi-cloud.com/api/v1/buscar-documento?tipo=6&numero=20555666777" \
  -H "X-Api-Key: TU_API_KEY" \
  -H "X-Api-Secret: TU_API_SECRET"

Respuesta200 OK

{
  "estado": "exito",
  "datos": {
    "tipo_doc": "6",
    "num_doc": "20555666777",
    "razon_social": "ACME CORP SAC",
    "direccion": "JR. ACME 456",
    "fuente": "sunat"
  }
}