Todo el flujo usa la API de Chateea. Para obtener las credenciales de desarrollador, la URL base y la documentación de referencia de cada endpoint, escribe a soporte de Chateea en [email protected].
Cómo funciona el flujo
1. Crea la app
Crea tu app en el Marketplace de aplicaciones para desarrolladores: completa el perfil, agrega los permisos (scopes) de OAuth que necesitas y genera las credenciales de cliente (Client ID y Client Secret). Esto define la identidad de tu app y lo que puede hacer. Agrega los permisos según las API que vayas a usar: productos, precios, pedidos, despachos y webhooks.2. Gestiona la autorización
- Configura la URL de redirección de OAuth en los ajustes de la app.
- Crea un endpoint GET de retorno que reciba el código de autorización.
- Intercambia ese código por los tokens de acceso y de actualización, y guárdalos de forma segura.
- Crea un endpoint POST para webhooks y registra su URL en los ajustes de la app.
- Instala la app en la cuenta del negocio y verifica la conexión.
3. Sincroniza productos del proveedor a Chateea
Primero creas el producto y después uno o varios precios para ese producto. Un producto simple tiene un solo precio. Un producto con variantes lleva un precio por cada combinación. Crear el producto. Incluye los campos principales:name,locationId(el identificador de la cuenta),descriptionproductType(PHYSICALoDIGITAL)availableInStore,imageymedias- Para productos con variantes:
variantscon sus opciones (por ejemplo, color y talla). Guarda los ID de las opciones, porque los necesitas al crear los precios.
_id del producto e incluye:
locationId,type(one_timeorecurring),currency,amountysku- Opciones de inventario, si aplican
- Para variantes:
variantOptionIdscon la combinación exacta (por ejemplo, color rojo y talla chica) - Para productos físicos:
shippingOptionscon el peso (value,unit) y las dimensiones (length,width,height,unit)
medias del producto con los priceIds para que la tienda muestre la imagen correcta de cada variante.
4. Recibe los pedidos de Chateea
Suscríbete a dos webhooks:
Con estos datos arma el pedido en el formato del proveedor: artículos asociados a sus SKU, direcciones y totales.
5. Envía el despacho de vuelta a Chateea
Suscríbete a los webhooks de envío o despacho de tu proveedor. Cuando se cree o actualice un envío, registra el despacho del pedido correspondiente con la API de despachos de pedidos de Chateea:- Pedido: el ID interno del pedido en Chateea.
- Artículos: los identificadores de precio o variante y las cantidades despachadas.
- Seguimiento:
trackingNumber,shippingCarrierytrackingUrl. - Aviso al cliente: opcional, con
notifyCustomer.
6. Agrega páginas propias (opcional)
Si tu integración necesita pantallas dentro de Chateea, usa las páginas personalizadas de la app. Sirven para asistentes de conexión, pasos de verificación, preferencias de envío, asociación de servicios de transportista o páginas de ayuda. Para identificar de forma segura al usuario y a la cuenta que instaló la app, recibe y valida el contexto de usuario que Chateea envía al cargar tu página.Resumen
- Crea la app con sus permisos y completa la autorización con OAuth.
- Sincroniza el catálogo con las API de productos y precios.
- Escucha los webhooks de pedidos para enviarlos al proveedor.
- Escucha los envíos del proveedor y registra los despachos en Chateea.
- Si lo necesitas, agrega páginas propias con el contexto del usuario.
Artículos relacionados
Crea un producto con precio por API
Ejemplos para crear productos y precios.
Transportista personalizado por API
Ofrece tarifas de envío desde tu propio sistema.
Integraciones privadas
Conecta tus sistemas con tu cuenta.
Integración con Printify
Un ejemplo de proveedor ya integrado.