# TradeCatalog-Entwicklerdokumentation

> Verbinden Sie Ihre Systeme und KI-Apps mit TradeCatalog über die REST API, den MCP-Server und LLM-freundliche Dokumente.

TradeCatalog speichert das Katalogverzeichnis eines Handelslieferanten, Kundenpreise, Bestellungen und Preisanpassungen an einem Ort. Diese Dokumente beschreiben die Weisen, wie Software mit dieser Daten arbeiten kann.

Für Katalogfamilien, gemessene Produkte, Größentabellen und überprüfte Importe siehe [Richten Sie Ihren Handelskatalog ein](/docs/guides/trade-catalogues).

## Drei Wege hinein

### REST API

Für Ihre eigenen Systeme: ERP, Lagerverwaltung, Buchhaltung, eine Nacht-Script. Eigentümer erstellen einen API-Schlüssel in **Einstellungen → API**. Der Schlüssel funktioniert in einem Workspace mit Mitarbeiterrights.

- Produkte mit den Preisen jedes Kunden, Kunden, Bestellungen, Preisanpassungen und dem Aktivitätsprotokoll abrufen.
- Produkte und Kunden in Gruppen von 100 erstellen und aktualisieren.
- Bestellungen verschieben (bestätigt, versandt, abgeschlossen, storniert).

Starten Sie mit dem [Quickstart](/docs/quickstart), dann lesen Sie die [REST API-Übersicht](/docs/api).

### MCP Server für KI-Apps

Für Menschen, die Claude, ChatGPT, Cursor oder jeden MCP-Client verwenden. Jede Person meldet sich mit ihrem eigenen TradeCatalog-Anmeldenamen an und genehmigt den Lesezugriff, optional mit Schreibzugriff und überprüften Änderungen. Die KI-App sieht dann genau das, was diese Person in der App sieht: Mitarbeiter sehen ihre Workspaces, Käufer sehen ihre eigenen Preise.

Siehe [KI-App verbinden](/docs/mcp) und die [MCP-Tools](/docs/mcp/tools).

### Dokumentation für LLMs

Jede Seite hier ist auch reiner Markdown. Fügen Sie `.md` zu jeder Dokumentations-URL hinzu, oder laden Sie [/llms-full.txt](/llms-full.txt) herunter, um alle in einer Datei zu erhalten. Jede Seite hat **Seite kopieren** und **In Claude öffnen**-Schaltflächen. Siehe [KI- und LLM-Ressourcen](/docs/guides/llms).

## Welche sollte ich verwenden?

| Sie möchten…                                                                   | Verwenden                         |
| ------------------------------------------------------------------------------ | --------------------------------- |
| Produkte und Kunden aus Ihrem ERP jede Nacht synchronisieren                   | [REST API](/docs/guides/erp-sync) |
| Neue Bestellungen in Ihr Buchhaltungssystem oder Vertriebssystem laden         | [REST API](/docs/api/orders)      |
| Fragen Sie „Was zahlt Oakfield Joinery für HX-8510?“ im Chat                   | [MCP](/docs/mcp)                  |
| Ermöglichen Sie einem Käufer, seine eigenen Preise über seine KI-App zu prüfen | [MCP](/docs/mcp)                  |
| Generieren Sie einen typisierten Client für Ihren Code                         | [OpenAPI](/docs/api/openapi)      |

## Was fehlt noch

- **Webhooks.** Statt dessen [`GET /orders?status=new`](/docs/api/orders) alle paar Minuten abfragen.
- **Veröffentlichen von Preiserhöhungen per API.** Geänderte Listenpreise werden in einen Entwurf aufgenommen, den Sie in der App überprüfen und veröffentlichen. Siehe [Preiserhöhungen](/docs/api/price-changes).
- **Löschen von Produkten oder Kunden per API.** Machen Sie ein Produkt inaktiv oder entfernen Sie es in der App.
- **Schlüssel für Käufer.** Käufer verwenden [MCP](/docs/mcp) oder laden ihre Preisliste als CSV aus ihrem Handelsportal herunter.

Brauchen Sie Hilfe bei einer Verbindung? Siehe [Support kontaktieren](/docs/support).

Fehlt etwas, das Sie benötigen? E-Mail-Support aus Ihrem Workspace (Support im Menü) und sagen Sie uns, was Sie bauen.