--- schema_version: "1" id: 9c9261326dbd8f35f03304da771d3f16d614720a933f0baf2a6261abcde7e259 title: InvoiceLine collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_invoiceline.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_invoiceline.htm source_site: developer.salesforce.com content_type: documentation content_hash: 21467c37289b6b10bcb35ef3e54e387c08b3ef0d7c2cc32edcf9da0d7e2ced21 description: 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. This object is available in API version 48.0 and later. --- # InvoiceLine 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. This object is available in API version 48.0 and later. ## Supported Calls describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), update() ## Special Access Rules This object is available with Order Management, Subscription Management, and Billing (Revenue Cloud). For information about this object that's available with Billing (Revenue Cloud), including its special access rules, see the [Revenue Cloud Developer Guide](https://developer.salesforce.com/docs/atlas.en-us.264.0.revenue_lifecycle_management_dev_guide.meta/revenue_lifecycle_management_dev_guide/sforce_api_objects_invoiceline.htm "HTML (New Window)"). ## Fields | Field | Details | | --- | --- | | AdjustmentAmount | Type currency Properties Filter, Nillable, Sort Description Sum of adjustments made to the invoice line. | | AdjustmentAmountWithTax | Type currency Properties Filter, Nillable, Sort Description Sum of adjustment amounts, including associated taxes related to the invoice line. | | AdjustmentTaxAmount | Type currency Properties Filter, Nillable, Sort Description Sum of tax adjustments to the invoice line. This field is available in API version 55.0 and later. | | Balance | Type currency Properties Filter, Nillable, Sort Description The outstanding balance for an invoice line. This is equal to the invoice’s total amount with tax after deducting the payments made. | | BillingAddressId | Type reference Properties Filter, Group, Nillable, Sort Description Lookup field to an InvoiceAddressGroup containing the billing address for the invoice line. Assign one InvoiceAddressGroup to the invoiceLine's BillingAddressID, and another InvoiceAddressGroup to the invoiceLine's ShippingAddressId. This field is a relationship field. This field is available in API version 55.0 and later. Relationship Name BillingAddress Relationship Type Lookup Refers To InvoiceAddressGroup | | BillingScheduleGroupId | Type reference Properties Filter, Group, Nillable, Sort, Update Description This field is a relationship field. Relationship Name BillingScheduleGroup Refers To BillingScheduleGroup | | BillingScheduleId | Type reference Properties Filter, Group, Nillable, Sort, Update Description ID of the billing schedule for the invoice line. This field is a relationship field. This field is available in API version 55.0 and later. Relationship Name BillingSchedule Relationship Type Lookup Refers To BillingSchedule | | ChargeAmount | Type currency Properties Filter, Nillable, Sort, Update Description Sum of charges made to the invoice line. | | ChargeAmountWithTax | Type currency Properties Filter, Nillable, Sort Description Amount on a charge invoice line, including tax. This field is available in API version 55.0 and later. | | ChargeTaxAmount | Type currency Properties Filter, Nillable, Sort Description Tax to be applied on a charge invoice line. This field is available in API version 55.0 and later. | | ConvertedNegAmount | Type currency Properties Filter, Nillable, Sort Description The amount from an invoice line that is converted to credit. This field is available in API version 56.0 and later. | | Description | Type string Properties Filter, Group, Nillable, Sort, Update Description Description of the invoice line. | | GroupReferenceEntityItemId | Type reference Properties Filter, Group, Nillable, Sort, Update Description Grouping field for adjustment line items. This field is a polymorphic relationship field. Relationship Name GroupReferenceEntityItem Relationship Type Lookup Refers To OrderItem, OrderItemAdjustmentLineItem | | HasMultipleItems | Type boolean Properties Defaulted on create, Filter, Group, Sort Description Indicates whether this field merges items from the same billing period. The default value is false. | | InvoiceId | Type reference Properties Filter, Group, Sort Description The invoice that contains this invoice line. This field is a relationship field. Relationship Name Invoice Relationship Type Lookup Refers To Invoice | | InvoiceLineEndDate | Type date Properties Filter, Group, Sort, Update Description For invoice lines made from a time-based service, the end date of the billing for the service. | | InvoiceLineStartDate | Type date Properties Filter, Group, Sort, Update Description For invoice lines made from a time-based service, the first date of the billing for the service. | | InvoiceStatus | Type string Properties Filter, Group, Nillable, Sort Description State of the invoice line. Inherited from the invoice’s status. | | LegalEntityAccountingPeriodId | Type reference Properties Filter, Group, Nillable, Sort, Update Description This field is a relationship field. Relationship Name LegalEntityAccountingPeriod Refers To LegalEntyAccountingPeriod | | LegalEntityId | Type reference Properties Filter, Group, Nillable, Sort, Update Description This field is a relationship field. Relationship Name LegalEntity Refers To LegalEntity | | LineAmount | Type currency Properties Filter, Nillable, Sort Description The amount of the invoice line. This field is a calculated field. This field is available in API version 55.0 and later. | | Name | Type string Properties Filter, Group, idLookup, Sort, Update Description Name of the invoice line. | | NetCreditsApplied | Type currency Properties Filter, Nillable, Sort Description The total credit memo line amount applied to the invoice line. This amount is calculated by subtracting the unapplied credit memo line amount from the applied credit memo line amount. This field is a calculated field. | | NetPaymentsApplied | Type currency Properties Filter, Nillable, Sort Description The total payment applied to the invoice line. This amount is calculated by subtracting the unapplied payment amount from the applied payment amount. This field is a calculated field. | | Product2Id | Type reference Properties Filter, Group, Nillable, Sort, Update Description The product that was charged or ordered to create the invoice line. This field is a relationship field. Relationship Name Product2 Relationship Type Lookup Refers To Product2 | | Quantity | Type double Properties Filter, Nillable, Sort, Update Description Number of units of the order product that created the invoice line. | | ReferenceEntityItemId | Type reference Properties Filter, Group, Nillable, Sort, Update Description The order item or adjustment item that created the invoice line. This field is a polymorphic relationship field. Relationship Name ReferenceEntityItem Relationship Type Lookup Refers To OrderItem, OrderItemAdjustmentLineItem | | ReferenceEntityItemType | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort, Update Description The type of transaction that created the invoice line. Possible values are: - DeliveryCharge—Charge - Fee—Charge. This value is available in API version 56.0 and later. - OrderProduct—Product | | ReferenceEntityItemTypeCode | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort, Update Description The type of object that created the invoice line. Possible values are: - Charge - Product | | RelatedLineId | Type reference Properties Filter, Group, Nillable, Sort, Update Description The original invoice line that was adjusted or taxed. This field is a relationship field. Relationship Name RelatedLine Relationship Type Lookup Refers To InvoiceLine | | ShippingAddressId | Type reference Properties Filter, Group, Nillable, Sort Description The ID of the shipping address associated with the invoice line. This field is a relationship field. This field is available in API version 55.0 and later. Relationship Name ShippingAddress Relationship Type Lookup Refers To InvoiceAddressGroup | | TaxAmount | Type currency Properties Filter, Nillable, Sort, Update Description Total tax for the invoice line. | | TaxCode | Type string Properties Filter, Group, Nillable, Sort, Update Description The code used to calculate tax rate for the invoice line. | | TaxDocumentNumber | Type string Properties Filter, Group, Nillable, Sort Description Represents the latest record in the external tax engine in which this invoice line item is included. This field is available in API version 55.0 and later. | | TaxEffectiveDate | Type date Properties Filter, Group, Nillable, Sort, Update Description The date used to calculate the invoice line’s TaxAmount. | | TaxName | Type string Properties Filter, Group, Nillable, Sort, Update Description User-defined name for the applied tax. | | TaxRate | Type percent Properties Filter, Nillable, Sort, Update Description Percentage value used for calculating tax. | | TaxTransactionNumber | Type string Properties Filter, Group, Nillable, Sort Description Represents the transaction in the external tax engine in which the taxes for the line were calculated for the invoice line. This field is available in API version 55.0 and later. | | TaxTreatmentId | Type reference Properties Filter, Group, Nillable, Sort Description The tax treatment used on this invoice line. This field is a relationship field. This field is available in API version 55.0 and later. Relationship Name TaxTreatment Relationship Type Lookup Refers To TaxTreatment | | Type | Type picklist Properties Filter, Group, Restricted picklist, Sort Description Shows the type of transaction for the invoice line. Possible values are: - Adjustment - Charge - Tax | | UnitPrice | Type currency Properties Filter, Nillable, Sort, Update Description Price for one unit of the item on the invoice line. | ## Associated Objects This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later. [InvoiceLineFeed](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.") Feed tracking is available for the object. [InvoiceLineHistory](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.") History is available for tracked fields of the object. [InvoiceLineOwnerSharingRule](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_ownersharingrule.htm "StandardObjectNameOwnerSharingRule is the model for all owner sharing rule objects associated with standard objects. These objects represent a rule for sharing a standard object with users other than the owner.") Sharing rules are available for the object. [InvoiceLineShare](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_share.htm "StandardObjectNameShare is the model for all share objects associated with standard objects. These objects represent a sharing entry on the standard object.") Sharing is available for the object.