logo

Are you need IT Support Engineer? Free Consultant

Create Sales Orders – AI-Assisted Extraction (F8947): Processing Purchase Orders from Incoming Email

  • By Sanjay
  • 18/11/2026
  • 16 Views



Customers often send purchase orders as email attachments. Traditionally, internal sales representatives need to open the email, download the document, review its contents, and manually enter the order information into the sales system. This process is time-consuming and prone to manual errors.

With the Create Sales Orders – AI-Assisted Extraction app (F8947), incoming purchase order attachments can be processed automatically based on a preconfigured email inbound channel in the SAP Document AI workspace.

This blog explains how to configure an email inbound channel in the SAP Document AI workspace and validate the complete end-to-end process. Note that a sales order request is not yet a sales order. Human review (and sometimes manual data entry) remains part of the process before sales order creation.

The following diagram illustrates the overall process flow, with this blog focusing on the email scenario:

2026-11-16_16-04-45.Png1. Prerequisites

Before configuring the inbound channel, ensure that the following prerequisites are fulfilled:

  • App F8957 and its prerequisites have been set up by your administrator. See Create Sales Orders – AI-Assisted Extraction.
  • A supported mailbox and related authentication setup are available. Only selected mailbox types are supported. See Configuring Inbound Channels: Technical Information.
  • A dedicated mailbox folder has been configured per company code. Since the inbound channel monitors a specific mailbox folder, all purchase-order emails must first be routed to that folder. It is recommended to use mailbox rules for automatic routing.
  • Users are authorized to configure and activate inbound channels in the SAP Document AI workspace.

2. Create an Email Inbound Channel in the SAP Document AI workspace

The inbound channel associates emails from a specific mailbox and folder with a schema version, allowing automated extraction of business data from incoming purchase order documents. For more information, see  SAP Document AI – Create Inbound Channel.

Step 1: Configure General Settings

From the Overview screen of the SAP Document AI workspace, choose My Channels.

Xiao_Zhao1_0-1794972002079.Png

Choose Create Channel and maintain the required fields.

2026-11-16_17-29-27.Png

Configure the fields as follows:

Field

Description

Name

Enter a name for the channel.

Channel

Select Inbound.

Type

Select MAIL.

Mail Server

Select Microsoft for Outlook, Microsoft 365, or Exchange mailboxes. Select Google for Gmail mailboxes.

Email ID

Enter the mailbox address that the channel should monitor.

Fetch Interval

Specify how frequently emails are retrieved. Supported values range from 5 to 1440 minutes.

Process Email Parts As

Select Separate Files.

Include in Processing

Recommendation: Select Attachments only.

If you select Separate Files, select which email parts to include in processing under Include in Processing: Body, Attachments, or both. For details on processing behavior by target type, see Processing Behavior for Inbound Email Parts.

Folder

Enter the mailbox folder from which the system retrieves purchase-order emails.

Destination Name

This name is freely definable and is used to create the destination on SAP Business Technology Platform. If you reuse a destination created in SAP Document AI, you must use the DOC_AI_  prefix.

Step 2: Configure Authentication

For Microsoft mailboxes, select OAuth2ClientCredentials as the authentication method.

Prepare the following information from the Microsoft Entra ID application registration:

  • Client ID
  • Client Secret
  • OAuth Tenant ID

2026-11-16_17-29-45.Png

For Gmail mailboxes, enter the Gmail account (email ID) used during the setup of the Google Cloud Console project.

Configure Two-Factor Authentication (2FA)

Microsoft

  • Set the 2FA switch to ON if the mailbox uses two-factor authentication.
  • If the refresh token expires after 90 days, the channel is automatically deactivated. To reactivate, choose Activate and authenticate again.

Google

  • Two-factor authentication is mandatory.
  • The 2FA switch is enabled by default and cannot be modified.

When the refresh token expires, the channel is automatically deactivated. To reactivate, choose Activate and authenticate again.

Step 3: Select the Extraction Target

Choose Schema Version as the target type and select Version 1 of the sales order request schema.

2026-11-16_17-05-06.Png

This schema determines how document information is extracted and mapped into a sales order request.

Step 4: Maintain Required Input Parameters

If the selected schema contains fields with processor type Input, provide all mandatory values in the Input Parameters step.

2026-11-16_17-30-28.Png

For schema SALES_ORDER_REQUEST (Version 1), the companyCode field is a mandatory input parameter.

Recommendation: Assign one company code to one mailbox folder.

Step 5: Review, Save, and Activate

Save the channel, activate it, and verify that its status is Active.

2026-11-16_17-31-33.Png

Once activated, the channel periodically monitors the configured mailbox folder and automatically retrieves email attachments for document processing.

3. Validate the End-to-End Process 

  1. Prepare a purchase order containing recognizable header and item information and attach it to an email.
  2. Send the email to the configured mailbox using a subject line that matches your routing rules.        

2026-11-17_11-09-45.Png

      3. Check the document processing result in the SAP Document AI workspace.

2026-11-17_16-24-21.Png

    4. Open the Create Sales Orders – AI-Assisted Extraction app (F8947) in SAP S/4HANA Cloud and verify that a new sales order request has been created.

2026-11-17_16-22-27.Png

    5. Review the extracted information and complete missing data before you create a sales order.

 

For further background and prerequisites, refer to:

 

 





Source link

Leave a Reply

Your email address will not be published. Required fields are marked *

Chat with us on WhatsApp!