OSID - osid.acknowledgement.AcknowledgementManager Service Interface Definition

Interface	osid.acknowledgement.AcknowledgementManager
Implements	`osid.OsidManager`
Implements	`osid.acknowledgement.AcknowledgementProfile`
Description	The acknowledgement manager provides access to acknowledgement sessions and provides interoperability tests for various aspects of this service. The sessions included in this manager are: `CreditLookupSession:` a session to lookup credits `CreditQuerySession:` a session for querying credits `CreditSearchSession:` a session to search credits `CreditAdminSession:` a session to manage credits `CreditNotificationSession:` a session to subscribe to notifications of credit changes `CreditBillingSession:` a session to look up credit to billing mappings `CreditBillingAssignmentSession:` a session to manage credit to billing mappings `CreditSmartBillingSession:` a session to manage dynamic credit to billing mappings `BillingLookupSession:` a session to retrieve billings `BillingQuerySession:` a session for querying billings `BillingSearchSession:` a session to search for billings `BillingAdminSession:` a session to create, update and delete billings `BillingNotificationSession:` a session to receive notifications for changes in billings `BillingHierarchyTraversalSession:` a session to traverse hierarchies of billings `BillingHierarchyDesignSession:` a session to manage hierarchies of billings The acknowledgement manager also provides a profile for determing the supported search types supported by this service.
Method	getCreditLookupSession
Description	Gets the `OsidSession` associated with the credit lookup service.
Return	`osid.acknowledgement.CreditLookupSession`		a `CreditLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsCreditLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsCreditLookup()` is `true.`
Method	getCreditLookupSessionForBilling
Description	Gets the `OsidSession` associated with the credit lookup service for the given billing.
Parameters	`osid.id.Id`	`billingId`	the `Id` of the `Billing`
Return	`osid.acknowledgement.CreditLookupSession`		a `CreditLookupSession`
Errors	NOT_FOUND		no `Billing` found by the given `Id`
	NULL_ARGUMENT		`billingId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsCreditLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsCreditLookup()` and `supportsVisibleFederation()` are `true`
Method	getCreditQuerySession
Description	Gets the `OsidSession` associated with the credit query service.
Return	`osid.acknowledgement.CreditQuerySession`		a `CreditQuerySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsCreditQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsCreditQuery()` is `true.`
Method	getCreditQuerySessionForBilling
Description	Gets the `OsidSession` associated with the credit query service for the given billing.
Parameters	`osid.id.Id`	`billingId`	the `Id` of the `Billing`
Return	`osid.acknowledgement.CreditQuerySession`		a `CreditQuerySession`
Errors	NOT_FOUND		no `Billing` found by the given `Id`
	NULL_ARGUMENT		`billingId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsCreditQuery()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsCreditQuery()` and `supportsVisibleFederation()` are `true`
Method	getCreditSearchSession
Description	Gets the `OsidSession` associated with the credit search service.
Return	`osid.acknowledgement.CreditSearchSession`		a `CreditSearchSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsCreditSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsCreditSearch()` is `true.`
Method	getCreditSearchSessionForBilling
Description	Gets the `OsidSession` associated with the credit search service for the given billing.
Parameters	`osid.id.Id`	`billingId`	the `Id` of the `Billing`
Return	`osid.acknowledgement.CreditSearchSession`		a `CreditSearchSession`
Errors	NOT_FOUND		no `Billing` found by the given `Id`
	NULL_ARGUMENT		`billingId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsCreditSearch()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsCreditSearch()` and `supportsVisibleFederation()` are `true`
Method	getCreditAdminSession
Description	Gets the `OsidSession` associated with the credit administration service.
Return	`osid.acknowledgement.CreditAdminSession`		a `CreditAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsCreditAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsCreditAdmin()` is `true.`
Method	getCreditAdminSessionForBilling
Description	Gets the `OsidSession` associated with the credit administration service for the given billing.
Parameters	`osid.id.Id`	`billingId`	the `Id` of the `Billing`
Return	`osid.acknowledgement.CreditAdminSession`		a `CreditAdminSession`
Errors	NOT_FOUND		no `Billing` found by the given `Id`
	NULL_ARGUMENT		`billingId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsCreditAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsCreditAdmin()` and `supportsVisibleFederation()` are `true`
