Pedidos en lenguaje natural
«Pedidos sin confirmar», «ventas por retailer esta semana», «qué salió ayer»: Claude lee la API y te lo resume.
Rithum (Dsco · ChannelAdvisor)
Rithum (antes CommerceHub y ChannelAdvisor) tiene APIs oficiales para pedidos, envíos, inventario y catálogo. Pega un prompt y Claude averigua cuál es la tuya, la conecta primero en solo lectura y solo cambia algo cuando tú lo digas.
Documentos/rithum-claudeClaude te preguntará qué Rithum usas, te ayudará a pedir las credenciales, las leerá de tu portapapeles y te enseñará tus últimos pedidos. Solo tienes que seguirle.
Cuando Claude confirme que está conectado, pídele cosas como:
¿Qué pedidos de dropship siguen sin confirmar?
Resúmeme las ventas de la semana por retailer o marketplace
Compara el stock de esta hoja con el de Rithum y prepárame los cambios para aprobarlos
¿Qué productos de mi catálogo no se han vendido en 60 días?
Cuál de las dos APIs es la tuya, cómo se autentica cada una y a qué prestar atención.
Rithum nació de juntar CommerceHub, ChannelAdvisor y Dsco, y mantiene dos APIs distintas. La Dsco API v3 es para dropship: eres proveedor y los retailers te mandan pedidos para servir. La API de ChannelAdvisor (hoy «Rithum for Brands») es para vender en marketplaces. Cuál es la tuya depende de cómo uses Rithum; el prompt te lo pregunta.
Las dos usan OAuth 2.0 con credenciales que emite Rithum, y las dos cubren pedidos, envíos, inventario y catálogo. No hay MCP, ni oficial ni de la comunidad: la vía para Claude Code es un script propio, y el prompt de arriba lo escribe.
«Pedidos sin confirmar», «ventas por retailer esta semana», «qué salió ayer»: Claude lee la API y te lo resume.
Claude compara tu hoja de stock o la exportación de tu ERP con Rithum y prepara la actualización por artículo. Tú la revisas antes de que se mande nada.
Si también vendes por Faire o NuORDER, Claude cruza los datos de todos los canales en la misma conversación.
GET /order/page exige ordersCreatedSince u ordersUpdatedSince más until, que tiene que ser al menos 5 segundos en el pasado; 31 días como máximo por consulta. Sigue el scrollId (caduca a los 5 minutos) hasta que una página vuelva vacía.
POST /order/acknowledge confirma pedidos y POST /order/singleShipment registra un envío. Las llamadas batch son asíncronas: devuelven un requestId y el resultado se lee en /order/log, /inventory/log o /catalog/log, así que «202 aceptado» todavía no significa «hecho».
GET /v1/Orders con OData ($filter, $select, $expand, $top), 100 por página por defecto; sigue @odata.nextLink en vez de montar tú el $skip. POST /v1/Orders({id})/Ship marca un envío y POST /v1/Products({id})/UpdateQuantity cambia el stock.
Eres proveedor y los retailers te mandan pedidos. Credenciales de cliente, un token por hora, un script de un fichero.
support-dsco@rithum.com con el asunto Create Client Credentials for Me, el nombre de tu organización y los datos de la cuenta. La doc enlaza también un artículo para crearlas uno mismo.POST /oauth2/token (grant_type=client_credentials), envíalo como Authorization: bearer y prueba con GET /hello. Renuévalo cada hora.Vendes en marketplaces a través de Rithum. Developer key, una app y un refresh token.
POST https://api.channeladvisor.com/oauth2/token con Authorization: Basic base64(applicationId:sharedSecret) y grant_type=refresh_token devuelve un access token de una hora. El refresh token caduca a los 30 días sin uso.| La API | Rithum no publica un precio aparte por el acceso a la API; ChannelAdvisor avisa de que las cuentas de prueba se facturan. Pregunta a tu gestor de cuenta. |
| El coste real | Un pedido confirmado o un stock cambiado por error, que ven los retailers. Por eso el prompt empieza en solo lectura y escribe solo con tu OK. |
developer.channeladvisor.com redirige ahora a una página de la base de conocimiento marcada para retirarse; la referencia viva es api.channeladvisor.com/apidocs. Muchos tutoriales siguen apuntando al sitio antiguo.GET /order/page: 10 por segundo) y por cuenta en ChannelAdvisor (2.000 por minuto, 5 a la vez por integración). Con un 429, espera y reintenta con pausas crecientes.