Zum Hauptinhalt springen
POST
Push Material Tonnage

Autorisierungen

Authorization
string
header
erforderlich

API key generated in Settings > API Keys. Include as Authorization: Bearer <key>.

Body

application/json

One aggregate-tonnage row for POST /api/v1/ppwr/tonnage. Upsert key: (zsvrCategory, periodYear, market). LUCID (Germany) only.

periodYear
integer
erforderlich

Calendar reporting year (2000–2100).

Erforderlicher Bereich: 2000 <= x <= 2100
market
string
erforderlich

ISO alpha-2 market code.

Pattern: ^[A-Z]{2}$
zsvrCategory
enum<string>
erforderlich

The VerpackG material category (see ZsvrCategory).

Verfügbare Optionen:
10000,
20000,
30000,
40000,
50000,
60000,
70000,
80000
tonnageKg
number
erforderlich

Kilograms placed. A JSON number — unlike the intake row schemas, this field is not string-coerced.

Erforderlicher Bereich: x >= 0
note
string | null

Optional note (at most 500 characters).

Maximum string length: 500

Antwort

Tonnage result

Result of the synchronous tonnage intake. A category a human entered in the app is reported in skipped, never overwritten; delete the override in the app and the next push recreates it as ERP-owned.

written
object[]
erforderlich

The categories written (created or updated) by this request.

skipped
object[]
erforderlich

The categories not written because a figure entered in the app takes precedence.

failed
object[]
erforderlich

Rows that hit an unexpected database error (dbError). Reported per row — the categories that committed are kept.

invalid
object[]
erforderlich

Rows rejected by schema validation.