PO Upload Interface

PO Upload Interface allows you to upload purchase order information from an external system in order to create a new purchase order or update the PO lines on an existing purchase order in the CWSerenade database.

In this topic:

PO Upload Process

Creating a New PO through the PO Upload Interface

Maintaining an Existing PO through the PO Upload Interface

PO Upload Interface Errors

PO Upload Table Updates

PO Header Interface Table (IXPHDP)

PO Header Interface Message Table (IXPHMP)

PO Detail Interface Table (IXPDTP)

PO Detail Interface Message Table (IXPDMP)

For more information: See:

Working with PO Interface Records (WPOI)

Work with PO Interface Records Screen

Change PO Header Interface Screen

Display Purchase Order Header Interface Screen

Change PO Header Interface Messages Screen

First PO Interface - Maintain Detail Screen

Second PO Interface Maintain Detail Screen (Changing)

Display Purchase Order Detail Interface Screen

Change PO Detail Interface Message Screen

Rerun PO Interface Table Edit (RPOI)

Rerun PO Interface Edit Screen

PO Upload Process

Instructions: Use the following steps to upload PO information from an external system.

1.

Create a PO text file for the purchase order information you wish to upload.

You can use the sample data below to create the PO upload text files.

PO Header upload file:

7|416151|REF416151||1150501|N|1150425|1150416|N|1150430|THOMAS BROWN|N||V416151|SHIP INSTRUCTIONS|I|BTM|7|5|7|1|USR1|USR2|USR3|USR4

PO Header Message upload file:

7|416151|1|P|PO HEADER MESSAGE LINE 1

PO Detail upload file:

7|416151|1|1||1150425|100|25.0000|1150430|1150416|RF123SKU4567|ROSE XSML WMNS|EA|7|5|1

PO Detail Message upload file:

7|416151|1|1|P|PO DETAIL MESSAGE LINE 1

2.

Once the text files are ready to upload, use the Working with File Uploads (WUPL) menu option to upload the records in the text files to the PO Interface tables in the CWSerenade database.

PO Header Interface Table (IXPHDP): Each record in this table represents a separate PO.

PO Header Interface Message Table (IXPHMP): Each record in this table represents a separate PO Header message for the specified PO.

PO Detail Interface Table (IXPDTP): Each record in this table represents a separate PO line for the specified PO.

PO Detail Interface Message Table (IXPDMP): Each record in this table represents a separate PO Detail message for the specified PO and PO line.

3.

Review, and optionally change, the records in the PO Interface tables in the Working with PO Interface Records (WPOI) menu option.

4.

When you are ready to upload the records from the PO Interface tables, use the Work with PO Interface Records Screen or Rerun PO Interface Edit Screen to submit the PO upload process.

Note: You can also schedule the PO upload process to run periodically by setting up the POUPLD periodic function using the PFR0085 program. See Scheduling Jobs for background.

See Creating a New PO through the PO Upload Interface and Maintaining an Existing PO through the PO Upload Interface for processing details.

Batch PO layering: Once you have uploaded PO information, use the Batch PO Layering (BPOL) to update the expected delivery dates for items on backorder, based on the quantity and expected delivery dates for items on open purchase orders. See Purchase Order Layering for more information.

Creating a New PO through the PO Upload Interface

The system performs the following validation when you create a new PO through the PO Upload Interface.

1.

Determines if the PO number in the PO Header Interface Table (IXPHDP) already exists in the PO Header table.

If the PO number already exists in the PO Header table, the system looks at the setting of the PO Interface Maintenance (L05) system control value.

• If this system control value is selected, the system allows you to upload PO maintenance changes through the PO Upload Interface; see Maintaining an Existing PO through the PO Upload Interface.

• If this system control value is unselected, the system places the PO interface record in an error status:

Duplicate PO/PO # Already Exists.

You can review and correct errors in the Working with PO Interface Records (WPOI) menu option.

2.

Validates that each record in the PO Header Interface Table (IXPHDP) is associated with a record in the PO Detail Interface Table (IXPDTP). You can upload multiple PO Detail Interface records for one PO Header Interface record. Each detail record represents a PO line on the purchase order.

3.

Validates that the required fields in the PO Interface tables contain information and the fields that require a valid value contain a valid value. For example, the system validates the buyer code against the Buyer table.

See PO Upload Interface Errors for more information on the validation the system performs.

4.

Failed New PO Upload

If the PO record does not pass validation, the system:

• Prints the record on the PO Interface - Error Report.

• Retains the record in the PO Interface table in an error status until the record is fixed or deleted. You can work with PO interface records that are in an error status using the Working with PO Interface Records (WPOI) menu option.

Note: If one of the records for a PO Interface record contains an error, the system retains all of the associated records for the PO in the PO Interface tables until the entire PO is error-free. For example, if you upload a new PO and one of the PO lines for the PO in the PO Detail Interface Table (IXPDTP) contains an error, the system retains all of the associated records for the PO in the PO Interface Header table, PO Interface Detail table, PO Interface Header Message table, and PO Interface Detail Message table.

5.

Successful New PO Upload

If the PO record passes validation, the system:

• Creates the CWSerenade purchase order. See PO Upload Table Updates for more information on how the system creates the PO.

• Submits the purchase order to the OTHR_Async for processing. See Updates During Background Processing for a listing of related table updates.

• Deletes the records from the PO Interface tables.

• Prints the purchase order on the PO Interface - Accepted PO Report.

You can review or maintain the purchase order in Maintaining Purchase Orders (MPOE). The system defaults the value INTERFACE in the User field to indicate that the purchase order was created through the PO Upload Interface.

Maintaining an Existing PO through the PO Upload Interface

