Para qué sirve
- Anular facturas emitidas por error desde tu propio sistema.
- Enviar cada día el resumen de boletas de tu punto de venta.
- Informar la anulación de boletas dentro del resumen diario.
- Consultar automáticamente el estado de los tickets pendientes.
- Llevar un registro de qué bajas y resúmenes aceptó SUNAT.
Cómo funcionan: envío y ticket
A diferencia de una factura, la comunicación de baja y el resumen diario se procesan de forma asíncrona:
- Envías el documento y SUNAT responde con un ticket.
- Más tarde consultas el estado con ese ticket.
- Cuando SUNAT termina de procesarlo, la consulta devuelve el resultado y la CDR.
Si la consulta indica que sigue en proceso, vuelve a consultar después de un rato. Guarda siempre el ticket: sin él no podrás conocer el resultado.
Comunicación de baja (RA) y resumen diario (RC)
| Documento | tipodoc | Para qué sirve |
|---|---|---|
| Comunicación de baja | RA | Informa la anulación de facturas y documentos vinculados. Cada ítem indica tipo, serie, correlativo y motivo. |
| Resumen diario | RC | Informa de forma consolidada las boletas y sus notas vinculadas, con moneda, importe total, operaciones gravadas, IGV y documento del cliente. También se usa para informar la anulación de boletas. |
En la cabecera, la serie es la fecha en formato aaaammdd y el correlativo es el número de envío de ese día. fechaEmision es la fecha de los comprobantes informados y fechaEnvio, la fecha en que generas el documento.
SUNAT fija plazos y condiciones para dar de baja un comprobante y para enviar el resumen diario. Revisa la normativa vigente: si un comprobante ya no puede darse de baja, normalmente corresponde una nota de crédito.
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.
Prueba en beta: emite una factura de ejemplo, envía una comunicación de baja que la incluya, guarda el ticket y consulta su estado hasta obtener la respuesta.
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
- Guarda cada ticket con el documento al que pertenece y su estado.
- Consulta el estado con espera: no lo hagas en un bucle continuo; programa reintentos espaciados.
- Controla el correlativo diario de RA y RC para no repetir números.
- Envía el resumen diario de forma automática al cierre de caja, con una tarea programada.
- Verifica el resultado con la API para validar comprobantes.
Llama a estos endpoints solo desde tu servidor: llevan tu token y tu clave secreta.
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.
Envío de Comunicación de Bajas
Informa a SUNAT la anulación de comprobantes (RA para facturas, RC para boletas).
POST https://miapi.cloud/apifact/voided/send
curl -X POST "https://miapi.cloud/apifact/voided/send" \
-H "Authorization: Bearer TU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"claveSecreta":"TU_CLAVE_SECRETA","cabecera":{"tipodoc":"RA","serie":"20240101","correlativo":"1","fechaEmision":"2024-01-01","fechaEnvio":"2024-01-01"},"items":[{"tipodoc":"01","serie":"F001","correlativo":"1","motivo":"ERROR EN DATOS"}]}'const respuesta = await fetch("https://miapi.cloud/apifact/voided/send", {
method: "POST",
headers: {
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
body: JSON.stringify({
"claveSecreta": "TU_CLAVE_SECRETA",
"cabecera": {
"tipodoc": "RA",
"serie": "20240101",
"correlativo": "1",
"fechaEmision": "2024-01-01",
"fechaEnvio": "2024-01-01"
},
"items": [
{
"tipodoc": "01",
"serie": "F001",
"correlativo": "1",
"motivo": "ERROR EN DATOS"
}
]
}),
});
const datos = await respuesta.json();
console.log(datos);<?php
$ch = curl_init("https://miapi.cloud/apifact/voided/send");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer TU_TOKEN",
"Content-Type: application/json"
],
CURLOPT_POSTFIELDS => json_encode([
"claveSecreta" => "TU_CLAVE_SECRETA",
"cabecera" => [
"tipodoc" => "RA",
"serie" => "20240101",
"correlativo" => "1",
"fechaEmision" => "2024-01-01",
"fechaEnvio" => "2024-01-01"
],
"items" => [
[
"tipodoc" => "01",
"serie" => "F001",
"correlativo" => "1",
"motivo" => "ERROR EN DATOS"
]
]
]),
]);
$datos = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($datos);import requests
respuesta = requests.post(
"https://miapi.cloud/apifact/voided/send",
headers={
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
json={
"claveSecreta": "TU_CLAVE_SECRETA",
"cabecera": {
"tipodoc": "RA",
"serie": "20240101",
"correlativo": "1",
"fechaEmision": "2024-01-01",
"fechaEnvio": "2024-01-01"
},
"items": [
{
"tipodoc": "01",
"serie": "F001",
"correlativo": "1",
"motivo": "ERROR EN DATOS"
}
]
},
timeout=30,
)
print(respuesta.json()) Estado de Comunicación de Bajas
Consulta el estado del ticket generado al enviar una comunicación de bajas.
POST https://miapi.cloud/apifact/voided/status
curl -X POST "https://miapi.cloud/apifact/voided/status" \
-H "Authorization: Bearer TU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"claveSecreta":"TU_CLAVE_SECRETA","ticket":"TICKET_RECIBIDO"}'const respuesta = await fetch("https://miapi.cloud/apifact/voided/status", {
method: "POST",
headers: {
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
body: JSON.stringify({
"claveSecreta": "TU_CLAVE_SECRETA",
"ticket": "TICKET_RECIBIDO"
}),
});
const datos = await respuesta.json();
console.log(datos);<?php
$ch = curl_init("https://miapi.cloud/apifact/voided/status");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer TU_TOKEN",
"Content-Type: application/json"
],
CURLOPT_POSTFIELDS => json_encode([
"claveSecreta" => "TU_CLAVE_SECRETA",
"ticket" => "TICKET_RECIBIDO"
]),
]);
$datos = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($datos);import requests
respuesta = requests.post(
"https://miapi.cloud/apifact/voided/status",
headers={
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
json={
"claveSecreta": "TU_CLAVE_SECRETA",
"ticket": "TICKET_RECIBIDO"
},
timeout=30,
)
print(respuesta.json()) Envío Resumen Diario de Boletas
Envía a SUNAT el resumen diario consolidado de boletas y notas vinculadas.
POST https://miapi.cloud/apifact/summary/send
curl -X POST "https://miapi.cloud/apifact/summary/send" \
-H "Authorization: Bearer TU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"claveSecreta":"TU_CLAVE_SECRETA","cabecera":{"tipodoc":"RC","serie":"20240101","correlativo":"1","fechaEmision":"2024-01-01","fechaEnvio":"2024-01-01"},"items":[{"tipodoc":"03","serie":"B001","correlativo":"1","moneda":"PEN","importe_total":118,"op_gravadas":100,"igv_total":18,"numdoc":"00000000"}]}'const respuesta = await fetch("https://miapi.cloud/apifact/summary/send", {
method: "POST",
headers: {
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
body: JSON.stringify({
"claveSecreta": "TU_CLAVE_SECRETA",
"cabecera": {
"tipodoc": "RC",
"serie": "20240101",
"correlativo": "1",
"fechaEmision": "2024-01-01",
"fechaEnvio": "2024-01-01"
},
"items": [
{
"tipodoc": "03",
"serie": "B001",
"correlativo": "1",
"moneda": "PEN",
"importe_total": 118,
"op_gravadas": 100,
"igv_total": 18,
"numdoc": "00000000"
}
]
}),
});
const datos = await respuesta.json();
console.log(datos);<?php
$ch = curl_init("https://miapi.cloud/apifact/summary/send");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer TU_TOKEN",
"Content-Type: application/json"
],
CURLOPT_POSTFIELDS => json_encode([
"claveSecreta" => "TU_CLAVE_SECRETA",
"cabecera" => [
"tipodoc" => "RC",
"serie" => "20240101",
"correlativo" => "1",
"fechaEmision" => "2024-01-01",
"fechaEnvio" => "2024-01-01"
],
"items" => [
[
"tipodoc" => "03",
"serie" => "B001",
"correlativo" => "1",
"moneda" => "PEN",
"importe_total" => 118,
"op_gravadas" => 100,
"igv_total" => 18,
"numdoc" => "00000000"
]
]
]),
]);
$datos = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($datos);import requests
respuesta = requests.post(
"https://miapi.cloud/apifact/summary/send",
headers={
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
json={
"claveSecreta": "TU_CLAVE_SECRETA",
"cabecera": {
"tipodoc": "RC",
"serie": "20240101",
"correlativo": "1",
"fechaEmision": "2024-01-01",
"fechaEnvio": "2024-01-01"
},
"items": [
{
"tipodoc": "03",
"serie": "B001",
"correlativo": "1",
"moneda": "PEN",
"importe_total": 118,
"op_gravadas": 100,
"igv_total": 18,
"numdoc": "00000000"
}
]
},
timeout=30,
)
print(respuesta.json()) Estado de Resumen Diario
Verifica con el ticket si SUNAT aceptó el resumen diario enviado.
POST https://miapi.cloud/apifact/summary/status
curl -X POST "https://miapi.cloud/apifact/summary/status" \
-H "Authorization: Bearer TU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"claveSecreta":"TU_CLAVE_SECRETA","ticket":"TICKET_RECIBIDO"}'const respuesta = await fetch("https://miapi.cloud/apifact/summary/status", {
method: "POST",
headers: {
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
body: JSON.stringify({
"claveSecreta": "TU_CLAVE_SECRETA",
"ticket": "TICKET_RECIBIDO"
}),
});
const datos = await respuesta.json();
console.log(datos);<?php
$ch = curl_init("https://miapi.cloud/apifact/summary/status");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer TU_TOKEN",
"Content-Type: application/json"
],
CURLOPT_POSTFIELDS => json_encode([
"claveSecreta" => "TU_CLAVE_SECRETA",
"ticket" => "TICKET_RECIBIDO"
]),
]);
$datos = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($datos);import requests
respuesta = requests.post(
"https://miapi.cloud/apifact/summary/status",
headers={
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
json={
"claveSecreta": "TU_CLAVE_SECRETA",
"ticket": "TICKET_RECIBIDO"
},
timeout=30,
)
print(respuesta.json()) Errores frecuentes
| Código | Qué significa |
|---|---|
401 | Token inválido o ausente. Revisa la cabecera Authorization: Bearer TU_TOKEN y tu clave secreta. |
400 / 422 | Datos incompletos o inconsistentes en el cuerpo (montos, series, códigos de catálogo, documento del cliente). Corrige antes de reenviar. |
429 | Alcanzaste el límite de tu plan o enviaste demasiadas peticiones seguidas. |
5xx | El servicio de SUNAT no está disponible. Reintenta el envío más tarde; si ya tienes ticket, reintenta solo la consulta de estado. |
Preguntas frecuentes
¿Por qué no recibo el resultado al instante?
Porque SUNAT procesa las bajas y los resúmenes de forma asíncrona. Al enviar recibes un ticket y con él consultas el resultado después.
¿Cómo anulo una boleta?
Las boletas se informan y anulan mediante el resumen diario, no con la comunicación de baja de facturas. Revisa con tu contador el procedimiento aplicable a tu caso.
¿Qué serie lleva la comunicación de baja?
La fecha de generación en formato aaaammdd, por ejemplo 20240101, y un correlativo que identifica el envío de ese día.
¿Qué pasa si se venció el plazo para dar de baja?
Si SUNAT ya no permite la baja, normalmente corresponde emitir una nota de crédito. Confirma el caso con tu contador.
¿Puedo probar la API gratis?
Sí, regístrate gratis en miapi.cloud y prueba en el entorno beta. Los límites dependen de tu plan; revísalos en miapi.cloud/#planes.
APIs relacionadas
-
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.
-
API Notas de Crédito y Débito
Corrige, anula o ajusta facturas y boletas ya emitidas generando notas de crédito (tipo 07) y de débito (tipo 08) desde tu propio software.
-
API Validar Comprobante
Comprueba ante SUNAT si una factura, boleta o nota que recibiste está aceptada, y consulta los comprobantes emitidos y recibidos de tu RUC desde tu sistema.
Empieza gratis hoy
Crea tu cuenta gratis, copia tu token y haz tu primera consulta en minutos. Sin tarjeta de crédito.