blng__InvoiceLine__c

Represents the amount that a buyer must pay for a product, service, or fee. Invoice lines are created based on the amount of an order line.

Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.

Important

Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

Fields

Field Details
AVA_BLNG__Invoice_Message__c
Type
textarea
Properties
Create, Nillable, Update
Description
A summary of the invoice.
CurrencyIsoCode
Type
picklist
Properties
Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description
The three-letter ISO 4217 currency code associated with the invoice line when multiple currencies are enabled.
LastActivityDate
Type
date
Properties
Filter, Group, Nillable, Sort
Description
The timestamp of when a user had last associated a task or event action with the invoice line.
Name
Type
string
Properties
Create, Defaulted on create, Filter, Group, idLookup, Nillable, Sort, Update
Description
The name of the invoice line.
blng__ARStatus__c
Type
picklist
Properties
Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description
Specifies whether the invoice line has been credited, or canceled and rebilled. Valid values are:
  • Cancel and Rebill
  • Credited
blng__AllocatedRevenueAmount__c
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The total revenue impact of this invoice line. Possible scenarios of the allocated revenue amount:
  • Can differ from the subtotal and total amount (with tax).
  • Used when reallocating revenue among several transactions.
  • Can be configured to create revenue schedules for this invoice line using this field as the amount.
blng__Asset__c
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Inherited by default from the Lifecycle-Managed Asset field on the invoice line’s parent order product. This field can be overridden with a different asset. This is a relationship field.
Relationship Name
blng__Asset__r
Relationship Type
Lookup
Refers To
Asset
blng__Balance__c
Type
currency
Properties
Filter, Nillable, Sort
Description
The total amount of the invoice that isn’t settled, which equals total amount (with tax) − allocations + unallocations. This is a calculated field.
blng__BalancewithoutDebits__c
Type
currency
Properties
Filter, Nillable, Sort
Description
The total amount of the invoice that isn’t settled, excluding debit note allocations. The balance without debits amount equals the total amount (with tax) − payments + unallocations against invoice lines − credits. This is a calculated field.
blng__BaseCurrencyAmount__c
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The credit note line’s total amount, converted into the base currency.
blng__BaseCurrencyFXDate__c
Type
date
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The date used to determine the foreign exchange rate when calculating the base currency amount.
blng__BaseCurrencyFXRate__c
Type
double
Properties
Create, Filter, Nillable, Sort, Update
Description
The FX rate used to convert the credit note amount to the base currency amount.
blng__BaseCurrency__c
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The base currency of this credit note line that’s used for reporting purposes.
blng__BillingFinanceBook__c
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
This invoice line’s transactions report to this finance book. This is a relationship field.
Relationship Name
blng__BillingFinanceBook__r
Relationship Type
Lookup
Refers To
blng__FinanceBook__c
blng__BillingFinancePeriod__c
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The invoice line’s transactions report to a finance period within the finance book. This is a relationship field.
Relationship Name
blng__BillingFinancePeriod__r
Relationship Type
Lookup
Refers To
blng__FinancePeriod__c
blng__BillingFrequency__c
Type
picklist
Properties
Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description
Indicates how frequently Salesforce Billing invoices the invoice line’s originating order product. Valid values are:
  • Annual
  • Invoice Plan
  • Monthly
  • Quarterly
  • Semiannual
