Ambientes
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:
| Ambiente | URL base | Ministerio de Hacienda | Para qué |
|---|---|---|---|
| Demo | https://demo-api.openbox.cloud | Pruebas (ambiente 00) | Construir y probar tu integración. Lo que emites no tiene validez fiscal y puedes repetirlo cuantas veces necesites. |
| Producción | https://production-api.openbox.cloud | Real (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:
# 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
/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:
- Una empresa con su sucursal, conectada al Ministerio de Hacienda de ese ambiente.
- 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. - 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:
- WhatsApp: +503 2113 6220
- Correo: info@openbox.cloud
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
curlpara 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.