Zum Hauptinhalt springen
POST
Push SKU Quantities

Autorisierungen

Authorization
string
header
erforderlich

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

Body

application/json

One placed-quantity row for POST /api/v1/ppwr/quantities. Upsert key: (articleNumber, periodYear, market) — re-pushing a period with corrected numbers is the normal flow.

articleNumber
string
erforderlich

Internal article number of an existing article. An unknown number is the row error unknownArticleNumber; a key repeated inside one batch is first-seen-wins plus duplicateInFile on the later rows.

Minimum string length: 1
periodYear
integer
erforderlich

Calendar reporting year.

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

ISO alpha-2 market code (case-insensitive, stored upper-case).

Pattern: ^[A-Z]{2}$
quantity
string
erforderlich

Pieces placed on that market in that year. Required and non-negative — a blank quantity is a broken feed row, not zero.

Minimum string length: 1

Antwort

Batch accepted — async import job staged. Nothing imported yet; poll the job.

Batch import staged as an async job. Nothing is imported yet — poll statusUrl for progress and the final result.

jobId
string
erforderlich

UUID of the staged import job — pass it to GET /api/v1/import-jobs/{jobId}.

status
string
erforderlich

Always queued — nothing is imported yet.

statusUrl
string
erforderlich

The poll URL, also sent as the Location header.