API de Partners v1

Factura electrónica desde tu propio sistema

Conecta tu ERP, punto de venta o plataforma con Openbox Cloud: registra tu catálogo, emite ventas y compras electrónicas y consulta su estado ante el Ministerio de Hacienda, con un contrato OpenAPI y ejemplos listos para copiar.
Obtener un token (demo)
curl -X POST "https://demo-api.openbox.cloud/partners/v1/auth/login" \
  -H 'Content-Type: application/json' \
  -d '{"key":"<TU_LLAVE>","secret":"<TU_SECRETO>"}'

# Respuesta
# { "data": { "access_token": "<TOKEN>" } }
Qué puedes hacer

Todo el ciclo del documento electrónico

La API de Partners cubre lo que tu sistema necesita para facturar sin entrar a Openbox Cloud.
    Emitir ventas
    Factura, crédito fiscal y demás tipos de documento, firmados y enviados al Ministerio de Hacienda.
    Emitir compras
    Factura de Sujeto Excluido por cada compra a quien no emite documento.
    Consultar y anular
    El estado ante Hacienda de cada documento, por tu internalId o por el id de Openbox Cloud.
    Mantener tu catálogo
    Clientes, proveedores, productos, servicios, vendedores, zonas y condiciones de pago.
    Errores claros
    Cada error trae su código y su motivo, y la guía dice cuáles conviene reintentar.
    Contrato OpenAPI
    Descárgalo e impórtalo en Postman o Insomnia; es el mismo que alimenta la referencia.
Inicio rápido

Tu primera venta en cuatro pasos

1. Pide tu llave
El equipo de Openbox Cloud deja lista tu empresa y te entrega la llave y el secreto de cada ambiente.
2. Obtén un token
Cambia la llave y el secreto por un token de acceso y úsalo en cada petición.
3. Emite en demo
Registra una venta contra el Ministerio de Hacienda de pruebas, sin validez fiscal.
4. Pasa a producción
Mismo contrato, otra URL y otra llave: tus documentos ya tienen validez fiscal.
Ambientes

Dos ambientes, un mismo contrato

Integra y prueba en demo; cuando todo funcione, cambia la URL y la llave a producción.
Demo

https://demo-api.openbox.cloud

Conectado al Ministerio de Hacienda de pruebas (ambiente 00): los documentos no tienen validez fiscal.

Producción

https://production-api.openbox.cloud

Conectado al Ministerio de Hacienda (ambiente 01): los documentos tienen validez fiscal.

Estado del contrato

Qué funciona hoy

El contrato completo ya está publicado; la insignia de cada operación dice su estado.

48 operaciones en el contrato. Ver el estado de cada una →

Recursos

Todo lo que necesitas para integrar

Guías
Guías en cuatro bloques: empezar, conceptos, recetas y operar.
Referencia
Cada operación con su esquema y un ejemplo curl para demo o producción.
Estado del contrato
La insignia de cada operación del contrato, en una sola tabla.
Descargar OpenAPI
El contrato en JSON para importarlo en Postman, Insomnia o tu generador de clientes.
Soporte

¿Necesitas tu llave o ayuda con la integración?

El equipo de Openbox Cloud prepara tu empresa, te entrega la llave y el secreto de cada ambiente y te acompaña mientras integras. Escríbenos por WhatsApp al +503 2113 6220 o al correo info@openbox.cloud.
Copyright © 2026