ONT Order Upload creates new sales orders, updates existing orders, adds lines, books orders and cancels orders in Oracle Order Management from Excel – via the standard Oracle public API. Each spreadsheet row is one order line, grouped under a shared order identifier.
When to use it
- Mass-create new sales orders from a spreadsheet (one or many lines per order).
- Add lines to existing orders in bulk.
- Bulk-update header or line fields (dates, prices, addresses, shipping, salesrep, flexfields) on existing orders.
- Book many entered orders at once.
- Cancel orders (and all their lines) in bulk, with a recorded change reason.
- Apply line-level discounts or price overrides with a proper price-adjustment audit trail.
Before you start
- Blitz Report is installed and you are signed in to a responsibility with access to the operating unit.
- The customer (and its account) exists, is active, and has ship-to/bill-to sites in the operating unit.
- The item exists and is orderable; a valid order type and line type exist for the operating unit.
Step 1 – Choose a mode, set the parameters and download
In Blitz Report, open ONT Order Upload, choose an Upload Mode (Create, Update – the default – downloads existing orders to edit; Create gives an empty template), and set the parameters:
| Parameter | Purpose |
|---|---|
| Upload Mode | Create or Create, Update. Default is Create, Update. |
| Operating Unit | The operating unit; drives the customer/order/warehouse lists. |
| Order Number / Customer / Order Type / Order Status / Item / dates | Restrict which existing orders are downloaded. |
| Order Action | Pre-set the action (Book / Cancel) written into every downloaded row. |
Run the upload to download and open the Excel file. Each order is automatically handled as a create or an update depending on whether it already exists.
Step 2 – Enter the orders
Each row is one order line; the Upload Order Identifier groups a single order’s lines. For a new order leave Order Number blank and put a unique reference (e.g. new1) in the identifier; repeat it on every line. On the header enter the Operating Unit, Customer, Order Type, Header Ship To and Header Bill To; on each line the Item, Ordered Quantity, UOM and Line Request Date.
Step 3 – Book or cancel (optional)
Set Order Action to Book to submit the order for booking, or to Cancel to cancel the order and all its lines (a Header Change Reason is required to cancel).
Step 4 – Validate and Save
Click Validate and Save. This checks for missing required values and runs the upload’s validation, then saves the file. Correct anything it flags before continuing.
Step 5 – Upload and view the result
Back in Blitz Report, click Upload and select your saved file. This submits the Blitz Upload request, which creates, updates, books or cancels each order. When it finishes, a result report opens showing each row as success or error.
What’s produced
- Created and updated sales orders with their lines; orders booked or cancelled as requested.
- A result report listing every row with a status (success or error) and a message.
Common questions
How do I create a brand-new order?
Leave Order Number blank and put a unique reference (e.g. new1) in Upload Order Identifier; repeat that identifier on every line of the order.
How do I put several lines on one order?
Give all those rows the same Upload Order Identifier; the header columns are read from the first row.
How do I book an order?
Set Order Action to Book (you can pre-set it for the whole download via the Order Action parameter).
How do I cancel an order?
Set Order Action to Cancel and supply a Header Change Reason – this cancels the order and all its lines. There is no separate delete.
Why must I enter a Discount Modifier when I change the selling price?
A manual price override must be backed by a price adjustment so it’s auditable; the upload enforces this exactly as the Order Management form does.
Troubleshooting
| Message | Cause | What to do |
|---|---|---|
| Operating Unit not found | The operating unit isn’t recognised or not accessible. | Pick the Operating Unit from the dropdown; ensure your responsibility has access. |
| Header Change Reason is required when Order Action is Cancel | Cancel attempted without a reason. | Enter a Header Change Reason (and optionally comments). |
| Discount Modifier is required when Unit Selling Price differs from Unit List Price | A manual price override with no modifier. | Choose a Discount Modifier, or set the selling price equal to the list price. |
| Tax Exempt Reason is required when Tax Handling is Exempt | Tax Handling set to Exempt without a reason. | Fill in the corresponding Tax Exempt Reason. |
| Order-processing error (invalid item/customer/site) | The Oracle API rejected the data. | Read the Oracle error in the Message column, correct the field, and re-upload (the order is rolled back, so no partial data is left). |