ReturnPOHeaderInformation

Return Purchase Order Information

Minor Business Rule

Object Name: B4300190

Parent DLL: CDIST

Location: Client/Server

Language: C

This function will return information  from the purchase order header data structure created in 
memory by GetPurchaseOrderHeader.

The function GetPurchaseOrderHeader must be run before this function is called to build the data 

structure in memory

Data Structure

D4300190 - Return Purchase Order Header Information

Parameter NameData ItemData TypeReq/OptI/O/Both
idPointerToF4301DSGENLNGIDNONENONE

General purpose ID variable.

mnSupplierNumberAN8MATH_NUMERICNONENONE

A number that identifies an entry in the Address Book system, such as employee, applicant, participant, customer, supplier, tenant, or 
location.

mnShipToAddressSHANMATH_NUMERICNONENONE

The address number of the location to which you want to ship this order. The address book provides default values for customer address, 
including street, city, state, zip code, and country.

szBranchPlantMCUcharNONENONE

An alphanumeric code that identifies a separate entity within a business for which you want to track costs. For example, a business unit 
might be a warehouse location, job, project, work center, branch, or plant. You can assign a business unit to a document, entity, or person for 
purposes of responsibility reporting. For example, the system provides reports of open accounts payable and accounts receivable by 
business unit to track equipment by responsible department. Business unit security might prevent you from viewing information about business units 
for which you have no authority.

szOrderedByORBYcharNONENONE

SALES ORDER SYSTEM:  An optional entry field, intended for the name of the customer placing the order.

szOrderTakenByTKBYcharNONENONE

SALES ORDER SYSTEM:  An optional entry field, intended for the name of the individual taking the customer's order. If you do not enter a 
user ID in this field, the system uses the ID of the person who is signed on.

szOrderHoldCodeHOLDcharNONENONE

A user defined code (42/HC) that identifies why an order is on hold.

cAssociatedTextFlagATXTcharNONENONE

This is a one byte flag that is used to determine whether or not a specific line item on a sales or purchase order has additional extended 
text associated with it.

cPurchaseOrderStatusOSTScharNONENONE

This field identifies the status of a purchase order. The following lists the possible values: blank     New 1     Amended  

mnOrderTotalDomesticOTOTMATH_NUMERICNONENONE

The total value of all lines on the order that have not been shipped and billed to the customer.

mnOrderTotalForeignFAPMATH_NUMERICNONENONE

The unpaid foreign amount of a transaction.

cCurrencyModeCRRMcharNONENONE

An option that specifies whether the system displays amounts in the domestic or foreign currency. On  The system displays amounts in the 
foreign currency of the transaction. Off  The system displays amounts in the domestic currency of the transaction.

szCurrencyCodeCRCDcharNONENONE

A code that identifies the currency of a transaction. 

mnExchangeRateCRRMATH_NUMERICNONENONE

A number (exchange rate) that a foreign currency amount is multiplied by to calculate a domestic currency amount.  The number in this field 
can have a maximum of seven decimal positions. If more are entered, the system adjusts to the nearest seven decimal positions. 

szUserIDUSERcharNONENONE

The code that identifies a user profile.

szProgramIDPIDcharNONENONE

The number that identifies the batch or interactive program (batch or interactive object). For example, the number of the Sales Order Entry 
interactive program is P4210, and the number of the Print Invoices batch process report is R42565. The program ID is a variable length value. 
It is assigned according to a structured syntax in the form TSSXXX, where: T The first character of the number is alphabetic and identifies the 
type, such as P for Program, R for Report, and so on. For example, the value P in the number P4210 indicates that the object is a 
program. SS The second and third characters of the number are numeric and identify the system code. For example, the value 42 in the number P4210 
indicates that this program belongs to system 42, which is the Sales Order Processing system. XXX The remaining characters of the numer are 
numeric and identify a unique program or report. For example, the value 10 in the number P4210 indicates that this is the Sales Order Entry 
program.

szJobNumberJOBNcharNONENONE

The code that identifies the work station ID that executed a particular job.

jdDateUpdatedUPMJJDEDATENONENONE

The date that specifies the last update to the file record.

mnTimeOfDayTDAYMATH_NUMERICNONENONE

The computer clock in hours:minutes:seconds.

Related Functions

None

Related Tables

F4301 Purchase Order Header