# Documentazione per sviluppatori di TradeCatalog

> Connetti i tuoi sistemi e le tue app AI a TradeCatalog con l'API REST, il server MCP e i documenti pronti per LLM.

TradeCatalog conserva il catalogo di un fornitore di commercio, i prezzi dei clienti, gli ordini e i cambiamenti dei prezzi in un unico posto. Questi documenti coprono i modi in cui il software può lavorare con questi dati.

Per le famiglie di cataloghi, prodotti misurati, tabelle di taglie e importazioni revisionate, consulta [Configura il tuo catalogo commerciale](/docs/guides/trade-catalogues).

## Tre modi di accesso

### API REST

Per i vostri sistemi: ERP, controllo magazzino, contabilità, uno script notturno. Gli amministratori creano una chiave API in **Impostazioni → API**. La chiave funziona su un'unica area di lavoro con diritti di personale.

- Leggere prodotti con i prezzi di qualsiasi cliente, clienti, ordini, cambiamenti dei prezzi e il registro delle attività.
- Creare e aggiornare prodotti e clienti in lotti di 100.
- Spostare gli ordini (confermati, spediti, completati, annullati).

Inizia con il [avvio rapido](/docs/quickstart), poi leggi la [panoramica dell'API REST](/docs/api).

### Server MCP per app AI

Per le persone che utilizzano Claude, ChatGPT, Cursor o qualsiasi client MCP. Ogni persona si connette con il proprio login TradeCatalog e approva l'accesso in lettura, opzionalmente con l'accesso in scrittura e modifiche revisionate. L'app AI vede esattamente ciò che quella persona vede nell'app: il personale vede le proprie aree di lavoro, i compratori vedono i propri prezzi.

Guarda [Connetti un'app AI](/docs/mcp) e gli strumenti [MCP](/docs/mcp/tools).

### Documenti per LLM

Ogni pagina qui è anche markdown semplice. Aggiungi `.md` a qualsiasi URL delle documentazioni, oppure scarica [/llms-full.txt](/llms-full.txt) per ottenere tutte le pagine in un unico file. Ogni pagina ha i pulsanti **Copia pagina** e **Apri in Claude**. Guarda [Risorse su AI e LLM](/docs/guides/llms).

## Quale usare?

| Vuoi fare…                                                              | Usare                             |
| ----------------------------------------------------------------------- | --------------------------------- |
| Sincronizza prodotti e clienti dal tuo ERP ogni sera                    | [REST API](/docs/guides/erp-sync) |
| Estrai nuovi ordini nei tuoi account o nel tuo sistema di gestione      | [REST API](/docs/api/orders)      |
| Chiedi "Quanto paga Oakfield Joinery per HX-8510?" in chat              | [MCP](/docs/mcp)                  |
| Lascia che un acquirente controlli i propri prezzi dalla propria app AI | [MCP](/docs/mcp)                  |
| Genera un client tipizzato per il tuo codice                            | [OpenAPI](/docs/api/openapi)      |

## Cosa non è ancora disponibile

- **Webhook.** Poll [`GET /orders?status=new`](/docs/api/orders) ogni pochi minuti.
- **Pubblicazione di modifiche ai prezzi tramite API.** I listini modificati vengono inseriti in un bozza che tu revisioni e pubblichi nell'app. Vedi [Modifiche ai prezzi](/docs/api/price-changes).
- **Cancellazione di prodotti o clienti tramite API.** Disattiva o rimuovi un prodotto nell'app.
- **Chiavi per gli acquirenti.** Gli acquirenti utilizzano [MCP](/docs/mcp) o scaricano il loro listino prezzi in formato CSV dal loro portale commerciale.

Hai bisogno di aiuto per una connessione? Vedi [Contatta il supporto](/docs/support).

Qualcosa mancante che ti serve? Invia una mail al supporto dal tuo spazio di lavoro (Supporto nel menu) e dirci cosa stai costruendo.