RebundleRebundle Stack
Claude Code Hub

Rithum (Dsco · ChannelAdvisor)

Tus pedidos de Rithum, desde Claude Code

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.

Funciona en Mac, Windows o Linux. Necesitas una cuenta de Rithum como proveedor o vendedor y credenciales de API, que Rithum emite a petición (Claude te redacta el email). Empieza en solo lectura y nunca confirma un pedido, envía ni cambia stock sin enseñarte lo que va a mandar y esperar tu OK.
1

Abre Claude Code

Tú haces esto
  1. 1Abre Claude Desktop
  2. 2Haz clic en la pestaña Claude Code
  3. 3Elige una carpeta vacía, por ejemplo Documentos/rithum-claude
2

Pega este prompt

Claude Code

Claude 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.

dile esto a claude
Quiero conectar mi cuenta de Rithum a Claude Code para consultar pedidos, inventario y catálogo y, cuando yo lo apruebe, confirmar pedidos, marcar envíos y actualizar stock. No soy técnico: guíame paso a paso, un paso cada vez, y espera a que te confirme antes de seguir. CONTEXTO PARA TI - Rithum nació de juntar CommerceHub, ChannelAdvisor y Dsco, y tiene dos APIs distintas. No hay MCP oficial; la vía es la API con un script propio. Los paths pueden haber cambiado: confírmalos en la doc antes de la primera llamada que escriba algo. 1. Dsco API v3 (dropship: vendo a retailers que me mandan pedidos). Base https://api.dsco.io/api/v3, doc en https://api.dsco.io/doc/v3/reference/. Token con POST /oauth2/token, form-encoded, grant_type=client_credentials, client_id y client_secret; dura una hora; después cada llamada lleva Authorization: bearer <token>. GET /hello sirve de prueba. Las credenciales se piden por email a support-dsco@rithum.com con el asunto "Create Client Credentials for Me" y el nombre de la organización y los datos de la cuenta (la doc enlaza también un artículo para crearlas uno mismo). Existe https://staging-api.dsco.io/api/v3 para pruebas. 2. ChannelAdvisor, hoy "Rithum for Brands" (vendo en marketplaces). Doc en https://api.channeladvisor.com/apidocs. Hace falta una developer key (se pide en https://complete.channeladvisor.com/DeveloperNetwork/RequestApiDevKey.aspx) y una app en https://api.channeladvisor.com/developerconsole (application ID y shared secret); un usuario Group Admin de la cuenta concede el acceso y la consola genera un refresh token. Token: POST https://api.channeladvisor.com/oauth2/token con Authorization: Basic base64(applicationId:sharedSecret) y grant_type=refresh_token; el access token dura una hora y el refresh token caduca a los 30 días sin uso. Endpoints OData: /v1/Orders y /v1/Products con $filter, $select, $expand y $top; pagina con @odata.nextLink. - Dsco, endpoints útiles: GET /order/page (exige ordersCreatedSince u ordersUpdatedSince y until, que tiene que ser al menos 5 segundos en el pasado; rango máximo 31 días; sigue el scrollId, que caduca a los 5 minutos; página vacía = fin), POST /order/acknowledge, POST /order/singleShipment, POST /inventory/singleItem, GET /catalog?itemKey=&value=. Las llamadas batch son asíncronas: devuelven un requestId y el resultado se mira en /order/log, /inventory/log o /catalog/log. - Límites por endpoint (GET /order/page: 10 por segundo). Un 429 se reintenta con espera creciente. QUÉ QUIERO QUE HAGAS 1. ENTENDER: pregúntame, de una en una y con opciones para elegir: si vendo a retailers que me mandan pedidos de dropship (Dsco) o en marketplaces (ChannelAdvisor), si no lo sé ayúdame a averiguarlo por cómo entro a Rithum; si quiero solo consultar o también confirmar, enviar o cambiar stock; y si ya tengo credenciales de API. 2. CREDENCIALES: si no las tengo, redáctame el email o dime qué formulario rellenar, y espera. Cuando las tenga, nunca me pidas que te las escriba en el chat: dime exactamente qué copiar, un dato cada vez; cuando te diga «OK», léelo tú del portapapeles (pbpaste en Mac; Get-Clipboard de PowerShell en Windows) y guárdalo directamente en un sitio privado de mi usuario (mira CÓMO TRABAJAR CONMIGO), sin mostrarlo, repetirlo ni escribirlo en el chat. Comprueba solo que no está vacío y después vacía el portapapeles. 3. REVISAR: comprueba tú mismo que hay curl y python3 o node. Instala lo que falte pidiéndome permiso antes. 4. CONECTAR: escribe un script pequeño y legible (un solo fichero) que pida el token, lo renueve cuando caduque y haga las llamadas de lectura. Enséñamelo antes de ejecutarlo. 5. PROBAR (solo lectura): los pedidos de los últimos 7 días, y enséñame en una tabla corta fecha, retailer o canal, estado e importe. 6. RECORDAR: crea una skill personal con qué API uso, cómo se usa el script, los endpoints de arriba y la regla de solo lectura salvo instrucción mía. Reglas: nada de confirmar pedidos, crear envíos ni tocar inventario o catálogo salvo que yo lo pida de forma explícita, y en ese caso enséñame antes exactamente qué vas a mandar y espera mi OK. Antes de un cambio de stock en bloque, guarda una copia del stock actual. Si algo falla, explícamelo en lenguaje sencillo antes de intentar arreglarlo. CÓMO TRABAJAR CONMIGO - Explícame cada paso como a un niño de 10 años: frases cortas, sin jerga y, si usas una palabra técnica, dime en una línea qué es. Si te digo que soy técnico, ve al grano. - Cuando tengas que preguntarme algo, hazlo de una pregunta en una y con opciones para elegir (usa la herramienta de preguntas con opciones si la tienes), con una línea que explique cada opción. - Si hay que instalar algo, dime en una línea qué es y para qué sirve, y ofrécete a instalarlo tú con mi permiso. Si algo falla, cuéntame en palabras sencillas qué ha pasado y cuál es el siguiente intento, antes de probarlo. - Lo que te cuento arriba puede haberse quedado viejo. Antes de empezar, comprueba en la documentación oficial que sigue vigente; si algo no coincide, manda la documentación y dime qué ha cambiado. - Si tienes navegador (el navegador integrado de la app de Claude o Claude in Chrome), hazlo tú todo lo que puedas en vez de mandarme a una web: ábrela tú, navega hasta la pantalla exacta, rellena lo que no sea secreto y léeme lo que haga falta. Si arriba pone que yo vaya a una página o pulse algo, tómalo como lo que hay que conseguir y hazlo tú con el navegador. Pídeme a mí, de un paso en uno, solo lo que no puedes hacer: iniciar sesión, aprobar permisos, pagar o copiar una clave; tú no escribes contraseñas ni claves en ninguna web. Si no tienes navegador, entonces guíame con instrucciones. - Si hacen falta claves o algo más para conectarte (scripts, configuración), guárdalo en un sitio fijo de mi usuario, fuera de esta carpeta y de cualquier repositorio, que solo yo pueda leer. Nunca en el chat ni dentro de una skill. - La skill de RECORDAR, hazla personal (que funcione desde cualquier carpeta) y apunta en ella: cómo conectarte, con qué cuenta o usuario, dónde están las claves (el sitio, nunca el valor), qué suelo pedirte, las reglas de arriba y la fecha en que comprobaste la documentación. Si algo deja de funcionar porque el servicio cambió, mira la documentación, arréglalo y actualiza la skill. - Mis preferencias y lo que haya fallado van en un LEARNINGS.md aparte, en la misma carpeta de esa skill (una línea por aprendizaje, con fecha y el porqué). El primer paso de la skill es leerlo y aplicarlo. Para que nunca se te olvide proponer aprendizajes nuevos al terminar, añade al frontmatter de su SKILL.md este hook, cambiando <nombre-de-la-skill> por su nombre (inyecta un recordatorio una vez por uso; no lo cambies por un bloqueo, que entra en bucle): hooks: Stop: - hooks: - type: command once: true command: | grep -q '"stop_hook_active":true' && exit 0 echo '{"hookSpecificOutput":{"hookEventName":"Stop","additionalContext":"Antes de terminar: si en este uso de la skill <nombre-de-la-skill> el usuario corrigió algo, algo falló o mostró una preferencia, propón de 0 a 3 aprendizajes para su LEARNINGS.md (fecha, una línea y el porqué), enséñalos y pide OK antes de escribirlos. Si ya propusiste aprendizajes en este turno, no los repitas. Si no hay nada que aprender, termina sin añadir nada."}}'

