PO Acceptance Upload

Description

PO Acceptance Upload records buyer acceptances (acknowledgments) against existing Oracle Purchasing documents – Standard, Blanket, Contract and Planned purchase orders and Blanket Releases – from Excel, using the standard Oracle Purchasing acceptance API. Each row creates one acceptance with the Accepted flag, acceptance type, action, action date, accepting employee, role and an optional note, the same as entering it in the Acceptances window.

When to use it

  • Record supplier acknowledgments of many purchase orders or releases in one go, for example from a supplier confirmation list.
  • Clear the acceptance requirement of purchase orders that require acceptance, once the supplier has confirmed them.
  • Backfill acceptance history with a specific action date and acceptance type per document.
  • Record who accepted each document and in which role.

Before you start

  • Access to the upload in Blitz Report, with a responsibility that has access to the operating unit.
  • The purchase order or release exists and is not cancelled or finally closed, with status Approved, Requires Reapproval or Incomplete.
  • Acceptances are recorded for the current revision of the document only.

Step 1 – Set the parameters

Open PO Acceptance Upload in Blitz Report and set the parameters:

ParameterMeaning
Operating UnitDefaults the Operating Unit column of new rows and restricts the upload to acceptances for this operating unit. Leave it blank to upload acceptances for any operating unit you have access to.
Default ActionThe Action used for rows where the Action column is empty (default New).
Default Action DateThe Action Date used for rows where the Action Date column is empty. If both are empty, the current date is used.
Blitz Report run screen for PO Acceptance Upload with Operating Unit Vision Operations and Default Action New

Step 2 – Run to download the Excel file

Click Run. The Excel file downloads and opens with an empty sheet: the upload only creates new acceptances and does not download existing ones.

Downloaded Excel file with an empty sheet for entering new acceptances

Step 3 – Enter the acceptances

Enter one row per acceptance with the Operating Unit and PO Number, plus the Release for a Blanket Release. Set Accepted (Yes or No) and the Acceptance Type (for example Accepted All Terms or On Schedule), and optionally the Action, Action Date, Role and Comments.

  • Supplier, Supplier Number and Supplier Site are optional and only narrow the PO Number list. Selecting a supplier fills its number and site.
  • Revision defaults to the document’s current revision.
  • Accepted By Employee and Accepted By Employee Num default to the buyer of the purchase order or release. You can pick another buyer from the list; if the name is not unique, also enter the employee number.
Excel file with acceptances for blanket agreement 3004 and purchase order 6021, marked Create, with acceptance type, role and comments

Step 4 – Validate and Save

Click Validate and Save. This checks for missing required values and saves the file. Correct any rows it flags before uploading.

Both acceptance rows show status Valid after Validate and Save

Step 5 – Upload the file

In Blitz Report click Upload and select the saved file. This submits the upload request, which records each acceptance.

File Upload page with the saved Excel file selected for upload

Step 6 – Review the result report

When the request completes, a result report opens listing every uploaded row with its status and message.

Result report showing both acceptances recorded with status Success

What’s produced

  • One buyer acceptance per row against the purchase order or release, visible in the Acceptances window of the document.
  • For rows with Accepted = Yes, the document no longer requires acceptance: its Acceptance Required flag and acceptance due date are cleared.
  • A result report listing every row with a status (success or error) and a message.

Common questions

Can I update or delete existing acceptances?
No. The upload only records new acceptances; the Excel file always opens empty.

Can I record supplier acceptances?
No. All acceptances are recorded as buyer acceptances.

Do I have to fill in the supplier columns?
No. They only narrow the PO Number list; you can enter the PO Number directly.

What happens if I leave Action or Action Date blank?
Action takes the Default Action parameter (default New). Action Date takes the Default Action Date parameter, or the current date if that is blank too.

Who is recorded as the accepting employee?
The employee in Accepted By Employee, which defaults to the buyer of the purchase order or release. If it is cleared, the buyer is used.

Can I accept an older revision?
No. Only the current revision of the purchase order or release can be accepted.

Can I enter descriptive flexfield values?
The default template does not include the acceptance descriptive flexfield. Add the Attribute Category and attribute columns to a template of your own to upload them.

Troubleshooting

MessageCauseWhat to do
Operating Unit is invalidThe operating unit does not exist or is no longer active.Pick the Operating Unit from the list.
PO Number is not validNo purchase order with this number exists in the operating unit.Pick the PO Number from the list and check the operating unit.
PO Number is not uniqueMore than one purchase order with this number exists in the operating unit.Contact your Purchasing administrator; the document cannot be identified by number.
Release Number is not validThe release does not exist for this blanket agreement.Pick the Release from the list for the selected PO Number.
Revision Number does not match documents current revision number (n)The Revision entered is not the document’s current revision, shown in brackets.Enter the current revision or leave Revision at its default.
Accepted By is not a valid current employeeThe employee name or number does not match a current employee.Pick the employee from the list, or clear both columns to use the buyer.
Accepted By is not unqiue. Please specify the Employee Number as wellMore than one current employee has this name.Also enter Accepted By Employee Num.
You cannot update this document because its status is either Frozen, Canceled, Finally Closed, In Process or Pre-approved.The purchase order or release is cancelled, finally closed or in an approval status that does not allow acceptances.Record acceptances only for open documents in status Approved, Requires Reapproval or Incomplete.
DFF Error: …A descriptive flexfield value failed validation.Correct the Attribute Category and attribute values to the allowed values.

SQL 70 lines

Parameters 3

ParameterTypeList of values SQL
Operating UnitLOV
Default ActionChar
Default Action DateDate