org.killbill.billing.invoice.api

Interface InvoiceUserApi

All Superinterfaces:

KillbillApi

public interface InvoiceUserApi
extends KillbillApi

Method Summary

Methods

Modifier and Type	Method and Description
void	consumeExstingCBAOnAccountWithUnpaidInvoices(UUID accountId, CallContext context) Rebalance CBA for account which have credit and unpaid invoices-- only needed if system is configured to not rebalance automatically.
void	deleteCBA(UUID accountId, UUID invoiceId, UUID invoiceItemId, CallContext context) Delete a CBA item.
BigDecimal	getAccountBalance(UUID accountId, TenantContext context) Retrieve the account balance.
BigDecimal	getAccountCBA(UUID accountId, TenantContext context) Retrieve the account CBA.
InvoiceItem	getCreditById(UUID creditId, TenantContext context) Retrieve a credit by id.
InvoiceItem	getExternalChargeById(UUID externalChargeId, TenantContext context) Retrieve an external charge by id.
Invoice	getInvoice(UUID invoiceId, TenantContext context) Retrieve an invoice by id.
String	getInvoiceAsHTML(UUID invoiceId, TenantContext context) Retrieve the invoice formatted in HTML.
Invoice	getInvoiceByNumber(Integer number, TenantContext context) Retrieve an invoice by invoice number.
Invoice	getInvoiceByPayment(UUID paymentId, TenantContext context) Get all invoices for a given payment.
Pagination<Invoice>	getInvoices(Long offset, Long limit, TenantContext context)
List<Invoice>	getInvoicesByAccount(UUID accountId, org.joda.time.LocalDate fromDate, TenantContext context) Find invoices from a given day, for a given account.
List<Invoice>	getInvoicesByAccount(UUID accountId, TenantContext context) Get all invoices for a given account.
Collection<Invoice>	getUnpaidInvoicesByAccountId(UUID accountId, org.joda.time.LocalDate upToDate, TenantContext context) Find unpaid invoices for a given account, up to a given day.
InvoiceItem	insertCredit(UUID accountId, BigDecimal amount, org.joda.time.LocalDate effectiveDate, Currency currency, CallContext context) Add a credit to an account.
InvoiceItem	insertCreditForInvoice(UUID accountId, UUID invoiceId, BigDecimal amount, org.joda.time.LocalDate effectiveDate, Currency currency, CallContext context) Add a credit to an invoice.
List<InvoiceItem>	insertExternalCharges(UUID accountId, org.joda.time.LocalDate effectiveDate, Iterable<InvoiceItem> charges, CallContext context) Add one or multiple external charges to an account.
InvoiceItem	insertInvoiceItemAdjustment(UUID accountId, UUID invoiceId, UUID invoiceItemId, org.joda.time.LocalDate effectiveDate, BigDecimal amount, Currency currency, CallContext context) Adjust partially a given invoice item.
InvoiceItem	insertInvoiceItemAdjustment(UUID accountId, UUID invoiceId, UUID invoiceItemId, org.joda.time.LocalDate effectiveDate, CallContext context) Adjust fully a given invoice item.
Pagination<Invoice>	searchInvoices(String searchKey, Long offset, Long limit, TenantContext context) Find all invoices having their id, number, account id or currency matching the search key
void	tagInvoiceAsNotWrittenOff(UUID invoiceId, CallContext context) Unmark an invoice as written off.
void	tagInvoiceAsWrittenOff(UUID invoiceId, CallContext context) Mark an invoice as written off.
Invoice	triggerInvoiceGeneration(UUID accountId, org.joda.time.LocalDate targetDate, boolean dryRun, CallContext context) Trigger an invoice for a given account and a given day.

Method Detail

getInvoicesByAccount

List<Invoice> getInvoicesByAccount(UUID accountId,
                                 TenantContext context)

Get all invoices for a given account.

Parameters:

accountId - account id

context - the tenant context

Returns:

all invoices

getInvoicesByAccount

List<Invoice> getInvoicesByAccount(UUID accountId,
                                 org.joda.time.LocalDate fromDate,
                                 TenantContext context)

