Übersicht
Die Polygon One API ermöglicht Ihnen die programmatische Verwaltung Ihrer EUDR-Compliance-Daten. Sie ist für die Server-zu-Server-Integration mit Ihrem ERP-System (SAP, Oracle, Microsoft Dynamics, etc.) konzipiert.
Was Sie mit der API tun können:
- Artikel — Artikel erstellen, aktualisieren und abfragen. Die EUDR-Relevanz wird automatisch anhand des HS-Codes bestimmt.
- Lieferanten — Lieferantendaten verwalten und Lieferanten mit Artikeln verknüpfen.
- Bestellungen — Einkaufs- und Verkaufsbestellungen importieren (einzeln oder im Stapel). Bestellungen können automatisch DDS-Erklärungen zugewiesen werden.
- DDS-Erklärungen — Sorgfaltspflichterklärungen für die TRACES-Einreichung erstellen und verwalten.
Authentifizierung
Alle API-Endpunkte erfordern einen Bearer-Token. Generieren Sie Ihren API-Schlüssel im Polygon One Dashboard:
- Navigieren Sie zu Einstellungen > API-Schlüssel
- Klicken Sie auf API-Schlüssel erstellen
- Wählen Sie die erforderlichen Berechtigungen (z.B.
articles:read, orders:write)
- Kopieren Sie den generierten Schlüssel
Fügen Sie den Schlüssel im Authorization-Header jeder Anfrage hinzu:
Authorization: Bearer eudr_8f7d2a...
API-Schlüssel sind vertrauliche Zugangsdaten für die Server-zu-Server-Kommunikation. Speichern Sie diese in Umgebungsvariablen und geben Sie sie niemals in clientseitigem Code preis.
Basis-URL
Alle API-Anfragen werden an folgende URL gerichtet:
https://app.polygonone.com
Berechtigungen
Jedem API-Schlüssel werden spezifische Berechtigungen zugewiesen, die den Zugriff steuern:
| Berechtigung | Beschreibung |
|---|
articles:read | Artikel lesen |
articles:write | Artikel erstellen, aktualisieren, löschen |
suppliers:read | Lieferanten lesen |
suppliers:write | Lieferanten erstellen, aktualisieren, löschen |
orders:read | Bestellungen lesen |
orders:write | Bestellungen erstellen, aktualisieren, löschen |
dds:read | DDS-Erklärungen lesen |
dds:write | DDS-Erklärungen erstellen, aktualisieren, löschen |
201 zurück:
{
"article": { "id": "...", "name": "..." }
}
200 mit einer Zusammenfassung zurück:
{
"imported": [{ "id": "...", "orderNumber": "ORD-001" }],
"failed": [{ "orderNumber": "ORD-002", "error": "Supplier not found" }],
"skipped": 0
}
Fehlerbehandlung
Die API verwendet Standard-HTTP-Statuscodes:
| Code | Beschreibung |
|---|
200 | OK — Anfrage erfolgreich |
201 | Erstellt — Ressource erfolgreich erstellt |
400 | Ungültige Anfrage — Ungültige Eingabedaten oder Validierungsfehler |
401 | Nicht autorisiert — Ungültiger oder fehlender API-Schlüssel |
403 | Zugriff verweigert — API-Schlüssel hat nicht die erforderlichen Berechtigungen, oder Kontoeinrichtung ist unvollständig |
404 | Nicht gefunden — Ressource existiert nicht oder gehört nicht zu Ihrem Unternehmen |
500 | Interner Serverfehler — Auf unserer Seite ist ein Fehler aufgetreten |
error-Feld und optional details:
{
"error": "Validation failed",
"details": [{ "path": ["hsCode"], "message": "Commodity is required." }]
}
