> ## Documentation Index
> Fetch the complete documentation index at: https://docs.commercy.com.ar/llms.txt
> Use this file to discover all available pages before exploring further.

# Desarrollá con IA

> Cómo darle esta documentación a Claude, Codex o Cursor para armar tu app, con un prompt listo.

Podés armar tu app de Commercy con un asistente de IA (Claude Code, Codex, Cursor u otro) dándole la documentación como contexto. La forma tradicional sigue igual: estas mismas páginas son la referencia, y la IA lee exactamente el mismo contenido en markdown plano.

## Qué le podés dar a la IA

| Qué | URL | Para qué |
| - | - | - |
| Toda la documentación | `https://docs.commercy.com.ar/llms-full.txt` | Un solo archivo con el contexto, el checklist de punta a punta, todas las páginas y las reglas para asistentes. Es lo recomendado. |
| Índice | `https://docs.commercy.com.ar/llms.txt` | Lista de páginas con una línea de descripción, en el formato llms.txt. |
| Una página | `https://docs.commercy.com.ar/oauth.md` | Cualquier página de la documentación en markdown plano: cambiá `oauth` por el nombre de la página. |

## Cómo dárselo

* **Pasale la URL.** En Claude Code, Codex o Cursor pegá `https://docs.commercy.com.ar/llms-full.txt` en el primer mensaje y pedile que la lea antes de escribir código.
* **Copialo y pegalo.** En cualquier página de la documentación usá el menú **Copy page** (arriba a la derecha): deja la página que estás viendo en el portapapeles, lista para pegar en el chat. Para toda la documentación de una vez, usá la URL de `llms-full.txt`.
* **Dejalo en el proyecto.** Si trabajás con un agente de código, guardá el archivo en tu repositorio (por ejemplo `docs/commercy.md`) y mencionalo en las instrucciones del agente.

## Prompt de arranque

Copiá y completá lo que está entre corchetes:

```text theme={null}
Vas a construir una app de Commercy. Antes de escribir código, leé la documentación
completa en https://docs.commercy.com.ar/llms-full.txt y seguí sus reglas para asistentes de IA.

Qué quiero construir: [descripción de la app, por ejemplo "sincronizar el stock con mi ERP"].
Scopes que necesita (los mínimos): [por ejemplo read_products, write_stock].
Stack: [lenguaje y framework del servidor].

Reglas:
- Usá sólo los endpoints documentados; si algo no está en la documentación, preguntame.
- OAuth con PKCE (S256) en el servidor, con el refresh token rotativo de un solo uso.
- Los secretos (client secret, secreto de webhook, tokens) van en variables de entorno, nunca en el código.
- Implementá los 4 webhooks obligatorios y verificá la firma con el cuerpo crudo y el timestamp.
- Mandá Idempotency-Key en las escrituras y respetá Retry-After ante un 429.

Empezá con un plan corto de los pasos y esperá mi OK antes de implementar.
```

## Recomendaciones

* **Probá en una tienda demo.** Creá una desde el portal (ver [Primeros pasos](/quickstart)) y apuntá ahí a la IA mientras desarrollás. Datos ficticios, cero riesgo para un comercio real.
* **Pedí los scopes mínimos.** Decile a la IA exactamente qué scopes puede usar; cada scope extra se revisa y se le muestra al comerciante (ver [Scopes y permisos](/scopes)).
* **Verificá la firma de los webhooks.** Es lo que más se omite o se hace mal: tiene que calcularse sobre el cuerpo crudo, con el timestamp, en tiempo constante (ver [Webhooks](/webhooks#verificar-la-firma)). Probala con el vector de prueba de esa página.
* **No pegues secretos en el chat.** Ni el client secret ni el secreto de webhook ni tokens: pasalos por variables de entorno.
* **Revisá lo que genera.** Contrastá los endpoints y los campos con la [referencia de la API](/api) y corré el flujo completo (instalar, llamar a la API, recibir un webhook) antes de enviar a revisión.

<Note>
  Si la IA inventa un endpoint o un campo, pedile que cite la página de la documentación de donde lo sacó. La API rechaza los parámetros desconocidos con `400 invalid_request`.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.