Method	getCreditNotificationSession
Description	Gets the `OsidSession` associated with the credit notification service.
Parameters	`osid.acknowledgement.CreditReceiver`	`creditReceiver`	the receiver
Return	`osid.acknowledgement.CreditNotificationSession`		a `CreditNotificationSession`
Errors	NULL_ARGUMENT		`creditReceiver` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsCreditNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsCreditNotification()` is `true.`
Method	getCreditNotificationSessionForBilling
Description	Gets the `OsidSession` associated with the credit notification service for the given billing.
Parameters	`osid.acknowledgement.CreditReceiver`	`creditReceiver`	the receiver
Parameters	`osid.id.Id`	`billingId`	the `Id` of the `Billing`
Return	`osid.acknowledgement.CreditNotificationSession`		a `CreditNotificationSession`
Errors	NOT_FOUND		no `Billing` found by the given `Id`
	NULL_ARGUMENT		`creditReceiver` or `billingId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsCreditNotification()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsCreditNotification()` and `supportsVisibleFederation()` are `true`
Method	getCreditBillingSession
Description	Gets the session for retrieving credit to billing mappings.
Return	`osid.acknowledgement.CreditBillingSession`		a `CreditBillingSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsCreditBilling()` is `false`
Compliance	`optional`		This method must be implemented if `supportsCreditBilling()` is `true.`
Method	getCreditBillingAssignmentSession
Description	Gets the session for assigning credit to billing mappings.
Return	`osid.acknowledgement.CreditBillingAssignmentSession`		a `CreditBillingAssignmentSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsCreditBillingAssignment()` is `false`
Compliance	`optional`		This method must be implemented if `supportsCreditBillingAssignment()` is `true.`
Method	getCreditSmartBillingSession
Description	Gets the session associated with the credit smart billing for the given billing.
Parameters	`osid.id.Id`	`billingId`	the `Id` of the billing
Return	`osid.acknowledgement.CreditSmartBillingSession`		a `CreditSmartBillingSession`
Errors	NOT_FOUND		`billingId` not found
	NULL_ARGUMENT		`billingId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsCreditSmartBilling()` is `false`
Compliance	`optional`		This method must be implemented if `supportsCreditSmartBilling()` is `true.`
Method	getBillingLookupSession
Description	Gets the `OsidSession` associated with the billing lookup service.
Return	`osid.acknowledgement.BillingLookupSession`		a `BillingLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsBillingLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBillingLookup()` is `true.`
Method	getBillingQuerySession
Description	Gets the `OsidSession` associated with the billing query service.
Return	`osid.acknowledgement.BillingQuerySession`		a `BillingQuerySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsBillingQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBillingQuery()` is `true.`
Method	getBillingSearchSession
Description	Gets the `OsidSession` associated with the billing search service.
Return	`osid.acknowledgement.BillingSearchSession`		a `BillingSearchSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsBillingSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBillingSearch()` is `true.`
Method	getBillingAdminSession
Description	Gets the `OsidSession` associated with the billing administrative service.
Return	`osid.acknowledgement.BillingAdminSession`		a `BillingAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsBillingAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBillingAdmin()` is `true.`
Method	getBillingNotificationSession
Description	Gets the `OsidSession` associated with the billing notification service.
Parameters	`osid.acknowledgement.BillingReceiver`	`billingReceiver`	the receiver
Return	`osid.acknowledgement.BillingNotificationSession`		a `BillingNotificationSession`
Errors	NULL_ARGUMENT		`billingReceiver` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsBillingNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBillingNotification()` is `true.`
Method	getBillingHierarchySession
Description	Gets the `OsidSession` associated with the billing hierarchy service.
Return	`osid.acknowledgement.BillingHierarchySession`		a `BillingHierarchySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsBillingHierarchy()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBillingHierarchy()` is `true.`
Method	getBillingHierarchyDesignSession
Description	Gets the `OsidSession` associated with the billing hierarchy design service.
Return	`osid.acknowledgement.BillingHierarchyDesignSession`		a `BillingHierarchyDesignSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsBillingHierarchyDesign()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBillingHierarchyDesign()` is `true.`
Method	getAcknowledgementBatchManager
Description	Gets an `AcknowledgementBatchManager.`
Return	`osid.acknowledgement.batch.AcknowledgementBatchManager`		an `AcknowledgementBatchManager`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAcknowledgementBach()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAcknowledgementBatch()` is `true.`