Items in error & items ignored

1. Items in error : These errors need to be fixed as soon as possible.
   For instance, if myFulfillment tries to import an order with a shipping method not yet mapped to a myFulfillment one, or containing a product not yet imported.
   In this case, the order will not be importable, and an "High severity error" will be raised to keep track of the failed import.
   
   
2. Items ignored : These errors are indicative only.
   For example, if myFulfillment tries to import an order having a status setup to not be imported.
   In this case, the order will be ignored, and an "Info error" will be raised to keep track of the fact the system ignored this order.

How to see items in error

1. From the bell icon, click on the integration link (in blue)
   
2. Go in menu Integrations > Manage integrations > [click on the wanted integration] > select  "Items in error" tab
   
3. Go in menu Integrations > Synchronization errors
   

1. Date : Date when the error was registered
   
2. Object type : Type of error, can be "order", "product", "shipment", ect...
   
3. External ID : External identifier of the item
   
4. External reference : External reference of the item (order reference, product SKU, etc...)
   
5. Error message : Details about the error
   
6. Severity : Error severity, will be "High"
   
7. Retry : Defines if the system will automatically retry to process the item in error through the "Retry" feed
   
8. Retry count : Number of attempts made by the "Retry" feed to process the item in error
   

How to fix items in error

Depending of the type of the error, a manual fix can be required

Items in error are most of the time due to error happening during feeds execution.

They most of the time require a manual action.

To be able to correct theswe errors, you need first to understand why they happen.

Most of the time, checking the error message will be helpful enough, for instance Unknow shipping methods, Shipping or payment methods not yet mapped, ect...

In this case, you must fix the problem (for instance add a new mapping for shipping method) and then manually retry the error like this.

1. To manually retry to process any item, tick the matching checkbox and select "Retry" in the bulk action menu :
   

If the retry succeed, the error is deleted and you have a confirmation message, else the error message is updated.

1. You can also see a button "Fix" for  specific type of errors from the column called 'Actions' :

This button allows for example to fix an order not imported because the shipping method is not mapped (so unknown) into Connect. When you click on this button, a new window will be opened on which you will be able to do the mapping. Once the issue is fixed, it should fix other orders with the same problem.

If this action succeed, the error is deleted and you have a confirmation message, else the error message is updated.

How to see items ignored

There's only one way to see items ignored, which consits in going into any integration, then to the "Items ignored" tab.

You will be lead to a grid containing details about items ignored :

Here are columns details :

1. Date : Date when the error was registered
   
2. Object type : Type of error, can be "order", "product", "shipment", ect...
   
3. External ID : External identifier of the item
   
4. External reference : External reference of the item (order reference, product SKU, etc...)
   
5. Error message : Details about the error
   
6. Severity : Error severity, will be "Info"
   
7. Retry : Defines if the system will automatically retry to process the item in error through the "Retry" feed
   
8. Retry count : Number of attempts made by the "Retry" feed to process the item in error

How manage items ignored

Items ignored are most of the time due to business rules.

For instance, if an order is not imported because you configure its status to not be imported, myFulfillment will log this as an "Info error" (an item ignored).

In that case, the "Retry" feed will automatically retry to process the item if it's scheduled when it runs, until it can process it.
Else, your CMS API will send again the item to myFulfillment  as soon as it is updated.

Here is an example : 

1. An order is placed on your CMS and customer selects the "Paypal" payment method. Then the order status is "Pending paypal payment"
   
2. If myFulfillment requests your CMS for new orders to import, it will detects the new order but not import it as the "Pending paypal payment" status was setup to not be imported.
   In this case, a new record will be added into the "Items ignored" tab to let you know why the order was not imported.
3. 30 Minutes later, the order status is still "Pending paypal payment". The order synchronization feed runs, and so the order is still not imported.
   
4. 30 Minutes later, customer confirms the payment, then order status goes to "Processing".
   
5. The order synchronization feed runs, it detects again the order through API call as it was updated in the CMS, and this time will be able to import it as the "Processing" status is setup to be imported.
   

Common errors and fixes