Find invoices from a given day, for a given account.

Parameters:

accountId - account id

fromDate - the earliest target day to consider, in the account timezone

context - the tenant context

Returns:

a list of invoices

getInvoices

Pagination<Invoice> getInvoices(Long offset,
                              Long limit,
                              TenantContext context)

Parameters:

context - the user context

offset - the offset of the first result

limit - the maximum number of results to retrieve

Returns:

the list of invoices for that tenant

searchInvoices

Pagination<Invoice> searchInvoices(String searchKey,
                                 Long offset,
                                 Long limit,
                                 TenantContext context)

Find all invoices having their id, number, account id or currency matching the search key

Parameters:

searchKey - the search key

offset - the offset of the first result

limit - the maximum number of results to retrieve

context - the user context

Returns:

the list of invoices matching this search key for that tenant

getAccountBalance

BigDecimal getAccountBalance(UUID accountId,
                           TenantContext context)

Retrieve the account balance.

Parameters:

accountId - account id

context - the tenant context

Returns:

the account balance

getAccountCBA

BigDecimal getAccountCBA(UUID accountId,
                       TenantContext context)

Retrieve the account CBA.

Parameters:

accountId - account id

context - the tenant context

Returns:

the account CBA

getInvoice

Invoice getInvoice(UUID invoiceId,
                 TenantContext context)
                   throws InvoiceApiException

Retrieve an invoice by id.

Parameters:

invoiceId - invoice id

context - the tenant context

Returns:

the invoice

Throws:

InvoiceApiException

getInvoiceByPayment

Invoice getInvoiceByPayment(UUID paymentId,
                          TenantContext context)
                            throws InvoiceApiException

Get all invoices for a given payment.

Parameters:

paymentId - payment id

context - the tenant context

Returns:

the invoice

Throws:

InvoiceApiException

getInvoiceByNumber

Invoice getInvoiceByNumber(Integer number,
                         TenantContext context)
                           throws InvoiceApiException

Retrieve an invoice by invoice number.

Parameters:

number - invoice number

context - the tenant context

Returns:

the invoice

Throws:

InvoiceApiException

getUnpaidInvoicesByAccountId

Collection<Invoice> getUnpaidInvoicesByAccountId(UUID accountId,
                                               org.joda.time.LocalDate upToDate,
                                               TenantContext context)

Find unpaid invoices for a given account, up to a given day.

Parameters:

accountId - account id

upToDate - the latest target day to consider, in the account timezone

context - the tenant context

Returns:

a collection of invoices

triggerInvoiceGeneration

Invoice triggerInvoiceGeneration(UUID accountId,
                               org.joda.time.LocalDate targetDate,
                               boolean dryRun,
                               CallContext context)
                                 throws InvoiceApiException

Trigger an invoice for a given account and a given day.

Parameters:

accountId - account id

targetDate - the target day, in the account timezone

dryRun - dry run mode or not

context - the call context

Returns:

the invoice generated

Throws:

InvoiceApiException

tagInvoiceAsWrittenOff

void tagInvoiceAsWrittenOff(UUID invoiceId,
                          CallContext context)
                            throws TagApiException,
                                   InvoiceApiException

Mark an invoice as written off.

Parameters:

invoiceId - invoice id

context - call context

Throws:

TagApiException

InvoiceApiException

tagInvoiceAsNotWrittenOff

void tagInvoiceAsNotWrittenOff(UUID invoiceId,
                             CallContext context)
                               throws TagApiException,
                                      InvoiceApiException

Unmark an invoice as written off.

Parameters:

invoiceId - invoice id

context - call context

Throws:

TagApiException

InvoiceApiException

getExternalChargeById

InvoiceItem getExternalChargeById(UUID externalChargeId,
                                TenantContext context)
                                  throws InvoiceApiException

Retrieve an external charge by id.

Parameters:

externalChargeId - external charge id

context - the tenant context

Returns:

the external charge

Throws:

InvoiceApiException

insertExternalCharges

List<InvoiceItem> insertExternalCharges(UUID accountId,
                                      org.joda.time.LocalDate effectiveDate,
                                      Iterable<InvoiceItem> charges,
                                      CallContext context)
                                        throws InvoiceApiException

