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:
| Campo | Contenido |
|---|---|
files | El archivo XML del comprobante. En modo masivo puedes enviar varios. |
format | a4 para hoja completa o ticket para impresoras térmicas. |
tipo_documento | Código SUNAT del comprobante, por ejemplo 01 factura o 03 boleta. |
masivo | 0 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 archivoapplication/pdflisto 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
- 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 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/
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"}'const respuesta = await fetch("https://convertir.miapi.cloud/generate-pdf/", {
method: "POST",
headers: {
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "multipart/form-data"
},
body: JSON.stringify({
"files": "@documento.xml",
"format": "a4",
"tipo_documento": "01",
"masivo": "0"
}),
});
const datos = await respuesta.json();
console.log(datos);<?php
$ch = curl_init("https://convertir.miapi.cloud/generate-pdf/");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer TU_TOKEN",
"Content-Type: multipart/form-data"
],
CURLOPT_POSTFIELDS => json_encode([
"files" => "@documento.xml",
"format" => "a4",
"tipo_documento" => "01",
"masivo" => "0"
]),
]);
$datos = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($datos);import requests
respuesta = requests.post(
"https://convertir.miapi.cloud/generate-pdf/",
headers={
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "multipart/form-data"
},
json={
"files": "@documento.xml",
"format": "a4",
"tipo_documento": "01",
"masivo": "0"
},
timeout=30,
)
print(respuesta.json()) Errores frecuentes
| Código | Qué significa |
|---|---|
401 | Token ausente o inválido. Revisa la cabecera Authorization: Bearer TU_TOKEN. |
400 / 422 | Falta el archivo, no es un XML de comprobante válido o algún campo (format, tipo_documento, masivo) es incorrecto. |
429 | Alcanzaste el límite de tu plan o enviaste demasiadas peticiones seguidas. |
5xx | El 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
-
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 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.
-
API WhatsApp
Vincula tu propio número de WhatsApp escaneando un QR en el panel y envía mensajes de texto y archivos a tus clientes con una simple petición HTTP.
Empieza gratis hoy
Crea tu cuenta gratis, copia tu token y haz tu primera consulta en minutos. Sin tarjeta de crédito.