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.

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.