> ## Documentation Index
> Fetch the complete documentation index at: https://developers.cubbo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> Integra tu tienda, ERP o marketplace con la red de fulfillment de Cubbo a través de la Clients API.

La Clients API de Cubbo te permite conectar tus propios sistemas con la operación de fulfillment de Cubbo. Envías órdenes,
mantienes sincronizados tu catálogo y tu stock, anuncias envíos entrantes de reabastecimiento (replenishment), gestionas devoluciones y recibes
webhooks cuando algo cambia en el almacén o durante la entrega.

La API es una API REST en JSON disponible en:

```text theme={"dark"}
https://api.cubbo.com/v1
```

Todas las solicitudes, excepto la creación del token, llevan un token `Bearer`. Consulta [Autenticación](https://developers.cubbo.com/es/guides/authentication.md).

## Tienda de pruebas y cuenta de producción

Cubbo tiene un solo entorno: producción. No hay un sandbox aparte. En su lugar, pruebas tu integración en una
**tienda de pruebas** antes de empezar a operar:

1. **Contacta a Cubbo.** Escribe al equipo de soporte de Cubbo o a tu asesor de cuenta. Ellos te orientan en el
   proceso y crean tu tienda de pruebas, que Cubbo marca como cuenta de prueba.
2. **Haz todas tus pruebas en la tienda de pruebas.** Crea la integración y sus credenciales, configura los métodos
   de envío y los webhooks, y prueba cada endpoint que use tu integración.
3. **Activa tu cuenta de producción.** Cuando termines tus pruebas, pide a tu asesor de cuenta que active tu cuenta
   de producción. Tiene sus propias credenciales y su propio `store_id`.

> [!WARNING]
>
> La cuenta de prueba y la de producción nunca comparten credenciales. Al salir a producción, reemplaza en tu
> integración el `client_id`, el `client_secret` y el `store_id` por los de producción.

## Qué puedes hacer

> [card] [Órdenes](https://developers.cubbo.com/api-reference/orders/create-an-order.md)
>
> Crea órdenes de venta, actualízalas antes de que se surtan, ponlas en pausa o cancélalas, y consulta su estado de fulfillment y de entrega.

> [card] [Inventario](https://developers.cubbo.com/api-reference/inventory/list-products-with-stock.md)
>
> Crea y actualiza productos, consulta el stock disponible por almacén y gestiona lotes.

> [card] [Reabastecimientos](https://developers.cubbo.com/api-reference/replenishments/create-a-replenishment.md)
>
> Anuncia envíos entrantes al almacén y da seguimiento a lo que se recibió.

> [card] [Devoluciones](https://developers.cubbo.com/api-reference/returns/request-a-return-for-a-shipped-order.md)
>
> Registra una devolución, da seguimiento a su recepción y decide qué hacer con las unidades devueltas.

> [card] [Envíos](https://developers.cubbo.com/api-reference/shipping-methods/list-active-shipping-methods-available-to-a-store.md)
>
> Lista los métodos de envío disponibles para una tienda, revisa la cobertura por código postal y cotiza un envío.

> [card] [Webhooks](https://developers.cubbo.com/es/guides/webhooks.md)
>
> Recibe notificaciones HTTPS firmadas para eventos de órdenes, envíos, inventario y reabastecimientos.

## Antes de empezar

**1. Pide tu tienda de pruebas**

Contacta al equipo de soporte de Cubbo o a tu asesor de cuenta. Te orientan y crean tu tienda de pruebas, con
acceso a la app de Cubbo.

**2. Configura la integración en la app**

En la app de Cubbo, abre **Integraciones**, crea una integración **Open API** y copia tu `client_id` y tu
`client_secret`. Después configura tus métodos de envío y tus webhooks. Consulta
[Configura tu integración](https://developers.cubbo.com/es/guides/setup.md).

**3. Cámbialas por un token**

Llama a `POST /v1/auth/token` y usa el token que recibes como token `Bearer` en todas las demás solicitudes.

**4. Conoce el ID de tu tienda**

La mayoría de los endpoints reciben un `store_id`. Lo encuentras en **Tiendas Autorizadas** cuando creas o
regeneras las credenciales en la app. Una cuenta de API puede tener acceso a varias tiendas; la API solo responde
por las tiendas que tiene permitido ver.

**5. Pasa a tu cuenta de producción**

Cuando termines tus pruebas, pide a tu asesor de cuenta que active tu cuenta de producción. Configura ahí
también la integración: tiene credenciales y un `store_id` distintos. Cámbialos en tu integración para empezar
a operar.

> [card] [Inicio rápido](https://developers.cubbo.com/es/quickstart.md)
>
> Crea tu primera orden en cinco minutos.

## Convenciones

* Los cuerpos de las solicitudes y respuestas son JSON (`Content-Type: application/json`).
* Las fechas y horas son cadenas ISO 8601 en UTC, salvo que el campo indique otra cosa.
* Los campos de montos son decimales en la moneda de la tienda.
* Los identificadores (`id`, `store_id`, `order_id`) son enteros. `order_number` es tu propia referencia y es una cadena.
* Los errores siempre regresan como un objeto JSON con una llave `error`. Consulta [Errores](https://developers.cubbo.com/es/guides/errors.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.