curl --request POST \
--url https://app.polygon-one.com/api/v1/ppwr/quantities \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"rows": [
{
"articleNumber": "ART-2001",
"periodYear": 2025,
"market": "DE",
"quantity": "120000"
}
],
"replaceScope": "period-market"
}
'import requests
url = "https://app.polygon-one.com/api/v1/ppwr/quantities"
payload = {
"rows": [
{
"articleNumber": "ART-2001",
"periodYear": 2025,
"market": "DE",
"quantity": "120000"
}
],
"replaceScope": "period-market"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
rows: [
{articleNumber: 'ART-2001', periodYear: 2025, market: 'DE', quantity: '120000'}
],
replaceScope: 'period-market'
})
};
fetch('https://app.polygon-one.com/api/v1/ppwr/quantities', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.polygon-one.com/api/v1/ppwr/quantities",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'rows' => [
[
'articleNumber' => 'ART-2001',
'periodYear' => 2025,
'market' => 'DE',
'quantity' => '120000'
]
],
'replaceScope' => 'period-market'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.polygon-one.com/api/v1/ppwr/quantities"
payload := strings.NewReader("{\n \"rows\": [\n {\n \"articleNumber\": \"ART-2001\",\n \"periodYear\": 2025,\n \"market\": \"DE\",\n \"quantity\": \"120000\"\n }\n ],\n \"replaceScope\": \"period-market\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.polygon-one.com/api/v1/ppwr/quantities")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"rows\": [\n {\n \"articleNumber\": \"ART-2001\",\n \"periodYear\": 2025,\n \"market\": \"DE\",\n \"quantity\": \"120000\"\n }\n ],\n \"replaceScope\": \"period-market\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.polygon-one.com/api/v1/ppwr/quantities")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"rows\": [\n {\n \"articleNumber\": \"ART-2001\",\n \"periodYear\": 2025,\n \"market\": \"DE\",\n \"quantity\": \"120000\"\n }\n ],\n \"replaceScope\": \"period-market\"\n}"
response = http.request(request)
puts response.read_body{
"jobId": "d2f7a4c9-8e15-4b63-9a2d-1c6e5f0b8d37",
"status": "queued",
"statusUrl": "/api/import-jobs/d2f7a4c9-8e15-4b63-9a2d-1c6e5f0b8d37"
}{
"error": "Validation failed",
"details": [
{
"origin": "string",
"code": "too_small",
"minimum": 1,
"inclusive": true,
"path": [
"address",
"street"
],
"message": "Address is required."
}
]
}{
"error": "Invalid or expired API key"
}{
"error": "Forbidden"
}{
"error": "batchTooLarge",
"maxBatchSize": 5000
}{
"error": {
"code": "rate_limited",
"message": "…"
}
}{
"error": "Internal server error"
}Mengen übermitteln
The recurring ERP feed: how many pieces of each SKU were placed on which market in which year. Asynchronous — the request stages an import job and returns 202 with a jobId; poll GET /api/v1/import-jobs/{jobId} (needs packaging:read) until status is terminal. Row validation runs BEFORE staging, so a malformed batch is a 400 you see immediately, never a job that fails minutes later. At most 5000 rows (413), at least one row (400). Restatement is the norm: the upsert is idempotent on (articleNumber, periodYear, market). A packaging unit’s placed figure is computed from the stored SKU rows whenever it is read — the sum of its linked SKUs’ quantities, per size when every linked SKU of a multi-size unit names a size, otherwise on the unit level — so link changes take effect without a re-push. A unit with a figure typed in the app on either level uses the typed figures; it surfaces in the job result’s conflicts, and clearing its typed figures lets the feed’s figure apply immediately. Requires packaging:write; customer workspace with the PPWR module enabled — see the guide.
curl --request POST \
--url https://app.polygon-one.com/api/v1/ppwr/quantities \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"rows": [
{
"articleNumber": "ART-2001",
"periodYear": 2025,
"market": "DE",
"quantity": "120000"
}
],
"replaceScope": "period-market"
}
'import requests
url = "https://app.polygon-one.com/api/v1/ppwr/quantities"
payload = {
"rows": [
{
"articleNumber": "ART-2001",
"periodYear": 2025,
"market": "DE",
"quantity": "120000"
}
],
"replaceScope": "period-market"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
rows: [
{articleNumber: 'ART-2001', periodYear: 2025, market: 'DE', quantity: '120000'}
],
replaceScope: 'period-market'
})
};
fetch('https://app.polygon-one.com/api/v1/ppwr/quantities', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.polygon-one.com/api/v1/ppwr/quantities",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'rows' => [
[
'articleNumber' => 'ART-2001',
'periodYear' => 2025,
'market' => 'DE',
'quantity' => '120000'
]
],
'replaceScope' => 'period-market'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.polygon-one.com/api/v1/ppwr/quantities"
payload := strings.NewReader("{\n \"rows\": [\n {\n \"articleNumber\": \"ART-2001\",\n \"periodYear\": 2025,\n \"market\": \"DE\",\n \"quantity\": \"120000\"\n }\n ],\n \"replaceScope\": \"period-market\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.polygon-one.com/api/v1/ppwr/quantities")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"rows\": [\n {\n \"articleNumber\": \"ART-2001\",\n \"periodYear\": 2025,\n \"market\": \"DE\",\n \"quantity\": \"120000\"\n }\n ],\n \"replaceScope\": \"period-market\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.polygon-one.com/api/v1/ppwr/quantities")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"rows\": [\n {\n \"articleNumber\": \"ART-2001\",\n \"periodYear\": 2025,\n \"market\": \"DE\",\n \"quantity\": \"120000\"\n }\n ],\n \"replaceScope\": \"period-market\"\n}"
response = http.request(request)
puts response.read_body{
"jobId": "d2f7a4c9-8e15-4b63-9a2d-1c6e5f0b8d37",
"status": "queued",
"statusUrl": "/api/import-jobs/d2f7a4c9-8e15-4b63-9a2d-1c6e5f0b8d37"
}{
"error": "Validation failed",
"details": [
{
"origin": "string",
"code": "too_small",
"minimum": 1,
"inclusive": true,
"path": [
"address",
"street"
],
"message": "Address is required."
}
]
}{
"error": "Invalid or expired API key"
}{
"error": "Forbidden"
}{
"error": "batchTooLarge",
"maxBatchSize": 5000
}{
"error": {
"code": "rate_limited",
"message": "…"
}
}{
"error": "Internal server error"
}Autorisierungen
API key generated in Settings > API Keys. Include as Authorization: Bearer <key>.
Body
- object[]
- object
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.
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.
1Calendar reporting year.
2000 <= x <= 2100ISO alpha-2 market code (case-insensitive, stored upper-case).
^[A-Z]{2}$Pieces placed on that market in that year. Required and non-negative — a blank quantity is a broken feed row, not zero.
1Antwort
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.