Saltar al contenido principal
Facturación electrónica

API de facturación electrónica SUNAT

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.

Para qué sirve

  • Emitir facturas y boletas desde tu ERP, tienda online o punto de venta.
  • Agregar facturación electrónica a un software que vendes a tus clientes.
  • Automatizar la emisión de comprobantes por suscripciones o cobros recurrentes.
  • Reemplazar la emisión manual en el portal de SUNAT por un flujo integrado.
  • Centralizar la emisión de varias sucursales en un solo servicio.

Cómo funciona el flujo

La emisión se hace en dos pasos, cada uno con su endpoint:

  1. Generar el XML: envías en JSON la cabecera del comprobante (tipoDoc 01 factura o 03 boleta, serie, correlativo, fecha, moneda, totales), los datos del cliente y los items. Generamos el XML en el formato UBL que exige SUNAT y lo firmamos con tu certificado digital.
  2. Enviar a SUNAT: indicas tipo, serie y correlativo del comprobante ya generado y lo enviamos. SUNAT responde con la CDR (Constancia de Recepción), que dice si lo aceptó, lo aceptó con observaciones o lo rechazó.

Todas las peticiones llevan tu token en Authorization: Bearer TU_TOKEN y la claveSecreta de tu configuración de facturación en el cuerpo.

Beta, producción, certificado digital y CDR

Beta: SUNAT ofrece un entorno de pruebas donde los comprobantes no tienen validez tributaria. Úsalo para probar tu integración, revisar los cálculos y ver las respuestas sin riesgo.

Producción: para emitir comprobantes reales necesitas ser emisor electrónico, un certificado digital vigente para firmar y tus credenciales para el envío. Los comprobantes de producción tienen validez tributaria, así que revisa bien series y correlativos.

CDR: es la respuesta oficial de SUNAT a cada envío. Guárdala junto con el XML firmado: es tu prueba de que el comprobante fue aceptado. Si fue rechazado, corrige el problema y emite un nuevo comprobante según corresponda.

Para configurar tu RUC en producción o resolver dudas del paso a producción, escríbenos por WhatsApp.

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.

Empieza en beta con el ejemplo de esta página (cliente con RUC ficticio 20000000002, un ítem gravado con IGV) y verifica que los totales cuadren: mtoOperGravadas + mtoIGV = total.

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

  • Controla los correlativos en tu base de datos, por serie, y no reutilices un número ya enviado.
  • Calcula y redondea igual en todas partes: los montos de los ítems deben sumar los totales de la cabecera.
  • Valida el cliente antes de emitir: RUC con la API RUC para facturas y DNI con la API DNI para boletas.
  • Reintenta el envío, no la generación, si SUNAT no responde: el comprobante ya existe con su serie y correlativo.
  • Guarda XML, CDR y PDF de cada comprobante; puedes generar el PDF con la API XML a PDF.

Nunca expongas tu token ni tu clave secreta en el navegador o en una app móvil: llama a la API siempre desde tu servidor.

Para corregir o anular comprobantes consulta las notas de crédito y débito y la comunicación de baja.

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.

Generar XML Comprobante (factura/boleta)

Genera y firma el XML de una factura o boleta electrónica.

POST https://miapi.cloud/apifact/invoice/create

Petición
curl -X POST "https://miapi.cloud/apifact/invoice/create" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"claveSecreta":"TU_CLAVE_SECRETA","comprobante":{"tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","observacion":"","fechaEmision":"2023-02-14","horaEmision":"17:00:00","tipoMoneda":"PEN","tipoPago":"Contado","total":118,"mtoIGV":18,"igvOp":0,"mtoOperGravadas":100,"totalTexto":"SON CIENTO DIECIOCHO CON 00/100 SOLES"},"cliente":{"codigoPais":"PE","tipoDoc":"6","numDoc":"20000000002","rznSocial":"EMPRESA DE EJEMPLO S.A.C.","direccion":"AV. DE EJEMPLO 123"},"items":[{"codProducto":"PR001","descripcion":"PRODUCTO 1","unidad":"NIU","tipoPrecio":"01","cantidad":1,"mtoBaseIgv":100,"mtoValorUnitario":100,"mtoPrecioUnitario":118,"codeAfectAlt":10,"codeAfect":1000,"nameAfect":"IGV","tipoAfect":"VAT","igvPorcent":18,"igv":18,"igvOpi":18}]}'

Envío a SUNAT

Envía a SUNAT un comprobante ya generado (factura, boleta o nota).

POST https://miapi.cloud/apifact/invoice/send

Petición
curl -X POST "https://miapi.cloud/apifact/invoice/send" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"claveSecreta":"TU_CLAVE_SECRETA","comprobante":{"tipoDoc":"01","serie":"F001","correlativo":"1"}}'

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 o no respondió. Reintenta más tarde sin cambiar serie ni correlativo.

Preguntas frecuentes

¿Necesito certificado digital?

Para emitir comprobantes reales en producción, sí: el XML debe ir firmado con un certificado digital vigente. Para probar en beta no necesitas emitir comprobantes con validez.

¿Qué es la CDR?

Es la Constancia de Recepción que devuelve SUNAT tras el envío. Indica si el comprobante fue aceptado, aceptado con observaciones o rechazado. Debes guardarla junto con el XML.

¿Puedo emitir boletas además de facturas?

Sí. El mismo endpoint genera facturas (tipo 01) y boletas (tipo 03). Las boletas también pueden informarse a SUNAT mediante el resumen diario.

¿Qué hago si SUNAT rechaza un comprobante?

Revisa el motivo que viene en la respuesta, corrige los datos en tu sistema y emite un nuevo comprobante según corresponda. No reutilices el mismo número.

¿Cuánto cuesta la API de facturación?

Depende de tu plan. Puedes registrarte gratis para probar y revisar los planes 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.