---
title: "Developer Center"
description: "Guías, referencia y estado del contrato de la API de Partners v1 de Openbox Cloud."
canonical_url: "https://developers.openbox.cloud"
---
# Developer Center

> Guías, referencia y estado del contrato de la API de Partners v1 de Openbox Cloud.

<u-page-hero orientation="horizontal">
<template v-slot:headline="">
<u-badge label="API de Partners v1" size="lg" variant="subtle">



</u-badge>
</template>

<template v-slot:title="">

Factura electrónica desde tu propio sistema

</template>

<template v-slot:description="">

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.

</template>

<template v-slot:links="">
<u-button size="xl" to="https://developers.openbox.cloud/guias/empezar/ambientes" trailing-icon="i-lucide-arrow-right">

Empezar ahora

</u-button>

<u-button size="xl" to="https://developers.openbox.cloud/referencia" color="neutral" variant="outline" icon="i-lucide-braces">

Ver la referencia

</u-button>
</template>

```bash [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>" } }
```

</u-page-hero>

<u-page-section headline="Qué puedes hacer">
<template v-slot:title="">

Todo el ciclo del documento electrónico

</template>

<template v-slot:description="">

La API de Partners cubre lo que tu sistema necesita para facturar sin entrar a Openbox Cloud.

</template>

<template v-slot:features="">
<u-page-feature description="Factura, crédito fiscal y demás tipos de documento, firmados y enviados al Ministerio de Hacienda." icon="i-lucide-receipt-text" title="Emitir ventas" to="https://developers.openbox.cloud/guias/recetas/vender-con-payload-completo">



</u-page-feature>

<u-page-feature description="Factura de Sujeto Excluido por cada compra a quien no emite documento." icon="i-lucide-shopping-cart" title="Emitir compras" to="https://developers.openbox.cloud/guias/recetas/compra-a-sujeto-excluido">



</u-page-feature>

<u-page-feature description="El estado ante Hacienda de cada documento, por tu internalId o por el id de Openbox Cloud." icon="i-lucide-search" title="Consultar y anular" to="https://developers.openbox.cloud/guias/recetas/consultar-y-conciliar">



</u-page-feature>

<u-page-feature description="Clientes, proveedores, productos, servicios, vendedores, zonas y condiciones de pago." icon="i-lucide-library" title="Mantener tu catálogo" to="https://developers.openbox.cloud/guias/recetas/sincronizar-catalogo">



</u-page-feature>

<u-page-feature description="Cada error trae su código y su motivo, y la guía dice cuáles conviene reintentar." icon="i-lucide-shield-check" title="Errores claros" to="https://developers.openbox.cloud/guias/operar/errores">



</u-page-feature>

<u-page-feature description="Descárgalo e impórtalo en Postman o Insomnia; es el mismo que alimenta la referencia." icon="i-lucide-file-json" title="Contrato OpenAPI" to="https://developers.openbox.cloud/referencia">



</u-page-feature>
</template>
</u-page-section>

<u-page-section headline="Inicio rápido">
<template v-slot:title="">

Tu primera venta en cuatro pasos

</template>

<u-page-grid className="lg:grid-cols-4">
<u-page-card icon="i-lucide-key-round" title="1. Pide tu llave" to="https://developers.openbox.cloud/guias/empezar/ambientes">

El equipo de Openbox Cloud deja lista tu empresa y te entrega la llave y el secreto de cada ambiente.

</u-page-card>

<u-page-card icon="i-lucide-lock-keyhole" title="2. Obtén un token" to="https://developers.openbox.cloud/guias/empezar/autenticacion">

Cambia la llave y el secreto por un token de acceso y úsalo en cada petición.

</u-page-card>

<u-page-card icon="i-lucide-send" title="3. Emite en demo" to="https://developers.openbox.cloud/guias/recetas/vender-con-payload-completo">

Registra una venta contra el Ministerio de Hacienda de pruebas, sin validez fiscal.

</u-page-card>

<u-page-card icon="i-lucide-rocket" title="4. Pasa a producción" to="https://developers.openbox.cloud/guias/empezar/ambientes">

