Purchase Orders to Sales Orders Converter
Oracle documents an Order Management AI agent that converts purchase orders received as PDF documents into Oracle sales orders. Users can upload one or more purchase-order PDFs for a selected business unit and click Create Order, and from release 26C a designated email account can be configured so that purchase orders arriving by email are picked up and converted without user intervention. Oracle states the agent gets the order into draft status rather than failing, optionally invoking the separate Sales Order Correction Assistant to resolve master-data mismatches.
Recorded characteristics
- Function
- Oracle: "Use an AI agent in Oracle Order Management to automatically convert a purchase order from a PDF file into a sales order." Two intake paths are documented for the same seeded template. Interactive path: Order Management work area, Sales Orders, Create Sales Orders from Purchase Orders; the user selects a business unit, uploads one or more PDF purchase orders and clicks Create Order, then reviews a process ID on the Action Status page and any entries under Issues Needing Your Attention. Email path, added in 26C: an inbound email account, monitored folder, authentication and polling interval are configured in AI Agent Studio, and "purchase orders coming into the designated emails get picked up automatically by the agent and converted to sales orders without user intervention", with an activity trace showing the source email and its attachments.
- Data access
- Purchase-order PDF documents supplied by upload or as email attachments; for the email path, the monitored mailbox folder and message contents. Oracle states the PDF must contain values for Customer, Ordered Date, Purchase Order Number, Ship-to Address, Item, Quantity and Unit Price, and that any other order attribute may optionally be included. When the Sales Order Correction Assistant is configured, Oracle states smart matching compares purchase-order values with Oracle master and setup data for Customer, Account, Address, Payment Term, Item, Item Description, Salesperson, Currency, FOB, Freight Terms and Shipping Method, and that it can examine a customer's most recent 20 sales orders to find attribute values.
- Actions
- Can take actions
- External actions
- Unknown
- Human confirmation
- Conditional
- Permission basis
- Not established
- Administrative control
- Oracle documents an administrator-driven setup: set the profile option Enable VBCS Progressive Web Application User Interface (ORA_HCM_VBCS_PWA_ENABLED) to Y at site level; open Tools, AI Agent Studio and find the Purchase Order to Sales Order Converter template; use Actions, Copy Template with a suffix; publish the copy and confirm its status is Published; note the resulting agent team code, for example PURCHASEORDERTOSALESORDERCONVERTOR_1; and set the convertPOtoSOAgentName attribute on the Sales Orders page through Visual Builder Studio. Optional automatic error fixing requires repeating the same steps with the Sales Order Correction Assistant template and setting salesOrderCorrectionAgentName. The email path additionally requires adding an email account under AI Agent Studio, Credentials, Email Accounts with account name, email address, email folder and authentication details (tenant ID, client ID, secret), plus workflow variables including businessUnitName and an email trigger. Access requirements documented include SCM Intelligent Agent Management Duty (both ORA_RCS_SCM_AI_AGENT_MANAGEMENT_DUTY and ORA_RCS_SCM_AI_AGENT_MANAGEMENT_DUTY_HCM), Fai Genai Agent SCM Administrator Duty, Fai Genai Agent Runtime Duty for interacting with agents in product pages, permission groups enabled in the Security Console, and the View Orders privilege (FOM_VIEW_ORDERS_PRIV).
- Default state
- Disabled
- Availability
- Documented for Oracle Fusion Cloud Order Management in the redesigned (Redwood) Order Management pages. Oracle introduced the converter in release 25D, described automatic error fixing and draft-status outcomes in 26A, and added the email intake channel in 26C. A living implementation-guide page maintained outside a single release describes the upload path, template setup and error correction; as fetched it does not yet describe the 26C email channel.
- Licensing
- Not established. No Oracle primary page reviewed states a licence, entitlement or additional charge for this agent.
- External model or provider
- Not established. Oracle does not name a model or model provider for this agent in the documentation reviewed.
- Limitations and uncertainty
- Oracle does not state whose identity the resulting sales-order writes execute under, so permission basis is recorded as not established; the documented duties cover administrator setup and interacting with agents in product pages rather than proving the runtime write identity, although a "Created by Agent" filter indicates some agent attribution exists. Oracle states the order is placed in draft status; no primary text reviewed establishes automatic submission, order import, approval, reservation, release, picking, shipping, invoicing, payment or revenue recognition, and Oracle notes that if the sales order is imported it must be imported through REST API. Oracle describes matching against existing master and setup data with an error displayed when matching fails, and does not establish that the agent creates customer or item master records. Unit price is listed as a required extracted attribute but is not listed among the smart-matched attributes, and no interaction with Oracle pricing rules is documented. Oracle does not establish whether the source PDF remains attached to the created order, whether multiple uploaded PDFs map one-to-one to orders, allowed senders or supported attachment types for the email channel, scanned-image PDF support, or file-size limits. No AI-specific audit store is established beyond the process ID, Action Report, Issues Needing Your Attention and the AI Agent Studio Monitoring and Evaluation activity trace.
Evidence
- AI: Purchase Orders to Sales Orders Converter (Implementing Order Management)
Supports: Function · Actions · Data access · Human confirmation · Admin controls · Default state · Permission basis · Limitations · General · Primary source
Oracle documents the agent as converting purchase orders received as PDF files into Oracle sales orders, configured from the Purchase Order to Sales Order Converter template in AI Agent Studio.
Oracle: "Automatically fix errors and get the order into draft status instead failing." Oracle also states that if the sales order is imported, it must be imported through REST API.
Oracle: "Your PDF must include values for these attributes: Customer, Ordered Date, Purchase Order Number, Ship-to Address, Item, Quantity, Unit Price", with other order attributes optional.
Oracle documents the interactive path in which the user selects a business unit, uploads PDFs and clicks Create Order.
Oracle documents the profile option ORA_HCM_VBCS_PWA_ENABLED, Copy Template and Publish of the seeded template, the agent team code, and setting convertPOtoSOAgentName in Visual Builder Studio; the Sales Order Correction Assistant is a separate template enabled through salesOrderCorrectionAgentName.
Oracle requires an administrator to copy and publish the seeded template and wire the agent name into the Sales Orders page before the agent is usable.
Oracle lists SCM Intelligent Agent Management Duty, Fai Genai Agent SCM Administrator Duty, Fai Genai Agent Runtime Duty for interacting with agents in product pages, Security Console permission groups and the View Orders privilege; the identity under which order writes execute is not stated.
Oracle: "You must use Order Management's redesigned pages", the purchase order "must clearly indicate the relationship between the attribute and its value", and customers must thoroughly test with correct and incorrect purchase orders in a test environment before production deployment.
Oracle documents smart matching against master and setup data for Customer, Account, Address, Payment Term, Item, Item Description, Salesperson, Currency, FOB, Freight Terms and Shipping Method, with an 80% confidence threshold, a fallback examining the customer's most recent 20 sales orders, and an error displayed if that fails; no creation of customer or item master data is documented.
- AI Agent: Purchase Orders to Sales Orders Converter (25D)
Supports: Availability · Primary source
Oracle 25D introduced the AI agent that converts a purchase order from a PDF file into a sales order.
- AI Agent: Purchase Orders to Sales Orders Converter (26A)
Supports: Actions · Availability · Permission basis · Primary source
Oracle 26A: "Select your Business Unit, upload one or more PDF files that contain your purchase orders, then click Create Order", with a process ID shown and viewable through Action Status and the Action Report.
Oracle 26A documents the current upload workflow, automatic error fixing and the Issues Needing Your Attention review path.
Oracle 26A lists the access requirements including both SCM Intelligent Agent Management duty role codes and the View Orders privilege.
- AI Agent: Purchase Order to Sales Order Converter via email (26C)
Supports: Human confirmation · Admin controls · Limitations · Actions · Availability · Primary source
Oracle 26C: "Purchase orders coming into the designated emails get picked up automatically by the agent and converted to sales orders without user intervention."
Oracle 26C: configure the inbound purchase order email account in AI Agent Studio, including the email address, monitored folder, authorization details and polling interval, plus workflow variables including businessUnitName as the default business unit where sales orders are created.
Oracle 26C: "You can't have multiple instances of same agent that is sharing same email address." Oracle also advises reviewing the generated sales order and any holds or exceptions before continuing downstream order processing.
Oracle 26C states the Sales Order Correction Agent, if enabled, corrects errors automatically and logs them as warnings for review, with Created by Agent and Validation Error filters available on sales order search.
Oracle 26C adds the email intake channel to the converter, monitored through the Monitoring and Evaluation page activity trace showing the source email and its attachments.