blng__BillingGLRule__c
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Defines the general ledger (GL) treatment for this invoice line. This is a relationship field.
Relationship Name
blng__BillingGLRule__r
Relationship Type
Lookup
Refers To
blng__GLRule__c
blng__BillingGLTreatment__c
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Defines the debit and credit GL accounts that record this invoice line. This is a relationship field.
Relationship Name
blng__BillingGLTreatment__r
Relationship Type
Lookup
Refers To
blng__GLTreatment__c
blng__BillingRule__c
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The lookup to the billing rule used to generate this invoice line. This is a relationship field.
Relationship Name
blng__BillingRule__r
Relationship Type
Lookup
Refers To
blng__BillingRule__c
blng__BillingTransaction__c
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The billing transaction associated with the invoice line. This is a relationship field.
Relationship Name
blng__BillingTransaction__r
Relationship Type
Lookup
Refers To
blng__BillingTransaction__c
blng__BillingTreatment__c
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The lookup to the billing treatment used to generate this invoice line. This is a relationship field.
Relationship Name
blng__BillingTreatment__r
Relationship Type
Lookup
Refers To
blng__BillingTreatment__c
blng__CalculatedQuantity__c
Type
double
Properties
Create, Filter, Nillable, Sort, Update
Description
The number of billing periods charged on the invoice line.
blng__ChargeDate__c
Type
date
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Specifies the transaction date of the invoice line.
blng__ChargeType__c
Type
picklist
Properties
Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description
Specifies if the invoice line is recurring, one-time, or usage (legacy). Possible values are:
  • One-Time
  • Recurring
  • Usage
blng__ConvertedCreditNoteLine__c
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
For converted negative invoice lines, the credit note line is created as part of the conversion. This is a relationship field.
Relationship Name
blng__ConvertedCreditNoteLine__r
Relationship Type
Lookup
Refers To
blng__CreditNoteLine__c
blng__Credits__c
Type
currency
Properties
Filter, Nillable, Sort
Description
The sum of all credit note lines allocated to this invoice line. This is a calculated field.
blng__DaysPastDue__c
Type
double
Properties
Filter, Nillable, Sort
Description
The number of days past the invoice line due date. This is a calculated field.
blng__DebitPayments__c
Type
currency
Properties
Filter, Nillable, Sort
Description
The net amount of all payments made to debit note allocations on this invoice line. The debit payments equals the debits (payment allocations) − debits (payment unallocations). This is a calculated field.
blng__DebitsPaymentAllocations__c
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The sum of all payments made against the debit note allocated to this invoice line.
blng__DebitsPaymentUnallocations__c
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The sum of all payments unallocated from debit notes allocated to this invoice line.
blng__Debits__c
Type
currency
Properties
Filter, Nillable, Sort
Description
The sum of all debit note lines allocated to this invoice line. This is a calculated field.
blng__DueDate__c
Type
date
Properties
Filter, Group, Nillable, Sort
Description
The date by which customers must pay their invoice line. This is a calculated field.
blng__EndDate__c
Type
date
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The end date of the billed period for this invoice line. This value can impact the revenue.
blng__GroupedQuantity__c
Type
double
Properties
Create, Filter, Nillable, Sort, Update
Description
Salesforce Billing creates invoice lines for different groups of order products based on several order and order product fields.
blng__ImpactAmount__c
Type
currency
Properties
Filter, Nillable, Sort
Description
The change to net receivables as a result of this credit note line. Positive credit note lines have a negative impact amount because they reduce the overall amount owed to the company. This is a calculated field.
blng__InvoiceLineState__c
Type
picklist
Properties
Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description
Specifies if the invoice line is marked. Valid values are:
  • Merged— The invoice line contains invoice sublines.
  • Regular— The invoice line is standard and doesn’t include sublines.
The default value is Regular.
blng__InvoiceLineStatus__c
Type
picklist
Properties
Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description
The status of the invoice line and is inherited from the invoice’s status. Valid values are:
  • Cancelled
  • Draft
  • Error
  • Initiated
  • Post In progress
  • Posted
  • Rebilled
