send feedback

❮ Previous Next ❯

Purchase Order Approvals interface for JD Edwards

About the Purchase Order Approvals interface

This interface is used to approve or reject purchase orders.

When a purchase order is entered and the total amount of the order is over the limit in the settings for JDE procurement setup, the order must be approved or rejected by the responsible approver(s). This interface, ND3N4381 Purchase Order Approvals, will perform the task of approving or rejecting orders.

In Edwards the application name is P43081. The dcLINK® version is called ND3N4381. This interface was written in NER and calls “C” business function BD3N4303 to retrieve the processing options. It also may call NER business function ND3N4370 to Release Held Purchase Orders while processing an approval transaction.

Name	Function name	Description
DD3N4381		dcLINK Interface Purchase Order Approval
ND3N4381	dcLINKInterfacePOApproval	dcLINK Interface Purchase Order Approval
DD3N4303		dcLINK Processing Options PO Approval
BD3N4303	PORetrievalPOApproval	dcLINK Processing Options PO Approval

The full name of this interface is ND3N4381 Purchase Order Approvals

This interface guide applies to the following JDE versions.

EnterpriseOne 8 through 9.1

Corresponding EnterpriseOne application

In EnterpriseOne, the application you would run to launch Purchase Order Approvals is P43081. The menu to find Purchase Order Processing > Orders Awaiting Approval is G43A11.

Processing options

Processing options for Purchase Order Approvals interface.

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

Process tab

Awaiting Approval Status (szPO_AwaitingApprovalStat_NXT2): This field specifies the status of an order that is awaiting the approval step. You set up the steps for the processing cycle on the Order Activity Rules form.
Approved Status (szPO_ApprovedStatus_NXTR): This field specifies the status of an order once it has been approved.
Rejected Status (szPO_RejectedStatus_LTTR): This field specifies the status of an order once it has been rejected.
Budget Hold Code (szPO_BudgetHoldCode_HOLD): This field is the budget hold code.

Defaults tab

Order Type (szPO_OrderType_DCTO): This is the default order type that will be used on the approval screen.
Enter ‘1' to protect address number from input (cPO_OrderType_DCTO): Self-explanatory

Versions tab

Order Entry (P4310) (szPO_OrderEntryVers_VL01): Will default with the value “ZJDE0001” if left blank.
Budget Comparison (P09210) (szPO_BudgetCompVers_VL02): Will default with the value “ZJDE0001” if left blank.
Release Held Orders (P43070) (szPO_ReleaseHldOrdersVers_VL03): Will default with the value “ZJDE0001” if left blank.
Open Order Inquiry (P4310) (szPO_OpenOrderInqVers_VL04): Will default with the value “ZJDE0001” if left blank.

Processing option data structure for DD3N4303

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

Type	Description	Parameter
String	szPO_Version_VERS	Input
String	szPO_AwaitingApprovalStat_NXT2	Output
String	szPO_ApprovedStatus_NXTR	Output
String	szPO_RejectedStatus_LTTR	Output
String	szPO_BudgetHoldCode_HOLD	Output
String	szPO_OrderType_DCTO	Output
char	cPO_ProtectAddressNbr_EV02	Output
String	szPO_OrderEntryVers_VL01	Output
String	szPO_BudgetCompVers_VL02	Output
String	szPO_ReleaseHldOrdersVers_VL03	Output
String	szPO_OpenOrderInqVers_VL04	Output

Processing

Processing information for Purchase Order Approvals interface.

You can view the Orders Awaiting Approval from JDE's application P42081 on Menu G43A11 for stock items and G43B11 for non-stock items. Based on the order selection criteria in the header, the app will show the orders “Queued for approval” for the applicable approver. It will also show the orders “Waiting Approval”, “Approved”, and “Rejected” for the order's Originator. After an Approval or Rejection you can verify that the order status was updated correctly from the Purchase Order Entry application P4310 which is also on Menu G43A11 or G43B11. Record details may be verified from the Approval/Rejection Reasons table F4318.

Action Code	Advanced Inventory Action Code	Description
A		Approve Order
D		Add/Change reason for Approval/Rejection
M		Remove Messages from Approval Review screen
R		Reject Order and add rejection reason

Required fields

cActionCode = ‘A,R,M,D': Approve/Reject Purchase Order.

Required fields:

