Standardizes invoice line item IDsBreaking changes

What’s new

Changes the id field of all invoice line items, prefixing them with il_. The new ID has consistent prefixes across all line items, is globally unique, and can be used for pagination. Old prefixes included sub_, su_, item_, sli_, and ii_ and weren`t globally unique.

• You can no longer use the prefix of the ID to determine the source of the line item. Instead use the type field for this purpose.
• For lines with type=invoiceitem, use the invoice_item field to reference or update the originating Invoice Item object.
• On earlier API versions, the Invoice Line Item object also has a unique_id field that you can use to migrate internal references before upgrading to this version.
• When setting a tax rate to individual line items, use the new id. If you’re on an earlier API version, pass in either a line item id or unique_id.

Impact

Lets you work with a more consistent and globally unique invoice line item ID format. The new IDs are prefixed with “il_” instead of various legacy prefixes, providing a standardized approach across all line items.

Upgrade