When you maintain an existing PO through the PO Upload Interface, the system cancels the existing lines on the PO and adds a new line to the PO for each associated record in the PO Detail Interface Table (IXPDTP). The system uses the PO number defined for the record in the PO Header Interface Table (IXPHDP) to determine which PO to update; however, the system does not update the existing PO with the header information defined for the PO Header Interface record. For example, if the Buyer passed in the PO Header Interface record is different from the Buyer that is defined on the existing PO, the system does not update the buyer code on the PO. Also, you cannot create or maintain PO header messages or PO line messages on an existing PO using the PO Upload Interface.

Drop ship POs: The system allows you to maintain the lines on a drop ship PO through the PO Upload Interface.

The system performs the following validation when you maintain an existing PO through the PO Upload Interface.

1.

Determines if the PO number in the PO Header Interface Table (IXPHDP) already exists in the PO Header table.

If the PO number does not already exist in the PO Header table, the system creates the PO; see Creating a New PO through the PO Upload Interface.

2.

Verifies that the PO is eligible for maintenance through the PO Upload Interface. In order to be eligible for maintenance:

• The PO Interface Maintenance (L05) system control value must be selected. Note: If this system control value is not selected, you can use the PO Upload Interface to create new POs only and use the Maintaining Purchase Orders (MPOE) menu option to maintain the POs.

• The status of the PO must be Open.

• The Received qty for each line on the PO must be 0, indicating no receipts have been made against the PO.

• The record in the PO Header Interface Table (IXPHDP) must be associated with a record in the PO Detail Interface Table (IXPDTP). You can upload multiple PO Detail Interface records for one PO Header Interface record. Each detail record represents a PO line on the purchase order. You must upload at least one PO line for the PO; you cannot use the PO Upload Interface to cancel an entire PO.

If the PO does not pass these edits, the system places the PO interface record in an error status.

PO cannot be maintained.

You can review and correct errors in the Working with PO Interface Records (WPOI) menu option.

3.

Validates that the required fields in the PO Interface tables contain information and the fields that require a valid value contain a valid value. For example, the system validates the vendor number against the Vendor table.

See PO Upload Interface Errors for more information on the validation the system performs.

4.

Failed PO Maintenance Upload

If a record does not pass validation, the system:

• Prints the record on the PO Interface - Error Report.

• Retains the record in the PO Interface table in an error status until the record is fixed or deleted. You can work with PO interface records that are in an error status using the Working with PO Interface Records (WPOI).

Note: If one of the records for a PO Interface record contains an error, the system retains all of the associated records for the PO in the PO Interface tables until the entire PO is error-free. For example, if you upload a maintained PO and one of the PO lines for the PO in the PO Detail Interface Table (IXPDTP) contains an error, the system retains all of the associated records for the PO in the PO Interface Header table, PO Interface Detail table, PO Interface Header Message table, and PO Interface Detail Message table.

5.

Successful PO Maintenance Upload

If the PO record passes validation, the system:

• Retains the existing record in the PO Header table.

• Cancels all of the existing lines for the PO in the PO Detail table.

• Adds new lines to the PO based on the records for the PO in the PO Detail Interface Table (IXPDTP). See PO Upload Table Updates for more information on how the system creates the new PO lines.

• Submits the purchase order to the OTHR_Async for processing. See Updates During Background Processing for a listing of related table updates.

• Deletes the records from the PO Interface tables.

• Prints the purchase order on the PO Interface - Accepted PO Report.

You can review or maintain the purchase order in Maintaining Purchase Orders (MPOE).

PO Upload Interface Errors

The system includes PO Interface records that are in error on the PO Interface - Error Report. You can correct records that are in error using the Working with PO Interface Records (WPOI) menu option.

Error

Reason

PO Header Interface Errors

PO Header Without Detail

A record exists in the PO Header Interface Table (IXPHDP) that is not associated with a record in the PO Detail Interface Table (IXPDTP).

Reference # missing on Hdr

The Reference # field for the record in the PO Header Interface Table (IXPHDP) is blank. The system requires a reference number for POs created or maintained through the PO Upload Interface regardless of the setting of the PO Reference # Required (A35) system control value.

Buyer # missing on Hdr

The Buyer field for the record in the PO Header Interface Table (IXPHDP) is blank and it is a required field.

Invalid Buyer # on Hdr

The Buyer field for the record in the PO Header Interface Table (IXPHDP) is an invalid value.

Buyer codes are defined in and validated against the Buyer table.

Invalid Offer

The Offer field for the record in the PO Header Interface Table (IXPHDP) is an invalid value.

Offer codes are defined in and validated against the Offer table.

Offer Required

The Offer field for the record in the PO Header Interface Table (IXPHDP) is blank and it is a required field. The setting of the Offer Required Entry on Purchase Orders (A36) system control value defines whether an offer is required on a PO.

Invalid Ship Via on Hdr

The Ship via field for the record in the PO Header Interface Table (IXPHDP) is an invalid value.

Ship via codes are defined in and validated against the Ship Via table.

Invalid Warehouse# on Hdr

The Warehouse field for the record in the PO Header Interface Table (IXPHDP) is an invalid value. Warehouse codes are defined in and validated against the Warehouse table.

Invalid Warehouse on Hdr/missing on Whs X-ref file

The Warehouse field for the record in the PO Header Interface Table (IXPHDP) is blank and it is a required field.

Vendor # missing on Hdr

The Vendor number field for the record in the PO Header Interface Table (IXPHDP) is blank and it is a required field.

Invalid Vendor # on Hdr

The Vendor number field for the record in the PO Header Interface Table (IXPHDP) is an invalid value. Vendor codes are defined in and validated against the Vendor table.

Cancel date cannot be less than or equal to today’s date

The Cancel Date field for the record in the PO Header Interface Table (IXPHDP) contains a date that is less than or equal to the current date; the date must be greater than the current date.

Due Date missing on Hdr

