Each ReturnCaseItem defines ReturnCaseItem.getAuthorizedQuantity() representing the maximum
quantity expected to be returned. The ReturnCaseItem may be associated with
0..n ReturnItems - ReturnItems are added to the ReturnCaseItem when
Returns are created.
Either - a ReturnCase may be used as an RMA, in which case they are
created when a customer first shows a wish to return item(s). The customer
then includes the RMA number with the returned item(s). The Return created as
a result is then associated with the existing ReturnCase.
Or - a ReturnCase is automatically created as part of the return
creation, i.e. the customer returns some item(s) leading to a creation of
both a Return and an associated ReturnCase.
The scripting api allows access to the ReturnCases, whether the ReturnCase is an RMA or not,
and the ReturnCase status. Both the ReturnCaseItems and any Returns
associated with the ReturnCase can be accessed.
A ReturnCase has one of these status values:
NEW - the ReturnCase has been created and can be edited previous to its authorization
CONFIRMED - the ReturnCase is CONFIRMED, can no longer be edited, no Returns have been associated with it. Only a NEW- ReturnCase can be CONFIRMED
PARTIAL_RETURNED - the ReturnCase has been associated with at least one Return, but is not yet complete. Only a CONFIRMED- ReturnCase can be set to PARTIAL_RETURNED
RETURNED - the ReturnCase has been associated with Returns which match the expected authorized quantity. Only an CONFIRMED- or PARTIAL_RETURNED- return-case can be set to RETURNED
CANCELLED - the ReturnCase has been cancelled (only a NEW- or CONFIRMED- ReturnCase can be cancelled)
Order post-processing APIs (gillian) are now inactive by default and will throw
an exception if accessed. Activation needs preliminary approval by Product Management.
Please contact support in this case. Existing customers using these APIs are not
affected by this change and can use the APIs until further notice.
Creates a new Invoice based on this
ReturnCase. The return-case-number will
be used as the invoice-number. The Invoice can then be
accessed using getInvoice() or its number using
getInvoiceNumber(). The method must not be called more than once
for a ReturnCase, nor may 2 Invoices
exist with the same invoice-number.
The new Invoice is a credit-invoice with a
Invoice.STATUS_NOT_PAID status, and will be passed to
the refund payment-hook in a separate database transaction for
processing.
Creates a new Invoice based on this
ReturnCase. The invoice-number must be specified as an
argument. The Invoice can then be
accessed using getInvoice() or its number using
getInvoiceNumber(). The method must not be called more than once
for a ReturnCase, nor may 2 Invoices
exist with the same invoice-number.
The new Invoice is a credit-invoice with a
Invoice.STATUS_NOT_PAID status, and will be passed to
the refund payment-hook in a separate database transaction for
processing.
Parameters:
invoiceNumber - the invoice-number to be used for the invoice creation
j