> For the complete documentation index, see [llms.txt](https://developer.emporix.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.emporix.io/ce/extensibility-and-integrations/integrations/sap-integration/sap-sales-quotes-integration/sap-sales-quotes-process.md). # Process Flow This guide describes the interactions between Emporix Commerce Engine and SAP S/4HANA for sales and quote transactions at process level. The content is aligned with the [Integration Suite Configuration](/ce/extensibility-and-integrations/integrations/sap-integration/sap-sales-quotes-integration/sap-sales-quotes-configuration.md) guide. ## Processes overview ### Price simulation The price simulation process ensures that a customer sees individual prices instead of general list prices, which is especially relevant in B2B processes. Pricing processes consider product discounts, customer discounts, master agreements, and other configured parameters. As part of corporate sales processes, pricing is typically defined in the ERP backend. In those processes, current and individual prices are determined by executing the backend pricing logic. For consistency, price determination in eCommerce relies on the same pricing process. Determining individual product prices in the ERP backend is also response time-sensitive — customers accessing the B2B Commerce Frontend expect a quick update in response to their latest UI interaction. Individual pricing requires a logged-on customer, so their relationship to a [company](/ce/management-dashboard/customer-management/companies.md) is known and all relevant information can be provided to the pricing process. For SAP S/4HANA as the ERP backend, the function module `PIQ_CALCULATE` is a good option for fast price simulation. It is suggested to call pricing simulation from the shopping cart, providing the customer with up-to-date prices just before a potential checkout. The `PIQ_CALCULATE` function module carries out pricing at line item level by determining and executing the pricing procedure configured in SAP S/4HANA. Header-level pricing, credit checks, and similar functions are not covered by this function module. The integration package provides the [RFC-based Pricing Simulation](/ce/extensibility-and-integrations/integrations/sap-integration/sap-sales-quotes-integration/sap-sales-quotes-configuration.md#rfc-based-pricing-simulation) iFlow for calling this function module. ### Order simulation Order simulation provides order-relevant information before checkout and is closely related to price simulation. While price simulation primarily determines pricing results, order simulation covers the broader sales order creation process and can return additional information such as material availability and credit check results. The simulation executes the configured ERP sales order creation logic without persisting the order. This allows relevant results — such as pricing, material availability, and credit status — to be displayed in the shopping cart. In SAP S/4HANA, simulation is based on the `API_SALES_ORDER_SIMULATION_SRV` OData service, invoked by the [A2X-based Order Simulation](/ce/extensibility-and-integrations/integrations/sap-integration/sap-sales-quotes-integration/sap-sales-quotes-configuration.md#a2x-based-order-simulation) integration flow. ### Order creation The order creation process manages the transfer of sales orders from Emporix Commerce Engine to the SAP S/4HANA ERP system, triggered by the customer checkout event. Upon checkout, Emporix Commerce Engine initiates the `order.create` webhook, which calls the [A2X-based Order Create](/ce/extensibility-and-integrations/integrations/sap-integration/sap-sales-quotes-integration/sap-sales-quotes-configuration.md#a2x-based-order-create) integration flow. This flow uses the SAP S/4HANA `API_SALES_ORDER_SRV` OData service to create the sales order, supporting both standard order creation and creation with reference to existing documents. Once successfully processed in the ERP — triggering any configured approval, execution, or invoicing workflows — the system updates the [order status](/ce/management-dashboard/orders-module/orders.md) in the B2B Commerce Frontend to keep the customer informed. Ongoing status updates are managed by the [A2X-based Order Status Update](/ce/extensibility-and-integrations/integrations/sap-integration/sap-sales-quotes-integration/sap-sales-quotes-configuration.md#a2x-based-order-status-update) integration flow, which queries the same `API_SALES_ORDER_SRV` OData service to translate SAP S/4HANA status values into corresponding statuses within Emporix Commerce Engine. ### Quotation creation The quotation process is essential for B2B scenarios and can originate either from the Emporix Commerce Engine shopping cart or directly within the ERP system — for example, as a follow-up to a customer call. From the customer's perspective, the B2B Commerce Frontend provides the interface to accept or decline [quotations](/ce/management-dashboard/quotes/quotes-view.md). If a quotation is accepted, a sales order with a reference is posted to the ERP system. If declined, the quotation status is updated accordingly in the ERP system. On the seller side, post-creation steps — such as sales manager approvals — occur within the ERP system, following corporate sales processes. Customers can track the progress of their quotation processing directly via the B2B Commerce Frontend. #### Process steps involved in quotation processing * **Quotation creation from Emporix** — If the origin is the shopping cart, the Emporix `quote.create` webhook triggers the [A2X-based Quote Create](/ce/extensibility-and-integrations/integrations/sap-integration/sap-sales-quotes-integration/sap-sales-quotes-configuration.md#a2x-based-quote-create) integration flow. The OData service `API_SALES_QUOTATION_SRV` is used for creation. * **Status updates from Emporix** — Customer declines are managed via the `quote.change` webhook, triggering the [A2X-based Quote Status Update](/ce/extensibility-and-integrations/integrations/sap-integration/sap-sales-quotes-integration/sap-sales-quotes-configuration.md#a2x-based-quote-status-update) integration flow. This flow uses the OData service `API_SALES_QUOTATION_SRV`. * **Order creation** — Customer acceptance initiates the `order.create` webhook, triggering the [A2X-based Order Create](/ce/extensibility-and-integrations/integrations/sap-integration/sap-sales-quotes-integration/sap-sales-quotes-configuration.md#a2x-based-order-create) integration flow to create an order in SAP S/4HANA with a reference to the quotation, as described in the order creation process. * **Replication from SAP S/4HANA** — If a quotation is created or updated in SAP S/4HANA, the [A2X-based Quote Replication](/ce/extensibility-and-integrations/integrations/sap-integration/sap-sales-quotes-integration/sap-sales-quotes-configuration.md#a2x-based-quote-replication) integration flow queries the `API_SALES_QUOTATION_SRV` service to sync these changes to Emporix Commerce Engine. ## Master data prerequisites For the quote approval flow to work end to end, master data must be set up correctly across Emporix and SAP. #### Customer and company relationship The [customer](/ce/management-dashboard/customer-management/customers.md) who logs in to the B2B Commerce Frontend must have a clear relationship to a [company](/ce/management-dashboard/customer-management/companies.md). In the current example setup, a 1:1 relationship between the shop user and the company is required. At customer level, one Business Partner entry is assigned. A customer can be related to a company in a "one to many" model, but the Business Partner assignment on the customer is a single entry. #### SAP Business Partner and Sales Area on company level On the company, the **Sap Business Partner** mixin defines the SAP Business Partner and the Sales Area assignment. The Business Partner must have a unique relationship to the sales organization for the flow to work as delivered in the integration package.
SAP Business Partner and Sales Area configuration for a company

SAP Business Partner and Sales Area configuration for a company

Sales Area assignment on company level is configured per sales organization. The integration package supports one sales organization per shop user through the company relationship. If a single user must work across multiple sales organizations, a project-specific solution is required to extend the assignment model. {% hint style="info" %} For mixin import and Sales Area setup, see [Mixin setup](/ce/extensibility-and-integrations/integrations/sap-integration/sap-sales-quotes-integration/sap-sales-quotes-configuration.md#mixin-setup). {% endhint %} ## End-to-end quote approval flow The following steps describe a quote approval scenario example across SAP S/4HANA, [Emporix Management Dashboard](/ce/management-dashboard/quotes/quotes-view.md), and the [B2B Commerce Frontend](/frontend/commerce-examples/quote-process.md) that you can follow. In this example, the quotation originates in SAP and is replicated to Emporix through the [A2X-based Quote Replication](/ce/extensibility-and-integrations/integrations/sap-integration/sap-sales-quotes-integration/sap-sales-quotes-configuration.md#a2x-based-quote-replication) integration flow. {% hint style="success" %} The same flow can also start from the B2B Commerce Frontend. In that case, the customer creates the quotation in Emporix, which triggers quote creation in SAP S/4HANA through the [A2X-based Quote Create](/ce/extensibility-and-integrations/integrations/sap-integration/sap-sales-quotes-integration/sap-sales-quotes-configuration.md#a2x-based-quote-create) integration flow. After the quotation is released in SAP, the process continues in the same way — the customer accepts or declines the quotation on the B2B Commerce Frontend, and acceptance leads to order creation as described in the steps below. The only difference is the quote origin: when the flow starts in Emporix, it's the customer who creates the quotation. {% endhint %} {% stepper %} {% step %} #### Create the quotation in SAP S/4HANA In SAP Fiori, create the sales quotation and select the **Sales Area**. After choosing the area, enter the remaining sales details. * The **order reason** is required to proceed with the quote. * On the **Partner** details, assign the contact person who should receive the quotation in Emporix. Then when the quotation is created, you can check its details overview.
Create Quotation overview in SAP S/4HANA with Sales Area, sold-to party, and line items

Create Quotation overview in SAP S/4HANA with Sales Area, sold-to party, and line items

{% endstep %} {% step %} #### Quote replication in Emporix The quotation replicated from SAP appears in the [Quotes](/ce/management-dashboard/quotes/quotes-view.md) view in the Management Dashboard with **Creating** status. In the **Sap Quote Details** tab, the SAP mixin fields show **Sales Quote Id**, **Sales Quote Origin** (`SAP`), and **Sales Quote Status** (`In approval`).
Sap Quote Details tab showing Sales Quote Status In approval

Sap Quote Details tab showing Sales Quote Status In approval

On the **B2B Commerce Frontend**, the replicated quotation is also visible with **Creating** status. The customer cannot accept or decline the quote yet because it has not been approved in SAP.
Quote details on the B2B Commerce Frontend with Creating status

Quote details on the B2B Commerce Frontend with Creating status

At this stage, the quotation status in SAP S/4HANA is **In Approval**. This mapping is intentional: on the B2B Commerce Frontend, the quote is not yet customer-actionable because it has not been approved in SAP. | System | Status | | ---------------------------------------------------- | ----------- | | SAP S/4HANA | In Approval | | Emporix Management Dashboard / B2B Commerce Frontend | Creating | | {% endstep %} | | {% step %} #### Release the quotation in SAP S/4HANA In SAP, open the quotation workflow and view the task that was created for approval. **Release** the quotation to complete the internal approval step.
SAP To-Dos task for releasing the quotation

SAP To-Dos task for releasing the quotation

{% endstep %} {% step %} #### Quote becomes available on the B2B Commerce Frontend After the quotation is released in SAP, the status is replicated to Emporix: * In the **Management Dashboard** [Quotes](/ce/management-dashboard/quotes/quotes-view.md) view, the replicated quotation appears in the list with **Open** status. The row shows the related **Company**, **Creation date**, and **Total price**.
Replicated SAP quotation in the Management Dashboard Quotes list with Open status

Replicated SAP quotation in the Management Dashboard Quotes list with Open status

* On the **Sap Quote Details** tab, the SAP mixin fields are populated with **Sales Quote Id**, **Sales Quote Origin** (`SAP`), and **Sales Quote Status** (`Released`).
Sap Quote Details tab showing Sales Quote Id, Sales Quote Origin, and Sales Quote Status Released

Sap Quote Details tab showing Sales Quote Id, Sales Quote Origin, and Sales Quote Status Released

On the **B2B Commerce Frontend**, the quote status changes from **Creating** to **Open**. The customer can review the quotation and choose **Accept**, **Reject**, or **Request Change**.
Quote details on the B2B Commerce Frontend with Open status and accept actions

Quote details on the B2B Commerce Frontend with Open status and accept actions

{% hint style="info" %} For the general quote acceptance flow in Emporix, see the [Quote Process](/frontend/commerce-examples/quote-process.md) guide. {% endhint %} {% endstep %} {% step %} #### Accept the quote and create the order On the B2B Commerce Frontend, the customer accepts the quote by choosing **Create Order**, it starts the quote-to-order conversion. An optional comment can be added before confirming.
B2B Commerce Frontend prompt to accept the quote and create an order

B2B Commerce Frontend prompt to accept the quote and create an order

Emporix creates the order in the Commerce Engine. In the Management Dashboard [Quotes](/ce/management-dashboard/quotes/quotes-view.md) view, the quote status changes to **Accepted**. The **General** tab shows the related **Order Number**.
Accepted quote in the Management Dashboard with related Order Number

Accepted quote in the Management Dashboard with related Order Number

On the B2B Commerce Frontend, the **Order Details** view shows the new order with **Created** status, including **Shipping address**, **Payment method**, and line items.
Order details on the B2B Commerce Frontend with Created status

Order details on the B2B Commerce Frontend with Created status

The `order.create` webhook triggers the [A2X-based Order Create](/ce/extensibility-and-integrations/integrations/sap-integration/sap-sales-quotes-integration/sap-sales-quotes-configuration.md#a2x-based-order-create) integration flow to post the order to SAP S/4HANA with a reference to the quotation. Once the quote is accepted on the B2B Commerce Frontend, it can no longer be updated from SAP. {% endstep %} {% step %} #### Verify the sales order in SAP S/4HANA In SAP, a new sales order appears in the workflow. Choose **Display Order** to open it. You can verify that the sales order was created with a reference to the originating quotation. The **Customer Reference** field carries the Emporix order number.
Display Sales Order in SAP S/4HANA with customer reference to the Emporix order

Display Sales Order in SAP S/4HANA with customer reference to the Emporix order

{% hint style="info" %} The SAP order ID is also visible in the B2B Commerce Frontend and Management Dashboard order details. {% endhint %} {% endstep %} {% endstepper %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://developer.emporix.io/ce/extensibility-and-integrations/integrations/sap-integration/sap-sales-quotes-integration/sap-sales-quotes-process.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.