API REST v1 • UBL 2.1 Homologado SUNAT 2026

Facturación Electrónica SUNAT
para Desarrolladores y Tiendas Online

Emite facturas, boletas de venta y notas de crédito en milisegundos con una arquitectura REST moderna. Envía un simple JSON y nosotros nos encargamos de la firma digital X.509, el envío SOAP a SUNAT y la generación del PDF, XML y CDR.

Probar API Gratis (30 Días Sandbox) Ver Documentación de Endpoints

Integración directa con: WooCommerce Shopify PHP / Laravel Python / Django Node.js / Express Flutter / React

POST https://emitefacil.pro/api/v1/comprobantes

curl -X POST https://emitefacil.pro/api/v1/comprobantes \ -H "Authorization: Bearer TU_API_TOKEN_EMITEFACIL" \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{ "tipo_comprobante": "01", "serie": "F001", "cliente_tipo_doc": "6", "cliente_num_doc": "20601234567", "cliente_denominacion": "DISTRIBUIDORA LIMA S.A.C.", "cliente_direccion": "Av. Javier Prado Este 450, San Isidro", "items": [ { "descripcion": "Licencia Anual Software ERP", "cantidad": 1, "precio_unitario": 590.00 } ] }'

<?php // Ejemplo con cURL nativo en PHP $ch = curl_init('https://emitefacil.pro/api/v1/comprobantes'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'Authorization: Bearer ' . $miApiToken, 'Content-Type: application/json', 'Accept: application/json' ]); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([ 'tipo_comprobante' => '01', 'serie' => 'F001', 'cliente_tipo_doc' => '6', 'cliente_num_doc' => '20601234567', 'cliente_denominacion' => 'DISTRIBUIDORA LIMA S.A.C.', 'items' => [[ 'descripcion' => 'Licencia Anual Software ERP', 'cantidad' => 1, 'precio_unitario' => 590.00 ]] ])); $response = json_decode(curl_exec($ch), true); curl_close($ch);

// Ejemplo con Axios / Fetch en Node.js const axios = require('axios'); const emiteFactura = async () => { const res = await axios.post('https://emitefacil.pro/api/v1/comprobantes', { tipo_comprobante: '01', serie: 'F001', cliente_tipo_doc: '6', cliente_num_doc: '20601234567', cliente_denominacion: 'DISTRIBUIDORA LIMA S.A.C.', items: [{ descripcion: 'Licencia Anual Software ERP', cantidad: 1, precio_unitario: 590.00 }] }, { headers: { Authorization: `Bearer ${process.env.EMITEFACIL_TOKEN}` } }); console.log('Comprobante emitido:', res.data.comprobante.serie_numero); };

# Ejemplo con Requests en Python import requests payload = { "tipo_comprobante": "01", "serie": "F001", "cliente_tipo_doc": "6", "cliente_num_doc": "20601234567", "cliente_denominacion": "DISTRIBUIDORA LIMA S.A.C.", "items": [{"descripcion": "Licencia Anual Software ERP", "cantidad": 1, "precio_unitario": 590.00}] } headers = { "Authorization": "Bearer TU_API_TOKEN", "Content-Type": "application/json" } r = requests.post("https://emitefacil.pro/api/v1/comprobantes", json=payload, headers=headers) print(r.json())

HTTP 200 OK Tiempo de respuesta: ~680ms

{ "exito": true, "mensaje": "Comprobante F001-000042 emitido y homologado exitosamente por SUNAT", "comprobante": { "id": 42, "serie_numero": "F001-000042", "estado_sunat": "ACEPTADO", "codigo_hash": "kP3z8xV91A/Lm0q=", "total": 590.00 }, "links": { "pdf_a4": "https://emitefacil.pro/api/v1/comprobantes/42/descargar-pdf?formato=a4&dtoken=5005e78b...", "pdf_ticket": "https://emitefacil.pro/api/v1/comprobantes/42/descargar-pdf?formato=ticket&dtoken=5005e78b...", "xml": "https://emitefacil.pro/api/v1/comprobantes/42/descargar-xml?dtoken=5005e78b...", "cdr": "https://emitefacil.pro/api/v1/comprobantes/42/descargar-cdr?dtoken=5005e78b..." } }

Arquitectura RESTful

Catálogo de Endpoints

Endpoints estandarizados que reciben y retornan JSON con códigos de estado HTTP semánticos.

POST /api/v1/comprobantes

Emitir Comprobante a SUNAT

Crea Facturas (01), Boletas de Venta (03) y Notas de Crédito (07). Realiza la firma UBL 2.1, lo envía por WebService SOAP y descuenta inventario si aplica.

GET /api/v1/consultar-documento

Consulta RUC & DNI en Vivo

Consulta oficial en los padrones de SUNAT y RENIEC. Autocompleta Razón Social, Estado (Activo/Habido) y Dirección para agilizar tu carrito de compras.

GET /api/v1/comprobantes/{id}

Consultar Estado de Comprobante

Retorna los metadatos completos, estado tributario ante SUNAT, código hash y enlaces de descarga actualizados del comprobante.

GET /api/v1/empresa/estado

Estado de Cuenta y Cupo

Verifica el cupo mensual disponible, cantidad de comprobantes emitidos, estado de la suscripción y modo activo (Beta o Producción).

Infraestructura & Protección

Diseñado con Estándares de Seguridad Bancaria

Tokens de Descarga Seguros (dtoken)

Los clientes finales descargan sus PDFs y XMLs mediante firmas HMAC-SHA256 únicas por documento. Nunca se expone el API Token maestro de tu empresa.

Rate Limiting Anti-Saturación

Protección con cabeceras estándar X-RateLimit-Limit: 60 para prevenir bucles accidentales o intentos de denegación de servicio contra los servidores de SUNAT.

Entorno Sandbox / Beta

Alterna entre el entorno de pruebas oficial de SUNAT y producción con un solo clic. Desarrolla y prueba tu integración de extremo a extremo sin contingencias tributarias.

Soporte para Integradores

Preguntas Frecuentes de Desarrolladores

Puedes utilizar webhooks de WooCommerce (evento order.completed) o nuestro snippet PHP para que en cuanto se confirme el pago en pasarelas como Culqi, MercadoPago o Niubiz, se envíe la solicitud a /api/v1/comprobantes. El enlace al PDF se almacena automáticamente en las notas del pedido para el cliente.

Nuestra plataforma se encarga al 100%. La empresa sube su Certificado Digital (.p12 o .pfx) una sola vez en el panel administrativo. Al recibir tus peticiones JSON, nuestro motor firma criptográficamente el XML con el certificado de la empresa y gestiona la comunicación SOAP con los servidores de SUNAT.

Sí, mediante el endpoint /api/v1/consultar-documento?tipo=ruc&numero=.... Al ingresar el RUC o DNI en el carrito, se consulta el padrón en línea y se devuelve la Razón Social y Domicilio Fiscal para rellenar los campos sin errores de tipeo.

Facturación Electrónica SUNAT para Desarrolladores y Tiendas Online