OSID Logo
OSID Specifications
messaging batch package
Version 3.0.0
Release Candidate Preview
Interfaceosid.messaging.batch.ReceiptBatchAdminSession
Implementsosid.messaging.ReceiptAdminSession
Description

This session updates Receipts in bulk. The data for update is provided by the consumer via the form object. OsidForms are requested for each update and may not be reused.

For updates, ReceiptForms are requested to the Receipt Id that is to be updated using getReceiptFormsForUpdate() where the reference Id in the ReceiptForm may be used to link the request. Similarly, the ReceiptForm has metadata about the data that can be updated and it can perform validation before submitting the update. The ReceiptForm can only be used once for a successful update and cannot be reused.

Once a batch of ReceiptForms are submitted for update, an UpdateResponse is returned for each ReceiptForm, although the ordering is not defined. Only errors that pertain to the entire update operation are returned from updateReceipts(), errors specific to an individual ReceiptForm are indicated in the corresponding UpdateResponse. UpdateResponses may be linked to the originating ReceiptForm through the ReceiptForm Id.

MethodgetReceiptFormsForUpdate
Description

Gets the receipt forms for updating an existing set of receipts. A new receipt form should be requested for each update transaction.

Parametersosid.id.IdListreceiptIdsthe Ids of the Receipts
Returnosid.messaging.batch.ReceiptBatchFormListthe receipt form
ErrorsNOT_FOUNDa receiptId is not found
NULL_ARGUMENT receiptIds is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodupdateReceipts
Description

Updates existing receipts. This method returns an error if the entire operation fails. Otherwise, the status of an individual update operation is indicated in the BatchCreateResponse .

Parametersosid.messaging.batch.ReceiptBatchFormListreceiptFormsthe form containing the elements to be updated
Returnosid.transaction.batch.UpdateResponseListthe update responses
ErrorsNULL_ARGUMENT receiptForms is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.