Replace one variant's SKUU_Network availability

put

https://{merchantHost}/{connectBasePath}/inventory

Merchant-hosted endpoint called by SKUU. The customer API root is the
reviewed prefix immediately before the fixed /inventory path.

The merchant must create one virtual location (recommended name:
SKUU_Network) and provide its ID in the integration configuration. SKUU writes only to that
location and never mutates the merchant's physical locations. The request is
an absolute replacement and must be idempotent: repeating the same body is a
safe no-op that returns the same success receipt.

SKUU signs the exact JSON bytes it transmits. If a response is lost or the
final outcome is uncertain, SKUU may safely repeat the same idempotent PUT.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Absolute network-location availability. location_id is always the one
virtual SKUU_Network location agreed for this merchant/environment.

variant_id

string

required

length between 1 and 255

(?=^[^\u0000-\u001F\u007F]+$)(?=^\S(?:[\s\S]*\S)?$)

Non-empty string without surrounding whitespace.

location_id

required

^(?:0|[1-9][0-9]{0,17}|[1-8][0-9]{18}|9[0-1][0-9]{17}|92[0-1][0-9]{16}|922[0-2][0-9]{15}|9223[0-2][0-9]{14}|92233[0-6][0-9]{13}|922337[0-1][0-9]{12}|92233720[0-2][0-9]{10}|922337203[0-5][0-9]{9}|9223372036[0-7][0-9]{8}|92233720368[0-4][0-9]{7}|922337203685[0-3][0-9]{6}|9223372036854[0-6][0-9]{5}|92233720368547[0-6][0-9]{4}|922337203685477[0-4][0-9]{3}|9223372036854775[0-7][0-9]{2}|922337203685477580[0-6]|9223372036854775807)$

Canonical base-10 JSON string whose value fits the inclusive signed 64-bit
range -9223372036854775808 through 9223372036854775807. Surrounding
whitespace, a plus sign, leading zeroes, and negative zero are rejected.

available_quantity

int32

required

0 to 2147483647

Binding absolute non-negative availability, not a delta. The webhook requires
this exact JSON integer type and rejects negative or integer-like string values.
For one variant, the sum across all physical locations must also be at most
2147483647.

Responses

200Applied, or an idempotent no-op. The JSON response must echo the requested variant_id, location_id, and available_quantity with identical JSON types and values. Additional response fields are ignored. A success without the three required receipt values is a contract failure to the SKUU client.

400Invalid request shape or value; permanent and not retried by SKUU.

401Missing or invalid bearer credential or request signature; permanent until configuration changes.

403Authenticated credential is forbidden from this operation; permanent until access policy changes.

404Unknown variant or location; permanent and not retried by SKUU.

409Request cannot be applied in the merchant's current state; permanent unless jointly reclassified.

429Rate limited. SKUU retries this idempotent PUT, up to three total attempts. The implementation honors Retry-After only when it is integer seconds; otherwise it uses exponential backoff with jitter.

2XXCompatibility success other than 200. The current SKUU client accepts any 2xx only when it contains valid JSON echoing the three requested values. Merchants should return 200 as the portable contract response.

4XXOther client error. SKUU treats it as permanent and does not retry automatically.

5XXTransient merchant failure. SKUU retries every 5xx response for this idempotent PUT, up to three total attempts, with exponential backoff and jitter.