Desarrollá con IA

​

Qué le podés dar a la IA

​

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

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) 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).
• 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). 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 y corré el flujo completo (instalar, llamar a la API, recibir un webhook) antes de enviar a revisión.