Class Invoice
java.lang.Object
com.softlayer.api.Type
com.softlayer.api.service.Entity
com.softlayer.api.service.billing.Invoice
@ApiType("SoftLayer_Billing_Invoice") public class Invoice extends Entity
The SoftLayer_Billing_Invoice data type contains general information relating to an individual invoice applied to a SoftLayer customer account. Personal information in this type such as names, addresses, and phone numbers are taken from the account's contact information at the time the invoice is generated.
- See Also:
- SoftLayer_Billing_Invoice
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
Invoice.Mask
static interface
Invoice.Service
The SoftLayer_Billing_Invoice service controls the invoices that are created whenever a SoftLayer customer's account balance changes.static interface
Invoice.ServiceAsync
-
Field Summary
Fields Modifier and Type Field Description protected Account
account
The account that an invoice belongs to.protected Long
accountId
The SoftLayer customer account that an invoice belongs to.protected boolean
accountIdSpecified
protected String
address1
The first line of an address belonging to an account at the time an invoice is created.protected boolean
address1Specified
protected String
address2
The second line of an address belonging to an account at the time an invoice is created.protected boolean
address2Specified
protected BigDecimal
amount
This is the amount of this invoice.protected Brand
brandAtInvoiceCreation
protected String
city
The city portion of an address belonging to an account at the time an invoice is created.protected boolean
citySpecified
protected Boolean
claimedTaxExemptTxFlag
Whether an account was exempt from taxes on their invoices at the time an invoice is created.protected boolean
claimedTaxExemptTxFlagSpecified
protected GregorianCalendar
closedDate
The date an invoice was closed.protected boolean
closedDateSpecified
protected String
companyName
The company name belonging to an account at the time an invoice is created.protected boolean
companyNameSpecified
protected String
country
A two-letter abbreviation of the country portion of an address belonging to an account at the time an invoice is created.protected boolean
countrySpecified
protected GregorianCalendar
createDate
The date an invoice was created.protected boolean
createDateSpecified
protected Boolean
detailedPdfGeneratedFlag
A flag that will reflect whether the detailed version of the pdf has been generated.protected Boolean
documentsGeneratedFlag
protected boolean
documentsGeneratedFlagSpecified
protected String
email
The email address belonging to an account at the time an invoice is created.protected boolean
emailSpecified
protected BigDecimal
endingBalance
An SoftLayer account's balance at the time an invoice is closed.protected boolean
endingBalanceSpecified
protected String
faxPhone
The fax telephone number belonging to an account at the time an invoice is created.protected boolean
faxPhoneSpecified
protected String
firstName
The first name of the account holder at the time an invoice is created.protected boolean
firstNameSpecified
protected Long
id
An invoice's internal identifier.protected boolean
idSpecified
protected Long
invoiceTopLevelItemCount
A count of a list of top-level invoice items that are on the currently pending invoice.protected List<Item>
invoiceTopLevelItems
A list of top-level invoice items that are on the currently pending invoice.protected BigDecimal
invoiceTotalAmount
The total amount of this invoice.protected BigDecimal
invoiceTotalOneTimeAmount
The total one-time charges for this invoice.protected BigDecimal
invoiceTotalOneTimeTaxAmount
A sum of all the taxes related to one time charges for this invoice.protected BigDecimal
invoiceTotalPreTaxAmount
The total amount of this invoice.protected BigDecimal
invoiceTotalRecurringAmount
The total Recurring amount of this invoice.protected BigDecimal
invoiceTotalRecurringTaxAmount
The total amount of the recurring taxes on this invoice.protected Long
itemCount
A count of the items that belong to this invoice.protected List<Item>
items
The items that belong to this invoice.protected String
lastName
The last name of the account holder at the time an invoice is created.protected boolean
lastNameSpecified
protected ExchangeRate
localCurrencyExchangeRate
Exchange rate used for billing this invoice.protected GregorianCalendar
modifyDate
The date an invoice was last modified.protected boolean
modifyDateSpecified
protected String
officePhone
The telephone number belonging to an account at the time an invoice is created.protected boolean
officePhoneSpecified
protected BigDecimal
payment
This is the total payment made on this invoice.protected Long
paymentCount
A count of the payments for the invoice.protected List<Payment>
payments
The payments for the invoice.protected String
postalCode
The postal code portion of an address belonging to an account at the time an invoice is created.protected boolean
postalCodeSpecified
protected String
purchaseOrderNumber
protected boolean
purchaseOrderNumberSpecified
protected String
sellerRegistration
This is the seller's tax registration.protected BigDecimal
startingBalance
An SoftLayer account's balance at the time an invoice is created.protected boolean
startingBalanceSpecified
protected String
state
A two-letter abbreviation of the state portion of an address belonging to an account at the time an invoice is created.protected boolean
stateSpecified
protected String
statusCode
An invoice's status.protected boolean
statusCodeSpecified
protected Info
taxInfo
This is the tax information that applies to tax auditing.protected List<Info>
taxInfoHistory
This is the set of tax information for any tax calculation for this invoice.protected Long
taxInfoHistoryCount
A count of this is the set of tax information for any tax calculation for this invoice.protected String
taxMessage
This is a message explaining the tax treatment for this invoice.protected Long
taxStatusId
protected boolean
taxStatusIdSpecified
protected Type
taxType
This is the strategy used to calculate tax on this invoice.protected Long
taxTypeId
protected boolean
taxTypeIdSpecified
protected String
typeCode
An invoice's type.protected boolean
typeCodeSpecified
Fields inherited from class com.softlayer.api.Type
unknownProperties
-
Constructor Summary
Constructors Constructor Description Invoice()
-
Method Summary
Methods inherited from class com.softlayer.api.Type
getUnknownProperties, setUnknownProperties
-
Field Details
-
account
The account that an invoice belongs to. -
amount
This is the amount of this invoice. -
brandAtInvoiceCreation
-
detailedPdfGeneratedFlag
A flag that will reflect whether the detailed version of the pdf has been generated. -
invoiceTopLevelItems
A list of top-level invoice items that are on the currently pending invoice. -
invoiceTotalAmount
The total amount of this invoice. -
invoiceTotalOneTimeAmount
The total one-time charges for this invoice. This is the sum of one-time charges + setup fees + labor fees. This does not include taxes. -
invoiceTotalOneTimeTaxAmount
A sum of all the taxes related to one time charges for this invoice. -
invoiceTotalPreTaxAmount
The total amount of this invoice. This does not include taxes. -
invoiceTotalRecurringAmount
The total Recurring amount of this invoice. This amount does not include taxes or one time charges. -
invoiceTotalRecurringTaxAmount
The total amount of the recurring taxes on this invoice. -
items
The items that belong to this invoice. -
localCurrencyExchangeRate
Exchange rate used for billing this invoice. -
payment
This is the total payment made on this invoice. -
payments
The payments for the invoice. -
sellerRegistration
This is the seller's tax registration. -
taxInfo
This is the tax information that applies to tax auditing. This is the official tax record for this invoice. -
taxInfoHistory
This is the set of tax information for any tax calculation for this invoice. Note that not all of these are necessarily official, so use the taxInfo key to get the final information. -
taxMessage
This is a message explaining the tax treatment for this invoice. -
taxType
This is the strategy used to calculate tax on this invoice. -
accountId
The SoftLayer customer account that an invoice belongs to. -
accountIdSpecified
protected boolean accountIdSpecified -
address1
The first line of an address belonging to an account at the time an invoice is created. -
address1Specified
protected boolean address1Specified -
address2
The second line of an address belonging to an account at the time an invoice is created. -
address2Specified
protected boolean address2Specified -
city
The city portion of an address belonging to an account at the time an invoice is created. -
citySpecified
protected boolean citySpecified -
claimedTaxExemptTxFlag
Whether an account was exempt from taxes on their invoices at the time an invoice is created. -
claimedTaxExemptTxFlagSpecified
protected boolean claimedTaxExemptTxFlagSpecified -
closedDate
The date an invoice was closed. Open invoices have a null closed date. -
closedDateSpecified
protected boolean closedDateSpecified -
companyName
The company name belonging to an account at the time an invoice is created. -
companyNameSpecified
protected boolean companyNameSpecified -
country
A two-letter abbreviation of the country portion of an address belonging to an account at the time an invoice is created. -
countrySpecified
protected boolean countrySpecified -
createDate
The date an invoice was created. -
createDateSpecified
protected boolean createDateSpecified -
documentsGeneratedFlag
-
documentsGeneratedFlagSpecified
protected boolean documentsGeneratedFlagSpecified -
email
The email address belonging to an account at the time an invoice is created. -
emailSpecified
protected boolean emailSpecified -
endingBalance
An SoftLayer account's balance at the time an invoice is closed. This value is measured in US Dollar ($USD) currency. -
endingBalanceSpecified
protected boolean endingBalanceSpecified -
faxPhone
The fax telephone number belonging to an account at the time an invoice is created. -
faxPhoneSpecified
protected boolean faxPhoneSpecified -
firstName
The first name of the account holder at the time an invoice is created. -
firstNameSpecified
protected boolean firstNameSpecified -
id
An invoice's internal identifier. -
idSpecified
protected boolean idSpecified -
lastName
The last name of the account holder at the time an invoice is created. -
lastNameSpecified
protected boolean lastNameSpecified -
modifyDate
The date an invoice was last modified. -
modifyDateSpecified
protected boolean modifyDateSpecified -
officePhone
The telephone number belonging to an account at the time an invoice is created. -
officePhoneSpecified
protected boolean officePhoneSpecified -
postalCode
The postal code portion of an address belonging to an account at the time an invoice is created. -
postalCodeSpecified
protected boolean postalCodeSpecified -
purchaseOrderNumber
-
purchaseOrderNumberSpecified
protected boolean purchaseOrderNumberSpecified -
startingBalance
An SoftLayer account's balance at the time an invoice is created. This value is measured in US Dollar ($USD) currency. -
startingBalanceSpecified
protected boolean startingBalanceSpecified -
state
A two-letter abbreviation of the state portion of an address belonging to an account at the time an invoice is created. If the account that the invoice was generated for resides outside a province then this is set to "other". -
stateSpecified
protected boolean stateSpecified -
statusCode
An invoice's status. The "OPEN" status means SoftLayer has not yet received payment for this invoice. "CLOSED" status means that SoftLayer has received payment and closed the invoice. The "CLOSED_FAILED" status code means SoftLayer closed the invoice without receiving a payment. Invoices are usually set to CLOSED_FAILED status in cases where customer accounts are terminated for non-payment. -
statusCodeSpecified
protected boolean statusCodeSpecified -
taxStatusId
-
taxStatusIdSpecified
protected boolean taxStatusIdSpecified -
taxTypeId
-
taxTypeIdSpecified
protected boolean taxTypeIdSpecified -
typeCode
An invoice's type. SoftLayer invoices and service credits are differentiated by their type. The "NEW" type code signifies an invoice for new service. A SoftLayer customer's first invoice has the NEW type code. "RECURRING" invoices are generated on a SoftLayer customer's anniversary billing date for monthly services. "ONE-TIME-CHARGE" invoices are generated when one-time charges are applied to an account. "CREDIT" invoices are generated whenever SoftLayer applies a credit against an account's balance. There are two special types of service credits. "REFUND" type credits are applied against a customer's account balance along with the receivables on their account. "MANUAL_PAYMENT_CREDIT" invoice credits are generated whenever a customer makes an unscheduled payment. -
typeCodeSpecified
protected boolean typeCodeSpecified -
invoiceTopLevelItemCount
A count of a list of top-level invoice items that are on the currently pending invoice. -
itemCount
A count of the items that belong to this invoice. -
paymentCount
A count of the payments for the invoice. -
taxInfoHistoryCount
A count of this is the set of tax information for any tax calculation for this invoice. Note that not all of these are necessarily official, so use the taxInfo key to get the final information.
-
-
Constructor Details
-
Invoice
public Invoice()
-
-
Method Details
-
getAccount
-
setAccount
-
getAmount
-
setAmount
-
getBrandAtInvoiceCreation
-
setBrandAtInvoiceCreation
-
getDetailedPdfGeneratedFlag
-
setDetailedPdfGeneratedFlag
-
getInvoiceTopLevelItems
-
getInvoiceTotalAmount
-
setInvoiceTotalAmount
-
getInvoiceTotalOneTimeAmount
-
setInvoiceTotalOneTimeAmount
-
getInvoiceTotalOneTimeTaxAmount
-
setInvoiceTotalOneTimeTaxAmount
-
getInvoiceTotalPreTaxAmount
-
setInvoiceTotalPreTaxAmount
-
getInvoiceTotalRecurringAmount
-
setInvoiceTotalRecurringAmount
-
getInvoiceTotalRecurringTaxAmount
-
setInvoiceTotalRecurringTaxAmount
-
getItems
-
getLocalCurrencyExchangeRate
-
setLocalCurrencyExchangeRate
-
getPayment
-
setPayment
-
getPayments
-
getSellerRegistration
-
setSellerRegistration
-
getTaxInfo
-
setTaxInfo
-
getTaxInfoHistory
-
getTaxMessage
-
setTaxMessage
-
getTaxType
-
setTaxType
-
getAccountId
-
setAccountId
-
isAccountIdSpecified
public boolean isAccountIdSpecified() -
unsetAccountId
public void unsetAccountId() -
getAddress1
-
setAddress1
-
isAddress1Specified
public boolean isAddress1Specified() -
unsetAddress1
public void unsetAddress1() -
getAddress2
-
setAddress2
-
isAddress2Specified
public boolean isAddress2Specified() -
unsetAddress2
public void unsetAddress2() -
getCity
-
setCity
-
isCitySpecified
public boolean isCitySpecified() -
unsetCity
public void unsetCity() -
getClaimedTaxExemptTxFlag
-
setClaimedTaxExemptTxFlag
-
isClaimedTaxExemptTxFlagSpecified
public boolean isClaimedTaxExemptTxFlagSpecified() -
unsetClaimedTaxExemptTxFlag
public void unsetClaimedTaxExemptTxFlag() -
getClosedDate
-
setClosedDate
-
isClosedDateSpecified
public boolean isClosedDateSpecified() -
unsetClosedDate
public void unsetClosedDate() -
getCompanyName
-
setCompanyName
-
isCompanyNameSpecified
public boolean isCompanyNameSpecified() -
unsetCompanyName
public void unsetCompanyName() -
getCountry
-
setCountry
-
isCountrySpecified
public boolean isCountrySpecified() -
unsetCountry
public void unsetCountry() -
getCreateDate
-
setCreateDate
-
isCreateDateSpecified
public boolean isCreateDateSpecified() -
unsetCreateDate
public void unsetCreateDate() -
getDocumentsGeneratedFlag
-
setDocumentsGeneratedFlag
-
isDocumentsGeneratedFlagSpecified
public boolean isDocumentsGeneratedFlagSpecified() -
unsetDocumentsGeneratedFlag
public void unsetDocumentsGeneratedFlag() -
getEmail
-
setEmail
-
isEmailSpecified
public boolean isEmailSpecified() -
unsetEmail
public void unsetEmail() -
getEndingBalance
-
setEndingBalance
-
isEndingBalanceSpecified
public boolean isEndingBalanceSpecified() -
unsetEndingBalance
public void unsetEndingBalance() -
getFaxPhone
-
setFaxPhone
-
isFaxPhoneSpecified
public boolean isFaxPhoneSpecified() -
unsetFaxPhone
public void unsetFaxPhone() -
getFirstName
-
setFirstName
-
isFirstNameSpecified
public boolean isFirstNameSpecified() -
unsetFirstName
public void unsetFirstName() -
getId
-
setId
-
isIdSpecified
public boolean isIdSpecified() -
unsetId
public void unsetId() -
getLastName
-
setLastName
-
isLastNameSpecified
public boolean isLastNameSpecified() -
unsetLastName
public void unsetLastName() -
getModifyDate
-
setModifyDate
-
isModifyDateSpecified
public boolean isModifyDateSpecified() -
unsetModifyDate
public void unsetModifyDate() -
getOfficePhone
-
setOfficePhone
-
isOfficePhoneSpecified
public boolean isOfficePhoneSpecified() -
unsetOfficePhone
public void unsetOfficePhone() -
getPostalCode
-
setPostalCode
-
isPostalCodeSpecified
public boolean isPostalCodeSpecified() -
unsetPostalCode
public void unsetPostalCode() -
getPurchaseOrderNumber
-
setPurchaseOrderNumber
-
isPurchaseOrderNumberSpecified
public boolean isPurchaseOrderNumberSpecified() -
unsetPurchaseOrderNumber
public void unsetPurchaseOrderNumber() -
getStartingBalance
-
setStartingBalance
-
isStartingBalanceSpecified
public boolean isStartingBalanceSpecified() -
unsetStartingBalance
public void unsetStartingBalance() -
getState
-
setState
-
isStateSpecified
public boolean isStateSpecified() -
unsetState
public void unsetState() -
getStatusCode
-
setStatusCode
-
isStatusCodeSpecified
public boolean isStatusCodeSpecified() -
unsetStatusCode
public void unsetStatusCode() -
getTaxStatusId
-
setTaxStatusId
-
isTaxStatusIdSpecified
public boolean isTaxStatusIdSpecified() -
unsetTaxStatusId
public void unsetTaxStatusId() -
getTaxTypeId
-
setTaxTypeId
-
isTaxTypeIdSpecified
public boolean isTaxTypeIdSpecified() -
unsetTaxTypeId
public void unsetTaxTypeId() -
getTypeCode
-
setTypeCode
-
isTypeCodeSpecified
public boolean isTypeCodeSpecified() -
unsetTypeCode
public void unsetTypeCode() -
getInvoiceTopLevelItemCount
-
setInvoiceTopLevelItemCount
-
getItemCount
-
setItemCount
-
getPaymentCount
-
setPaymentCount
-
getTaxInfoHistoryCount
-
setTaxInfoHistoryCount
-
asService
-
service
-
service
-