Mismo contrato, otra URL y otra llave: tus documentos ya tienen validez fiscal.

</u-page-card>
</u-page-grid>
</u-page-section>

<u-page-section headline="Ambientes">
<template v-slot:title="">

Dos ambientes, un mismo contrato

</template>

<template v-slot:description="">

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

</template>

<u-page-grid className="lg:grid-cols-2">
<u-page-card icon="i-lucide-flask-conical" title="Demo" to="https://developers.openbox.cloud/guias/empezar/ambientes">

`https://demo-api.openbox.cloud`

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

</u-page-card>

<u-page-card icon="i-lucide-building-2" title="Producción" to="https://developers.openbox.cloud/guias/empezar/ambientes">

`https://production-api.openbox.cloud`

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

</u-page-card>
</u-page-grid>
</u-page-section>

<u-page-section headline="Estado del contrato">
<template v-slot:title="">

Qué funciona hoy

</template>

<template v-slot:description="">

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

</template>

<resumen-estado>



</resumen-estado>
</u-page-section>

<u-page-section headline="Recursos">
<template v-slot:title="">

Todo lo que necesitas para integrar

</template>

<u-page-grid className="lg:grid-cols-4">
<u-page-card icon="i-lucide-book-open" title="Guías" to="https://developers.openbox.cloud/guias/empezar/ambientes">

Guías en cuatro bloques: empezar, conceptos, recetas y operar.

</u-page-card>

<u-page-card icon="i-lucide-braces" title="Referencia" to="https://developers.openbox.cloud/referencia">

Cada operación con su esquema y un ejemplo curl para demo o producción.

</u-page-card>

<u-page-card icon="i-lucide-list-checks" title="Estado del contrato" to="https://developers.openbox.cloud/estado">

La insignia de cada operación del contrato, en una sola tabla.

</u-page-card>

<u-page-card icon="i-lucide-download" title="Descargar OpenAPI" to="https://developers.openbox.cloud/contrato/partners-v1.openapi.json" target="_blank">

El contrato en JSON para importarlo en Postman, Insomnia o tu generador de clientes.

</u-page-card>
</u-page-grid>
</u-page-section>

<u-page-section headline="Soporte">
<u-page-c-t-a variant="subtle">
<template v-slot:title="">

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

</template>

<template v-slot:description="">

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](mailto:info@openbox.cloud).

</template>

<template v-slot:links="">
<u-button size="lg" to="https://developers.openbox.cloud/guias/empezar/ambientes#pide-tu-llave-al-equipo-de-openbox-cloud" trailing-icon="i-lucide-arrow-right">

Cómo pedir tu llave

</u-button>

<u-button size="lg" to="https://wa.me/50321136220" color="neutral" variant="outline" icon="i-lucide-message-circle" label="WhatsApp +503 2113 6220" target="_blank">



</u-button>

<u-button size="lg" to="mailto:info@openbox.cloud" color="neutral" variant="outline" icon="i-lucide-mail" label="info@openbox.cloud">



</u-button>

<u-button size="lg" to="https://developers.openbox.cloud/guias/operar/errores" color="neutral" variant="outline">

Errores y reintentos

</u-button>
</template>
</u-page-c-t-a>
</u-page-section>

## Recursos para agentes

- [Catálogo de API: los documentos de servicio que publica el sitio](https://developers.openbox.cloud/.well-known/api-catalog)
- [Mapa del sitio (XML)](https://developers.openbox.cloud/sitemap.xml)
- [Mapa del sitio (markdown): todas las páginas del sitio](https://developers.openbox.cloud/sitemap.md)
- [llms.txt: índice de la documentación para modelos de lenguaje](https://developers.openbox.cloud/llms.txt)
- [llms-full.txt: toda la documentación en un solo archivo](https://developers.openbox.cloud/llms-full.txt)
- [Contrato OpenAPI de la API de Partners v1 de Openbox Cloud](https://developers.openbox.cloud/openapi.json)


## Mapa del sitio

El [mapa del sitio](https://developers.openbox.cloud/sitemap.md) lista todas las páginas.