cActionCode
zVersion_VERS
szApprover_ALKY
szBranchPlant_MCU
szOrderType_DCTO
mnOrdersOlderThan_DORE1
mnOrdersWaitingMoreThan_DWTE1
mnQBEOrderNumber_DOCO
szQBECompany_DCOO
mnQBEPersonResponsible_RPER
mnQBELineNumber_LNID
szRejectRemark_RMK
szRejectGridRemark_RMK
cURC1ReqDate_UC01
cURC2Qty_UC02
szPassword_PWRD

Verify the processing

From the Purchase Order Entry application P4310 which is also on Menu G43A11 or G43B11. Record details may be verified from the Approval/Rejection Reasons table F4318.

Input data structure

Input data structure for DD3N4381.

O = Optional

R = Required

X = Required but will default in if not passed

C = Conditional

Name	Default value	R/O	Alias	Notes
cdcLINKActionCode_EV01	0	X	EV01	The dcLINK Action Codes is only used when calling the other dcLINK functions.
cActionCode_ACTION			ACTION	Valid Action Codes: A, D, M, R A = Approve Order and add approval reason (reason limited to one line only) D = Add/Change reasons for Approval/Rejection (mnQBELineNumber_LNID is required) M = Remove Messages from Approval Review screen R = Reject Order and add rejection reason
jdDateUpdated_UPMJ	(today)	X	UPMJ	Returned from GetAuditInfo if not passed in.
mnTimeUpdated_TDAY	(now)	X	TDAY
szUserId_USER	(current user id)	X	USER
szWorkStationId_JOBN	(current workstation id)	X	JOBN
mnJobNumber_JOBS		X	JOBS
szProgramId_PID	ND3N4381	X	PID	Generally leave this blank and let the default value populate.
szVersion_VERS	ZJDE0001	X	VERS	This is used by function to look up the appropriate set of processing options.
cSuppressErrMsg_EV01		O	EV01	Enter a “1” here to suppress error messages - not recommended. You should usually leave this field blank.
cErrorCode_ERRC		X	ERRC	Indicates an error condition. Set by program.
szErrorMessageKey_EKEY		X	EKEY	Holds EnterpriseOne error message number.
iDebugLevel_INT01		O	INT01	Leave blank except for debugging and testing purposes only. Higher numbers will show more debug dialog boxes. Leave this blank or set to suppress 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.
szApprover_ALKY		R	ALKY	User ID of the Approver.
szBranchPlant_MCU		X	MCU	Defaults from F4301 based on Order/Type.
szOrderType_DCTO		R	DCTO	Order Doc Type.
mnOrdersOlderThan_DORE1		O	DORE1	This field is not currently used.
mnOrdersWaitingMoreThan_DWTE1		O	DWTE1	This field is not currently used.
cApprovalAction_APPACT		O	APPACT	This field is not currently used.
mnQBEOrderNumber_DOCO		R	DOCO	Purchase Order Number.
szQBEOrderType_DCTO		O	DCTO	This field is not currently used.
szQBECompany_KCOO		X	KCOO	Defaults based on BranchPlant.
jdQBEOrderDate_TRDJ		O	TRDJ	This field is not currently used.
mnQBEPersonResponsible_RPER		X	RPER	Defaults based on the Approver.
mnQBEOriginator_AN8		O	AN8	This field is not currently used.
cForeignCurrencyCheckbox_CRRM		O	CRRM	This field is not currently used.
szApprovedStatusDesc_DESC		O	DESC	This field is not currently used.
jdOrderDate_TRDJ		X	TRDJ	Defaults from F4209 Order Date.
mnQBELineNumber_LNID		C	LNID	Purchase Order Line Number. This field is Required when using Action Code = “D”. This field is used with processing the F4318 Rejection Reasons.
jdQBERequestDate_DRQJ		O	DRQJ	This field is not currently used.
mnQBEUnitCost_PRRC		O	PRRC	This field is not currently used.
szQBEUoM_UOM		O	UOM	This field is not currently used.
szQBEPurchasingUoM_UOM3		O	UOM3	This field is not currently used.
szQBEDescriptionLine1_DSC1		O	DSC1	This field is not currently used.
szQBEDescriptionLine2_DSC2		O	DSC2	This field is not currently used.
mnQBEDiscountFactor_DSPR		O	DSPR	This field is not currently used.
cQBESubledgerType_SBLT		O	SBLT	This field is not currently used.
szQBESubledger_SBL		O	SBL	This field is not currently used.
szQBELineType_LNTY		O	LNTY	This field is not currently used.
szQBEOrderSuffix_SFXO		X	SFXO	Defaults from F4301 based on Order/Type.
szQBESerialNumber_ASID		O	ASID	This field is not currently used.
szQBEAccountNumber_ANI		O	ANI	This field is not currently used.
szRejectRemark_RMK		X	RMK	Used with Action Codes “D” and “R”. Will default from the value in F4318. If % is passed in, the field will be left blank.
szRejectGridRemark_RMK		O	RMK	Used with Action Codes "D" and "R". Will default from the value in F4318. If % is passed in, the field will be left blank. This field is only used when the value passed in mnQBELineNumber_LNID is greater than zero.
cURC1ReqDate_UC01		X	UC01	Used with Action Codes “D” and “R”. Will default from the value in F4318. If % is passed in, the field will be left blank. This field is only used when the value passed in mnQBELineNumber_LNID is greater than zero.
cURC2Qty_UC02		X	UC02	Used with Action Codes “D” and “R”. Will default from the value in F4318. If % is passed in, the field will be left blank. This field is only used when the value passed in mnQBELineNumber_LNID is greater than zero.
cURC3UnitCost_UC03		X	UC03	Used with Action Codes “D” and “R”. Will default from the value in F4318. If % is passed in, the field will be left blank. This field is only used when the value passed in mnQBELineNumber_LNID is greater than zero.
cURC4Disc_UC04		X	UC04	Used with Action Codes “D” and “R”. Will default from the value in F4318. If % is passed in, the field will be left blank. This field is only used when the value passed in mnQBELineNumber_LNID is greater than zero.
cURC5CostCntr_UC05		X	UC05	Used with Action Codes “D” and “R”. Will default from the value in F4318. If % is passed in, the field will be left blank. This field is only used when the value passed in mnQBELineNumber_LNID is greater than zero.
cURC6ProjCode_UC06		X	UC06	Used with Action Codes “D” and “R”. Will default from the value in F4318. If % is passed in, the field will be left blank. This field is only used when the value passed in mnQBELineNumber_LNID is greater than zero.
cURC7ProdGrp_UC07		X	UC07	Used with Action Codes “D” and “R”. Will default from the value in F4318. If % is passed in, the field will be left blank. This field is only used when the value passed in mnQBELineNumber_LNID is greater than zero.
cURC8CustGrp_UC08		X	UC08	Used with Action Codes “D” and “R”. Will default from the value in F4318. If % is passed in, the field will be left blank. This field is only used when the value passed in mnQBELineNumber_LNID is greater than zero.
szPassword_PWRD		X	PWRD	szPassword_PWRD.
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.

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	A - Approve order	R - Reject order	M - Remove old originator messages	D - Add or revise reject reasons
cActionCode_ACTION	A	R	M	D
zVersion_VERS	ZJDE0002	ZJDE0002	ZJDE0002	ZJDE0002
szApprover_ALKY	POAPPR1	POAPPR1	CLAITNER	POAPPR1
szBranchPlant_MCU	30	30	30	30
szOrderType_DCTO	OP	OP	OP	OP
mnOrdersOlderThan_DORE1	0	0	0	0
mnOrdersWaitingMoreThan_DWTE1	0	0	0	0
mnQBEOrderNumber_DOCO	XXXXX	XXXXX	XXXXX	XXXXX
szQBECompany_DCOO	0001	0001	0001	0001
mnQBEPersonResponsible_RPER	8976543	8976543	1966632	8976543
mnQBELineNumber_LNID	2	2		2
szRejectRemark_RMK	RMK – HEADER	RMK – HEADER		RMK – HEADER
szRejectGridRemark_RMK	RMK – GRID	RMK – GRID		RMK – GRID
cURC1ReqDate_UC01	1	1		1
cURC2Qty_UC02	2	2		2
szPassword_PWRD	POAPPR1	POAPPR1	POAPPR1	POAPPR1

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.
0425	Action Code Invalid. This is set when the PO next status is blank or null.
3778	Address book record is invalid. In this interface, this will be set if the Person Responsible is blank or null..
4634	Order Type Required. This is set if the Order Type is Blank or Null.
0003	Blanks Invalid. This is set when Order suffix is Blank or Null.
3500	Invalid Line Number. This is set when Line Number is Blank or Null or Zero and Action Code is “D”.
0964	Branch Plant Invalid. This is set when business function returned error.
138T	Action Code Invalid. This is set when Action Code is not equal to “A,D,M,R”.
43BUD	Budget Hold Not Completely Released. This is set when Budget Approval flag is “1”.

There was a problem loading this topic

Mobile Enterprise Platform