What is changing?

The Orders API section and the Reports API section are now returning anonymized phone numbers for some selling accounts, to help protect customer privacy. These new phone number values contain more characters than those previously returned by Amazon MWS.

We have already begun rolling out this change, and we expect to be returning anonymized phone numbers for all selling accounts within the next few weeks.

Here are the operations and reports that are affected by this change:

• ListOrders, ListOrdersByNextToken, and GetOrder. The Phone element will return the new phone number values.
• Flat file Order reports (_GET_FLAT_FILE_ACTIONABLE_ORDER_DATA_, _GET_FLAT_FILE_ORDER_REPORT_DATA_, _GET_CONVERGED_FLAT_FILE_ORDER_REPORT_DATA_). The ship-phone-number field will contain the new phone number values.
• XML Order report (_GET_ORDERS_DATA_). The PhoneNumber element (contained in Address) and the BuyerPhoneNumber element (contained in BillingData) will contain the new phone number values.

Which marketplaces are affected?

This change applies to the US marketplace.

Who is affected?

You or your delivery carrier may only contact the customer via phone for delivery issues through our phone number anonymization system.

Developers with applications that consume phone number values from the Orders API section or one of the Order reports from the Reports API section are affected by this change.

What action is required?

If you have an application that is affected by this change, be sure that it does not apply any length or format validation to phone number values returned by the Orders API section or the Reports API section.