Empezar

Ambientes

Los dos ambientes de la API de Partners v1, cómo pedir tu llave y cómo usar los ejemplos.

Dos ambientes: demo y producción

La API de Partners v1 de Openbox Cloud está disponible en dos ambientes, con las mismas rutas y el mismo contrato:

AmbienteURL baseMinisterio de HaciendaPara qué
Demohttps://demo-api.openbox.cloudPruebas (ambiente 00)Construir y probar tu integración. Lo que emites no tiene validez fiscal y puedes repetirlo cuantas veces necesites.
Producciónhttps://production-api.openbox.cloudReal (ambiente 01)Operar: cada venta o compra que emites es un documento con validez fiscal.

Empieza en demo y pasa a producción cuando tu integración funcione de punta a punta. Cada ambiente tiene su propia empresa y su propia llave: una llave de demo no sirve en producción, ni al revés.

La URL base en los ejemplos

Los ejemplos curl de las guías usan la variable OPENBOX_API_URL en lugar de una URL fija. Defínela una vez con el ambiente en el que trabajas:

Terminal
# Demo (pruebas)
export OPENBOX_API_URL=https://demo-api.openbox.cloud

# Producción (documentos con validez fiscal)
export OPENBOX_API_URL=https://production-api.openbox.cloud
Todas las rutas de la API cuelgan de /partners/v1. Por ejemplo, el inicio de sesión es POST $OPENBOX_API_URL/partners/v1/auth/login. En la Referencia, elige el ambiente en el selector de servidor: los ejemplos se arman con la URL que escojas (demo, si no eliges otra).

Pide tu llave al equipo de Openbox Cloud

La llave (key) y el secreto (secret) se piden al equipo de Openbox Cloud, que también deja lista tu empresa. Para cada ambiente en el que vayas a trabajar recibes:

  1. Una empresa con su sucursal, conectada al Ministerio de Hacienda de ese ambiente.
  2. Una llave (key, un UUID) y su secreto (secret). El secreto se entrega por un canal seguro y no se vuelve a mostrar: guárdalo como cualquier contraseña.
  3. Un perfil asignado a la llave con acceso a los módulos que vas a usar (ventas, compras, inventario). Una operación de un módulo que el perfil no tiene responde 403.

Para pedirla, escríbenos por cualquiera de estos canales:

Cómo leer este portal

  • Guías (esta sección), en cuatro bloques: Empezar (ambientes y autenticación), Conceptos (lo que conviene entender antes de integrar), Recetas (cada tarea paso a paso) y Operar (errores, reintentos y contingencia).
  • Referencia: cada operación con su esquema y un ejemplo curl para el ambiente que elijas. El portal no envía peticiones: copia el ejemplo y córrelo tú.
  • Estado del contrato: la insignia de cada operación, en una sola tabla.

Cada operación lleva una insignia que sale del contrato publicado, por ejemplo DisponiblePOST /partners/v1/auth/login Ver operación en la Referencia → . Qué significa cada una está en Disponibilidad.

Si prefieres Postman o Insomnia, descarga el OpenAPI con el botón OpenAPI (Postman / Insomnia) de la cabecera e impórtalo: trae los dos ambientes como servidores.

Copyright © 2026