Purchase Order Receipt Manager Web Service

This chapter provides an overview of the Purchase Order Receipt Manager web service, lists a prerequisite, and discusses the processPurchaseOrderReceipt web service operation.

Understanding the Purchase Order Receipt Manager Web Service

The PurchaseOrderReceiptManager web service (JP43A000) manages the processing of purchase order receipt-related web service operations. This table includes a description of the purchase order receipt web service operation:

Operation	Description
processPurchaseOrderReceipt (J43A0010)	Use this operation to create partial and full purchase order receipts within the JD Edwards EnterpriseOne Procurement system. The operation supports basic and advanced serial number receipts.

Accessing Javadoc for the Purchase Order Receipt Manager Web Service Operations

To access Javadoc for the Purchase Order Receipt Manager web service and its related operations, review these Javadoc packages:

JP43A000 (PurchaseOrderReceiptManager)
J43A0010 (processPurchaseOrderReceipt)

See Accessing Javadoc for Business Services.

Reviewing Input and Response Interfaces

To review information about the classes and fields that are used by these web service operations, you can review the input and response interface tables. Input and response interface tables list the classes and fields used by each operation, the key fields, the data types of each fields, and which fields or classes are required for each action.

See Accessing Additional Information about Business Services, Appendix A: Input and Response Interfaces.

Prerequisite

Before using the Purchase Order Receipt manager web service, or the related web service operation, you must install and configure the JD Edwards EnterpriseOne Procurement system.

See Getting Started with JD Edwards EnterpriseOne Procurement Management.

See Understanding Serial Number Processing in the Distribution System.

processPurchaseOrderReceipt

This section provides an overview of the processPurchaseOrderReceipt web service operation.

Understanding the processPurchaseOrderReceipt Web Service Operation

The processPurchaseOrderReceipt web service operation is an inbound transaction operation that enables consumers to process purchase order receipt information within the JD Edwards EnterpriseOne system. The consumer can create full and partial purchase order receipts in the JD Edwards EnterpriseOne Procurement system. The operation also supports basic and advanced serial number receipts.

The processPurchaseOrderReceipt web service operation receives goods and services on a purchase order. The processPurchaseOrderReceipt operation calls the XPIProcessInboundReceipt business function (B4302240) to process the purchase order receipt. If there are no errors during processing, the business function may return information and warnings depending upon the scenario and report back to the processPurchaseOrderReceipt web service operation.

See Setting Processing Options for Purchase Order XPI (P43XPI).

Supported Functionality

This section discusses the functionality that the processPurchaseOrderReceipt operation supports.

Note. If functionality is not explicitly documented as supported functionality, it is to be understood that the functionality is not supported by the integration solution.

When creating purchase order receipts:

Full and partial purchase order receipts are supported.
Basic and advanced serial number receipts are supported.
Receipt by purchase order and receipt by purchase order line item are supported.
Receipt of one purchase order at a time is supported.

The processPurchaseOrderReceipt web service operation does not support the following functionality:

Receipts of multiple purchase orders at a time.
Update purchase order receipts.
Receipts by account.
Receive into multiple locations.
Receipts for transportation.
Receive and close purchase order and cancel purchase order receipt line.
Receipt routing.
Reverse receipt.
Cascading receipts.
Desktop receipt.
Weight tag receipt (for wine industry).

Setup Considerations

Before you use this operation, you can set business service properties to specify how the system processes purchase order information. This table includes information about the business service properties that the processPurchaseOrderReceipt web service operation uses:

Group	Key	Description	Default Value
J43A0010	J43A0010_PR_MBF_VERSION	Use this business service property to specify which version of the PO Receipts program (P4312) the operation uses. See Setting Processing Options for PO Receipts (P4312).	ZJDE0001
J43A0010	J43A0010_PREFIX_1	Use this business service property to specify the prefix value the operation uses for error messages when JD Edwards EnterpriseOne runs the SerialNumberCacheProcess business function (B4302180) .	Receipt Serial Number Sent in:
J43A0010	J43A0010_PREFIX_2	Use this business service property to specify the prefix value the operation uses for error messages when JD Edwards EnterpriseOne runs the XPIProcessInboundReceipt business function (B4302240) for edit doc and edit line.	Receipt Sent in:
J43A0010	J43A0010_PREFIX_3	Use this business service property to specify the prefix value the operation uses for error messages when JD Edwards EnterpriseOne runs the XPIProcessInboundReceipt business function (B4302240) for end doc.	Receipt Process WF Sent in:

Implementation Details

The following table includes information that can help determine whether the processPurchaseOrderReceipt operation is functioning correctly:

Question	Answer
How can I tell if the operation completes successfully?	If the web service call does not throw a business service exception, then the operation has completed successfully. There may be some warning messages in the returned value object which the consumer can review. If the operation completes successfully, the system returns a confirmation message to the consumer. The return message includes all of the fields that are listed in the response interface for this operation. However, some of those fields can contain blank or zero values, depending on the data that exists in the JD Edwards EnterpriseOne system. At a minimum, the system returns non-zero values for these fields: documentNumber documentTypeCode documentCompany receiptNumber businessUnit documentLineNumber receiptLineNumber
If I encounter errors while processing a transaction, do I need to reverse the transaction?	This operation uses standard transaction processing. Therefore, if you encounter errors during processing, the system does not update any information in the JD Edwards EnterpriseOne system. The consumer only needs to reverse the addition of records to the Item Location File (F41021) table in the event that a fatal server or connection error occurred when the rollback was occurring since the rollback of the F41021 table is handled manually with a business function call. All other transactions for the receipt are rolled back in the normal transaction processing handling.
Does this operation use record reservation?	This operation calls the XPIProcessInboundReceipt business function (B4302240) . This function reserves purchase order records in the JD Edwards EnterpriseOne system when the operation is processing receipts so that no other user can update the purchase order. If the purchase order for which the operation is creating a receipt is reserved by some other application, then the call to the B4302240 business function returns an error and stops any further processing.