> ## 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. # Configura tu integración > Genera tus credenciales de API, configura tus métodos de envío y tus webhooks en la app de Cubbo. Configuras la integración tú mismo en la app de Cubbo, en [app.cubbo.com](https://app.cubbo.com/stores). Hazlo primero en tu tienda de pruebas, que crea para ti el equipo de soporte de Cubbo o tu asesor de cuenta, y repítelo en tu cuenta de producción cuando esté activada. Cada cuenta tiene sus propias credenciales. ## 1. Crea la integración Open API **1. Abre Integraciones** En el menú superior, abre **Integraciones** y haz clic en **Crear Integración**. Elige **Open API**. **2. Llena el formulario** **URL del Webhook** es opcional. Si la pones, debe ser HTTPS, y Cubbo envía un `POST` de prueba para verificar que responde. **Nota** es una etiqueta opcional para tu equipo. Haz clic en **Crear Integración**. ![Formulario Configurar Integración Open API con URL del webhook y nota](https://mintcdn.com/cubbo/RGfmvgvbM1HVXepF/images/setup/open-api-form.png?fit=max\&auto=format\&n=RGfmvgvbM1HVXepF\&q=85\&s=b1c9646c06b3617637ddd39af922287e) **3. Guarda tus credenciales** La app muestra tu `client_id` y tu `client_secret`. Copia ambos ahora y guárdalos en un lugar seguro. ![Pantalla de integración creada con Client ID, Client Secret y Tiendas Autorizadas](https://mintcdn.com/cubbo/RGfmvgvbM1HVXepF/images/setup/credentials.png?fit=max\&auto=format\&n=RGfmvgvbM1HVXepF\&q=85\&s=0933cfff4dd6f66b6d8080831dd16154) En **Tiendas Autorizadas** también aparecen las tiendas a las que tienen acceso esas credenciales, por ejemplo *Estas credenciales tienen acceso a las tiendas: 1234*. Cada número es un `store_id`: el valor que envías en `store_id` en órdenes, productos, inventario y los demás endpoints de tienda. Si aparece más de una tienda, las mismas credenciales sirven para todas; cambia el `store_id` para elegir la tienda. > [!WARNING] > > El `client_secret` se muestra una sola vez. Si lo pierdes, tienes que regenerar las credenciales, y las anteriores > dejan de funcionar de inmediato. Usa estas credenciales con `POST /v1/auth/token`. Consulta [Autenticación](https://developers.cubbo.com/es/guides/authentication.md). ## 2. Administra la integración Tu integración Open API aparece en **Integraciones** como una tarjeta. Desde ahí puedes: * **Activar o desactivar** la integración con el interruptor. Mientras está desactivada, Cubbo no procesa ninguna creación ni actualización que venga de ella. * Abrir **Métodos de envío** para configurar tus métodos de envío. La etiqueta indica si ya están configurados. * Abrir **Configurar Webhooks** para definir a dónde envía Cubbo los eventos. La etiqueta indica si están configurados o con errores. * **Regenerar Credenciales** si un secreto se perdió o quedó expuesto. Las credenciales actuales dejan de funcionar de inmediato. ![Tarjeta de la integración Open API con métodos de envío, webhooks y regenerar credenciales](https://mintcdn.com/cubbo/RGfmvgvbM1HVXepF/images/setup/integration-card.png?fit=max\&auto=format\&n=RGfmvgvbM1HVXepF\&q=85\&s=8caa6d61ccea1b68a0cbbbda54b8c9df) ## 3. Configura los métodos de envío Cada orden que creas debe indicar cómo se envía. Lo haces con `shipping_line_code` en `POST /v1/orders`: su valor es el nombre de un método de envío de tu integración. Cubbo elige la paquetería con la configuración de envío asignada a ese método. ![Página de métodos de envío de la integración con el interruptor de puntos de recolección](https://mintcdn.com/cubbo/RGfmvgvbM1HVXepF/images/setup/shipping-methods.png?fit=max\&auto=format\&n=RGfmvgvbM1HVXepF\&q=85\&s=6cf4375c4f3ccdf778666fcda442cca6) **1. Crea una configuración de envío** Haz clic en **Crear configuración de envío** y llena: * **Nombre de la configuración**. * **Tipo de destino**: Nacional, Internacional o Recolección. * **Preferencia de entrega**: mejor precio elige la paquetería más económica; mejor servicio elige la entrega más rápida al menor precio. * **Permitir zonas extendidas**: si se envía a zonas remotas que pueden tener un cargo adicional. Cubbo considera ese costo al seleccionar la paquetería. * **Paqueterías elegibles**: las paqueterías que puede usar esta configuración, agrupadas por nivel de servicio. ![Ventana Crear configuración de envío con tipo de destino, preferencia de entrega, zonas extendidas y paqueterías elegibles](https://mintcdn.com/cubbo/RGfmvgvbM1HVXepF/images/setup/create-shipping-configuration.png?fit=max\&auto=format\&n=RGfmvgvbM1HVXepF\&q=85\&s=26123b5ab1224495675558adea5b7506) **2. Agrega tus métodos de envío** Haz clic en **Crear método de envío**. En **Método de Envío de la Integración**, escribe el nombre exacto que enviarás como `shipping_line_code`, por ejemplo `standard` o `express`. Tus órdenes deben enviar exactamente este nombre: distingue mayúsculas y minúsculas y cuentan los espacios, así que `Express` y `express` son métodos distintos. Elige su **Tipo de método de envío**: | Tipo | Úsalo para | | - | - | | Nacional | Envíos dentro del país. | | Internacional | Envíos a otros países. | | Contra Reembolso | Envíos nacionales que se pagan al entregar. | | Recolección | Envíos externos con guía propia. | ![Ventana Agregar Método de Envío con el nombre y el tipo del método](https://mintcdn.com/cubbo/RGfmvgvbM1HVXepF/images/setup/add-shipping-method.png?fit=max\&auto=format\&n=RGfmvgvbM1HVXepF\&q=85\&s=661c3128a9e98c7765e98e419f7a748a) **3. Asigna una configuración a cada método** En la lista de métodos de envío, asigna una de tus configuraciones de envío a cada método. Cubbo la usa para seleccionar automáticamente la mejor paquetería. > [!TIP] > > Activa **Puntos de Recolección** en la misma página si ofreces click and collect. Consulta los endpoints de Click and > collect en la referencia de la API. ## 4. Configura los webhooks Haz clic en **Configurar Webhooks** en la tarjeta de la integración. Activa cada webhook que necesites y escribe su URL: | Webhook | Eventos que recibe | | - | - | | **Webhook de Órdenes** | `orderUpdated`, `orderFulfilled`, `shippingUpdated` | | **Webhook de Inventario** | `inventoryMovement`. Solo envía mientras el webhook de órdenes está activo. | | **Webhook de Recibos de Inventario** | `replenishmentCreated`, `replenishmentScheduled`, `replenishmentStatus` | ![Pantalla Configurar Webhooks con los webhooks de órdenes, inventario y recibos de inventario, y el secreto compartido](https://mintcdn.com/cubbo/RGfmvgvbM1HVXepF/images/setup/configure-webhooks.png?fit=max\&auto=format\&n=RGfmvgvbM1HVXepF\&q=85\&s=351907fea5d35cfa00ed065237ee5b1d) En la misma pantalla: * **Headers Personalizados** agrega headers fijos a cada solicitud de webhook, por ejemplo una API key de tu endpoint. * **Probar** envía una solicitud de prueba. Pasa cuando tu URL responde `200`. * **Secreto Compartido del Webhook** es la llave para verificar la firma. Haz clic en **Ver secreto** para copiarla. * **Regenerar secreto compartido del webhook** invalida el secreto actual. Actualízalo en tu sistema después de guardar. Las URL deben usar HTTPS y un nombre de dominio; las direcciones IP se rechazan. La tarjeta de la integración muestra si cada webhook funciona y cuándo fue el último envío exitoso. Consulta [Webhooks](https://developers.cubbo.com/es/guides/webhooks.md) para ver los eventos, los payloads y la verificación de la firma. ## 5. Pasa a producción Cuando termines todas tus pruebas en la tienda de pruebas, pide a tu asesor de cuenta que active tu cuenta de producción. Repite estos pasos ahí: obtienes credenciales nuevas y un `store_id` nuevo, y vuelves a configurar los métodos de envío y los webhooks. Después cambia las credenciales y el `store_id` en tu integración para empezar a operar. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.