ChannelEngine: why is my order labeled as 'Requires correction'?

About this article

This article describes the Requires correction issue, which can be seen in certain orders, as well as the steps required to address it.

Introduction

Most marketplaces use a system where address information is placed on address lines. This means that multiple lines can contain separate parts of an address (usually in a logical order). 

For example, the input from the connected channel is:

• Line 1 - ChannelEngine.com
• Line 2 - Rapenburg 1
• Line 3 - First door, next to the pub

ChannelEngine parses this input to the relevant standardized fields, applying dozens of scenarios on these lines to determine the individual parts of the address.

For the example above, ChannelEngine outputs:

• Company name - ChannelEngine
• Street name - Rapenburg
• House number - 1

Sometimes, parsing these address lines is unsuccessful, and the code is unable to determine the address fields. In this case, ChannelEngine marks the order with the Requires correction label.

This does not mean that the marketplace did not supply an address or that there is a misconfiguration. It does mean, however, that the individual address fields could not be parsed, and a manual check is needed to make sure the address fields are filled out correctly.

Often, the Requires correction label is applied to addresses that do not have a distinct house number. While these are valid addresses (seen in, for instance, Britain, France, and Spain), ChannelEngine cannot be certain your system can handle them. Some webstore and ERP systems do not accept orders without house numbers, and automatic parsing would break the order export to those systems. This is why, in these cases, ChannelEngine throws a notification so you can ensure the address is in a format your system accepts.

To learn more about how address parsing works and why this is sometimes very difficult, refer to the ChannelEngine: address parsing article.

Troubleshooting

To resolve the Requires correction error:

1. On the Order details page, click the pencil icon to correct the address fields.
2. Check that both the shipping and billing addresses are valid.
3. Save the changes. 
4. The order status changes to New, and the order becomes available for your order processing system.