send feedback

❮ Previous Next ❯

Purchase Order Entry interface for JD Edwards

About the Purchase Order Entry interface

The Purchase Order Entry interface is used to create new purchase order with item line, add an item line to an existing purchase order, copy an existing purchase order, update a line of an existing purchase order, and cancel an item line of a purchase order.

This interface was written in NER and calls a ‘C' business function BD3N4311 to retrieve the processing options.

Name	Function name	Description
DD3N4310		dcLINK Interface Purchase Order Entry
ND3N4310	dcLINKPurchaseOrderEntry	dcLINK Interface Purchase Order Entry
DD3N4311		PO Retrieval Purchase Order Entry
BD3N4311	PORetrievalPurchaseOrderEntry	PO Retrieval Purchase Order Entry

The full name of this interface is ND3N4310 Purchase Order Entry

This interface guide applies to the following JDE versions.

EnterpriseOne 9.0 through 9.1

Corresponding EnterpriseOne application

In EnterpriseOne, the application you would run to launch Purchase Order Entry is P4310. The menu to find Procurement and Subcontract Management / Daily Processing / Stock Based Purchasing / Purchase Order Processing / Enter Purchase Orders is G43.

Processing options

Processing options for Purchase Order Entry interface.

This interface requires processing options from P4310 program. A version will default to ZJDE0001 if not otherwise specified in the parameter list on the call.

Defaults tab

