Introduction
It may happen that orders imported from Handyman cannot be processed by the extension:
- Creation of the order fails
- Update of the order fails
Identify records having errors
If processing has failed, this appears in the inbound order list:
- Checkbox Processing Error is active
- Text appears i red font
- The actual error appears in the field Processing Error Text. If a standard BC error has occurred, the standard BC Error message appears here.
Correcting errors
- Open the inbound order card
- Do the required correction - either on the inbound order card or on other places in BC (e.g. for missing basic data/settings)
- Use the action "Reset update error"
- Continue processing the order as usual:
- Use the action "Update Order"
- Use the action "Re-Export"
Hints for correcting typical update errors
| Error message | Recommended correction |
| Quantity must be positive. | Service orders in BC do not accept negative quantity. You must set a positive quantity or delete the line. If negative quantity has been used in Handyman to correct already synchronized entries you may achieve the correction by correcting the original entry and deleting the line with the negative quantity. |
| No document could be found for this order. | BC cannot find a document (order/invoice) having the OrderNo provided by Handyman. Check whether a new document must be created. |
Creation of sales document ... failed because a sales document with HSID ... already exists.
| The Handyman Order Number (HSID) must be unique across projects, sales documents and service documents. The error indicates that for this HSID another document exists. Open the inbound order card and use the action "Open document" to identify the other document. This error might happen if you accidentally deleted the order before it has been finished in Handyman. BC is automatically deleting the order after posting the last open line. This should be considered when creating invoices on orders not yet finished in Handyman. |