Pedidos en lenguaje natural
«Pedidos nuevos desde el lunes», «qué retailers repiten», «qué falta por enviar»: Claude lee la API y te lo resume.
Faire · marcas
Faire tiene una API oficial para marcas: productos, pedidos, envíos e inventario. Pega un prompt y Claude conecta tu cuenta de marca, primero en solo lectura, y solo cambia algo cuando tú lo digas.
Documentos/faire-claudeClaude te preguntará qué quieres, te dirá exactamente dónde generar el token en Faire, lo 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 nuevos han entrado esta semana y de qué retailers?
¿Qué pedidos aceptados siguen sin envío?
Compara el stock de esta hoja con el de Faire y prepárame los cambios para aprobarlos
¿Cuáles son mis 10 productos más pedidos este trimestre?
Qué cubre la API, las dos formas de entrar y a qué prestar atención.
La Faire External API v2 es la vía oficial para que una marca opere su cuenta de Faire desde código: productos y variantes, pedidos, envíos e inventario. URL base https://www.faire.com/external-api/v2. Es para marcas: los retailers no tienen API documentada; si compras en Faire para tu tienda, tu guía es Faire para compradores.
Dos formas de entrar: un token que la marca genera en su portal (lo que Faire recomienda para una sola marca) u OAuth con una app registrada en el Developer Portal (para partners que integran muchas marcas). No hay MCP oficial: la vía para Claude Code es un script propio sobre la API, y el prompt de arriba lo escribe.
«Pedidos nuevos desde el lunes», «qué retailers repiten», «qué falta por enviar»: Claude lee la API y te lo resume.
Claude compara tu hoja de stock o la exportación de tu ERP con Faire y prepara la actualización por SKU. Tú la revisas antes de que se mande nada.
Si también vendes por NuORDER o Rithum, Claude cruza los datos de todos los canales en la misma conversación.
GET /orders filtra por updated_at_min, created_at_min y excluded_states: no hay filtro de los estados que quieres, solo de los que excluyes. Hasta 50 pedidos por página; pagina con page y limit o con cursor (el cursor no se combina con filtros).
PUT /orders/{order_id}/processing acepta un pedido (con expected_ship_date opcional); POST /orders/{order_id}/shipments añade el envío con transportista y código de seguimiento.
PATCH /product-inventory/by-skus con inventories: [{sku, on_hand_quantity}]. Los endpoints antiguos de inventory-levels se retiraron el 1 de junio de 2026: un tutorial que aún los use está desfasado.
Una marca, un token del portal, un script pequeño que escribe Claude. Empieza en solo lectura.
.env con permisos 600, fuera de cualquier repo, y pruébalo con GET /brands/profile.Para agencias o partners que conectan más de una marca.
applicationId y applicationSecret, y pide solo los scopes que necesites (READ_ORDERS, READ_PRODUCTS… antes que cualquier WRITE_).https://faire.com/oauth2/authorize, canjea el code (dura 10 minutos) en POST https://www.faire.com/api/external-api-oauth2/token y envía X-FAIRE-APP-CREDENTIALS más X-FAIRE-OAUTH-ACCESS-TOKEN en cada llamada.| La API | Parte de la cuenta de marca: el token se genera en el portal y Faire no publica un precio aparte por ella. |
| El coste real | Un pedido aceptado o un stock cambiado por error. Por eso el prompt empieza en solo lectura y escribe solo con tu OK. |
X-FAIRE-ACCESS-TOKEN del token del portal viene de la doc v2 anterior. Pruébala con GET /brands/profile antes de construir encima.idempotency_token: derívalo de la operación (pedido y fecha, por ejemplo) para que un reintento no cree un duplicado.429: prueba en solo lectura sobre la cuenta real y espera antes de reintentar cuando salga un 429.