Referencia
Referencia de la API
Todos los endpoints de la API v1, la API de socios y Conectar, con sus esquemas, ejemplos y un «probar aquí» contra el modo pruebas. Descarga la colección de Postman y el OpenAPI.
Actualizado el
Elige la API arriba a la izquierda de la referencia. Para probar aquí, usa el servidor
https://pruebas.sistemafacturacionperu.com/api/v1 y tu clave sfp_test_… en la autenticación
Bearer: las llamadas salen desde tu navegador directo a la API. Nunca pegues aquí una clave sfp_live_.
API v1 de las empresas
Comprobantes, guías, cobros, catálogo, stock, consultas y webhooks de una empresa.
https://<tu-subdominio>.sistemafacturacionperu.com/api/v1
API de socios
Alta de empresas, claves v1 por empresa, saldo, movimientos y webhooks del socio.
https://api.sistemafacturacionperu.com/socios/v1
Conectar (OAuth 2.0)
Servidor de autorización: ventana de conexión, canje y renovación de tokens, revocación.
https://api.sistemafacturacionperu.com
Las colecciones de Postman traen las variables base_url y api_key (más
client_id y client_secret en socios y Conectar) y mandan una Idempotency-Key
nueva en cada POST. Importa el archivo en Postman (Import) y completa las variables de la
colección.
Cargando la referencia interactiva…
Todos los endpoints
La misma lista de la referencia, para buscar con Ctrl + F o leer sin JavaScript.
API v1 de las empresas
| Método | Ruta | Qué hace |
|---|---|---|
| GET | /yo | Con qué clave, usuario, local y permisos estás llamando |
| GET | /comprobantes | Listar comprobantes (paginado) |
| POST | /comprobantes | Emitir factura, boleta, nota de crédito o de débito |
| GET | /comprobantes/buscar | Buscar por serie y número |
| GET | /comprobantes/{id} | Consultar un comprobante (por id o external_id) |
| GET | /comprobantes/{id}/pdf | Descargar el PDF |
| GET | /comprobantes/{id}/xml | Descargar el XML firmado |
| GET | /comprobantes/{id}/cdr | Descargar la constancia de SUNAT (CDR, zip) |
| POST | /comprobantes/{id}/anular | Anular (el sistema elige baja o resumen) |
| GET | /anulaciones/{ticket} | Estado de una baja o resumen de anulación (consulta a SUNAT) |
| POST | /comprobantes/{id}/reenviar-sunat | Reenviar una factura (o su nota) registrada a SUNAT |
| POST | /comprobantes/{id}/enviar | Enviar por correo o por el WhatsApp de tu empresa |
| GET | /comprobantes/{id}/cobros | Cobros y saldo pendiente |
| POST | /comprobantes/{id}/cobros | Registrar un cobro |
| GET | /guias | Listar guías |
| POST | /guias | Emitir guía (crea, envía y consulta en una llamada) |
| GET | /guias/{id} | Consultar una guía (si está pendiente, consulta el ticket en SUNAT) |
| POST | /guias/{id}/enviar | Reintentar el envío de una guía registrada |
| GET | /guias/{id}/pdf | PDF de la guía |
| GET | /guias/{id}/xml | XML firmado de la guía |
| GET | /guias/{id}/cdr | CDR de la guía |
| POST | /retenciones | Emitir comprobante de retención (20) |
| POST | /percepciones | Emitir comprobante de percepción (40) |
| POST | /liquidaciones-compra | Emitir liquidación de compra (04) |
| POST | /notas-venta | Registrar nota de venta |
| POST | /cotizaciones | Registrar cotización |
| GET | /clientes | Listar clientes |
| POST | /clientes | Crear cliente |
| GET | /clientes/{numero} | Consultar cliente por número de documento |
| PUT | /clientes/{numero} | Cambiar datos del cliente (el documento no cambia) |
| GET | /productos | Listar productos |
| POST | /productos | Crear producto (nace sin stock) |
| GET | /productos/{id} | Consultar producto |
| PUT | /productos/{id} | Cambiar producto (cambiar el precio pide catalog.items.prices.update) |
| GET | /stock | Stock por almacén, lote y serie |
| GET | /establecimientos | Locales con sus series y almacenes |
| GET | /consultas/ruc/{numero} | Consulta RUC (SUNAT) |
| GET | /consultas/dni/{numero} | Consulta DNI (RENIEC) |
| GET | /consultas/tipo-cambio | Tipo de cambio SUNAT |
| GET | /webhooks | Listar webhooks |
| POST | /webhooks | Crear webhook (el secreto se muestra una vez) |
| DELETE | /webhooks/{id} | Borrar webhook |
| GET | /webhooks/{id}/entregas | Entregas de un webhook |
| POST | /webhooks/entregas/{id}/reenviar | Reenviar una entrega |
API de socios
| Método | Ruta | Qué hace |
|---|---|---|
| POST | /token | Pedir un token de acceso (client_credentials) |
| GET | /empresas | Listar tus empresas |
| POST | /empresas | Dar de alta una empresa |
| GET | /empresas/{id} | Ver una empresa (vuelve a leer su estado) |
| PATCH | /empresas/{id} | Cambiar contacto, nombre comercial, dirección, certificado, usuario SOL o forma de envío |
| GET | /empresas/{id}/uso | Comprobantes del mes por tipo y lo que descontó de tu bolsa |
| POST | /empresas/{id}/suspender | Pausar la emisión por API de una empresa |
| POST | /empresas/{id}/reactivar | Volver a permitir la emisión por API |
| GET | /empresas/{id}/claves | Listar las claves v1 de la empresa (sin la clave) |
| POST | /empresas/{id}/claves | Crear una clave v1 (sfp_live_) para emitir con esa empresa |
| DELETE | /empresas/{id}/claves/{keyId} | Revocar una clave |
| GET | /saldo | Tu saldo, tus bolsas, vencimientos y cuotas pendientes |
| GET | /movimientos | Consumos y recargas, del más nuevo al más viejo |
| GET | /webhooks | Listar tus webhooks (y los eventos disponibles en meta) |
| POST | /webhooks | Registrar un webhook |
| DELETE | /webhooks/{id} | Borrar un webhook (y su historial) |
| GET | /webhooks/{id}/entregas | Entregas de un webhook |
| POST | /webhooks/entregas/{id}/reenviar | Reenviar una entrega ya |
Conectar (OAuth 2.0)
| Método | Ruta | Qué hace |
|---|---|---|
| GET | /conectar | Abre la ventana «Conectar con Sistema Facturación Perú» |
| POST | /oauth/token | Canjea el código o renueva los tokens |
| POST | /oauth/revoke | Revoca un token (RFC 7009) |