The Due Date field for the record in the PO Header Interface Table (IXPHDP) is blank and it is a required field.

Due Date cannot be less than or equal to today’s Date

The Due Date field for the record in the PO Header Interface Table (IXPHDP) must contain a date that is greater than the current date.

Entry Date missing on Hdr

The Entry Date field for the record in the PO Header Interface Table (IXPHDP) is blank and it is a required field.

Invalid PO Type on Hdr

The PO type field for the record in the PO Header Interface Table (IXPHDP) is an invalid value. Valid values are:

I or blank = Initial Buy.

R = Reorder.

Duplicate PO/PO # Already Exists

The PO Number field for the record in the PO Header Interface Table (IXPHDP) already exists in the PO Header table and the PO Interface Maintenance (L05) system control value is unselected, indicating that PO maintenance changes are not allowed in the PO Upload Interface.

PO cannot be maintained

The PO Number field for the record in the PO Header Interface Table (IXPHDP) already exists in the PO Header table, the PO Interface Maintenance (L05) system control value is selected, indicating that PO maintenance changes are allowed in the PO Upload Interface, but the PO does not qualify for maintenance. In order to maintain a PO through the PO Upload Interface, the PO must be in an Open status and none of the lines on the PO can have receipts against them.

PO Detail Interface Errors

Associated PO Header Interface not found

A record exists in the PO Detail Interface Table (IXPDTP) that is not associated with a record in the PO Header Interface Table (IXPHDP).

Note: If a record fails for this reason, the system retains the record in the PO Detail Interface table in an error status; however, you cannot view the record in the Working with PO Interface Records (WPOI) menu option.

PO Detail Sequence # Required

The Sequence # field for the record in the PO Detail Interface Table (IXPDTP) is blank.

Item # missing on Dtl

The Item number field for the record in the PO Detail Interface Table (IXPDTP) is blank and it is a required field.

Invalid Item #

The Item number field for the record in the PO Detail Interface Table (IXPDTP) is invalid.

Item codes are defined in and validated against the Item table.

Invalid SKU Code

The SKU field for the record in the PO Detail Interface Table (IXPDTP) is blank or invalid and the item is a SKUed item, or the SKU field for the record in the PO Detail Interface Table (IXPDTP) contains a value and the item is a non-SKUed item.

SKU codes are defined in and validated against the SKU table.

UOM is Missing

The Unit of Measure field for the record in the PO Detail Interface Table (IXPDTP) is blank and it is a required field.

Invalid UOM on Detail

The Unit of Measure field for the record in the PO Detail Interface Table (IXPDTP) is invalid.

Unit of measure codes are defined in and validated against the Unit of Measure table.

UOM on Itemfile Difference

The Unit of Measure field for the record in the PO Detail Interface Table (IXPDTP) is a valid value, but does not match the unit of measure code defined for the specified item.

Vendor is Missing on Dtl

The Vendor number field for the record in the PO Detail Interface Table (IXPDTP) is blank and it is a required field.

Invalid Vendor on Detail

The Vendor number field for the record in the PO Detail Interface Table (IXPDTP) is invalid.

Vendor codes are defined in and validated against the Vendor table.

PO Header Vendor # is 7 and PO Detail Vendor is 9

The Vendor number field for the record in the PO Detail Interface Table (IXPDTP) is different from the value in the Vendor number field for the record in the PO Header Interface Table (IXPHDP).

Vendor codes are defined in and validated against the Vendor table.

Invalid warehouse on Dtl/missing on Whs X-Ref file

The Warehouse field for the record in the PO Detail Interface Table (IXPDTP) is blank and it is a required field.

Invalid warehouse on Dtl

The Warehouse field for the record in the PO Detail Interface Table (IXPDTP) is invalid.

Warehouse codes are defined in and validated against the Warehouse table.

PO Header Warehouse is 007 Different from PO Detail Warehouse

The Warehouse field for the record in the PO Detail Interface Table (IXPDTP) is different from the value in the Warehouse field for the record in the PO Header Interface Table (IXPHDP).

Warehouse codes are defined in and validated against the Warehouse table.

Due Date missing on Dtl

The Due Date field for the record in the PO Detail Interface Table (IXPDTP) is blank and it is a required field.

Invalid Due Date on Detail

The Due Date field for the record in the PO Detail Interface Table (IXPDTP) must contain a date that is greater than the current date.

Order Qty missing on Dtl

The Order qty field for the record in the PO Detail Interface Table (IXPDTP) is blank and it is a required field.

Price missing on Dtl

The Price field for the record in the PO Detail Interface Table (IXPDTP) is blank and it is a required field.

Entry Date missing on Dtl

The Entry date field for the record in the PO Detail Interface Table (IXPDTP) is blank and it is a required field.

Invalid Ship Via on Dtl

The Ship Via field for the record in the PO Detail Interface Table (IXPDTP) is invalid.

Ship via codes are defined in and validated against the Ship Via table.

PO Upload Table Updates

The system uses the information defined in the PO Interface tables and certain defaults to update the PO tables in the CWSerenade database.

You can review the PO in Maintaining Purchase Orders (MPOE).

PO Header Table

PO Detail Table

PO Header Table

New POs: The system creates a new record in the PO Header table for new POs created using the PO Upload Process. See below for the field updates.

Maintained POs: The system retains the existing record in the PO Header table for POs maintained using the PO Upload Process. The system does not apply any field updates from the PO Header Interface Table (IXPHDP) to this record.

You can review the PO Header information on the Display Purchase Order Header Screen; see this screen for complete field descriptions.

Field

Description

Company

From the Company field in the PO Header Interface Table (IXPHDP).

PO #

From the PO Number field in the PO Header Interface Table (IXPHDP).

Status

O (Open) defaults. The system creates the PO in an Open status, regardless of the setting of the PO Default Status (A49) system control value.