Order Type (szOrderType)
Line Type (szLineType)
Beginning Status (szStatusCodeLast
Override Next Status (szOverrideNextStatus)
Unit of Measure (szUnitOfMeasure)
Line Number Increment (mnLineNumberIncrement)
Default Tax Rate/Area (szTaxRateAreaSelection)
Transaction unit Of Measure (szUnitOfMeasureSelection)
Landed Cost Rule (szLandedCostRule)
Header to Detail (szHeaderChangesToDetail)
Work Order Status (szWorkOrderStatus)
Account Description (cDescriptionDefaults)
Line Sequence (cContinuousLineNumbering)
Cost Rule Selection (szCostRuleSelection_VL24)

Display tab

Suppress Closed Lines (szSuppressClosedLines)
Status Code Protection (szProtectStatusCode)
Order Type Protection (szProtectOrderType)
Kit Display (cDisplayKitComponentLines)
Cost Protection (szProtectPriceFlag)
Detail Line Protection (szLastStatusAllowingChange)
Free Goods Catalog (cFreeGoodsCatalogWarning)
Order Header Protection (cHeaderProtection_EV01)
Jargon and Header Business Unit (cJobProject)
Account Protection (cProtectAccountNumber)
Display Additional Properties Tab (cAdditionalProperties)
Display category Codes on Header tab and Detail Grid (cCategoryCodes)
Enable From Exit for Clauses (cClauseApplication)
Display Location and Lot fields for a Job or Project (cDisplayLocationLot)
Address Book Field Required (cAN8Required)
Display Retainage Indicator (cDisplayRetainageIndicator)
Display Service Units (cDisplayServiceUnits)

Interfaces tab

Business Unit Validation (cBranchPlantValidation)
PBCO Warning (zNoPBCOWarningOnGLDate)
PACO Warning (szNoPACOWarningOnGLDate)
Quality Update (szItemAvailabilityUpdate)
Supplier Analysis (szSupplierAnalysisUpdate)
Edit Supplier Master (cEditSupplierMaster)
Financial AAIs (cFinancialAAIs)

Process tab

New Supplier Information (szNewSupplierAdd)
Order Templates (szOrderTemplates)
Subsystem Printing (cPrintPOViaSubsystem)
Blanket Releases (szBlanketQuoteRelease)
Header Display (cHeaderFirstCode)
Agreement Search (cAgreementSearchMethod)
Base Order Protection (cProhibitChanges)
Project/job Validation (cSingleJob)
Exclusive Adjustment Hold (szExclusiveAdjustmentHold)
Logs Entry Display (cDisplayLogs)

Duplication tab

Duplicate Order Type (szDuplicationOrderType)
Beginning Status Code (szDuplicationLastStatus)
Next Status code (Optional) (szDuplicationNextStatus)
Copy Selection (cTextDuplicationSelection)

Cross ref

Substitute Items (szCrossReferenceType)
Obsolete Items (szTypeCrossReferenceT)
Promotional Items (szCrossReferencePromotional)

Order inquiry

From Status Code (InqFromStatusCode)
Thru Status Code (InqThruStatusCode)
Last Status (cInqBasedOnLastStatus)
Date (cInqBasedOnReqDate)

Versions tab

Supply/Demand Inquiry (P4021)( szSupplyDemandInquiry)
Supplier Analysis (P43230)( szSupplierAnalysisVersion)
Supplier Master (P04012)( szSupplierMasterVersion)
PO Print on Demand (R43500)( szPOPrintOnDemandVersion)
Item Availability Summary (P41202)( InqItemAvailVersion)
Approval Review (P43081)( InqApprovalReviewVersion)
Receipt Routing (P43250)( InqReceiptRoutingVersion)
Open Receipts (P43214)( InqOpenReceiptsVersion)
Revision Audit Summary (P4319)( InqChangeOrderVersion)
Purchase Ledger (P43041)( PurchasingLedgerVersion)
Open Order inquiry (P4310)( szOpenOrderInquiry)
Financial Status Inquiry (P44200)( szFinancialStatusInquiry)
Inbound Transportation (P4915)( szInboundTransportationVersion)
Preference Profile (R40400)( szWMSPreferenceProfileVersion)
Configurator (P3210)( szConfiguratorVersion)
Blanket Release (P43216)( szBlanketReleaseVersion)
Logs Entry (P4305)( szLogsEntryVersion)
Requisition Self Service (P43E10)( szRequistionSelfServiceVersion)
Style Matrix Entry (PCW10)( szStyleMatrixEntryVersion)

Currency tab

Tolerance (mnToleranceLimit)
As-If Currency Display
Currency Code (szCurrencyCodeFrom)
As Of date (jdDateTransactionJulian)

Approvals tab

Route Code (szApprovalRouteCodeSelection)
Awaiting Approval Status (szAwaitingApprovalStatus)
Approved Status (szApprovedStatus)
Reapprove Changed lines (cApprovalsReapproveChanges)
Approval Hold Code (szApprovalsHoldCode)

Budgeting

Budget Hold Code (szBudgetHoldCode)
Budget Ledger Type (szBudgetLedgerType)
Level Of Detail (cBudgetLevelofDetail)
Budget Total Method (cBudgetTotalMethod)
Period Accumulation Method (cBudgetPeriodAccumMethod)
Tolerance Percentage (cBudgetPeriodAccumMethod)
Hold Warning (cBudgetHoldWarning)
Budget Accumulation Level of Detail (cBudgetAccumLofD)
Exclude Subledger/Type (cBudgetExcludeSubledger)
Job Cost Account Sequence (cBudgetJobCostSequence)
Include Taxes (cBudgetIncludeTaxes)

Interop tab

Purchase Order Before/After Image Processing (cBeforeImageProcessing)
Purchase Order Transaction Type (szTypeTransaction)
Work Order Before / After Image Processing (cWOBeforeImageProcessing)
Work Order Transaction Type (szWOTypeTransaction)

Order revision

Revision Tracking (szChangeOrderProcessingOn)
Next Status (szChangeOrderStatus)
Text Entry (cAllowChangeOrderText)

Self-service tab

Supplier Self-Service (cSupplierSelfService1)

Product variants tab

Inventory Parent (cInventoryParent)

Workflow tab

Price Changes Notify (cNotifyPriceChange)
Planned Delivery date Changes notify (cNotifyDeliveryChange)
Quantity Changes Notify (cNotifyQuantityChanges)
Order Hold Notify (cNotifyOrderHold)

Transfer order tab

Create Item branch Record if one does not exist for the receiving B/P when Entering a Transfer Order (cCreateItemBranch)
Project transfer Order Line Type (szTransferProjectLineType)

Style tab

Display Matrix Entry (PCW10)( cDisplayPCW10)
Collection (szCollection)
Season Code (szSeasonCode)
Season Year (szSeasonYear)
Validate Items Against Collection (cValidateItemsWithCollection)
Prefix for Collection Templates (cCollectionTemplatePrefix)
Send Address Number for Split Percentage to Matrix Entry (PCW10) (cAddressNumberforPCW10)
Item Search and Select (cStyleItemSearchType)

Processing option data structure for DD3N4311

The interface retrieves these parameters by calling BD3N4311. They are passed back in the following data structure.

Type	Description	Parameter
String	szVersion_VERS	Input
String	szDefaultOrderType_DCT	Output
String	szDefaultLineType_LNTY	Output
String	szDefaultStatusCodeLast_LTTR	Output
String	szDefaultStatusCodeNext_NXTR	Output
String	szDefaultUnitOfMeasure_UOM	Output
Numeric	mnLineNumberIncrement_LNID	Output
String	szTaxRateAreaSelection_VL01	Output
String	szUnitOfMeasureSelection_VL02	Output
String	szLandedCostRule_LANC	Output
String	szHeaderChangesToDetail_VL03	Output
String	szWorkOrderStatus_SRST	Output
Char	cDescriptionDefaults_EV01	Output
Char	cContinuousLineNumber_EV01	Output
String	szSuppressClosedLines_VL08	Output
String	szProtectStatusCode_VL10	Output
String	szProtectOrderType_VL11	Output
Char	cDisplayKitComponentLine_EV02	Output
String	szProtectPriceFlag_VL09	Output
String	szLastStatusAllowingChg_A1TR	Output
String	szCostRuleSelection_VL24	Output
Char	cFreeGoodsCatalog_EV01	Output
Char	cHeaderProtection_EV01	Output
Char	cJobProject_EV01	Output
Char	cProtectAccountNumber_EV01	Output
Char	cAdditionalProperties_EV01	Output
Char	cCategoryCodes_EV01	Output
Char	cClauseApplication_EV01	Output
Char	cDisplayLocationLot_EV01	Output
Char	cAN8Required_EV01	Output
Char	cDisplayRetainageInd_EV01	Output
Char	cDisplayServiceUnits_EV01	Output
Char	cBranchPlantValidation_EV01	Output
String	szNoPBCOWarningOn_VL04	Output
String	szNoPACOWarningOn_VL05	Output
String	szItemAvailabilityUpdate_VL06	Output
String	szSupplierAnalysisUpdate_VL07	Output
Char	cEditSupplierMaster_EV01	Output
Char	cFinancialAAIs_EV01	Output
String	szNewSupplierAdd_VL12	Output
String	szOrderTemplates_VL15	Output
Char	cPrintPOViaSubsystem_EV05	Output
String	szBlanketQuoteRelease_VL14	Output
Char	cHeaderFirstCode_EV03	Output
Char	cAgreementSearchMethod_SCH1	Output
Char	cProhibitChanges_EV01	Output
Char	cSingleJob_EV01	Output
String	szExclusiveAdjustHold_HOLD	Output
Char	cDisplayLogs_EV01	Output
String	szDuplicationOrderType_DCTO	Output
String	szDuplicationLastStatus_A3TR	Output
String	szDuplicationNextStatus_A4TR	Output
Char	cTextDuplicationSelection_EV07	Output
String	szCrossReferenceType_XRT	Output
String	szTypeCrossReference_XRT2	Output
String	szCrossReferenceProm_XRT	Output
String	szInqFromStatusCode_LTTR	Output
String	szInqThruStatusCode_NXTR	Output
Char	cInqBasedOnLastStatus_EV01	Output
Char	cInqBasedOnReqDate_EV01	Output
String	szSupplyDemandInquiry_VL20	Output
String	szSupplierAnalysisVersion_VL21	Output
String	szSupplierMasterVersion_VL22	Output
String	szPOPrintOnDemandVers_VL23	Output
String	szInqItemAvailVers_VERS	Output
String	szInqApprovReviewVers_VERS	Output
String	szInqReceiptRoutingVers_VERS	Output
String	szInqOpenReceiptVers_VERS	Output
String	szInqChangeOrderVers_VERS	Output
String	szPurchasingLedgerVers_VERS	Output
String	szOpenOrderInquiry_VERS	Output
String	szFinancialStatusInq_VERS	Output
String	szInboundTransportation_VERS	Output
String	szWMSPreferenceProfile_VERS	Output
String	szConfiguratorVersion_VERS	Output
String	szBlanketReleaseVers_VERS	Output
String	szLogsEntryVers_VERS	Output
String	szRequistionSelfService_VER1	Output
Numeric	mnToleranceLimit_MATH01	Output
String	szCurrencyCodeFrom_CRCD	Output
Date	jdDateTransactionJulian_TRDJ	Output
String	szApprovalRouteCode_VL16	Output
String	szAwaitingApprovalStatus_LTT2	Output
String	szApprovedStatus_NXT2	Output
Char	cApprovalsReapprove_EV01	Output
String	szApprovalsHoldCode_HOLD	Output
String	szBudgetHoldCode_HOLD	Output
String	szBudgetLedgerType_LT	Output
Char	cBudgetLevelofDetail_LDA	Output
Char	cBudgetTotalMethod_EV01	Output
Char	cBudgetPeriodAccumMeth_EV02	Output
Char	mnBudgetTolerancePerc_PERT	Output
Char	cBudgetHoldWarning_EV06	Output
Char	cBudgetAccumLofD_EV01	Output
Char	cBudgetExcludeSubledger_EV02	Output
Char	cBudgetJobCostSequence_EV03	Output
Char	cBudgetIncludeTaxes_EV04	Output
Char	cBeforeImageProc_BIPROC	Output
String	szTypeTransaction_TYTN	Output
Char	cWOBeforeImageProc_BIPROC	Output
String	szWOTypeTransaction_TYTN	Output
String	szChangeOrderProcess_VL13	Output
String	szChangeOrderStatus_A2TR	Output
Char	cAllowChangeOrderText_EV04	Output
Char	cSupplierSelfService1_SSS1	Output
Char	cInventoryParent_SEGB	Output
Char	cNotifyPriceChange_EV01	Output
Char	cNotifyDeliveryChange_EV01	Output
Char	cNotifyQuantityChanges_EV01	Output
Char	cNotifyOrderHold_EV01	Output
Char	cCreateItemBranch_EV01	Output
String	szTransferProjectLineType_LNTY	Output
String	szStyleMatrixEntryVersion_VERS	Output
Char	cDisplayMatrixEntry_EV01	Output
String	szCollection_C9COLL	Output
String	szSeasonCode_C9SEAC	Output
String	szSeasonYear_C9SEAY	Output
Char	cValdiateItemsAgainstColl_EV01	Output
Char	cPrefixForCollTemplates_C9MACO	Output
Char	cSendAddSplitPercMatEnt_EV02	Output
Char	cItemSearchAndSelect_EV01	Output

Processing

Processing information for Purchase Order Entry interface.

There are several fields that can be edited and changed for Purchase Order. A user would be able to create a new purchase order, add an item to existing Purchase Order, update a line of an existing Purchase Order, copy an existing Purchase Order, and cancel a Purchase Order line or All purchase Order lines. The dsiActionCode is used to determine this.

In order to add/edit a job cost budget revisions record, the cdsiActionCode must be a ‘C'.

Action code	Advanced Inventory action code	Description
	N	Create a new Purchase Order.
	A	Add item line to existing Purchase Order.
	U	Update a Line of an existing Purchase Order.
	C	Copy an existing Purchase Order.
1/2	D	Cancel a Purchase Order Line or ALL PO lines.

Required fields

dcLINKActionCode	Action	Required fields	Description
'N'	Creates a new Purchase Order.	Supplier Number Branch Plant Item number (quantity is optional, will default to 1 if not entered) OR order template ID	An order must be created with an item line attached and other lines can be added with the add line functionality. All detail fields can be changed or edited for the line addition to the order. If the user would like to use an order template, then the order template ID must be entered INSTEAD of an item number and quantity. Default quantities and costs will be used from the order template but can be changed using the update functionality.
'A'	Add Item line to existing Purchase Order.	Order Number Branch Plant Item number (quantity is optional, will default to 1 if not entered) OR order template ID	The Order Number you wish to add a detail record to must be entered along with the orders branch plant. All detail fields can be changed or edited for the line addition to the order. If the user would like to use an order template, then the order template ID must be entered INSTEAD of an item number and quantity. Default quantities and costs will be used from the order template but can be changed using the update functionality.
'U'	Update a line of an existing Purchase Order.	Order Number Branch Plant *Line Number – Only if updating a line. This can be left blank if updating the header information	If only updating the header information of the Purchase Order, only the Order Number and Branch need to be entered to find the correct order. To update a detail line of a Purchase Order, the Order Number, Branch, and Line Number must be entered to find the correct detail record to update. All detail fields can be changed or edited for the line update of the order.
'C'	Copy an existing Purchase Order.	Order Number Branch Plant	Only the Order Number and Branch Plant are needed to copy an existing Purchase Order. When copying a purchase order, all lines of the existing order are added to the new order as well, and the status of the lines is reset to the default values for a purchase order creation.
'D'	Cancel a Purchase Order Line or ALL Purchase Order Lines.	Order Number Branch Plant Action Code - Action Code value of ‘1' to cancel one line, Action Code value of ‘2' to cancel all lines. Line Number - Only used if Action Code is equal to ‘1' to cancel one line.	Order Number and Branch Plant are needed, along with the Line Number if canceling just one line of a Purchase Order. To cancel one line, an ActionCode of a ‘1' is also needed. If an entire Purchase Order is to be canceled, an ActionCode value of ‘2' must be entered.

Verify the processing

Input data structure

Input data structure for DD3N4310.

Name	Default value	R/O	Alias	Notes
cdcLINKActionCode_EV01		R	EV01	‘C' (change) are valid. If no dcLINK Action Code is passed in, it will set an error.
cActionCode_ACTION		C	ACTION	Not used.
jdDateUpdated_UPMJ	(today)	X	UPMJ	Returned from GetAuditInfo if not passed in.
mnTimeUpdated_UPMT	(now)	X	UPMT	Returned from GetAuditInfo if not passed in.
szUserId_USER	(current user id)	X	USER	Returned from GetAuditInfo if not passed in.
szWorkStationId_JOBN	(current workstation id)	X	JOBN	Returned from GetAuditInfo if not passed in.
szProgramId_PID	ND3N4310	X	PID	Not used.
szVersion_VERS	ZJDE0001	X	VERS	Generally leave this blank and let it default in.
cSuppressErrorMessage_EV01			EV01
cErrorCode_ERRC			ERRC	Indicates an error condition. Set by program.
szErrorMessageKey_EKEY			EKEY	Holds EnterpriseOne error message number.
iDebugLevel_INT01		C	INT01	Leave blank except for debugging and testing purposes only. Higher numbers will show more debug dialog boxes. Leaving this blank or setting to “0” suppresses all debug dialog boxes. Do not leave a value greater than “0” in this field after initial setup and testing as it will cause synchronous dialogs on the computer to pop up when the function is called.
szMachineKey_MKEY		O	MKEY
szComputerID_CTID		O	CTID
szGuidUniqueID_GUID		O	GUID
szGuidApprover1_USR1		O	USR1
szGuidFullName1_FULLNAME1		O	FULLNAME1
szGuidApprover2_USR2		O	USR2
szGuidFullName2_FULLNAME2		O	FULLNAME2
mnGuidReasonCode1_REASON1		O	REASON1
szGuidCommentField_COMMENTS		O	COMMENTS
mnGuidReasonCode2_REASON2		O	REASON2
szGuidCommentField2_2COMMENTS		O	2COMMENTS
szGuidScriptID_FMNMVERS		O	FMNMVERS
szGuidTextMessage_TEXTMES		O	TEXTMES
szJobNumber_JOBN		O	JOBN
szOrderCompany_KCOO		O	KCOO
mnOrderNumber_DOCO		C	DOCO	If updating order, user need to pass this value.
szOrderType_DCTO		C	DCTO	If updating order, user need to pass this value.
szOrderSuffix_SFXO		O	SFXO
szBranchPlant_MCU		R	MCU	Required.
mnSupplierNumber_AN8		C	AN8	Required for new order.
mnAddressNumberShipTo_SHAN		O	SHAN
jdOrderDate_TRDJ		O	TRDJ
jdDateRequested_DRQJ		O	DRQJ
jdPromisedDeliveryDate_PPDJ		O	PPDJ
jdCancelDate_CNDJ		O	CNDJ
szCurrencyCodeFrom_CRCD		O	CRCD
mnExchangeRate_CRR		O	CRR
szCurrencyCodeTo_CRDC		O	CRDC
cCurrencyMode_CRRM		O	CRRM
mnBuyerNumber_ANBY		O	ANBY
mnCarrierNumber_ANCR		O	ANCR
szRemark_RMK		O	RMK
szDescription_DESC		O	DESC
szTaxExplanationCode_EXR1		O	EXR1
szHoldCode_HOLD		O	HOLD
szTaxRateOrArea_TXA1		O	TXA1
szCertificate_TXCT		O	TXCT
mnRetainagePercent_PCRT		O	PCRT
szTaxID_TAX		O	TAX
szOrderedBy_ORBY		O	ORBY
cPersonOrCorpID_TAXC		O	TAXC
szOrderTakenBy_TKBY		O	TKBY
szFreightHandlingCode_FRTH		O	FRTH
szPrintMessage_INMG		O	INMG
szPricingGroup_PRGP		O	PRGP
szCostRule_PRP5		O	PRPS
cEvaluatedReceipt_AVCH		O	AVCH
cAIADocument_FUF1		O	FUF1
szPaymentTerms_PTC		O	PTC
szSupplierSO_VR01		O	VR01
szReference_VR02		O	VR02
szDeliveryInstructions1_DEL1		O	DEL1
szDeliveryInstructions2_DEL2		O	DEL2
szAdjustmentSchedule_ASN		O	ASN
szDOrderSuffix_SFXO		O	SFXO
szDItemNumber_UITM		R	UITM	Required.
mnDQuantityOrdered_UORG		O	UORG	Will default to 1, if not entered.
szDTransactionUOM_UOM		O	UOM
mnDUnitCost_UPAX		O	UPAX
mnDExtendedCost_AEXP		O	AEXP
szDPurchasingUOM_UOM3		O	UOM3
szDLineType_LNTY		O	LNTY
szDDescription1_DSC1		O	DSC1
szDDescription2_DSC2		O	DSC2
szDAccountNumber_ANI		O	ANI
szDCostCenter_OMCU		O	OMCU
szDObject_OBJ		O	OBJ
szDSubsidiary_SUB		O	SUB
szDSubledger_SBL		O	SBL
cDSubledgerType_SBLT		O	SBLT
mnDLineNumber_LNID		O	LNID	Only if updating a line. This can be left blank if updating the header information.
szDBranchPlant_MCU		O	MCU
mnDShipToNumber_SHAN		O	SHAN
mnDBuyerNumber_ANBY		O	ANBY
mnDCarrierNumber_ANCR		O	ANCR
szDStatusCodeTo_LTTR		O	LTTR
szDStatusCodeNext_NXTR		O	NXTR
jdDRequestDate_DRQJ		O	DRQJ
jdDPromisedDelivery_PDDJ		O	PDDJ
jdDGLDate_DGL		O	DGL
jdDCancelDate_CNDJ		O	CNDJ
cDTaxableYN_TX		O	TX
szDTaxExplanationCode_EXR1		O	EXR1
szDTaxRateOrArea_TXA1		O	TXA1
mnDDiscountFactor_DSPR		O	DSPR
szDItemPriceGroup_PRGR		O	PRGR
szDPriceCatLevel_CLVL		O	CLVL
szDPrintMessage_INMG		O	INMG
szDLotSerialNumber_LOTN		O	LOTN
szDLocation_LOCN		O	LOCN
szDAssetNumber_ASII		O	ASII
szDReportingCode1_PDP1		O	PDP1
szDReportingCode2_PDP2		O	PDP2
szDReportingCode3_PDP3		O	PDP3
szDReportingCode4_PDP4		O	PDP4
szDCostRule_PDP5		O	PDP5
mnDExtendedWeight_ITWT		O	ITWT
szDWeightUOM_WTUM		O	WTUM
mnDExtendedVolume_ITVL		O	ITVL
szDVolumeUOM_VLUM		O	VLUM
szDSupplierSO_VR01		O	VR01
szDReference_VR02		O	VR02
szDGLOffset_GLC		O	GLC
cDEvaluatedReceipt_AVCH		O	AVCH
cDFreezeCode_UNCD		O	UNCD
cDSendMethod_CRMD		O	CRMD
szDOriginalOrderNumber_OORN		O	OORN
szDOriginalOrderType_OCTO		O	OCTO
szDOriginalOrderCompany_OKCO		O	OKCO
mnDOriginalLineNumber_OGNO		O	OGNO
szDAgreementNumber_DMCT		O	DMCT
mnDAgreementSupplement_DMCS		O	DMCS
cDSubstitutionExists_SBST		O	SBST
cDBlanketExists_BLKT		O	BLKT
cDAgreementExists_AGRE		O	AGRE
mnDShipmentNumber_SHPN		O	SHPN
szDItemFlashMessage_DL01		O	DL01
szDPlan_PL		O	PL
szDElevation_ELEV		O	ELEV
mnJobNumber_JOBS		O	JOBS
mnProcessID_PEID		O	PEID
mnTransactionID_TCID		O	TCID
szChgOrderBranch_MCU		O	MCU
szOrderTemplate_ORTP		O	ORTP
mnOrderTemplateSupplier_ANO		O	ANO
cSendMethod_CRMD		O	CRMO
szMobileOrderNumber_DS50		O	DS50
szProductionNumber_PMPN		O	PMPN
Globally Unique Identifier (GUID) Fields	GUID values are all optional unless a business must comply with FDA 21 CFR Part 11 auditing requirements. Refer to Special Processing Interface Usage Guide for GUID Input Data Structure details.

O = Optional

R = Required

X = Required but will default in if not passed

C = Conditional

Transaction test scenarios

The following test scenarios demonstrate a variety of ways in which this interface could be used, and the fields that would be passed for each scenario.

The data structure fields are in the left column, and the corresponding values for each scenario are listed by column.

Field name	Create a new purchase order	Add item line to existing purchase order	Update a line of an existing purchase order	Copy an existing purchase order	Cancel a purchase order line or all purchase order lines
cdcLINKActionCode_EV01	N	A	U	C	D
cActionCode_ACTION					1/2
jdDateUpdated_UPMJ
mnTimeUpdated_UPMT
szUserId_USER
szWorkStationId_JOBN
szProgramId_PID
szVersion_VERS
cSuppressErrorMessage_EV01
cErrorCode_ERRC
szErrorMessageKey_EKEY
iDebugLevel_INT01
szMachineKey_MKEY
szComputerID_CTID
szGuidUniqueID_GUID
szGuidApprover1_USR1
szGuidFullName1_FULLNAME1
szGuidApprover2_USR2
szGuidFullName2_FULLNAME2
mnGuidReasonCode1_REASON1
szGuidCommentField_COMMENTS
mnGuidReasonCode2_REASON2
szGuidCommentField2_2COMMENTS
szGuidScriptID_FMNMVERS
szGuidTextMessage_TEXTMES
szJobNumber_JOBN
szOrderCompany_KCOO
mnOrderNumber_DOCO		456780	345678	453455	666789
szOrderType_DCTO		OP	OP	OP	OP
szOrderSuffix_SFXO
szBranchPlant_MCU	M30	M30	M30	M30	M30
mnSupplierNumber_AN8	4242
mnAddressNumberShipTo_SHAN
jdOrderDate_TRDJ
jdDateRequested_DRQJ
jdPromisedDeliveryDate_PPDJ
jdCancelDate_CNDJ
szCurrencyCodeFrom_CRCD
mnExchangeRate_CRR
szCurrencyCodeTo_CRDC
cCurrencyMode_CRRM
mnBuyerNumber_ANBY
mnCarrierNumber_ANCR
szRemark_RMK
szDescription_DESC
szTaxExplanationCode_EXR1
szHoldCode_HOLD
szTaxRateOrArea_TXA1
szCertificate_TXCT
mnRetainagePercent_PCRT
szTaxID_TAX
szOrderedBy_ORBY
cPersonOrCorpID_TAXC
szOrderTakenBy_TKBY
szFreightHandlingCode_FRTH
szPrintMessage_INMG
szPricingGroup_PRGP
szCostRule_PRP5
cEvaluatedReceipt_AVCH
cAIADocument_FUF1
szPaymentTerms_PTC
szSupplierSO_VR01
szReference_VR02
szDeliveryInstructions1_DEL1
szDeliveryInstructions2_DEL2
szAdjustmentSchedule_ASN
szDOrderSuffix_SFXO
szDItemNumber_UITM	210	210
mnDQuantityOrdered_UORG
szDTransactionUOM_UOM
mnDUnitCost_UPAX
mnDExtendedCost_AEXP
szDPurchasingUOM_UOM3
szDLineType_LNTY
szDDescription1_DSC1
szDDescription2_DSC2
szDAccountNumber_ANI
szDCostCenter_OMCU
szDObject_OBJ
szDSubsidiary_SUB
szDSubledger_SBL
cDSubledgerType_SBLT
mnDLineNumber_LNID			1.00		1.00
szDBranchPlant_MCU
mnDShipToNumber_SHAN
mnDBuyerNumber_ANBY
mnDCarrierNumber_ANCR
szDStatusCodeTo_LTTR
szDStatusCodeNext_NXTR
jdDRequestDate_DRQJ
jdDPromisedDelivery_PDDJ
jdDGLDate_DGL
jdDCancelDate_CNDJ
cDTaxableYN_TX
szDTaxExplanationCode_EXR1
szDTaxRateOrArea_TXA1
mnDDiscountFactor_DSPR
szDItemPriceGroup_PRGR
szDPriceCatLevel_CLVL
szDPrintMessage_INMG
szDLotSerialNumber_LOTN
szDLocation_LOCN
szDAssetNumber_ASII
szDReportingCode1_PDP1
szDReportingCode2_PDP2
szDReportingCode3_PDP3
szDReportingCode4_PDP4
szDCostRule_PDP5
mnDExtendedWeight_ITWT
szDWeightUOM_WTUM
mnDExtendedVolume_ITVL
szDVolumeUOM_VLUM
szDSupplierSO_VR01
szDReference_VR02
szDGLOffset_GLC
cDEvaluatedReceipt_AVCH
cDFreezeCode_UNCD
cDSendMethod_CRMD
szDOriginalOrderNumber_OORN
szDOriginalOrderType_OCTO
szDOriginalOrderCompany_OKCO
mnDOriginalLineNumber_OGNO
szDAgreementNumber_DMCT
mnDAgreementSupplement_DMCS
cDSubstitutionExists_SBST
cDBlanketExists_BLKT
cDAgreementExists_AGRE
mnDShipmentNumber_SHPN
szDItemFlashMessage_DL01
szDPlan_PL
szDElevation_ELEV
mnJobNumber_JOBS
mnProcessID_PEID
mnTransactionID_TCID
szChgOrderBranch_MCU
szOrderTemplate_ORTP
mnOrderTemplateSupplier_ANO
cSendMethod_CRMD
szMobileOrderNumber_DS50
szProductionNumber_PMPN

Common error messages

The following are common error messages that can be generated by this BF, and what those error messages mean.

Error message	Meaning
0002	Record Invalid. This error is returned when an error has been detected from one of these three business functions: dcLINK Set User ID, dcLINK Utility Set Audit Info, or dcLINK Utility Write Signature Capture Record.
138T	Action Code Invalid. This is set when the ActionCode is not equal to 1 or 2 when cdsiActionCode is equal to “D” or “U”.
0037	Address Number Invalid. In this interface, this will be set if the Supplier Number and Branch Plant is Blank or Null.
4634	Order Type Required. This is set if the Order Type is Blank or Null.
4635	Order Number Required. This is set when Order Number is Blank or Null.
405Z	Invalid Line Number. This is set when Line Number is Blank or Null or Zero.
0964	Branch Plant Invalid. This is set when business function returned error.
2513	Order Type Invalid. This is set when UDC returned invalid order type.
011S	Purchase Order Header record not found. This is set when File IO failed to fetch from table F4301.
4174	No Detail Records Exist. This is set when File IO failed to fetch from table F4311.
3773	Asset Number Invalid. This is set when File IO failed from table F1201.
4601	Order Template Does Not Exist. This is set when File IO failed from table F4015

There was a problem loading this topic

Mobile Enterprise Platform