The default value is Draft.
blng__InvoiceRun__c
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The invoice run that created this invoice line. This is a relationship field.
Relationship Name
blng__InvoiceRun__r
Relationship Type
Lookup
Refers To
blng__InvoiceRun__c
blng__Invoice__c
Type
reference
Properties
Create, Filter, Group, Sort
Description
The parent invoice for this invoice line. This is a relationship field.
Relationship Name
blng__Invoice__r
Relationship Type
Master-detail
Refers To
blng__Invoice__c (the master object)
blng__LegalEntityReference__c
Type
string
Properties
Create, Filter, Group, idLookup, Nillable, Sort, Update
Description
blng__LegalEntity__c
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The lookup to this invoice line’s legal entity. Legal entities control which treatments are associated with this invoice line. This is a relationship field.
Relationship Name
blng__LegalEntity__r
Relationship Type
Lookup
Refers To
blng__LegalEntity__c
blng__NegativeLineConversion__c
Type
currency
Properties
Create, Defaulted on create, Filter, Nillable, Sort, Update
Description
The total amount of this invoice that’s converted to a credit note line. Only negative invoice lines are converted.
blng__NetAllocationsAgainstInvoiceLines__c
Type
currency
Properties
Filter, Nillable, Sort
Description
The net amount of all payments made against this invoice line, which equals (allocations against invoice lines) − (unallocations against invoice lines). This is a calculated field.
blng__Notes__c
Type
textarea
Properties
Create, Nillable, Update
Description
Reference notes that users can add. Notes fields don’t have associated system logic.
blng__OrderProduct__c
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The order product that generated the invoice line. This is a relationship field.
Relationship Name
blng__OrderProduct__r
Relationship Type
Lookup
Refers To
OrderItem
blng__OverrideInitialRevenueEndDate__c
Type
date
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
This field enables users to override the revenue period’s configured end date when creating revenue schedules.
blng__OverrideInitialRevenueStartDate__c
Type
date
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
This field enables users to override the revenue period’s configured start date when creating revenue schedules.
blng__PaymentsAgainstDebitNoteLines__c
Type
currency
Properties
Filter, Nillable, Sort
Description
The sum of payments made to debit notes allocated against the invoice and its invoice lines. This is a calculated field.
blng__PaymentsAgainstInvoiceLines__c
Type
currency
Properties
Filter, Nillable, Sort
Description
The total number of payment allocations made against the invoice lines. This is a calculated field.
blng__Payments__c
Type
currency
Properties
Filter, Nillable, Sort
Description
The net amount of payments against this invoice line and any of its allocated debit note lines, which equals the (amount allocated against invoice line) + (amount allocated against debit note lines) − (amount unallocated against invoice lines) − (amount unallocated against debit note lines). This is a calculated field.
blng__Product__c
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Product that created the order product being invoiced. This is a relationship field.
Relationship Name
blng__Product__r
Relationship Type
Lookup
Refers To
Product2
blng__Quantity__c
Type
double
Properties
Create, Filter, Nillable, Sort, Update
Description
Quantity invoiced from the order product.
blng__RefundsAgainstDebitNoteLines__c
Type
currency
Properties
Filter, Nillable, Sort
Description
This field is a calculated field.
blng__RefundsAgainstInvoiceLines__c
Type
currency
Properties
Filter, Nillable, Sort
Description
This field is a calculated field.
blng__RevenueExpectedAmount__c
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
This user-defined field is the expected revenue impact of this credit note line, if different from the credit note line amount. The revenue expected amount can:
  • Differ from the subtotal and total amount (with tax).
  • Be configured to create revenue schedules for this credit note line using this field as the amount on the revenue schedule.
blng__RevenueLiabilityAmount__c
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
This user-defined field is the revenue liability associated with this credit note line. The revenue liability amount can:
  • Differ from the subtotal and total amount (with tax).
  • Be configured to create revenue schedules for this credit note line using this field as the amount on the revenue schedule.
blng__RevenueMostLikelyAmount__c
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
This user-defined field is the most likely revenue impact of this credit note line for revenue calculations when the revenue amount is uncertain. This field can differ from the subtotal and total amount (with tax).
blng__RevenueScheduleStatus__c
Type
picklist
Properties
Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description
Specifies the status of the revenue schedule creation for this invoice line. Valid values are:
  • Complete
  • Error
  • Queued
