This chapter includes these topics:
Section 81.2, "Purchase Order Receipts Business Services - PurchaseOrderReceiptsManager"
Section 81.4, "Purchase Order Receipts Batch Import Programs"
Section 81.5, "Purchase Order Receipts Batch Export Programs"
This chapter provides detailed information about the business interfaces that are available for the Purchase Order Receipts business object.
This table lists all of the available interface components:
|
Note: You can find additional technical information about each type of business interface component. For additional descriptions of the information available, and instructions for finding this information, see Chapter 5, "Accessing Additional Information for Business Interface Components." |
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:
To access Javadoc for the Purchase Order Receipt Manager web service and its related operations, review these Javadoc packages:
JP43A000 (PurchaseOrderReceiptManager)
J43A0010 (processPurchaseOrderReceipt)
J43A0010 (processPurchaseOrderReceiptV2)
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 JD Edwards EnterpriseOne Applications Procurement Management Implementation Guide.
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. Therefore, you can choose which lines in a purchase order to send. You can send and receive all lines in a purchase order, or you can send and receive only selected lines in a purchase order.
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.
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).
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. | 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: |
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:
|
| 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. |
Review the information in the processPurchaseOrderReceipt section of this chapter before using the processPurchaseOrderReceiptV2 web service operation. All of the information in the processPurchaseOrderReceipt section also applies to the processPurchaseOrderReceiptV2 operation.
The processPurchaseOrderReceiptV2 operation is a version of the processPurchaseOrderReceipt web service operation. This web service operation is used to create partial and full purchase order receipts, including country of origin information. This version executes the processPurchaseOrderReceipt (J43A0010) web service operation.
This section describes the available real-time events associated with the Purchase Order Receipts business object, which include:
RTRECOUT
RTRECOUT is used by the JD Edwards EnterpriseOne system to notify third-party systems when a purchase order receipt is created.
| Event Type | Event Description | Event Category | Event Aggregate | Product Code | Data Structure |
|---|---|---|---|---|---|
| RTRECOUT | Purchase Order Receipt | RTE | Single | 43B | D4303420: Receipt Realtime Event Template |
This event is triggered when a purchase order receipt is created in the JD Edwards EnterpriseOne system.
These objects can initiate the RTRECOUT event:
B4301300 - F43121 Update Landed Cost Records
B4301440 - F43121 Copy Row With New Receipt Line Number
B7600400 - Receive NF Records - Brazil
B7602020 - Add Lines to Receipt File - Brazil
NXT43092 - Receipt Routing
X43091 - Receipt Routing Initiator
XF43121 - Purchase Order Item Ledger Functions
N4301430 - F43121 Update Line Split In Receipt Routing
B4300720 - F43121, Update Receipt Date
B4300870 - F43092, Update Disposition Information
B7602080 - LC - Update GL, Cardex and Cost Difference CT - BRA - 43
XT4312Z1 - Purchase Order Receipts
You use batch import programs to import data from an external software system into the JD Edwards EnterpriseOne system, where it can then be processed by EnterpriseOne programs.
This table lists and describes the available batch import programs that are associated with the Purchase Order Receipts business object:
You use batch export programs to retrieve and format data from the JD Edwards EntepriseOne database so that it can be used by an external software system.
This table lists and describes the available batch export programs that are associated with the Purchase Order Receipts business object: