Basic Serial Number Entry interface for JD Edwards

About the Basic Serial Number Entry interface

This interface is used to add serial numbers to the F4220 Basic Serial Numbers file.

This interface can only be used to add unique serial numbers. It does not support changing or removing serial numbers from the F4220 file. Each interface added is associated with a detail line on a sales order. In order to do this, the order number and line number for the sales order line should be passed into the business function. The NER is ND3N4220.

This interface uses no cache to store information over multiple calls. It is that storing of information into caches that causes problems when the connection to EnterpriseOne is reset. Since each call to this interface is independent of any other call this interface can be used with the Function Caller, the Asynchronous Function Caller or it can be called as a COM object.

Name	Function name	Description
DD3N4220		dcLINK Interface F4220 Serial Number Generation
ND3N4220	dcLINKF4220SerialNumberGeneration	dcLINK Interface F4220 Serial Number Generation
DD3N4203		PO Retrieval F4220 Serial Number Generation
BD3N4203	PORetrievalF4220SerialNoGeneration	PO Retrieval Serial Number Generation

The full name of this interface is ND3N4220 Basic Serial Number Entry

This interface guide applies to the following JDE versions.

EnterpriseOne 8.12

Processing options

Processing options for Basic Serial Number Entry interface.

The DreamWriter defaults to ZJDE0001 if not otherwise specified in the parameter list on the call.

Defaults tab

Order Type (szPO_OrderType_DCTO): Order type is used in conjunction with the order number and line number to find the correct sales order line to associate with this serial number.

Processing option data structure for DD3N4203

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

Type	Description	Parameter
String	szPOVersion_VERS	Input
String	szPO_OrderType_DCTO	Output
String	szPO_P4210Version_VL01	Output

Processing

The characteristics of an item determine which fields are required by the interface. Some characteristics are set at the item master level, and some are set at the item/branch level. The item/branch level always takes precedence over the item master. Refer to the Special Processing Interface Usage Guide for more information.

Verify processing

Steps to verify the processing for Basic Serial Number Entry.

To verify the processing, complete the following steps in JDE.

Go to menu G4241.
Select Serial Number Revisions.
Enter the order number and select FIND.

Step Information

The grid will be populated with all the serial numbers recorded for the order.
Find the serial number you entered. By entering either the serial number or line number on the QBE line, your search will be pared down to a manageable size.

If the record exists then the interface worked. There are no additional files that are updated.

Input data structure

Input data structure for DD3N4220

Name	Default values	R/O	Alias	Notes
cdcLINKActionCode_EV01	0	X	EV01	Not required to supply. “0” will be defaulted by the interface.
cActionCode_ACTION	1	X	ACTION	Not required to supply. “1” will be defaulted by the interface.
jdDateUpdated_UPMJ	Current Date	X	UPMJ	Retrieved from GetAuditInfo.
mnTimeOfDay_TDAY	Current Time	X	TDAY	Retrieved from GetAuditInfo.
szUserId_USER	Current User	X	USER	Retrieved from GetAuditInfo.
szWorkStationId_JOBN	Current Workstation	X	JOBN	Retrieved from GetAuditInfo.
mnJobNumber_JOBS		O	JOBS	Not used by this interface.
szProgramId_PID	ND3N4220	X	PID	Defaulted in program if not passed in.
szVersion_VERS	ZJDE0001	X	VERS	Defaulted in program if not passed in.
cSuppressErrMsg_EV01		O	EV01	Not used in this interface.
cErrorCode_ERRC	Blanks	X	ERRC	Defaulted in program.
szErrorMessageKey_EKEY	Blanks	X	EKEY	Defaulted in program.
iDebugLevel_INT01		O	INT01	Displays M&D Debug statements if the value is greater than “0”.
mnIdentifierShortItem_ITM		R	ITM	Required. The short item number entered is compared to the item number from the F4211 file.
szCostCenter_MCU		R	MCU	Required. This field is compared to the branch/plant retrieved from the F4211 file read.
mnOrderNumber_DOCO		R	DOCO	Required. The order number is used, along with the line number and document type, to find the sales order detail record.
mnLineNumber_LNID		R	LNID	Required. The line number is used, along with the order number and document type, to find the sales order detail record.
szSerialNumber1_SRL1		R	SRL1	Required. This serial number must always be supplied and it must not already exist in the F4220 serial number file. If it does, an error will be returned.
szSerialNumber2_SRL2		O	SRL2	Optional. If this field is sent up then it will also be recorded in the F4220 file when the record is written. However, it is not mandatory. If this is not scanned when the transaction is initially entered, it cannot be added later (using dcLINK).
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.

R = Required

O = Optional

X = Required but will default in if not passed

C = Conditional (see notes for conditions)

Additional information

Additional information for Basic Serial Number Entry interface.

Action code usage

This interface doesn't use multiple action codes to control processing. The dcLINK Action Code (cdcLINKActionCode_EV01) field is defaulted to “0” by the interface and the enterprise system action code (cActionCode_ACTION) is defaulted to “1”. It is not necessary to pass these values in from the script.

Typical flow

A user has a sales order for X quantity of an item. The Item Number has Serial Numbers associated with it, and they should be scanned and recorded in the F4220 Basic Serial Number file. In order to accomplish this, the following information needs to be passed to the Basic Serial Number Interface: the Order Number (mnOrderNumber_DOCO), line number (mnLineNumber_LNID), short item number (mnIdentifierShortItem_ITM), Branch/Plant (szCostCenter_MCU), and Serial Number One (szSerialNumber1_SRL1).

The interface will use the order number, line number, and the document type from the processing options to find the correct sales order detail line. The Item Number on the sales order detail line will be compared to the Item Number passed in. If they match, the serial number file (F4220) will be read using the Serial Number passed. As long as the Serial Number does not currently exist in the F4220 file, it will be added.

Alternative flows

In addition to the process outline in the typical flow the following processing variations can also be performed by this interface.

Adding an entry that contains both Serial Number “1” (szSerialNumber1_SRL1) and the Optional Serial Number “2” (szSerialNumber2_SRL2).

There was a problem loading this topic

Mobile Enterprise Platform