Workstation

INTERFACE defaults, indicating the purchase order was created through the PO Upload Interface.

Cancel date

From the Cancel Date field in the PO Header Interface Table (IXPHDP).

Confirming PO

From the Confirming PO field in the PO Header Interface Table (IXPHDP).

Currency rate

Defaults to 1.0000000.

Discount %

From the Discount % field in the Vendor table for the vendor defined in the Vendor number field in the PO Header Interface Table (IXPHDP).

See Applying Discounts to a Purchase Order Line for more information on how the system calculates the discounts to apply to a PO line.

Due date

From the Due Date field in the PO Header Interface Table (IXPHDP).

Entry date

From the Entry Date field in the PO Header Interface Table (IXPHDP).

Last transaction date

0 defaults.

Negotiate price

From the Negotiate Price field in the PO Header Interface Table (IXPHDP).

Print date

0 defaults.

Promise date

From the Promise Date field in the PO Header Interface Table (IXPHDP).

Placed with name

From the Placed With field in the PO Header Interface Table (IXPHDP).

Recurring PO

From the Recurring PO field in the PO Header Interface Table (IXPHDP).

Reference #

From the Reference # field in the PO Header Interface Table (IXPHDP).

Tax status

From the Tax Status field in the PO Header Interface Table (IXPHDP).

Vendor reference #

From the Vendor Reference # field in the PO Header Interface Table (IXPHDP).

Shipping instructions

From the Shipping instructions field in the PO Header Interface Table (IXPHDP).

Revision #

1 defaults.

Completed date

0 defaults.

Print worksheet

N defaults.

Revised date

Defaults to the date the PO was created.

Approval date

0 defaults.

EDI date

0 defaults.

Surcharge %

From the Surcharge % field in the Vendor table for the vendor defined in the Vendor number field in the PO Header Interface Table (IXPHDP).

PO Type

From the PO type field in the PO Header Interface Table (IXPHDP).

User field 1

From the PO User Field 1 field in the PO Header Interface Table (IXPHDP).

User field 2

From the PO User Field 2 field in the PO Header Interface Table (IXPHDP).

User field 3

From the PO User Field 3 field in the PO Header Interface Table (IXPHDP).

User field 4

From the PO User Field 4 field in the PO Header Interface Table (IXPHDP).

Unit discount amount 1

From the VDS Unit Discount field for VDS Seq # 1 in the Vendor table for the vendor defined in the Vendor number field in the PO Header Interface Table (IXPHDP).

See Applying Discounts to a Purchase Order Line for more information on how the system calculates the discounts to apply to a PO line.

Unit discount amount 2

From the VDS Unit Discount field for VDS Seq # 2 in the Vendor table for the vendor defined in the Vendor number field in the PO Header Interface Table (IXPHDP).

See Applying Discounts to a Purchase Order Line for more information on how the system calculates the discounts to apply to a PO line.

Unit discount amount 3

From the VDS Unit Discount field for VDS Seq # 3 in the Vendor table for the vendor defined in the Vendor number field in the PO Header Interface Table (IXPHDP).

See Applying Discounts to a Purchase Order Line for more information on how the system calculates the discounts to apply to a PO line.

Unit discount pct 1

From the VDS Discount Pct field for VDS Seq # 1 in the Vendor table for the vendor defined in the Vendor number field in the PO Header Interface Table (IXPHDP).

See Applying Discounts to a Purchase Order Line for more information on how the system calculates the discounts to apply to a PO line.

Unit discount pct 2

From the VDS Discount Pct field for VDS Seq # 2 in the Vendor table for the vendor defined in the Vendor number field in the PO Header Interface Table (IXPHDP).

See Applying Discounts to a Purchase Order Line for more information on how the system calculates the discounts to apply to a PO line.

Unit discount pct 3

From the VDS Discount Pct field for VDS Seq # 3 in the Vendor table for the vendor defined in the Vendor number field in the PO Header Interface Table (IXPHDP).

See Applying Discounts to a Purchase Order Line for more information on how the system calculates the discounts to apply to a PO line.

FOB Freight terms

Remains blank.

Extracted flag?

N defaults.

Processed by Inter

Remains blank.

Apt Code

From the APT Code field in the Vendor table for the vendor defined in the Vendor number field in the PO Header Interface Table (IXPHDP).

Buyer

From the Buyer field in the PO Header Interface Table (IXPHDP).

Offer number

From the Offer field in the PO Header Interface Table (IXPHDP).

User

INTERFACE defaults.

Warehouse

From the Warehouse field in the PO Header Interface Table (IXPHDP).

GLA Account #

From the GLA Account # field for the R Tran code in the Item Transaction Code table if the Default Receipt General Ledger Number (D95) system control value is selected.

Currency code

From the Local Currency Code (A55) system control value.

Customer #

0 defaults.

Order #

0 defaults.

Ship to #

0 defaults.

Vendor #

From the Vendor number field in the PO Header Interface Table (IXPHDP).

Ship via

From the Ship via field in the PO Header Interface Table (IXPHDP); otherwise, from the Default Purchase Order Ship Via for Purchase Order Interface (F85) system control value.

PO header estimated charges: You cannot create a PO header estimated charge for a PO created or maintained using the PO Upload Process. See the Work with PO Header Estimated Charges Screen for more information.

PO Detail Table

New POs: The system creates a new record in the PO Detail table for each new PO line created using the PO Upload Process. See below for the field updates.

Determining the Order of PO lines on New POs

The PO lines for a new PO created through the PO Upload interface display on the PO Maintenance - Maintain Detail Screen in line # sequence. Note: The sequence # and line # for each PO line created must be unique.

Example: If you pass the following PO lines in the PO Detail Interface table:

PO #

Seq #

Line #

Item

3183

1

4

AQU

3183

5

1

BLC

