Integraciones Facturador (B2B)

Circuito separado del resto de la API, pensado para integraciones tipo ERP/WooCommerce con el producto "Facturador". Se autentica con dos cabeceras en vez de un token Bearer:

License-Id: <identificador de tu integración>
License-Secret: <secreto entregado al crearla>

El secreto solo se muestra una vez al crear o regenerar la licencia — guárdalo de inmediato, no se puede recuperar después.

Endpoints

Endpoint	Descripción
`POST /licenses/facturador/series`	Lista las series configuradas en tu ERP.
`POST /licenses/services`	Devuelve qué funciones tiene habilitadas tu licencia (`emit`, `sync`).
`POST /licenses/format`	Convierte un comprobante genérico al formato JSON que espera el ERP.
`POST /licenses/sync`	Sincroniza productos de tu ERP hacia WooCommerce.
`POST /licenses/emit`	Reenvía un comprobante ya formateado al ERP para emitirlo.
`GET /licenses/ruc/{numero}`	Consulta básica de RUC (caché local) para armar el receptor del comprobante.
`GET /licenses/dni/{numero}`	Consulta básica de DNI (caché local), mismo propósito.

Ejemplo

curl -X POST https://mblapirest.com/api/v1/licenses/services \
  -H "License-Id: TU_LICENSE_ID" \
  -H "License-Secret: TU_LICENSE_SECRET"

{ "success": true, "emit": true, "sync": false }

Consulta de RUC/DNI (caché local)

Pensadas para armar el "receptor" de un comprobante sin pedirle al integrador que maneje también un token normal de cliente — mismas cabeceras License-Id/License-Secret.

curl https://mblapirest.com/api/v1/licenses/ruc/20123456789 \
  -H "License-Id: TU_LICENSE_ID" \
  -H "License-Secret: TU_LICENSE_SECRET"

{
  "success": true,
  "data": {
    "ruc": "20123456789",
    "razon_social": "EMPRESA EJEMPLO SAC",
    "nombre_comercial": null,
    "estado": "ACTIVO",
    "condicion": "HABIDO",
    "direccion": "AV. EJEMPLO 123 LIMA"
  }
}

Solo consultan la caché local (mismo origen que /ruc/{numero} y /dni/{numero}) — si el RUC/DNI no está en caché, responden 404 en vez de ir a buscarlo en vivo.

Última actualización: 03/09/2026