Consulta CPE/Validar Comprobante

Validar Comprobante

Verifica si un comprobante electrónico existe y está registrado en SUNAT. Retorna el estado del comprobante y del contribuyente emisor.

POST/api/v1/sunat/consulta/validar

Parámetros del Body

Parámetros

NombreTipoDescripción
ruc_emisorrequeridostringRUC del emisor del comprobante (11 dígitos)
tipo_comprobanterequeridostringTipo de documento: "01" (Factura), "03" (Boleta), "07" (NC), "08" (ND)
serierequeridostringSerie del comprobante (4 caracteres). Ej: "F001", "B001"
numerorequeridostringNúmero correlativo (1-8 dígitos). Ej: "00001234"
fecha_emisionrequeridostringFecha de emisión en formato DD/MM/YYYY. Ej: "15/01/2024"
montorequeridostringMonto total del comprobante con 2 decimales. Ej: "1500.00"

Ejemplo de Código

1curl -X POST \
2  "https://api.integracpe.com/api/v1/sunat/consulta/validar" \
3  -H "Authorization: Bearer sk_live_tu_api_key" \
4  -H "Content-Type: application/json" \
5  -d '{
6    "ruc_emisor": "20123456789",
7    "tipo_comprobante": "01",
8    "serie": "F001",
9    "numero": "00001234",
10    "fecha_emision": "15/01/2024",
11    "monto": "1500.00"
12  }'

Respuestas

Comprobante Aceptado

200 OK
{
  "success": true,
  "estado_comprobante": "ACEPTADO",
  "estado_comprobante_codigo": "1",
  "estado_ruc": "ACTIVO",
  "estado_ruc_codigo": "00",
  "condicion_domicilio": "HABIDO",
  "condicion_domicilio_codigo": "00",
  "ruc_emisor": "20123456789",
  "comprobante": "01-F001-00001234"
}

Comprobante No Existe

200 OK
{
  "success": true,
  "estado_comprobante": "NO_EXISTE",
  "estado_comprobante_codigo": "0",
  "estado_ruc": "ACTIVO",
  "estado_ruc_codigo": "00",
  "condicion_domicilio": "HABIDO",
  "condicion_domicilio_codigo": "00",
  "ruc_emisor": "20123456789",
  "comprobante": "01-F001-99999999"
}

Estados del Comprobante

CódigoEstadoDescripción
0NO_EXISTEEl comprobante no está registrado en SUNAT.
1ACEPTADOEl comprobante fue aceptado y es válido.
2ANULADOEl comprobante fue anulado por el emisor.

Estados del RUC (Emisor)

Estado del Contribuyente

CódigoEstado
00ACTIVO
01BAJA PROVISIONAL
02BAJA DEFINITIVA
03SUSPENSIÓN TEMPORAL

Condición del Domicilio

CódigoCondición
00HABIDO
09PENDIENTE
11POR VERIFICAR
12NO HABIDO

Campos de Respuesta

CampoTipoDescripción
successbooleanIndica si la petición fue exitosa
estado_comprobantestringACEPTADO, NO_EXISTE o ANULADO
estado_comprobante_codigostringCódigo numérico: 0, 1 o 2
estado_rucstringEstado del contribuyente emisor
estado_ruc_codigostringCódigo del estado del RUC
condicion_domiciliostringCondición del domicilio fiscal
condicion_domicilio_codigostringCódigo de la condición
ruc_emisorstringRUC del emisor consultado
comprobantestringIdentificador: TIPO-SERIE-NUMERO

Sin Clave SOL

Este endpoint no requiere credenciales SUNAT del usuario. Usa autenticación OAuth2 interna con SUNAT.

Datos exactos requeridos

Los 6 campos del body deben coincidir exactamente con los datos del comprobante original. Un error en cualquier campo resultará en NO_EXISTE.

Limitación

Este endpoint solo retorna estados de validación. No devuelve razón social, dirección fiscal ni detalles del comprobante.
Consulta CPEErrores