3183

2

3

BLU

3183

3

5

GOL

3183

4

2

ITM

The system displays the PO lines in the following order:

PO #

Seq #

Line #

Item

3183

5

1

BLC

3183

4

2

ITM

3183

2

3

BLU

3183

1

4

AQU

3183

3

5

GOL

Maintained POs: The system updates the Status of the existing PO lines on the PO to C (Cancelled) and creates a new record in the PO Detail table for each new PO line created using the PO Upload Process. See below for the field updates.

Determining the Order of PO lines on Maintained POs

The PO lines for a maintained PO created through the PO Upload interface display on the PO Maintenance - Maintain Detail Screen in line # sequence. If an existing PO line that is cancelled has the same line # as a PO line that is uploaded through the PO Upload interface, the system adds the new PO line before the existing cancelled PO line. Note: The sequence # and line # for each PO line created must be unique.

Example: An existing PO has the following PO lines:

PO #

Seq #

Line #

Item

3185

1

1

ROS

3185

2

2

RED

If you pass the following PO lines in the PO Detail Interface table for the existing PO:

PO #

Seq #

Line #

Item

3183

1

1

AQU

3183

2

2

BLC

3183

3

3

BLU

3183

4

4

GOL

3183

5

5

ITM

The system displays the PO lines in the following order:

PO #

Seq #

Line #

Item

Status

3183

3

1

AQU

 

3183

1

2

ROS

Cancelled

3183

4

3

BLC

 

3183

2

4

RED

Cancelled

3183

5

5

BLU

 

3183

6

6

GOL

 

3183

7

7

ITM

 

You can review the PO Detail information on the First Display Purchase Order Detail Screen and Second Display Purchase Order Detail Screen; see these screens for complete field descriptions.

Field

Description

Company

From the Company field in the PO Detail Interface Table (IXPDTP).

P/O #

From the PO Number field in the PO Detail Interface Table (IXPDTP).

Seq #

From the Sequence # field in the PO Detail Interface Table (IXPDTP).

See Determining the Order of PO lines on New POs and Determining the Order of PO lines on Maintained POs.

Status

O (Open) defaults.

Line #

From the Line # field in the PO Detail Interface Table (IXPDTP).

See Determining the Order of PO lines on New POs and Determining the Order of PO lines on Maintained POs.

Cancel date

From the Cancel date field for the associated PO header in the PO Header table.

Due date

From the Due Date field in the PO Detail Interface Table (IXPDTP).

In transit qty

0 defaults.

Inventory item

Y defaults.

Order qty

From the Order qty field in the PO Detail Interface Table (IXPDTP).

Price

From the Price field in the PO Detail Interface Table (IXPDTP).

Promise date

From the Promise date field in the PO Detail Interface Table (IXPDTP).

Received qty

0 defaults.

Vendor order qty

1 defaults.

Unit discount amount

From the Discount % field in the Vendor table for the vendor defined in the Vendor number field in the PO Detail Interface Table (IXPDTP).

See Applying Discounts to a Purchase Order Line for more information on how the system calculates the discounts to apply to a PO line.

Discount override

N defaults.

Entry date

From the Entry date field in the PO Detail Interface Table (IXPDTP).

Price method

O defaults.

Vendor price

From the Price field in the PO Detail Interface Table (IXPDTP).

Vnd price curr type

From the VND price currency type field in the Vendor table for the vendor defined in the Vendor number field in the PO Detail Interface Table (IXPDTP)

Unit discount amt 1

From the Unit discount amount 1 field for the associated PO Header in the PO Header table.

See Applying Discounts to a Purchase Order Line for more information on how the system calculates the discounts to apply to a PO line.

Unit discount amt 2

From the Unit discount amount 2 field for the associated PO Header in the PO Header table.

See Applying Discounts to a Purchase Order Line for more information on how the system calculates the discounts to apply to a PO line.

Unit discount amt 3

From the Unit discount amount 3 field for the associated PO Header in the PO Header table.

See Applying Discounts to a Purchase Order Line for more information on how the system calculates the discounts to apply to a PO line.

Unit discount pct 1

From the Unit discount pct 1 field for the associated PO Header in the PO Header table.

See Applying Discounts to a Purchase Order Line for more information on how the system calculates the discounts to apply to a PO line.

Unit discount pct 2

From the Unit discount pct 2 field for the associated PO Header in the PO Header table.

See Applying Discounts to a Purchase Order Line for more information on how the system calculates the discounts to apply to a PO line.

Unit discount pct 3

From the Unit discount pct 3 field for the associated PO Header in the PO Header table.

See Applying Discounts to a Purchase Order Line for more information on how the system calculates the discounts to apply to a PO line.

Misc price 1

0.00 defaults.

Misc price 2

0.00 defaults.

Vendor discount amt

From the Discount % field in the Vendor table for the vendor defined in the Vendor number field in the PO Detail Interface Table (IXPDTP).

See Applying Discounts to a Purchase Order Line for more information on how the system calculates the discounts to apply to a PO line.

Vnd Unit disc $ 1

0.0000 defaults.

Vnd Unit disc $ 2

0.0000 defaults.

Vnd Unit disc $ 3

0.0000 defaults.

Disc variance

0.0000 defaults.

ITM Number

From the Item number field in the PO Detail Interface Table (IXPDTP).

SKU Code

From the SKU field in the PO Detail Interface Table (IXPDTP).

Unit of measure

From the Unit of Measure field in the PO Detail Interface Table (IXPDTP).

Vendor’s unit of measure

From the Vend ord qty multiple field in the Vendor Item table for the Item number and Vendor number in the PO Detail Interface Table (IXPDTP).

Buyer

From the Buyer field for the associated PO Header in the PO Header table.

GLA Account #

From the GLA Account # field for the associated PO Header in the PO Header table.

