RebundleRebundle Stack
Claude Code Hub

NuORDER

Tu mayorista en NuORDER, desde Claude Code

NuORDER tiene una API oficial para marcas: pedidos, inventario, productos, catálogos y retailers. Pega un prompt y Claude conecta tu portal, primero en solo lectura, y solo cambia algo cuando tú lo digas.

Funciona en Mac, Windows o Linux. Necesitas un portal de marca en NuORDER con acceso de administrador a Settings > API Management (la API es para marcas). Si las claves aún no están ahí, las emite NuORDER: Claude te dirá qué pedir. Empieza en solo lectura y nunca cambia un pedido ni el 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/nuorder-claude
2

Pega este prompt

Claude Code

Claude te preguntará qué quieres, leerá tus claves del portapapeles, te guiará para aprobar la conexión en NuORDER y te enseñará tus pedidos pendientes. Solo tienes que seguirle.

dile esto a claude
Quiero conectar mi portal de marca en NuORDER a Claude Code para consultar pedidos, inventario y productos y, cuando yo lo apruebe, cambiar el estado de pedidos 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 - NuORDER tiene una API oficial para marcas, documentada en https://assets.nuorder.com/api-docs/index.html. 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. - Autenticación OAuth 1.0 con HMAC-SHA1, con una firma que NO es la estándar: la cadena a firmar lleva los parámetros oauth en un orden fijo, sin ordenar ni codificar, el digest va en hexadecimal (no base64) y la clave es consumer_secret&token_secret (con el & final aunque aún no haya token_secret). Una librería OAuth 1.0 normal probablemente firme mal: escribe tú el firmador siguiendo la sección Authentication de la doc. Ojo: el ejemplo oficial en Node.js no pasa oauth_callback ni oauth_verifier a la cabecera y no funciona tal cual. - Alta en tres pasos: GET /api/initiate con oauth_callback=oob y application_name devuelve un token temporal; yo apruebo la aplicación en Admin > Settings > API Management y aparece un verifier en una ventana que no se vuelve a mostrar; GET /api/token con ese oauth_verifier devuelve el token y el token_secret definitivos. - Claves: consumer key y consumer secret están en Admin > Settings > API Management; si no aparecen, las proporciona NuORDER (suele ir dentro de un proyecto de integración con ellos). Cada portal tiene sus propias credenciales. - Hosts: el centro de ayuda da next.nuorder.com como producción y sandbox1.nuorder.com como sandbox; los ejemplos de la doc usan otros. Confirma conmigo en qué dirección abro yo mi portal. - Endpoints útiles: GET /api/orders/{status}/detail (draft, review, pending, approved, processed, shipped, cancelled), GET /api/orders/list?start_date=&end_date= (pedidos modificados en un rango), GET /api/order/{id}, POST /api/order/{id}/{status} (cambiar estado), GET y POST /api/inventory/{id} o /api/inventory/external_id/{id}, GET /api/companies/list (retailers). - Límites: máximo 5 llamadas a la vez. Muchas listas no paginan: acota por estado o por fechas. QUÉ QUIERO QUE HAGAS 1. ENTENDER: pregúntame, de una en una y con opciones para elegir: si quiero solo consultar o también cambiar estados de pedidos o stock; si tengo uno o varios portales; y si prefiero probar primero en el sandbox. 2. REVISAR: comprueba tú mismo que hay curl y python3 o node. Instala lo que falte pidiéndome permiso antes. 3. CLAVES: guíame a Settings > API Management, menú a menú; si algo no coincide con lo que veo, pídeme una captura. Nunca me pidas que te escriba una clave 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. Si las claves no están, redáctame el email para pedírselas a NuORDER. 4. CONECTAR: escribe un script pequeño y legible (un solo fichero) con el firmador, haz el initiate, dime dónde aprobar la aplicación, recoge el verifier por el portapapeles igual que las claves y canjéalo por el token definitivo. Enséñame el script antes de ejecutarlo. 5. PROBAR (solo lectura): los pedidos en estado pending y enséñame en una tabla corta número, retailer, fecha e importe. 6. RECORDAR: crea una skill personal con cómo se usa el script, los endpoints de arriba, la firma y la regla de solo lectura salvo instrucción mía. Reglas: nada de cambiar estados de pedidos, inventario ni productos 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 tengo pendientes de aprobar y de qué retailers?

