Purchase Order Transaction Integration
A Purchase Order (PO) is a formal, legally binding commercial document issued by a buyer to a seller, requesting goods or services and defining the quantity, price, and terms and conditions.
In SAP Ariba Procurement solutions, buyers create POs to request goods or services from suppliers. POs are sent from SAP Ariba Procurement solutions to SAP ERP or SAP S/4HANA upon approval. If configured, SAP Ariba Procurement solutions can then send the POs to SAP Business Network, which routes them to the appropriate supplier using the supplier’s preferred order routing method.
Supported Purchase Order types include:
- Standard Purchase Orders (New, Change, Cancel & Close)
- Service Purchase Orders (New, Change, Cancel & Close)
SAP Ariba Procurement solutions allow exporting amount-based purchase orders to SAP ERP or SAP S/4HANA. The SAP Ariba Procurement solutions map the amount to the quantity in SAP ERP or SAP S/4HANA, setting the unit price to 1. A commodity code of type Service and Receive By Amountmust be enabled for this.
Example: if the unit price is $10 and the quantity is 5, it is exported as a quantity of 50 and with a unit price of $1.
Changed and canceled purchase orders can also be exported from SAP Ariba Procurement solutions to SAP ERP or SAP S/4HANA via the Managed Gateway for Spend&Network.
Note
When integrating purchase orders, changed purchase orders, and canceled purchase orders with SAP ERP or SAP S/4HANA, the source of truth is always the SAP Ariba Procurement solutions. That means all these documents must originate from the SAP Ariba Procurement solutions and then be sent to SAP ERP or SAP S/4HANA.
You must change or cancel orders in SAP Ariba Procurement solutions, not in the SAP system. Therefore, apply the appropriate authorization concept in SAP ERP or SAP S/4HANA to prevent users from changing purchase orders directly in SAP ERP or SAP S/4HANA.
Additional Information:
Buyers can send attachments and comments from SAP Ariba Procurement solutions to the SAP system. In the SAP system, these are processed as follows:
- Header level: Using the SAP Generic Object Services (GOS) for purchase orders.
- Line level: Using the SAP Document Management System (DMS) for purchase orders.
The attachment size cannot exceed 74 MB at the header or line level of purchase orders. Multiple attachments are allowed, but the limit for the number of attachments per line item is 20, and the combined attachment size is 100 MB.
Comments are supported for purchase orders at both the header and line levels. The comments field allows you to enter free-form text associated with a purchase order, including any additional information.
Prerequisites:
- Install the latest Managed Gateway for Spend&Network AddOn components for integration with SAP Ariba Procurement solutions.
- Configure the purchase order integration, change purchase order integration, and close purchase order integration between SAP Ariba Procurement solutions and SAP ERP or SAP S/4HANA.
- Enable required integration events in your SAP Ariba Procurement realm.
- Enable required parameters in your SAP Ariba Procurement realm.
- Maintain the required Cross-Reference parameters in the Managed Gateway for Spend&Network integration project for Ariba Procurement.
Required Events and Parameters:
The following list represents the required purchase order-specific integration events and parameters to be enabled on the SAP Ariba Procurement site (based on your requirements):
| Events |
|---|
| Export Purchase Orders Asynchronously |
| Import Purchase Order Status Asynchronously |
| Export Change Purchase Orders Asynchronously |
| Import Change Purchase Orders Status Asynchronously |
| Export Cancel Purchase Orders Asynchronously |
| Import Cancel Purchase Order Status Asynchronously |
| Import Purchase Order ERP Header Status Asynchronously |
| Export Purchase Order Close Status synchronously |
| Parameters |
|---|
| Application.Procure.EnableTaxesChargesAndDiscount |
| Application.Purchasing.RenumberReqLineItemSplits |
| Application.Purchasing.PullCloseOrderStatusAckFromERP |
| Application.Purchasing.PushCloseOrderStatusToERP |
| Application.Purchasing.AllowPurchaseOrderLineClose |
| Application.Procure.UseCancelOrderIntegration |
| Application.Procure.EnableServiceItemFieldInRequisition |
| Application.Procure.AllowAttachmentToERP |
| Application.Ordering.AllowOrderAttachmentToERP |
| Application.Approvable.AllowedAttachmentExtensions |
Important Restrictions:
- The SAP System supports file names of attachments only up to 50 characters, including extension.
- SAP Ariba Procurement solutions do not support exporting zero-value amounts for line items in amount-based purchase orders.
- The SAP System supports a maximum of 40 characters for line-item text when creating or changing Purchase Orders.
- Attachments for service line items in Purchase Orders are supported only at the parent line level and not at the child line level.
- Service hierarchy support is limited to 2 levels.
- Account assignment category U (Unknown) is supported only on service line items.
- SAP Ariba Procurement solutions do not allow editing purchase orders with Account assignment category A (Asset).
- Deleting a comment on SAP Ariba Procurement solutions does not delete the corresponding comment in SAP ERP or SAP S/4HANA.
Note
More information about the Purchase Order, including associated prerequisites and restrictions, is available in the SAP Integration Suite, Managed Gateway for Spend Management and SAP Business Network Overview Guide. Navigate to Transactions for SAP Ariba Procurement solutions > Inbound Transactions for SAP Ariba Procurement solutions and look for Purchase Order, Prerequisites, and Restrictions sections.
Integrating Closed Purchase Orders from SAP Ariba Procurement Solutions to the SAP System
The integration of purchase order closure information from SAP Ariba Procurement Solutions with SAP ERP or SAP S/4HANA enables seamless synchronization of purchase order data between the two systems. This integration supports both header-level and line-level closure, ensuring accurate and up-to-date information.
By integrating purchase order closure information, the system enhances fund allocation and utilization, providing a comprehensive view of available resources. The real-time nature of this integration ensures that any changes in purchase order status are promptly reflected in both SAP Ariba Procurement Solutions and SAP ERP or SAP S/4HANA.
When a purchase order is closed in SAP Ariba Procurement Solutions, the corresponding status is automatically updated in SAP ERP or SAP S/4HANA. Any unused funds allocated for the purchase order are released, and the open quantity is set to zero. Conversely, when a purchase order is reopened in SAP Ariba Procurement Solutions, the status of the corresponding purchase order in SAP ERP or SAP S/4HANA is updated accordingly. If a closed purchase order is reopened in SAP Ariba Procurement Solutions, the funds released as unused upon closure are restored to the system.
Buyers can specify a status when closing a purchase order. The following table lists the status messages that buyers can set in SAP Ariba Procurement solutions and the corresponding status update in SAP ERP or SAP S/4HANA:
| Status in SAP Ariba Procurement solutions | Status in SAP ERP |
|---|---|
| Order Closed for Receiving | Delivery Complete |
| Order Closed for Invoicing | Final Invoice |
| Order Closed for All Actions | Delivery Complete and Final Invoice |
Integrating Closed Purchase Orders from the SAP System to SAP Ariba Procurement Solutions
Integration of Closed Purchase Orders is supported in both directions. Buyers utilizing Managed Gateway for Spend&Network integrated with SAP Ariba Procurement solutions can enable this feature and export purchase order closure information from SAP ERP or SAP S/4HANA to SAP Ariba Procurement solutions.
Buyers using this feature must refrain from closing purchase orders in SAP Ariba Procurement solutions and from transmitting the status to the SAP system.
The line items closed in the purchase order are marked either as received or invoiced using the following indicators on the SAP ERP system:
- Delivery Complete
- Final Invoice
The Export the Status of Closed Purchase Orders program retrieves records for purchase orders closed within a specified range and transmits their status to SAP Ariba Procurement solutions.
The following table enumerates the status messages that buyers can set in the SAP system and the corresponding status update in SAP Ariba Procurement solutions:
| Status in SAP ERP | Status in SAP Ariba Procurement solutions |
|---|---|
| Delivery Complete | Order Closed for Receiving |
| Final Invoice | Order Closed for Invoicing |
| Delivery Complete and Final Invoice | Order Closed for Receiving and Invoicing |
Prerequisites:
When integrating closed purchase orders from the SAP System to SAP Ariba Procurement solutions, these important prerequisites apply:
In SAP Ariba Procurement Solutions:
- Disable the Application.Purchasing.PushCloseOrderStatusToERP parameter to block SAP Ariba Procurement solutions from sending the status of a closed purchase order back to the SAP system.
- Enable the Application.Purchasing.AllowPurchaseOrderLineClose parameter to allow the closure of individual line items in purchase orders.
- Enable the Ability to close order/order line item with a new status (status 7 - close for receiving and invoicing) feature available under Feature Availability Status to allow buyers to close a purchase order or purchase order line item with the Order Closed for Receiving and Invoicing status.
- Enable the following parameter to allow the change of closure status of individual line items in purchase orders: Application.Purchasing.EnableChangingFromOneERPOrderLineCloseStatusToAnother.
In the SAP System:
- Install the latest Managed Gateway for Spend&Network AddOn components for integration with SAP Ariba Procurement solutions.
- Enable the ERP Response to Procurement event in the Interface Setup program within your Managed Gateway for Spend&Network AddOn in the SAP system.
- Maintain the required configuration in your SAP system.
- Implement the SAP Note: 1987986.
Restrictions:
When integrating closed purchase orders from the SAP System to SAP Ariba Procurement solutions, the following restrictions apply:
- The status in SAP Ariba Procurement solutions will not be updated for purchase orders closed in SAP ERP prior to the implementation of this feature. In such cases, you can manually execute the program to export the status of the closed purchase orders that require updates in SAP Ariba Procurement solutions.
- The SAP system does not support the Delivery Complete status for service purchase orders or non-catalog items. Consequently, the SAP system does not update the status of closed service purchase orders in SAP Ariba Procurement solutions as Order Closed for Receiving or Order Closed for Receiving and Invoicing.
Importing Header Status of Purchase Orders
When integrating Purchase Orders, Goods Receipts, Invoices, etc. from SAP Ariba Procurement solutions with SAP ERP or SAP S/4HANA, the source of truth is the SAP Ariba Procurement solutions. All documents must originate from these solutions and be sent to SAP ERP or SAP S/4HANA. Users must change, cancel, receive, or invoice orders in SAP Ariba Procurement solutions, not in the SAP system. Therefore, apply the appropriate authorization concept in SAP ERP or SAP S/4HANA to prevent users from directly changing purchase orders in these systems.
Changed orders in a Received, Receiving, Invoiced, or Invoicing state in SAP Ariba Procurement solutions cannot be canceled. Similarly, if purchase orders are mistakenly received or invoiced in SAP ERP or SAP S/4HANA, the Change from SAP Ariba Procurement solutions to SAP ERP or SAP S/4HANA may fail, and the Cancel export will be rejected.
After an order reaches SAP ERP or SAP S/4HANA, its status can change. For instance, if you receive or invoice an order in SAP ERP or SAP S/4HANA, a subsequent Change Order from SAP Ariba Procurement solutions may fail, and a subsequent Cancel order is likely to be rejected.
To prevent such situations, the scheduled task ProcessERPHeaderStatusPull imports header status information from SAP ERP or SAP S/4HANA. It sets the ERPAllowCancel field, which determines if an order can be canceled in SAP Ariba Procurement solutions.
Note
Buyers should use ProcessERPHeaderStatusPull only if they have enabled Change and Cancel order integration from SAP Ariba Procurement solutions to SAP ERP or SAP S/4HANA and are receiving or invoicing purchase orders directly in these systems.
The task doesn’t eliminate all Cancel Order integration failures. SAP ERP or SAP S/4HANA considers various factors when determining if an order can be canceled. However, the status import is based on the receiving and invoicing status.
ProcessERPHeaderStatusPull imports the status for all orders in the Ordered state for the specified QueryPeriod (days before the current date).
Maintain the necessary configuration in the Managed Gateway for Spend&Network AddOn to extract Purchase Order Header Status from SAP ERP or SAP S/4HANA.