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:
1. 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.
Choose Create Channel and maintain the required fields.
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
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.
- 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.
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.
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.
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
- Prepare a purchase order containing recognizable header and item information and attach it to an email.
- Send the email to the configured mailbox using a subject line that matches your routing rules.
3. Check the document processing result in the SAP Document AI workspace.
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.
5. Review the extracted information and complete missing data before you create a sales order.
For further background and prerequisites, refer to:
- Create Sales Orders – AI-Assisted Extraction
- Create Sales Orders – AI-Assisted Extraction (F8947): How-To Guide
- SAP Help Portal: Create Sales Orders – AI-Assisted Extraction
- SAP Help Portal: SAP Document AI — Channels
Source link