Resúmeme lo vendido esta temporada por retailer

Compara el stock de esta hoja con el de NuORDER y prepárame los cambios para aprobarlos

¿Qué retailers no han vuelto a pedir desde la temporada pasada?

La API de NuORDER en detalle

Qué cubre la API, cómo funciona su alta con OAuth 1.0 y a qué prestar atención.

La API de NuORDER es la vía oficial para que una marca opere su portal B2B desde código: pedidos por estado, inventario, productos, catálogos, retailers (companies), facturas y pagos. Es para marcas: las integraciones las inicia la marca y no hay API documentada para retailers.

La autenticación es OAuth 1.0 con una firma propia, y cada portal tiene sus credenciales. 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, firmador incluido.

EnlacesDocs de la APIIntegración por API (ayuda)Revisado: octubre 2026

Por qué con Claude Code

La temporada de un vistazo

«Pedidos pendientes de aprobar», «ventas por retailer esta temporada», «quién no ha repetido»: Claude lee la API y te contesta en lenguaje natural.

De NuORDER a tu ERP

El patrón que recomienda NuORDER: exportar los pedidos aprobados y marcarlos processed en el momento. Claude puede preparar esa exportación en el formato que espere tu ERP o tu hoja.

Todos tus canales mayoristas juntos

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

Ejemplos

Pedidos por estado

GET /api/orders/{status}/detail devuelve los pedidos completos de un estado (draft, review, pending, approved, processed, shipped, cancelled); /list en lugar de /detail devuelve solo los IDs. GET /api/orders/list?start_date=&end_date= devuelve los modificados en un rango.

Cambiar el estado de un pedido

POST /api/order/{id}/{status} (o /api/order/number/{number}/{status}). Es la llamada que hay detrás del patrón «exportar y marcar processed», así que también es la que conviene dejar detrás de tu OK.

Inventario

GET y POST /api/inventory/{id}, o por tu propia referencia con /api/inventory/external_id/{id}, que es la cómoda cuando tu stock sale de un ERP.

Cómo añadirlo

Recomendado

API oficial, script propio

Claves de API Management, un alta en tres pasos y un script de un fichero que Claude escribe y tú lees.

  1. 1En el portal, Admin > Settings > API Management muestra la consumer key y el consumer secret. Si no están, las emite NuORDER, normalmente dentro de un proyecto de integración con su equipo.
  2. 2GET /api/initiate (con oauth_callback=oob y application_name) devuelve un token temporal. Aprueba la aplicación en API Management: aparece un verifier una sola vez y no se vuelve a mostrar.
  3. 3GET /api/token con el oauth_verifier devuelve el token y el token secret definitivos. Guarda los cuatro valores en un .env con permisos 600.

Qué cuesta

La APINuORDER no publica precio; su centro de ayuda pide revisar los costes de integración antes de firmar el SOW de integración. Pregunta a tu gestor de cuenta.
El coste realUn pedido movido al estado equivocado o un stock sobrescrito. Por eso el prompt empieza en solo lectura y escribe solo con tu OK.

Bueno saber

  • La firma no es OAuth 1.0 estándar: orden fijo de parámetros, sin ordenar ni codificar, digest en hexadecimal en vez de base64, y la clave conserva el & final mientras no hay token secret. Una librería normal muy probablemente sea rechazada; escribe el firmador desde la sección Authentication de la doc.
  • El ejemplo oficial en Node.js no pasa oauth_callback ni oauth_verifier a la cabecera, así que initiate y token fallan tal cual. Úsalo para ver la forma, no como código que funcione.
  • Hosts: el centro de ayuda da next.nuorder.com (producción) y sandbox1.nuorder.com (sandbox); los ejemplos de la doc usan otros. Usa aquel en el que abres tu portal.
  • Como mucho 5 llamadas a la vez, y las listas de pedidos, productos y companies no documentan paginación: acota por estado o rango de fechas en vez de traerlo todo.

Rebundle · 2026