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
typefield for this purpose. - For lines with
type=invoiceitem, use theinvoice_field to reference or update the originatingitem Invoice Itemobject. - On earlier API versions, the
Invoice Line Itemobject also has aunique_field that you can use to migrate internal references before upgrading to this version.id - 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 itemidorunique_.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.