Colección POSTMAN

Puedes probar la api en POSTMAN directamente

¿Aún no tienes una cuenta? Crea una aquí: https://facturalibre.org/precios/

En esta documentación tienes un conjunto de ejemplos de uso de la API REST de FacturaLibre.org

Importante: Los ejemplos fueron realizados con las credenciales de api de una empresa, pero estos ejemplos funcionan igual en cuentas de api individual y api de distribuidores.

En api de distribuidores cambia la cabecera, que tienes en los ejemplos en POSTMAN.

Ejemplo ruta de cuentas ERP:

https://miempresa.pro.facturalibre.org/api/documents

https://miempresa.pro2.facturalibre.org/api/documents

Ejemplos de rutas de cuentas individuales de API:

https://miempresa.proapi.facturalibre.org/api/documents

Ejemplo ruta de cuentas Api Distribuidor:

https://proapi.facturalibre.org/api/

Ver api de distribuidor en: API de Distribuidor

Catálogos usados en la API

Tipos de documento:

Código	Comprobante
`01`	Factura electrónica
`03`	Boleta de venta electrónica
`07`	Nota de crédito
`08`	Nota de débito

Estados — catálogo completo

	Descripción	Significado
`01`	Registrado	Creado en FacturaLibre; aún no aceptado por SUNAT (o pendiente de reenvío). Es el estado inicial al emitir por API.
`03`	Enviado	Enviado a SUNAT, pendiente de respuesta final. Muy habitual en boletas que van por resumen diario.
`05`	Aceptado	SUNAT aceptó el CPE
`07`	Observado	SUNAT observó el comprobante (códigos CDR ≥ 4000). El CPE existe pero con observaciones.
`09`	Rechazado	SUNAT rechazó el comprobante (códigos CDR 2000–3999).
`11`	Anulado	Comprobante anulado (p. ej. boleta incluida en resumen de bajas).
`13`	Por anular	En proceso de anulación (resumen de bajas enviado, aún no confirmado).

Condiciones de pago - catalogo interno

Código	Nombre	Default API
`01`	Contado	Sí (si no lo envías)
`02`	Crédito	Requiere `cuotas`

Métodos de pago - catálogo interno

Esto es lo que usa codigo_metodo_pagoal enviar pagos via api.

Código	Descripción
`01`	Efectivo
`02`	Tarjeta de crédito
`03`	Tarjeta de débito
`04`	Transferencia
`05`	Factura a 30 días
`06`	Tarjeta crédito visa
`07`	Contado contraentrega
`08`	A 30 días
`09`	Crédito
`10`	Contado

Catálogo 06 SUNAT — Tipos de documento de identidad

	Descripción	Activo en el sistema
`0`	Doc. trib. no domiciliado sin RUC	Sí
`1`	DNI	Sí
`4`	Carnet de extranjería (CE)	Sí
`6`	RUC	Sí
`7`	Pasaporte	Sí

Nota de crédito (`07`) — Catálogo SUNAT 09

Campo codigo_tipo_nota en notas de crédito.

Código	Descripción
`01`	Anulación de la operación
`02`	Anulación por error en el RUC
`03`	Corrección por error en la descripción
`04`	Descuento global
`05`	Descuento por ítem
`06`	Devolución total
`07`	Devolución por ítem
`08`	Bonificación
`09`	Disminución en el valor
`10`	Otros Conceptos
`11`	Ajustes de operaciones de exportación
`12`	Ajustes afectos al IVAP
`13`	Ajustes – montos y/o fechas de pago

Nota de débito (`08`) — Catálogo SUNAT 10

Campo codigo_tipo_nota en notas de débito.

Código	Descripción
`01`	Intereses por mora
`02`	Aumento en el valor
`03`	Penalidades/ otros conceptos
`10`	Ajustes de operaciones de exportación
`11`	Ajustes afectos al IVAP