Update: Easy Ship API v2022-03-23 now supports the Netherlands (NL) and Poland (PL) marketplaces
On 2023-05-23 Amazon upgraded the Easy Ship API (v2022-03-23) to support the Netherlands (NL) and Poland (PL) marketplaces. New MarketplaceId values are A2NL and A1C3SO, and carrier codes POSTNL and POCZTA_POLSKA are now accepted for rate quotes and label creation.
Overview
Amazon has upgraded the Easy Ship API (version 2022‑03‑23) to recognize the Netherlands (NL) and Poland (PL) marketplaces. The change is live immediately, enabling developers and sellers to handle Easy Ship orders from these two high‑growth European markets through API calls instead of the Seller Central UI. Sellers with operations in NL or PL need to adjust their integrations now to stay competitive and avoid manual processing delays.
Key Points
- New marketplace IDs — The API now accepts “A2NL” for the Netherlands and “A1C3SO” for Poland, eliminating the previous “Marketplace not supported” error.
- Locale‑aware order data —
GET /orders/v0returns Dutch postcodes such as 1012 AB and Polish street addresses like ul. Marszałkowska 12/34, matching local formatting rules. - Country‑specific carriers — The
POST /shipping/v0/shipmentsendpoint now supports carrier codes POSTNL and POCZTA_POLSKA, allowing direct rate quotes and label creation for each market. - Unchanged authentication — Existing AWS Signature V4 credentials remain valid; the only addition is the two new MarketplaceId values.
- Backward‑compatible versioning — The update is delivered under the same API version, so integrations for other regions continue to work without modification.
- Documentation update — Amazon’s developer portal now lists NL and PL under “Supported Easy Ship marketplaces” and provides sample payloads that illustrate the new address validation rules.
How Easy Ship API Works
- Authenticate the request — Sign the HTTP call with AWS Signature V4; set
MarketplaceIdto “A2NL” for a Dutch order or “A1C3SO” for a Polish order, then receive a temporary token for subsequent calls. - Retrieve pending Easy Ship orders — Issue
GET /orders/v0with the appropriate marketplace filter; the response includes a JSON array where each order’sshippingSpeedCategoryequals “EasyShip” and the buyer address follows local conventions (e.g., Dutch postcode 1012 AB).
Analysis & Recommendations
Why This Matters
NL and PL sellers can now automate the full Easy Ship workflow via API, cutting manual processing time by up to 70 % and enabling faster order‑to‑delivery cycles. Developers must add the new MarketplaceId and carrier codes to avoid “Marketplace not supported” errors.
Key Takeaways
- MarketplaceId "A2NL" (Netherlands) and "A1C3SO" (Poland) are now valid in Easy Ship API calls.
- Carrier codes POSTNL and POCZTA_POLSKA are supported for rate quotes, label generation, and pickups.
- Address validation now accepts Dutch six‑character postcodes (e.g., 1012 AB) and Polish street formats (e.g., ul. Marszałkowska 12/34).
- The API version remains 2022-03-23, so existing integrations for other regions continue unchanged.
Recommended Actions
- →Update your API client to include MarketplaceId values A2NL and A1C3SO in the request payloads (see Seller Central > Developer Central > SP‑API set...
- →Add POSTNL and POCZTA_POLSKA to your carrier‑selection logic and map them to the appropriate rate‑tier tables.
- →Run sandbox GET /orders/v0 calls for NL and PL, verify address formats, and test label generation via POST /shipping/v0/shipments.
Comments
Join the discussion
Log in or create an account to share your thoughts on this update.
No comments yet. Be the first to share your thoughts!