blng__StartDate__c
Type
date
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The start date of the billed period for this invoice line. This value can impact the revenue. See Salesforce Help for details on revenue recognition.
blng__Subtotal__c
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The total amount to settle on this invoice line, excluding tax.
blng__TaxAmount__c
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The total tax owed on this invoice line.
blng__TaxCity__c
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The city used during tax calculation. The invoice’s tax address fields are used only if the invoice line’s tax address fields are blank.
blng__TaxCountry__c
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The country used during tax calculation. The invoice’s tax address fields are used only if the invoice line’s tax address fields are blank.
blng__TaxCounty__c
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The county used during tax calculation. The invoice’s tax address fields are used only if the invoice line’s tax address fields are blank.
blng__TaxErrorMessage__c
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Descriptions of errors that occur during tax calculation.
blng__TaxError__c
Type
double
Properties
Filter, Nillable, Sort
Description
Specifies a problem with the tax details associated with the invoice line. This is a calculated field.
blng__TaxGLRule__c
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The lookup to the GL rule that defines the GL treatment of the tax for this invoice line. This is a relationship field.
Relationship Name
blng__TaxGLRule__r
Relationship Type
Lookup
Refers To
blng__GLRule__c
blng__TaxGLTreatment__c
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The lookup to the GL treatment that defines the debit and credit GL accounts used to record the tax for this invoice line. This is a relationship field.
Relationship Name
blng__TaxGLTreatment__r
Relationship Type
Lookup
Refers To
blng__GLTreatment__c
blng__TaxLocationCode__c
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The location code used during tax calculation. The invoice’s tax address fields are used only if the invoice line’s tax address fields are blank.
blng__TaxPercentageApplied__c
Type
percent
Properties
Create, Filter, Nillable, Sort, Update
Description
The total tax percentage applied to the invoice line and is null if the line is nontaxable.
blng__TaxRule__c
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Lookup to the tax rule that defines the tax engine and tax data, such as address and date, to use when calculating tax for this invoice line. This is a relationship field.
Relationship Name
blng__TaxRule__r
Relationship Type
Lookup
Refers To
blng__TaxRule__c
blng__TaxState__c
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The state used during tax calculation. The invoice’s tax address fields are used only if the invoice line’s tax address fields are blank.
blng__TaxStatus__c
Type
picklist
Properties
Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description
The status of the tax calculation for this invoice line. Valid values are:
  • Completed
  • Copied
  • Error
  • Processing
  • Queued
  • Warning
blng__TaxStreet2__c
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The street address used during tax calculation. The invoice’s tax address fields are used only if the invoice line’s tax address fields are blank.
blng__TaxStreet__c
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The street address used during tax calculation. The invoice’s tax address fields are used only if the invoice line’s tax address fields are blank.
blng__TaxTreatment__c
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Lookup to the tax treatment used to generate this invoice line. This is a relationship field.
Relationship Name
blng__TaxTreatment__r
Relationship Type
Lookup
Refers To
blng__TaxTreatment__c
blng__TaxZipCode__c
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The destination ZIP code or postal code used during tax calculation. The invoice’s tax address fields are used only if the invoice line’s tax address fields are blank.
blng__TotalAmount__c
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The subtotal of the invoice line plus tax.
blng__UniqueId__c
Type
string
Properties
Create, Filter, Group, idLookup, Nillable, Sort, Update
Description
This field is system-generated and not updated or changed by users.
blng__UnitPrice__c
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The price of the order product.
blng__UsageSummary__c
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Lookup to the usage summary that was used to create the invoice line and is blank unless the usage summary is the source for the invoice line. This is a relationship field.
Relationship Name
blng__UsageSummary__r
Relationship Type
Lookup
Refers To
blng__UsageSummary__c