Einführung

​

Übersicht

• 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.
• Parzellen (EUDR) — Produktionsparzellen mit Geometrie anlegen, auslesen, mit Lieferantenartikeln verknüpfen und löschen. Die Entwaldungsanalyse läuft nach dem Anlegen automatisch.
• Parzellenbericht und Geometrieprüfung (EUDR) — Den Parzellenbericht als PDF laden und eine Geometrie prüfen, ohne eine Parzelle anzulegen. Siehe Geo-Analyse.
• Nachweise (EUDR) — Nachweisdateien hochladen, an einen Lieferantenartikel hängen und auflisten.
• Bestellungen — Einkaufs- und Verkaufsbestellungen importieren (einzeln oder im Stapel). Bestellungen können automatisch DDS-Erklärungen zugewiesen werden.
• DDS-Erklärungen — DDS-Erklärungen für die TRACES-Einreichung erstellen und verwalten.
• Verpackungsstammdaten (PPWR) — Komponenten, Verpackungseinheiten, deren Größen und die Verknüpfungen dazwischen im Stapel anlegen und aktualisieren; Einheiten und Komponenten lassen sich einzeln und als Liste wieder auslesen.
• Mengen-Feed (PPWR) — die in Verkehr gebrachten Mengen je SKU, Markt und Jahr übermitteln, alternativ Tonnage je Materialart.
• Mengenmeldung (PPWR) — Berichte für LUCID und die übrigen nationalen Register erzeugen, auflisten und die Datei abholen.
• Dokumente (PPWR) — Prüfberichte, Erklärungen und Zeichnungen hochladen und an Verpackungseinheiten und Komponenten hängen.
• Konformitätserklärungen (PPWR) — Den DoC-Status je Einheit lesen, die Erklärungen auflisten und das PDF herunterladen.

​

Authentifizierung

1. Navigieren Sie zu Einstellungen > API-Schlüssel
2. Klicken Sie auf API-Schlüssel erstellen
3. Wählen Sie die erforderlichen Berechtigungen (z.B. articles:read, orders:write)
4. Kopieren Sie den generierten Schlüssel

Authorization: Bearer eudr_8f7d2a...

​

OAuth 2.1

​

Basis-URL

https://app.polygon-one.com

​

Versionierung

• Vertragsumfang: Nur die in dieser Referenz dokumentierten Endpunkte gehören zu v1. Andere Pfade unter diesen Präfixen können sich ändern. API-Schlüssel sind nicht Teil der API — Sie legen sie unter Einstellungen > API-Schlüssel an.
• Nur additive Änderungen: Innerhalb von v1 werden bestehende Felder nie entfernt oder umbenannt. Neue Antwortfelder können hinzukommen — Ihr Client muss unbekannte Felder ignorieren. Unbekannte Felder in Anfragen werden angenommen und ignoriert.
• Fehler: Der Body ist { "error": string } (optional mit details bzw. warnings), die HTTP-Statuscodes bleiben stabil. Einzige Ausnahme ist das 429 des Rate-Limits, siehe Fehler & Limits.
• Breaking Changes erscheinen ausschließlich als /api/v2/ — mit mindestens 6 Monaten Parallelbetrieb.

​

Berechtigungen

​

Antwortformat

{
  "article": { "id": "...", "name": "..." }
}

{
  "jobId": "6f7a...",
  "status": "queued",
  "statusUrl": "/api/import-jobs/6f7a..."
}

​

Feldauswahl (fields)

# Delta-Poll für ein ERP: nur Bestellnummer + TRACES-Referenzen
curl "https://app.polygon-one.com/api/v1/orders?changedSince=2026-09-25T06:00:00Z&limit=1000&fields=orderNumber,ddsReferences" \
  -H "Authorization: Bearer eudr_8f7d2a..."

• fields darf nur einmal übergeben werden (kommagetrennt, nicht wiederholt).
• Die Liste darf nicht leer sein (?fields= allein wird abgelehnt).
• Jedes Feld muss ein dokumentiertes Top-Level-Feld der Ressource sein; unbekannte Namen werden in der Fehlermeldung genannt, zusammen mit der erlaubten Liste. So kann ein später hinzukommendes Feld eine bestehende Anfrage nie unbemerkt verändern.
• Leerzeichen um Namen werden ignoriert, Duplikate zählen einmal. Verschachtelte Auswahl (supplier.id) gibt es nicht.

​

Fehlerbehandlung

{
  "error": "Validation failed",
  "details": [
    { "code": "too_small", "path": ["address", "street"], "message": "Address is required." }
  ]
}

​

Duplikatwarnungen

• Harter Konflikt (nicht überschreibbar): Ein Artikel mit derselben internalArticleNr existiert bereits. Die Antwort ist 409 mit einer error-Meldung.
• Weiche Warnungen (überschreibbar): ein doppelter Artikelname (duplicateName) oder eine doppelte ean (duplicateEan). Die Antwort ist 409 mit einem maschinenlesbaren warnings-Array:

{
  "error": "Article has unresolved warnings. Resubmit with acknowledgeWarnings=true to override.",
  "warnings": [
    { "type": "duplicateName", "existingInternalArticleNr": "ART-001" },
    { "type": "duplicateEan", "existingArticleName": "Oak plank 20mm" }
  ]
}