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 

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