Portal para desarrolladores
Emite facturas, boletas, notas y guías de remisión válidas ante SUNAT desde tu propio sistema. Una API REST en español, con modo pruebas, webhooks y ejemplos en cURL, PHP, Node.js y Python.
- OpenAPI 3.1
- Colección de Postman
- Webhooks firmados
- OAuth 2.0 + PKCE
curl https://pruebas.sistemafacturacionperu.com/api/v1/yo \
-H "Authorization: Bearer sfp_test_TU_CLAVE"
{
"success": true,
"data": {
"empresa": { "razon_social": "EMPRESA DE PRUEBAS API S.A.C." },
"modo": "pruebas",
"sunat": "beta",
"alcances": ["comprobantes.emitir", "comprobantes.leer"]
}
}Elige cómo integrarte
Depende de quién es la cuenta con la que vas a emitir. Muchos sistemas usan dos de las tres.
Tu empresa
Emites con tu propia cuenta desde tu tienda, ERP o app.
Cómo: Clave de API sfp_live_ con alcances
Desde el Plan PRO
Empezar con la API v1Socios
Tienes muchos clientes y quieres darlos de alta tú mismo.
Cómo: Token de socio y bolsas prepago desde S/ 0,048 por comprobante
Precio por uso
Ver la API de sociosConectar con un botón
Tus clientes ya tienen cuenta y la conectan con «Permitir».
Cómo: OAuth 2.0 con PKCE, sin copiar claves
También en el Plan Básico, para emitir
Poner el botónModo pruebas real
Una empresa aparte contra la beta de SUNAT, con claves sfp_test_. No toca tus correlativos ni tu stock.
Webhooks del estado SUNAT
Te avisamos firmado cuando SUNAT acepta, observa o rechaza. Sin consultar cada minuto.
Reintentos sin duplicar
Idempotency-Key en cada POST: si la red falla y reintentas, no se emite dos veces.
Errores que se entienden
Un code estable para tu código y un mensaje en español para tu usuario.
Toda la documentación
Desde la primera llamada hasta el pase a producción.
Empezar
- Inicio rápido Crea una clave de pruebas, prueba la conexión, emite tu primera boleta electrónica contra la beta de SUNAT y descarga su PDF con cURL, PHP, Node.js o Python.
- Conceptos Empresa y subdominio, locales y series, modo pruebas y producción, el camino de un comprobante ante SUNAT y la diferencia entre resumen diario y envío directo.
- Autenticación Las tres formas de llamar a la API: claves de empresa con alcances, token de socio con client_credentials y la conexión con un botón (OAuth 2.0 con PKCE).
Guías por comprobante
- Todas las guías Qué endpoint usar para cada comprobante electrónico (factura, boleta, notas, guías, retención, percepción, liquidación) y cómo llega cada uno a SUNAT.
- Factura JSON mínimo para emitir una factura electrónica SUNAT por API, al contado o a crédito, desde una cotización, y cómo enviarla por correo o WhatsApp.
- Boleta JSON mínimo para emitir una boleta de venta electrónica por API, cuándo pedir el DNI del comprador y cómo la informa el resumen diario a SUNAT.
- Notas de crédito y débito Cómo emitir notas de crédito y de débito electrónicas por API: el comprobante que modifican, el tipo de nota, el tope de la nota de crédito y su envío a SUNAT.
- Anular (baja y resumen) Anula facturas, boletas y sus notas por API con una sola llamada: el sistema elige la comunicación de baja o el resumen de anulación y te da el ticket de SUNAT.
- Resumen diario Cómo informa el sistema tus boletas a SUNAT con el resumen diario automático, cuándo quedan aceptadas y qué avisos te llegan, sin una sola llamada extra.
- Guías de remisión Emite guías de remisión remitente (09) y transportista (31) con la API nueva de SUNAT en una sola llamada: crear, enviar y consultar el ticket.
- Retención JSON mínimo para emitir el comprobante de retención (20) por API cuando eres agente de retención del IGV: proveedor, facturas pagadas e importes retenidos.
- Percepción JSON mínimo para emitir el comprobante de percepción (40) por API cuando eres agente de percepción: cliente, comprobantes cobrados e importes percibidos.
- Liquidación de compra JSON mínimo para emitir la liquidación de compra electrónica (04) por API cuando compras a una persona sin RUC: vendedor, lugar de la operación, ítems y totales.
- Casos especiales Los campos que cambian en una factura con detracción, anticipos, exportación, moneda extranjera, operaciones gratuitas o impuesto a las bolsas plásticas (ICBPER).
Referencia
- Referencia interactiva Todos los endpoints con «probar aquí», la colección de Postman y las especificaciones OpenAPI.
- Webhooks Recibe un aviso firmado cuando SUNAT acepta, observa o rechaza un comprobante. Eventos, verificación de la firma en PHP, Node.js y Python, reintentos y reenvíos.
- Errores Todos los códigos de error de la API v1, la API de socios y Conectar, con su causa y qué hacer, y los rechazos y observaciones de SUNAT más comunes explicados.
- RUC, DNI y tipo de cambio Consulta por API los datos de un RUC en SUNAT, un DNI en RENIEC y el tipo de cambio de SUNAT del día, con el mismo servicio que usan las pantallas del sistema.
- Límites y versiones Cuántas llamadas por minuto acepta la API, cómo reintentar sin emitir dos veces con Idempotency-Key, cómo paginar los listados y cómo cuidamos la compatibilidad.
Socios y conexión
- API de socios Para programadores y empresas de software con muchos clientes: da de alta empresas, emite con su API v1 y paga con bolsas prepago de comprobantes desde S/ 0,048.
- Conectar con un botón Pon un botón en tu sistema para que tus clientes conecten su cuenta de Sistema Facturación Perú sin copiar claves: OAuth 2.0 con PKCE, ventana emergente y tokens.
Descargas
Las especificaciones salen del mismo sistema que atiende tus llamadas y se publican aquí cada vez que cambian (última: 04/11/2026). Impórtalas en Postman, Insomnia o tu generador de clientes.
¿Programas con una IA? Dale llms.txt o llms-full.txt: incluyen todo este portal.
API v1
Socios
Conectar
¿Tienes muchos clientes y quieres facturar por ellos? Conoce la API de socios o escríbenos por WhatsApp.