Offer number

From the Offer field for the associated PO Header in the PO Header table.

Ship via

From the Ship Via field in the PO Detail Interface Table (IXPDTP).

Vendor #

From the Vendor number field in the PO Detail Interface Table (IXPDTP).

Item

From the Item field in the Vendor Item table for the item and SKU defined in the Item number field and SKU field in the PO Detail Interface Table (IXPDTP).

Warehouse

From the Warehouse field in the PO Detail Interface Table (IXPDTP).

PO detail estimated charges: You cannot create a PO detail estimated charge for a PO line created or maintained using the PO Upload Process. See the Work with PO Detail Estimated Charges Screen for more information.

PO Header Interface Table (IXPHDP)

Purpose: This table contains purchase order header information. You need to populate this table to generate a purchase order through the PO Upload Process.

Each record in this table represents a separate purchase order and must be associated with at least one record in the PO Detail Interface Table (IXPDTP).

Maintaining an existing PO: Maintaining an existing PO through the PO Upload Interface allows you to cancel the existing lines on the PO and create new lines based on the records for the PO in the PO Detail Interface Table (IXPDTP). When you maintain an existing PO through the PO Upload Process, the system uses the PO Header Interface record to find a match to an existing PO in the PO Header table. However, the system does not update the header information for the existing PO with the information defined in the PO Header Interface record. For example, if the existing PO has a buyer of BTM and the PO Header Interface record for the PO maintenance change has a buyer of KRB, the system does not update the buyer on the existing PO. See Maintaining an Existing PO through the PO Upload Interface for more information.

See Working with File Uploads (WUPL) for more information on how to populate this table with purchase order header information from an external system.

Field

Description

Company

The CWSerenade company number.

Company codes are defined in and validated against the Company table.

Corresponds to the Company field in the PO Header table.

Numeric, 3 positions; Required.

PO Number

The purchase order number that is being created or updated.

Corresponds to the PO # field in the PO Header table.

New Purchase Orders

The system:

• Validates that the PO number does not already exist in the PO Header table.

• Creates the new PO using the PO number provided, regardless of the setting of the System Assigned PO # (B76) system control value.

Maintained Purchase Orders

The system:

• Validates that the PO number exists in the PO Header table. Note: If the PO number does not already exist in the PO Header table, the system creates a new PO.

• Validates that the PO Interface Maintenance (L05) system control value is selected, allowing you to maintain POs through the PO Upload Interface.

• Validates that the status of the PO is Open and all of the lines on the PO have no receipts against them.

Numeric, 7 positions; Required.

Reference #

A reference number you can use if you have the system assign purchase order numbers and you want to track an internal purchase order number or a tracking number on the purchase order. Reference numbers can be used in PO Inquiry to scan for a specific purchase order number.

The reference number may print on the PO, depending on the print program from the PO Print Program (C64) system control value.

Note: The system requires a reference number, regardless of the setting of the PO Reference # Required (A35) system control value.

Corresponds to the Reference # field in the PO Header table.

Alphanumeric, 15 positions; Required.

Processed Status

The status of the PO Header Interface record.

Valid values are:

blank = The record has not yet been processed by the PO Upload Process.

O = The record has been processed by the PO Upload Process and no errors exist.

E = The record has been processed by the PO Upload Process and an error exists. Use the Work with PO Interface Records Screen to review and correct the error.

Alphanumeric, 1 position; Updated by the system.

Cancel Date

The date the purchase order will be marked for cancellation if you do not receive it. See Printing the PO Auto Cancel Report (MPAC).

The cancel date must be greater than the current date.

Corresponds to the Cancel date in the PO Header table.

Numeric, 7 positions (CYYMMDD format); Optional.

Confirming PO

Defines whether this is a confirming purchase order.

If this is a confirming purchase order, you can print confirming purchase orders and the purchase order will indicate that it is a confirming document when you print it; see Printing Purchase Orders.If you are using EDI to transmit orders and follow up with the printed order, the system indicates on the printed document that it is a confirmation of an EDI transmission.

Valid values:

Y = The order was placed over the phone with a vendor and this is a confirming PO.

N or blank = This is not a confirming PO.

Corresponds to the Confirming PO field (C6HYST) in the PO Header table.

Alphanumeric, 1 position; Optional.

Due Date

The date the purchase order is due for receipt. This is the date the operator sees in Order Entry.

The due date must be greater than the current date.

Corresponds to the Due Date field (C6C0DT) in the PO Header table.

Numeric, 7 positions (CYYMMDD format); Required.

Entry Date

The date the PO was created.

Corresponds to the Entry Date field (C6D1DT) in the PO Header table.

Numeric, 7 positions (CYYMMDD format); Required.

Negotiate Price

Determines whether the program pulls prices for items entered.

Valid values:

Y = You must enter a price for each item.

N or blank = The system will automatically pull prices for each item. Prices will be pulled from:

1. Vendor/Item quantity break table

2. Vendor/Item table

3. Item table

Note: Regardless of this setting, you must enter a price for each item in the PO Detail Interface Table (IXPDTP).

Corresponds to the Negotiate Price field (C6HZST) in the PO Header table.

Alphanumeric, 1 position; Optional.

Promise Date

Represents the expected ship date or promised arrival date.

Corresponds to the Promise Date field (C6C4DT) in the PO Header table.

Numeric, 7 positions (CYYMMDD format); Optional.

Placed With

The name of the person at the vendor site with whom you placed the purchase order.

Corresponds to the Placed with field (C6LJTX) in the PO Header table.

Alphanumeric, 30 positions; Optional.

Recurring PO

Determines whether you are entering a template for a recurring purchase order.

Valid values:

Y = The system will assign an R (Recurring) status to the order. Any items and quantities on this order will not be placed “on-order.” Orders with an R status are used in the Recurring Purchase Order generation program. See Recurring Purchase Order Screen.

