Breaking changes for March 4th, 2024

[nateswart]

Reminder that next week on Feb 5th these previously announced breaking changes will be rolled out.

On March 4th the following changes will be rolled out:

• In the current experience of calling the createShopShippingProfileUpgrade and updateShopShippingProfileUpgrade endpoints, the request fails if any shipping profile field or any of its entries are invalid. We've updated this to fail the request only if the upgrade being operated on is invalid.
• When activating or manually renewing a physical listing through the endpoint updateListing, the shipping profile referenced by the shipping_profile_id and all of its fields, along with its entries and upgrades, will now be validated. If the shipping profile is invalid then the request will fail until all the shipping profile validation errors are fixed.
• We’re enhancing shipping profile error messages for a better user experience. Instead of being shown one validation error at a time, users will now see a concatenated string of error messages with all the shipping profile validation errors related to the current request.
• We’re expanding postal code requirements for shipping profiles for all countries we support instead of only US and CA. These changes will be reflected in the following endpoints:
  • createShopShippingProfile
  • updateShopShippingProfile
  • createShopShippingProfileDestination
  • updateShopShippingProfileDestination
  • createShopShippingProfileUpgrade
  • updateShopShippingProfileUpgrade
  • updateListing

Here’s a list of the countries that will need a postal code in shipping profiles. We’ll also add this list to the Fulfillment Tutorial docs when the requirement goes live for future reference.

Country name	iso_code
Åland Islands	AX
Albania	AL
Algeria	DZ
American Samoa	AS
Andorra	AD
Argentina	AR
Armenia	AM
Australia	AU
Austria	AT
Azerbaijan	AZ
Bahrain	BH
Bangladesh	BD
Barbados	BB
Belarus	BY
Belgium	BE
Bermuda	BM
Bhutan	BT
Bosnia and Herzegovina	BA
Brazil	BR
British Indian Ocean Territory	IO
British Virgin Islands	VG
Brunei	BN
Bulgaria	BG
Cambodia	KH
Canada	CA
Cape Verde	CV
Cayman Islands	KY
Chile	CL
China	CN
Christmas Island	CX
Cocos (Keeling) Islands	CC
Colombia	CO
Costa Rica	CR
Croatia	HR
Cyprus	CY
Czech Republic	CZ
Denmark	DK
Dominican Republic	DO
Ecuador	EC
Egypt	EG
El Salvador	SV
Estonia	EE
Ethiopia	ET
Falkland Islands (Malvinas)	FK
Faroe Islands	FO
Finland	FI
France	FR
French Guiana	GF
French Polynesia	PF
Georgia	GE
Germany	DE
Gibraltar	GI
Greece	GR
Greenland	GL
Guadeloupe	GP
Guam	GU
Guatemala	GT
Guernsey	GG
Guinea	GN
Guinea-Bissau	GW
Haiti	HT
Heard Island and McDonald Islands	HM
Holy See (Vatican City State)	VA
Honduras	HN
Hungary	HU
Iceland	IS
India	IN
Indonesia	ID
Iran	IR
Iraq	IQ
Ireland	IE
Isle of Man	IM
Israel	IL
Italy	IT
Japan	JP
Jersey	JE
Jordan	JO
Kazakhstan	KZ
Kenya	KE
Kuwait	KW
Kyrgyzstan	KG
Laos	LA
Latvia	LV
Lebanon	LB
Lesotho	LS
Liberia	LR
Liechtenstein	LI
Lithuania	LT
Luxembourg	LU
Macedonia	MK
Madagascar	MG
Malaysia	MY
Maldives	MV
Malta	MT
Marshall Islands	MH
Martinique	MQ
Mauritius	MU
Mayotte	YT
Mexico	MX
Micronesia, Federated States of	FM
Moldova	MD
Monaco	MC
Mongolia	MN
Montenegro	ME
Morocco	MA
Myanmar (Burma)	MM
Nepal	NP
New Caledonia	NC
New Zealand	NZ
Nicaragua	NI
Niger	NE
Nigeria	NG
Norfolk Island	NF
Northern Mariana Islands	MP
Norway	NO
Oman	OM
Pakistan	PK
Palau	PW
Papua New Guinea	PG
Paraguay	PY
Peru	PE
Philippines	PH
Poland	PL
Portugal	PT
Puerto Rico	PR
Reunion	RE
Romania	RO
Russia	RU
Saint Barthélemy	BL
Saint Helena	SH
Saint Martin (French part)	MF
Saint Pierre and Miquelon	PM
Saint Vincent and the Grenadines	VC
San Marino	SM
Saudi Arabia	SA
Senegal	SN
Serbia	RS
Singapore	SG
Slovakia	SK
Slovenia	SI
Somalia	SO
South Africa	ZA
South Georgia and the South Sandwich Islands	GS
South Korea	KR
Spain	ES
Sri Lanka	LK
Svalbard and Jan Mayen	SJ
Swaziland	SZ
Sweden	SE
Switzerland	CH
Taiwan	TW
Tajikistan	TJ
Tanzania	TZ
Thailand	TH
The Netherlands	NL
Tunisia	TN
Turkey	TR
Turkmenistan	TM
Turks and Caicos Islands	TC
Ukraine	UA
United Kingdom	GB
United States	US
United States Minor Outlying Islands	UM
Uruguay	UY
U.S. Virgin Islands	VI
Uzbekistan	UZ
Venezuela	VE
Vietnam	VN
Wallis and Futuna	WF
Western Sahara	EH
Zambia	ZM