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:
- Generar el XML: envías en JSON la cabecera del comprobante (
tipoDoc01factura o03boleta, serie, correlativo, fecha, moneda, totales), los datos delclientey lositems. Generamos el XML en el formato UBL que exige SUNAT y lo firmamos con tu certificado digital. - 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
- 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.
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
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}]}'const respuesta = await fetch("https://miapi.cloud/apifact/invoice/create", {
method: "POST",
headers: {
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
body: JSON.stringify({
"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
}
]
}),
});
const datos = await respuesta.json();
console.log(datos);<?php
$ch = curl_init("https://miapi.cloud/apifact/invoice/create");
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",
"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
]
]
]),
]);
$datos = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($datos);import requests
respuesta = requests.post(
"https://miapi.cloud/apifact/invoice/create",
headers={
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
json={
"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
}
]
},
timeout=30,
)
print(respuesta.json()) Envío a SUNAT
Envía a SUNAT un comprobante ya generado (factura, boleta o nota).
POST https://miapi.cloud/apifact/invoice/send
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"}}'const respuesta = await fetch("https://miapi.cloud/apifact/invoice/send", {
method: "POST",
headers: {
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
body: JSON.stringify({
"claveSecreta": "TU_CLAVE_SECRETA",
"comprobante": {
"tipoDoc": "01",
"serie": "F001",
"correlativo": "1"
}
}),
});
const datos = await respuesta.json();
console.log(datos);<?php
$ch = curl_init("https://miapi.cloud/apifact/invoice/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",
"comprobante" => [
"tipoDoc" => "01",
"serie" => "F001",
"correlativo" => "1"
]
]),
]);
$datos = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($datos);import requests
respuesta = requests.post(
"https://miapi.cloud/apifact/invoice/send",
headers={
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
json={
"claveSecreta": "TU_CLAVE_SECRETA",
"comprobante": {
"tipoDoc": "01",
"serie": "F001",
"correlativo": "1"
}
},
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 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
-
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 Comunicación de Baja
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.
-
API XML 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.
-
API RUC
Consulta razón social, estado, condición y domicilio fiscal de cualquier RUC de 11 dígitos, con versiones detallada y completa de la ficha tributaria y consulta masiva.
Empieza gratis hoy
Crea tu cuenta gratis, copia tu token y haz tu primera consulta en minutos. Sin tarjeta de crédito.