Skip to main content
POST
Push SKU Quantities

Authorizations

Authorization
string
header
required

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

Body

application/json

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

articleNumber
string
required

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.

periodYear
required

Calendar reporting year.

Required range: 2000 <= x <= 2100
market
string
required

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

Pattern: ^[A-Za-z]{2}$
quantity
required

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

Response

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<uuid>
required
status
enum<string>
required
Available options:
queued
statusUrl
string
required
Example:

"/api/import-jobs/6f7a…"