v1.017
4 days ago
v1.017
SSCC unification.
The deprecated sscc field on the Create Receiving endpoint now accepts both the 18-digit GS1 SSCC and the 20-digit form with the leading GS1 AI "00" prefix. All API responses now return the 20-digit form consistently. The cartons[].identifiers / pallets[].identifiers SSCC values behave the same way.
🚀 New Endpoints
None
🛠 Schema & Property Updates
- Create Receiving (
POST /v1/integrations/receivings) — the deprecatedssccrequest property previously required exactly 18 digits (minLength: 18,maxLength: 18,pattern: ^\d{18}$). It now accepts 18 or 20 digits:minLength: 18,maxLength: 20,pattern: ^(00)?\d{18}$. The value is normalized to 20 digits on storage; the same rule applies tocartons[].identifiersandpallets[].identifiersentries withtype=SSCC.
📖 Documentation & Constraints Changes
- Create Receiving — the
ssccrequest property description now states: "Accepts 18-digit GS1 SSCC or 20-digit form with leading00; stored and returned as 20 digits." - Receiving identifier value — the
valueproperty oncartons[].identifiers/pallets[].identifiersitems now documents: "For type=SSCC, must be a valid GS1 SSCC — 18 digits or 20 digits with leading00; stored and returned as 20 digits." - Get Receiving — the deprecated
ssccresponse field description now clarifies: "Always returned as 20 digits (GS1 AI00prefix included)." No runtime change for callers that already accepted the field as a string; clients that hard-coded a length of 18 must accept 20.