How do I resolve receipts that are failing to send to my ERP?
Receipts (as well as negative/ reverse receipts) are created in SAP Business Network but are failing due to ERP Push Error.
When receiving an ERP Push error, investigate within your external procurement solution to find out if information is missing or incomplete.
If the error is because the order can't be found in your ERP, ensure that the order wasn't Force Ordered or deleted on the ERP after it was sent from SAP. Future operations aren't supported for forced orders, refer to document Order transmission and failed orders.
Understanding receipt workflow:
- As soon as a receipt is Approved, SAP will attempt to send it to the ERP (based on the Integration Configuration). If it fails, the system will retry to push for a total of 25 times based on Application.Receiving.MaxRetriesToSendPushFailedReceipts parameter.
- The retries are about 6 hours apart and will allow a window of about 6 days to identify and address the ERP side error. If you want the receipts to be repushed more frequently Application.Receiving.EnableProcessPendingReceiptsFrequently can be enabled so that receipts are repushed every 3 hours once.
- In cases where fixing the error takes longer than 25 retries, or any value configured in Application.Receiving.MaxRetriesToSendPushFailedReceipts parameter, then you can increase the maximum retries to send receipts. Please note that this parameter change will impact all receipts that are in Awaiting Processing status and the ones in Processing status only if Application.Receiving.EnableProcessPendingReceipts parameter is set to true.
In situations where the error cannot be fixed, we recommend the below approaches:
Option 1 (recommended):
Force Process the receipt using the Force Process button on the receipt's header. Then create the receipt manually on ERP.
Option 2:
If manual creation of receipts is not allowed or not possible:
- Force Process the stuck receipts (the one(s) receiving ERP Push Errors).
- Create a new receipt that will reverse the stuck receipt: if the first receipt has quantity 1, then the reverse receipt should have quantity -1; and vice versa.
- Ensure that the new receipt gets an ERP Push Error as well (suggestion: marking Delivery Complete or closing the Order for receiving on the ERP (not in SAP) can help).
- After that, the new reversal receipt should also be Force Processed.
- This will leave the order on SAP with 2 receipts canceling each other out.
- Now you need to ensure that any new receipt created will successfully flow to the ERP, then create a new receipt.
Caution: Test first to ensure no step is missed, or if there's complex receiving performed on the order. It is important to understand the logic and can vary based on the ERP response. For instance, if ERP accepts the negative receipt and posts it instead of sending back error, this approach cannot be followed.
Option 3:
Edit the receipt with ERP Push Error and set the Amount Accepted/Number Accepted as 0 and resubmit. Use the Close Order button on the receipt (the order may still be reopened).
Caution: Do not use this option if there are any new receipts posted against the order. Even if they are in Processed state and exported to ERP, they will be removed. This option is also not possible if your site is enabled for Purchase Order line level closure.
- If your site is configured for receipts integration with SAP Business Network please note that Force Processed receipts will still be sent and in sync within SAP, but the ERP would be out of sync.
- Force Processed receipts cannot be sent to the ERP again, if a user Force Processes a receipt accidentally, then one of the first two options above needs to be followed.
- For sites configured with File Channel integration, the receipt will be queued for export as soon as it is approved. Force Process will not stop it from being exported the first time, but will stop the receipt from being queued the next time. This scenario happens only when a receipt receives an ERP push Error.
- SAP doesn't support receipt cancellation. You can only do receiving and later reverse it with negative receiving, but not Cancel/Delete/Obsolete an Approved receipt.
-
To further read about specific documentations about receiving, please refer below:
Purchasing > Receiving
Purchasing > Receiving > Receipt Import/Export