Para qué sirve
- Validar cada factura de proveedor antes de registrarla y pagarla.
- Detectar comprobantes anulados o inexistentes en tu registro de compras.
- Revisar en lote los comprobantes recibidos al cierre de mes.
- Confirmar que tus propias ventas figuran correctamente en SUNAT.
- Automatizar la recepción de facturas en un ERP o sistema contable.
Qué devuelve la validación
Envías los datos que figuran en el comprobante: RUC del emisor (numRuc), tipo (codComp, por ejemplo 01 factura), serie, número, fecha de emisión, monto total y, si aplica, el documento del receptor. La respuesta, dentro de data, trae tres verificaciones:
| Campos | Qué indican |
|---|---|
estadoCp / estadoCpDesc | Estado del comprobante a la fecha de la consulta, por ejemplo ACEPTADO, ANULADO o que no existe. |
estadoRuc / estadoRucDesc | Estado del contribuyente emisor a la fecha de emisión, por ejemplo ACTIVO. |
condDomiRuc / condDomiRucDesc | Condición de domicilio del emisor a la fecha de emisión, por ejemplo HABIDO. |
Además recibes textos listos para mostrar (estadoComprobanteTexto, estadoContribuyenteTexto, condicionDomicilioTexto), descripciones del tipo de comprobante y de documento, un arreglo observaciones y un objeto desglose que explica cada código. Para la lógica de tu sistema usa los campos de descripción (...Desc) en lugar de interpretar los códigos a mano.
Comprobantes emitidos y recibidos
Los endpoints de emitidos (ventas) y recibidos (compras) consultan un comprobante concreto de tu propio RUC indicando tipo, RUC, serie y número en la URL. El tipo admite, entre otros, factura, boleta, factura-nc, factura-nd, recibo-honorario, percepcion y retencion.
Para usarlos primero debes configurar la sincronización con SUNAT en el panel admin.miapi.cloud con tus credenciales SOL. Sin esa configuración, estos endpoints no pueden traer información.
Cómo empezar
- Crea tu cuenta gratis en miapi.cloud; el plan gratuito te permite probar sin tarjeta.
- Copia tu token desde el panel admin.miapi.cloud.
- Envíalo en cada petición en la cabecera
Authorization: Bearer TU_TOKEN, siempre por HTTPS.
Para la validación, copia los datos exactamente como aparecen en el comprobante: fecha en formato dd/mm/aaaa y monto con dos decimales. Un dígito distinto en el monto o la fecha puede hacer que el comprobante no se encuentre.
La cantidad de consultas disponibles depende de tu plan; revisa los planes en miapi.cloud/#planes. Si tienes dudas para integrarla, escríbenos por WhatsApp.
Buenas prácticas
- Valida antes de enviar: RUC de 11 dígitos, serie de 4 caracteres, número sin ceros sobrantes, fecha válida y monto numérico.
- Valida al recibir y otra vez al cierre: un comprobante aceptado puede ser dado de baja después por el emisor.
- Guarda el resultado con la fecha de la consulta como evidencia de tu revisión.
- Reintenta solo los 5xx; si el comprobante no existe, contacta al proveedor.
Guarda el token en el servidor, en una variable de entorno o en tu gestor de secretos. No lo pongas en el código de una página web ni en una app móvil: cualquiera podría leerlo y gastar tus consultas. Si sospechas que se filtró, genera uno nuevo desde el panel.
Para revisar también al proveedor, usa la API de consulta RUC; y si recibes el XML, conviértelo en PDF legible con la API XML a PDF.
Referencia de la API
Todas las peticiones llevan tu token en la cabecera Authorization: Bearer TU_TOKEN.
Lo copias desde tu panel en admin.miapi.cloud después de
crear tu cuenta gratis. Más detalles en la documentación.
Validar comprobante (CPE)
Valida ante SUNAT el estado de un comprobante electrónico emitido.
POST https://miapi.cloud/v1/validarcpe
curl -X POST "https://miapi.cloud/v1/validarcpe" \
-H "Authorization: Bearer TU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"numRuc":"20000000001","codComp":"01","numeroSerie":"F001","numero":"1","fechaEmision":"01/01/2026","monto":"118.00","codDocRecep":"6","numDocRecep":"20000000002"}'const respuesta = await fetch("https://miapi.cloud/v1/validarcpe", {
method: "POST",
headers: {
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
body: JSON.stringify({
"numRuc": "20000000001",
"codComp": "01",
"numeroSerie": "F001",
"numero": "1",
"fechaEmision": "01/01/2026",
"monto": "118.00",
"codDocRecep": "6",
"numDocRecep": "20000000002"
}),
});
const datos = await respuesta.json();
console.log(datos);<?php
$ch = curl_init("https://miapi.cloud/v1/validarcpe");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer TU_TOKEN",
"Content-Type: application/json"
],
CURLOPT_POSTFIELDS => json_encode([
"numRuc" => "20000000001",
"codComp" => "01",
"numeroSerie" => "F001",
"numero" => "1",
"fechaEmision" => "01/01/2026",
"monto" => "118.00",
"codDocRecep" => "6",
"numDocRecep" => "20000000002"
]),
]);
$datos = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($datos);import requests
respuesta = requests.post(
"https://miapi.cloud/v1/validarcpe",
headers={
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
json={
"numRuc": "20000000001",
"codComp": "01",
"numeroSerie": "F001",
"numero": "1",
"fechaEmision": "01/01/2026",
"monto": "118.00",
"codDocRecep": "6",
"numDocRecep": "20000000002"
},
timeout=30,
)
print(respuesta.json()) {
"data": {
"numero": "1",
"numeroSerie": "F001",
"codComp": "01",
"fechaEmision": "01/01/2026",
"numRuc": "20000000001",
"codDocRecep": "6",
"numDocRecep": "20000000002",
"monto": "118.00",
"estadoCp": "1",
"estadoRuc": "00",
"condDomiRuc": "00",
"observaciones": [],
"estadoCpDesc": "ACEPTADO",
"estadoCpDetalle": "ACEPTADO (Válido)",
"estadoRucDesc": "ACTIVO",
"condDomiRucDesc": "HABIDO",
"codCompDesc": "Factura",
"codDocRecepDesc": "RUC",
"estadoComprobanteTexto": "Estado del comprobante a la fecha de la consulta : ACEPTADO",
"estadoContribuyenteTexto": "Estado del contribuyente a la fecha de emisión : ACTIVO",
"condicionDomicilioTexto": "Condición de domicilio a la fecha de emisión : HABIDO",
"desglose": {
"estadoComprobante": "estadoCp: '1' (ACEPTADO)",
"estadoContribuyente": "estadoRuc: '00' (ACTIVO)",
"condicionDomicilio": "condDomiRuc: '00' (HABIDO)",
"tipoComprobante": "codComp: '01' (Factura)",
"tipoDocReceptor": "codDocRecep: '6' (RUC)"
}
},
"rpta": 1
} Consultas SUNAT - Comprobantes emitidos (ventas)
Consulta un comprobante emitido por tu RUC; requiere configurar antes la sincronización con tus credenciales SOL en el panel.
GET https://miapi.cloud/v1/emitido/{tipo}/{ruc}-{serie}-{numero}
curl -X GET "https://miapi.cloud/v1/emitido/01/20000000001-F001-1" \
-H "Authorization: Bearer TU_TOKEN" \
-H "Accept: application/json"const respuesta = await fetch("https://miapi.cloud/v1/emitido/01/20000000001-F001-1", {
method: "GET",
headers: {
"Authorization": "Bearer TU_TOKEN",
"Accept": "application/json"
},
});
const datos = await respuesta.json();
console.log(datos);<?php
$ch = curl_init("https://miapi.cloud/v1/emitido/01/20000000001-F001-1");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer TU_TOKEN",
"Accept: application/json"
],
]);
$datos = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($datos);import requests
respuesta = requests.get(
"https://miapi.cloud/v1/emitido/01/20000000001-F001-1",
headers={
"Authorization": "Bearer TU_TOKEN",
"Accept": "application/json"
},
timeout=30,
)
print(respuesta.json()) Consultas SUNAT - Comprobantes recibidos (compras)
Consulta un comprobante recibido de un proveedor; requiere la sincronización SUNAT configurada.
GET https://miapi.cloud/v1/recibido/{tipo}/{ruc}-{serie}-{numero}
curl -X GET "https://miapi.cloud/v1/recibido/01/20000000001-F001-1" \
-H "Authorization: Bearer TU_TOKEN" \
-H "Accept: application/json"const respuesta = await fetch("https://miapi.cloud/v1/recibido/01/20000000001-F001-1", {
method: "GET",
headers: {
"Authorization": "Bearer TU_TOKEN",
"Accept": "application/json"
},
});
const datos = await respuesta.json();
console.log(datos);<?php
$ch = curl_init("https://miapi.cloud/v1/recibido/01/20000000001-F001-1");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer TU_TOKEN",
"Accept: application/json"
],
]);
$datos = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($datos);import requests
respuesta = requests.get(
"https://miapi.cloud/v1/recibido/01/20000000001-F001-1",
headers={
"Authorization": "Bearer TU_TOKEN",
"Accept": "application/json"
},
timeout=30,
)
print(respuesta.json()) Errores frecuentes
| Código | Qué significa |
|---|---|
401 | Token ausente o inválido. Revisa la cabecera Authorization: Bearer TU_TOKEN. |
404 / 422 | Faltan datos, tienen un formato inválido o el comprobante no se encontró. Revisa RUC, tipo, serie, número, fecha y monto. |
429 | Alcanzaste el límite de consultas de tu plan o enviaste demasiadas peticiones seguidas. |
5xx | El servicio de SUNAT no está disponible o no respondió. Reintenta con espera progresiva. |
Preguntas frecuentes
¿Qué datos necesito para validar un comprobante?
El RUC del emisor, el tipo de comprobante, la serie, el número, la fecha de emisión y el monto total; para facturas, también el tipo y número de documento del receptor.
¿Qué significa que un comprobante esté ACEPTADO?
Que SUNAT lo tiene registrado como válido a la fecha de la consulta. Si figura como anulado o no existe, no deberías registrarlo sin aclararlo con el emisor.
¿Por qué una factura real no aparece?
Lo más común es una diferencia en la fecha, el monto o el número. Revisa que coincidan exactamente con el comprobante. Si todo coincide, consulta al emisor si lo envió a SUNAT.
¿Necesito mi clave SOL?
Para validar comprobantes de terceros, no. Para consultar los comprobantes emitidos o recibidos de tu RUC sí debes configurar la sincronización con tus credenciales SOL en el panel.
¿Puedo probarla gratis?
Sí, con el plan gratuito al registrarte en miapi.cloud. Los límites dependen de tu plan; revísalos en miapi.cloud/#planes.
APIs relacionadas
-
API RUC
Consulta razón social, estado, condición y domicilio fiscal de cualquier RUC de 11 dígitos, con versiones detallada y completa de la ficha tributaria y consulta masiva.
-
API XML a PDF
Convierte el XML de tus comprobantes electrónicos en una representación impresa en PDF, en formato A4 o ticket, uno por uno o varios a la vez en un ZIP.
-
API Facturación Electrónica
Emite facturas y boletas electrónicas desde tu propio software: envías los datos en JSON, generamos y firmamos el XML y lo enviamos a SUNAT.
Empieza gratis hoy
Crea tu cuenta gratis, copia tu token y haz tu primera consulta en minutos. Sin tarjeta de crédito.