Add one or multiple external charges to an account.

Parameters:

accountId - account id

effectiveDate - the effective date for newly created invoices (in the account timezone)

charges - the charges

context - the call context

Returns:

the external charges invoice items

Throws:

InvoiceApiException

getCreditById

InvoiceItem getCreditById(UUID creditId,
                        TenantContext context)
                          throws InvoiceApiException

Retrieve a credit by id.

Parameters:

creditId - credit id

context - the tenant context

Returns:

the credit

Throws:

InvoiceApiException

insertCredit

InvoiceItem insertCredit(UUID accountId,
                       BigDecimal amount,
                       org.joda.time.LocalDate effectiveDate,
                       Currency currency,
                       CallContext context)
                         throws InvoiceApiException

Add a credit to an account.

Parameters:

accountId - account id

amount - the credit amount

effectiveDate - the day to grant the credit, in the account timezone

currency - the credit currency

context - the call context

Returns:

the credit invoice item

Throws:

InvoiceApiException

insertCreditForInvoice

InvoiceItem insertCreditForInvoice(UUID accountId,
                                 UUID invoiceId,
                                 BigDecimal amount,
                                 org.joda.time.LocalDate effectiveDate,
                                 Currency currency,
                                 CallContext context)
                                   throws InvoiceApiException

Add a credit to an invoice. This can be used to adjust invoices.

Parameters:

accountId - account id

invoiceId - invoice id

amount - the credit amount

effectiveDate - the day to grant the credit, in the account timezone

currency - the credit currency

context - the call context

Returns:

the credit invoice item

Throws:

InvoiceApiException

insertInvoiceItemAdjustment

InvoiceItem insertInvoiceItemAdjustment(UUID accountId,
                                      UUID invoiceId,
                                      UUID invoiceItemId,
                                      org.joda.time.LocalDate effectiveDate,
                                      CallContext context)
                                        throws InvoiceApiException

Adjust fully a given invoice item.

Parameters:

accountId - account id

invoiceId - invoice id

invoiceItemId - invoice item id

effectiveDate - the effective date for this adjustment invoice item (in the account timezone)

context - the call context

Returns:

the adjustment invoice item

Throws:

InvoiceApiException

insertInvoiceItemAdjustment

InvoiceItem insertInvoiceItemAdjustment(UUID accountId,
                                      UUID invoiceId,
                                      UUID invoiceItemId,
                                      org.joda.time.LocalDate effectiveDate,
                                      BigDecimal amount,
                                      Currency currency,
                                      CallContext context)
                                        throws InvoiceApiException

Adjust partially a given invoice item.

Parameters:

accountId - account id

invoiceId - invoice id

invoiceItemId - invoice item id

effectiveDate - the effective date for this adjustment invoice item (in the account timezone)

amount - the adjustment amount

currency - adjustment currency

context - the call context

Returns:

the adjustment invoice item

Throws:

InvoiceApiException

deleteCBA

void deleteCBA(UUID accountId,
             UUID invoiceId,
             UUID invoiceItemId,
             CallContext context)
               throws InvoiceApiException

Delete a CBA item.

Parameters:

accountId - account id

invoiceId - invoice id

invoiceItemId - invoice item id (must be of type CBA_ADJ)

context - the call context

Throws:

InvoiceApiException

getInvoiceAsHTML

String getInvoiceAsHTML(UUID invoiceId,
                      TenantContext context)
                        throws AccountApiException,
                               IOException,
                               InvoiceApiException

Retrieve the invoice formatted in HTML.

Parameters:

invoiceId - invoice id

context - the tenant context

Returns:

the invoice in HTML format

Throws:

AccountApiException

IOException

InvoiceApiException

consumeExstingCBAOnAccountWithUnpaidInvoices

void consumeExstingCBAOnAccountWithUnpaidInvoices(UUID accountId,
                                                CallContext context)

Rebalance CBA for account which have credit and unpaid invoices-- only needed if system is configured to not rebalance automatically.

Parameters:

accountId - account id

context - the callcontext