Bestellungen anlegen, Rechnungen freigeben und bezahlen und den Workspace einrichten.
Endpunktsuche
Käufer-API durchsuchen
146 Endpunkte in 19 Ressourcen. Suchen Sie nach Pfad, Methode oder dem, was Sie tun möchten – fügen Sie eine echte URL ein, und ihre IDs passen auf die Parameter des Pfads.
Beispiele
API-Referenz
Die Pleaxy-API ist eine REST-API mit JSON-Anfragen und -Antworten. Mit ihr lesen und erstellen Sie Bestellungen und Rechnungen und verfolgen sie durch Freigabe und Zahlung. Konzepte und Anleitungen finden Sie in der Dokumentation.
Authentifizierung
Senden Sie mit jeder Anfrage einen von zwei Headern:
X-Api-Key: <keyId>.<secret>– ein API-Schlüssel, für Ihre eigenen Systeme und Agenten.Authorization: Bearer <accessToken>– die Sitzung einer angemeldeten Person, erforderlich für einige Aktionen wie Freigaben und die Verwaltung von API-Schlüsseln.
Eine Anmeldeinformation gilt in einem Workspace, als Käufer oder als Lieferant. Jeder Pfad enthält die ID dieses Workspace als regionId; Sie kopieren sie in Pleaxy unter Unternehmensprofil → Workspace-ID.
Fehler
Fehler verwenden 4xx-Statuscodes und einen JSON-Body. Verzweigen Sie anhand von code, nicht anhand der englischen message; mit messageId und params zeigen Sie die Meldung in Ihrer eigenen Sprache an.
Versionierung
Pfade beginnen mit der Version, /v1. Neue Endpunkte, Felder und Werte kommen innerhalb dieser Version hinzu. Ignorieren Sie daher unbekannte Felder und sehen Sie für unbekannte Werte wie Status einen Standard vor. Inkompatible Änderungen erscheinen als neue Version.
https://api.pleaxy.aicurl "$PLEAXY_API_BASE_URL/v1/workspaces/$WORKSPACE_ID/purchase-orders" \
-H "X-Api-Key: $PLEAXY_API_KEY"{
"statusCode": 404,
"error": "Not Found",
"message": "Invoice INV-7F3A9C21 not found.",
"code": "string",
"messageId": "string",
"params": { ... }
}Ressourcen
- BestellungenBestellungen, die ein Käufer bei einem Lieferanten aufgibt: ihre Positionen, Beträge, ihr Status und ihre Freigabe.15 Endpunkte
- BestellanforderungenWas Personen kaufen möchten, bevor es eine Bestellung gibt: Freigabe, Budgetprüfung, dann eine Bestellung.9 Endpunkte
- RechnungenRechnungen von Lieferanten an Käufer, vom Eingang über Abgleich und Freigabe bis zur Zahlung.34 Endpunkte
- GutschriftenGutschriften, die mindern, was ein Käufer schuldet, und ihre Verrechnung mit Rechnungen.11 Endpunkte
- Cloud-VerbindungenSchreibgeschützte Verbindungen zur Abrechnung Ihrer Cloud-Anbieter-Konten.8 Endpunkte
- KI-AusgabenAusgaben für KI-Modelle nach Rechnungssteller, Modellanbieter, Modell und Zähler, gegen Ihre Bestellungen gestellt.21 Endpunkte
- KI-AnbieterDirekt mit einem Nur-Lese-Schlüssel verbundene KI-Anbieter und die KI-Rechnungssteller, die Sie als Lieferanten hinzufügen können.6 Endpunkte
- AbwicklungWann Bestellungen und Rechnungen die manuelle Freigabe überspringen können, und der Plan des Workspace.3 Endpunkte
- FreigabekettenWer Bestellungen und Rechnungszahlungen freigibt.2 Endpunkte
- AutomatisierungsregelnRegeln, die passende Dokumente automatisch freigeben oder immer in die Freigabe schicken.2 Endpunkte
- FreigabenDie Bestellungen und Rechnungen, die auf Sie warten.1 Endpunkt
- MitarbeitendeDie Personen in einem Workspace.1 Endpunkt
- WorkspacesDashboard-Übersichten der Aktivität eines Käufers oder Lieferanten.1 Endpunkt
- OrganisationsprofileDas Geschäftsprofil und die Rechnungsangaben Ihres Unternehmens.2 Endpunkte
- BenachrichtigungenIn-App-Benachrichtigungen und Erinnerungseinstellungen.6 Endpunkte
- API-SchlüsselSchlüssel, mit denen Ihre Systeme die API aufrufen können, ohne dass eine Person angemeldet ist.3 Endpunkte
- DokumentsynchronisierungHalten Sie Ihr eigenes System auf Stand: was sich geändert hat, und jedes Dokument als JSON, cXML oder UBL.8 Endpunkte
- BestellabwicklungLieferanten bestätigen Bestellungen und kündigen Lieferungen an; Käufer sehen beides an der Bestellung.6 Endpunkte
- WebhooksLassen Sie Pleaxy jede Änderung sofort an Ihren HTTPS-Endpunkt senden.7 Endpunkte