Saltar al contenido principal
Facturación electrónica

API de comunicación de baja y resumen diario

Anula comprobantes electrónicos e informa tus boletas a SUNAT con la comunicación de baja y el resumen diario, y consulta su resultado con el ticket.

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:

  1. Envías el documento y SUNAT responde con un ticket.
  2. Más tarde consultas el estado con ese ticket.
  3. 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)

DocumentotipodocPara qué sirve
Comunicación de bajaRAInforma la anulación de facturas y documentos vinculados. Cada ítem indica tipo, serie, correlativo y motivo.
Resumen diarioRCInforma 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

  1. Crea tu cuenta gratis en miapi.cloud; el plan gratuito te permite probar sin tarjeta.
  2. Copia tu token desde el panel admin.miapi.cloud.
  3. 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

Petición
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"}]}'

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

Petición
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"}'

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

Petición
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"}]}'

Estado de Resumen Diario

Verifica con el ticket si SUNAT aceptó el resumen diario enviado.

POST https://miapi.cloud/apifact/summary/status

Petición
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"}'

Errores frecuentes

CódigoQué significa
401Token inválido o ausente. Revisa la cabecera Authorization: Bearer TU_TOKEN y tu clave secreta.
400 / 422Datos incompletos o inconsistentes en el cuerpo (montos, series, códigos de catálogo, documento del cliente). Corrige antes de reenviar.
429Alcanzaste el límite de tu plan o enviaste demasiadas peticiones seguidas.
5xxEl 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

Empieza gratis hoy

Crea tu cuenta gratis, copia tu token y haz tu primera consulta en minutos. Sin tarjeta de crédito.