N or blank = This is not a recurring PO.

Corresponds to the Recurring PO field (C6H0ST) in the PO Header table.

Alphanumeric, 1 position; Optional.

Tax Status

Indicates whether taxes are applied to the order.

Corresponds to the Tax status field (C6LLTX) in the PO Header table.

Alphanumeric, 15 positions; Optional.

Vendor Reference #

An internal reference number that may be stored with the purchase order. For example, the reference number may represent an internal purchase order number from a preprinted purchase order, or an internal control for departmental purchase orders.

Corresponds to the Vendor reference # field (C6LMTX) in the PO Header table.

Alphanumeric, 15 positions; Optional.

Shipping instructions

One line of shipping instructions to print on the purchase order.

Corresponds to the Shipping instructions field (C6LNTX) in the PO Header table.

Alphanumeric, 20 positions; Optional.

PO type

Indicates whether this purchase order is an initial buy (I) or a reorder (R).

Valid values:

I or blank = Initial buy.

R = Reorder.

Corresponds to the PO type field (C6PUSS) in the PO Header table.

Alphanumeric, 1 position; Optional.

Buyer

A code that identifies a person who is authorized to make purchases for your company.

Buyer codes are defined in and validated against the Buyer table; see Working with Buyers (WBUY).

Corresponds to the Buyer field (C6CFCD) in the PO Header table.

Alphanumeric, 3 positions; Required.

Offer

The code for the offer (catalog) you will use to sell the merchandise. See Working with Offers (WOFR).

Required if the Offer Required Entry on Purchase Orders (A36) system control value is selected. The system creates a SKU/Offer record for each item on the purchase order if one does not already exist.

Corresponds to the Offer field (C6CACD) in the PO Header table.

Alphanumeric, 3 positions; Required if SCV A36 is selected.

Warehouse

The warehouse where the items on the purchase order will be shipped.

Corresponds to the Warehouse field (C6WCDE) in the PO Header table.

Numeric, 3 positions; Required.

Vendor number

A code for the vendor (supplier) associated with the purchase order.

Corresponds to the Vendor # field (C6FYNB) in the PO Header table.

Numeric, 7 positions; Required.

Ship via

A code that identifies the shipper to deliver the merchandise to you. This code is validated against the PO Ship Via table. See Working with Purchase Order Ship Via (WPSV). These shippers are defined separately from, and may differ from, those who deliver merchandise to your customers.

The Require Ship Via on Purchase Order Header (E96) system control value controls whether this field is optional or required.

Corresponds to the Ship via code field (C6JQNB) in the PO Header table.

If you leave this field blank, the ship via code from the Default Purchase Order Ship Via for Purchase Order Interface (F85) system control value defaults to the purchase order.

Numeric, 2 positions; Required if SCV E96 is selected.

PO User Field 1

Informational only.

Corresponds to the PO user field 1 field (C6DYTT) in the PO Header table.

Alphanumeric, 10 positions; Optional.

PO User Field 2

Informational only.

Corresponds to the PO user field 1 field (C6DZTT) in the PO Header table.

Alphanumeric, 10 positions; Optional.

PO User Field 3

Informational only.

Corresponds to the PO user field 1 field (C6D0TT) in the PO Header table.

Alphanumeric, 10 positions; Optional.

PO User Field 4

Informational only.

Corresponds to the PO user field 1 field (C6D1TT) in the PO Header table.

Alphanumeric, 10 positions; Optional.

PO Header Interface Message Table (IXPHMP)

Purpose: This table contains purchase order header message information.

Each record in this table represents a separate purchase order header message and must be associated with a record in the PO Header Interface Table (IXPHDP). If you do not wish to add header messages to a purchase order, you can leave this table blank.

Note: You can define a message for a PO only when you create a new PO through the PO Upload Process. You cannot add or maintain a message when you maintain an existing PO through the PO Upload Process.

See Working with File Uploads (WUPL) for more information on how to populate this table with purchase order header message information from an external system.

Field

Description

Company

The CWSerenade company code associated with the purchase order.

Company codes are defined in and validated against the Company table.

Corresponds to the Company field (C8COMP) in the PO Message table.

Numeric, 3 positions; Required.

PO Number

The PO number associated with the message. This PO number must exist in the PO Header Interface Table (IXPHDP).

Corresponds to the PO # field (C8IGNB) in the PO Message table.

Numeric, 7 positions; Required.

Sequence #

A unique number assigned to the PO header message.

Corresponds to the Seq # field (C8PCNB) in the PO Message table.

Numeric, 3 positions; Required.

Print

Indicates whether the message prints on the purchase order or receiving worksheet.

Valid values are:

B = The message prints on both the receiving worksheet and purchase order.

P = The message prints on the purchase order.

W = The message prints on the receiving worksheet.

blank = The message does not print on the purchase order or receiving worksheet.

Corresponds to the Print field (C8H3ST) in the PO Message table.

Alphanumeric, 1 position; Optional.

Message

Free form message about the vendor and/or purchase order.

Corresponds to the Message field (C8LOTX) in the PO Message table.

Alphanumeric, 60 positions; Required.

PO Detail Interface Table (IXPDTP)

Purpose: This table contains purchase order detail information. You need to populate this table to generate a purchase order through the PO Upload Process.

Each record in this table represents a separate purchase order line and must be associated with a record in the PO Header Interface Table (IXPHDP).

See Working with File Uploads (WUPL) for more information on how to populate this table with purchase order detail information from an external system.

Field

Description

Company

The CWSerenade company code associated with the purchase order.

Company codes are defined in and validated against the Company table.

Corresponds to the Company field (ENCOMP) in the PO Detail table.

Numeric, 3 positions; Required.

PO Number

The purchase order number that is being created or updated.