Después, prueba con estos

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?

Las APIs de Rithum en detalle

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.

EnlacesDocs de la Dsco API v3Docs de la API de ChannelAdvisorRevisado: octubre 2026

Por qué con Claude Code

Pedidos en lenguaje natural

«Pedidos sin confirmar», «ventas por retailer esta semana», «qué salió ayer»: Claude lee la API y te lo resume.

Stock sin teclear dos veces

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.

Todos tus canales mayoristas juntos

Si también vendes por Faire o NuORDER, Claude cruza los datos de todos los canales en la misma conversación.

Ejemplos

Leer pedidos (Dsco)

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.

# Token (one hour), then a connection test
curl -s -X POST https://api.dsco.io/api/v3/oauth2/token -d grant_type=client_credentials -d client_id=$DSCO_ID -d client_secret=$DSCO_SECRET
curl -s -H "Authorization: bearer $DSCO_TOKEN" https://api.dsco.io/api/v3/hello

Confirmar y enviar (Dsco)

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».

Pedidos de marketplaces (ChannelAdvisor)

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.

Cómo añadirlo

Dropship

Dsco API v3

Eres proveedor y los retailers te mandan pedidos. Credenciales de cliente, un token por hora, un script de un fichero.

  1. 1Pide las credenciales: email a 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.
  2. 2Pide el token con POST /oauth2/token (grant_type=client_credentials), envíalo como Authorization: bearer y prueba con GET /hello. Renuévalo cada hora.
Marketplaces

API de ChannelAdvisor

Vendes en marketplaces a través de Rithum. Developer key, una app y un refresh token.

  1. 1Pide una developer key y registra una app en la Developer Console (application ID y shared secret). Un Group Admin de la cuenta concede el acceso y la consola genera un refresh token.
  2. 2POST 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.

Qué cuesta

La APIRithum 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 realUn 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.

Bueno saber

  • 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.
  • Los límites van por endpoint en Dsco (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.
  • Si prefieres no mantener la integración, Pipe17 vende un servidor MCP sobre sus propios datos de pedidos e inventario, que se pueden alimentar desde Rithum. Es un tercero de pago, no Rithum.

Rebundle · 2026