Generic ReturnsBillingStatus business object

The generic ReturnsBillingStatus business object, which is one of the generic business objects that works with the Order Status collaboration template, is independent of the other status objects. It is used to capture the state of a returns billing document, such as a credit memo, associated with a return sales order whenever that state changes.

For example, the return delivery triggers the creation of a corresponding ReturnsBillingStatus business object with a status of "Not Billed". Releasing an invoice for a return order line item triggers creation of a new ReturnsBillingStatus business object, this time with a status of "Partially Billed".

Business object structure

The ReturnsBillingStatus business object is hierarchical. One of its attributes references the ReturnsBillingStatusLine child business object, which contains returns billing status information about a line item in the associated return order.

Each ReturnsBillingStatus business object matches the structure of its associated return order. If the return order has two line items, ReturnsBillingStatus has a header and two ReturnsBillingStatusLine business objects. Even if the triggering event reflects a change of billing status for only one line item, ReturnsBillingStatus references separate child business objects for each line item in the return order.

For example, assume a return order has two line items, only one of which has been returned. Sending the credit memo for the returned line item triggers creation of a ReturnsBillingStatus business object with two ReturnsBillingStatusLine business objects. Only one of the child business objects contains the change in status that triggered the event. The other child business object contains no information specific to the current triggering event.

ReturnsBillingStatus: Reporting summary status changes

ReturnsBillingStatus contains such header information as the identifiers of the return order and its associated customer and purchase order, the reason for the return, and the person who last changed the order as well as the date of the change. In addition, it contains the BillingStatusHeader attribute, which summarizes the billing status of all line items in the return order. The values of this attribute might include "Not Billed", "Partially Billed", "Bill Created", and "Fully Billed".

ReturnsBillingStatusLine: Reporting line item status changes

ReturnsBillingStatusLine contains such line item information as the identifiers of the return order line item and its associated returns billing status, and the person who last changed the line item as well as the date of the change. It uses the ReturnsBilllingStatusLine attribute to contain the return line item status for the return order, as explained in Table 1.

Table 1: Status Attributes in the ReturnsBillingStatusLine Business Object

Attribute Value reported
BillingStatusLine The status of the billing document for the return order line item
AccountingStatusLine Whether the invoice for the return order line item has been released to the accounting department; for example, values might include "Not Released", "Partially Released;, and "Fully Released"
ProcessingStatusLine The status of the physical state of the return order line item; for example, values might include "Entered", "Booked", and "Scheduled"
ApprovalStatusLine The status for the approvals of the return order line item; for example, values might include "Not Approved", "Level 1 Approved", "Level 2 Approved", and "Complete"
RejectionStatusLine The rejection status of the order line item if its fulfillment was rejected for any reason; for example, values might include "Not Rejected", "Rejected Customer", and "Rejected Part"
ReturnDeliverySchLineStatus Whether the return deliveries have been scheduled; for example, values might include "Not Scheduled", "Partially Scheduled", and "Fully Scheduled".

The generic ReturnsBillingStatus business object reports status changes between the return order and its returns billing document during the following operations:

For information on handling the billing status of complex sales orders, such as a single sales order with multiple billing documents, see the generic OrderDeliveryStatus business object.

Supported verbs

ReturnsBillingStatus supports the following verbs:

Examining the object

To examine the attributes of the generic ReturnsBillingStatus business object, use System Manager or Process Designer Express.

Related References

Copyright IBM Corp. 1997, 2004