Corresponds to the PO # field (ENIGNB) in the PO Detail table.

New Purchase Orders

• The system validates that the PO number does not already exist in the PO Detail table.

• Creates the new PO using the PO number provided, regardless of the setting of the System Assigned PO # (B76) system control value.

Maintained Purchase Orders

• The system validates that the PO number exists in the PO Detail table.

• The system validates that the PO Interface Maintenance (L05) system control value is selected.

• The system validates that the status of the PO is Open and all of the lines on the PO have no receipts against them.

Numeric, 7 positions; Required.

Sequence #

A unique number assigned to each PO line. Typically, the first detail line is assigned a sequence number of 1.

Note: You must enter a unique sequence number for each PO line. Also, you should use the same number for the sequence number and line number.

Corresponds to the Seq # field (ENPCNB) in the PO Detail table.

Numeric, 3 positions; Required.

Line #

The purchase order line number. There can be up to 999 lines on one purchase order.

Note: You must enter a unique line number for each PO line. Also, you should use the same number for the sequence number and line number.

Corresponds to the Line # field (ENIDNB) in the PO Detail table.

Numeric, 3 positions; Required.

Processed Status

Indicates the status of the PO Detail Interface record.

Valid values are:

blank or O = The record has not yet been processed by the PO Upload Process.

E = The record contains an error. Use the Work with PO Interface Records Screen to review and correct the error.

Alphanumeric, 1 position; optional, Updated by the system.

Due Date

The date the PO is due to be received. This date is indicated in Order Entry, Order Maintenance, and standard or streamlined Order Inquiry.

Corresponds to the Due Date field (ENCWDT) in the PO Detail table.

Numeric, 7 positions (CYYMMDD format); Required.

Order qty

The quantity of the item (in retailer’s unit of measure) being ordered from the vendor.

Corresponds to the Order qty field (ENKIQT) in the PO Detail table.

Numeric, 7 positions; Required.

Price

The unit price you pay the vendor for this item.

Corresponds to the Price field (ENSIPR) in the PO Detail table.

Numeric, 11 positions with a 4-place decimal; Required.

Promise date

The expected ship date or promised arrival date for the PO line. If you do not define a promise date for the PO line, the system defaults the promise date defined on the purchase order header to the line.

Corresponds to the Promise Date field (ENCXDT) in the PO Detail table.

Numeric, 7 positions (CYYMMMDD format); Optional.

Entry date

The date the PO line was added to the PO.

Corresponds to the Entry date field (ENINDT) in the PO Detail table.

Numeric, 7 positions (CYYMMDD format); Required.

Item number

The item being ordered. Must be a valid item, in retailer’s item code (not vendor item code).

Corresponds to the ITM Number field (ENBECD) in the PO Detail table.

Alphanumeric, 12 positions; Required.

SKU

The SKU code for the item.

Corresponds to the SKU Code field (ENBESK) in the PO Detail table.

Alphanumeric, 14 positions; Required if the item contains SKUs.

Unit of Measure

The unit of measure defined for the item.

Corresponds to the Unit of measure field (ENCDCD) in the PO Detail table.

Alphanumeric, 3 positions; Required.

Vendor number

The code that identifies the vendor or supplier of the item.

Corresponds to the Vendor # field (ENFYNB) in the PO Detail table.

Numeric, 7 positions; Required.

Warehouse

A code that represents the warehouse where the merchandise will be received. On order quantity is increased in this warehouse. Validated against the Warehouse table. See Creating and Maintaining Warehouses (WWHS).

Corresponds to the Warehouse field (ENWCDE) in the PO Detail table.

Numeric, 3 positions; Required.

Ship Via

A code that represents a carrier used for shipping merchandise to your company. This code is validated against the PO Ship Via table. See Working with Purchase Order Ship Via (WPSV).These shippers are defined separately from, and may differ from, those who deliver merchandise to your customers.

Corresponds to the Ship via field (ENJQNB) in the PO Detail table.

Numeric, 2 positions; Required.

PO Detail Interface Message Table (IXPDMP)

Purpose: This table contains purchase order detail message information.

Each record in this table represents a separate purchase order detail message and must be associated with a record in the PO Detail Interface Table (IXPDTP). If you do not wish to add detail messages to a purchase order line, you can leave this table blank.

Note: You can define a message for a PO line only when you create a new PO through the PO Upload Process. You cannot add or maintain a message when you maintain an existing PO through the PO Upload Process.

See Working with File Uploads (WUPL) for more information on how to populate this table with purchase order detail message information from an external system.

Field

Description

Company

The CWSerenade company code.

Company codes are defined in and validated against the Company table.

Corresponds to the Company field (C5COMP) in the PO Detail Message table.

Numeric, 3 positions; Required.

PO number

Corresponds to the PO # field (C5IGNB) in the PO Detail Message table.

Numeric, 7 positions; Required.

Sequence #

The purchase order line sequence number associated with the message.

Corresponds to the Seq # field (C5PCNB) in the PO Detail Message table.

Numeric, 3 positions; Required.

Sequence #

The unique sequence number assigned to the PO line message.

Corresponds to the Message Seq # field (C5PCNB) in the PO Detail Message table.

Numeric, 3 positions; Required.

Print

Indicates whether the message prints on the purchase order or receiving worksheet.

Valid values are:

B = The message prints on both the receiving worksheet and purchase order.

P = The message prints on the purchase order.

W = The message prints on the receiving worksheet.

blank = The message does not print on the purchase order or receiving worksheet.

Corresponds to the Print field (C5HXST) in the PO Detail Message table.

Alphanumeric, 1 position; Optional.

Message

Free form message about the purchase order line.

Corresponds to the Message field (C5LITX) in the PO Detail Message table.

Alphanumeric, 60 positions; Required.

ME07_02 OROMS 5.0 2018 OTN