Saltar al contenido principal
Consultas

API para convertir XML de SUNAT 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.

Para qué sirve

  • Generar el PDF de cada factura o boleta que emites para enviarlo al cliente.
  • Imprimir comprobantes en formato ticket en el punto de venta.
  • Hacer legibles los XML que te envían tus proveedores.
  • Convertir en lote los XML de un mes para archivarlos o enviarlos al contador.
  • Adjuntar el PDF a correos o mensajes de WhatsApp automáticos.

Cómo se envía el archivo

Esta API recibe form-data, no JSON, porque subes el archivo XML. Los campos son:

CampoContenido
filesEl archivo XML del comprobante. En modo masivo puedes enviar varios.
formata4 para hoja completa o ticket para impresoras térmicas.
tipo_documentoCódigo SUNAT del comprobante, por ejemplo 01 factura o 03 boleta.
masivo0 para un solo archivo, 1 para varios.

No fijes la cabecera Content-Type a mano cuando uses la clase FormData de tu lenguaje: la librería la arma con el separador correcto.

Qué devuelve

La respuesta es binaria, no JSON:

  • Con masivo=0, un archivo application/pdf listo para guardar, mostrar o adjuntar.
  • Con masivo=1, un archivo ZIP con un PDF por cada XML enviado.

En tu código, lee la respuesta como binario (blob, arrayBuffer o equivalente) y guárdala con la extensión correcta. Si la respuesta no es un PDF o ZIP, trátala como error y revisa el mensaje.

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 con el XML de un comprobante emitido en beta. Primero en formato a4 y luego en ticket para comparar cuál se adapta mejor a tu caso.

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

  • Envía XML válidos de SUNAT, preferiblemente el XML firmado tal como se envió.
  • Indica el tipo de documento correcto para que el diseño corresponda al comprobante.
  • Guarda el PDF generado en lugar de convertir el mismo XML cada vez que alguien lo pida.
  • Agrupa en lote las conversiones grandes con masivo=1.

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.

Puedes enviar el PDF a tus clientes con la API de WhatsApp y generar el XML con la API de facturación electrónica.

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.

Convertir XML a PDF

Convierte uno o varios XML de SUNAT a PDF (A4 o ticket); en modo masivo devuelve un ZIP.

POST https://convertir.miapi.cloud/generate-pdf/

Petición
curl -X POST "https://convertir.miapi.cloud/generate-pdf/" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: multipart/form-data" \
  -d '{"files":"@documento.xml","format":"a4","tipo_documento":"01","masivo":"0"}'

Errores frecuentes

CódigoQué significa
401Token ausente o inválido. Revisa la cabecera Authorization: Bearer TU_TOKEN.
400 / 422Falta el archivo, no es un XML de comprobante válido o algún campo (format, tipo_documento, masivo) es incorrecto.
429Alcanzaste el límite de tu plan o enviaste demasiadas peticiones seguidas.
5xxEl servicio de conversión no respondió. Reintenta más tarde con espera progresiva.

Preguntas frecuentes

¿Qué formatos de PDF puedo generar?

A4, para hoja completa, y ticket, para impresoras térmicas de punto de venta.

¿Puedo convertir varios XML a la vez?

Sí. Con masivo=1 envías varios archivos y recibes un ZIP con un PDF por cada XML.

¿Por qué la respuesta no es JSON?

Porque devuelve el archivo directamente: un PDF o un ZIP. Léelo como binario en tu código y guárdalo con la extensión correcta.

¿Sirve para XML que me envían mis proveedores?

Sí, puedes convertir cualquier XML de comprobante electrónico SUNAT que tengas, sea emitido o recibido.

¿Puedo probarla gratis?

Sí, regístrate gratis en miapi.cloud. 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.