請求書のラインアイテム ID を標準化しました対応が必要な変更点
新機能
すべてのインボイスのラインアイテムの id フィールドを変更し、名前の前に il_
が付きます。新しい ID には、すべてのラインアイテムで一貫性のある、グローバルで一意のプレフィックスが設定され、ページ分割に使用できます。以前のプレフィックスには、sub_
、su_
、item_
、sli_
、ii_
がありましたが、グローバルで一意ではありませんでした。
- ID のプレフィックスを使用してラインアイテムのソースを判断することはできなくなりました。代わりに
type
フィールドを使用して判断してください。 type=invoiceitem
が指定されたラインの場合は、invoice_
フィールドを使用して、元のitem Invoice Item
オブジェクトを参照または更新します。- 以前の API バージョンの
Invoice Line Item
オブジェクトには、unique_
フィールドもあり、このバージョンにアップグレードする前に内部参照を移行するために使用できます。id - 個々のラインアイテムに税率を設定するときは、新しい
id
を使用します。以前の API バージョンのユーザーは、ラインアイテムid
またはunique_
を渡すことができます。id
影響
一貫性があり、グローバルに一致の請求書のラインアイテム ID 形式を使用できます。新しい ID には各種のレガシーのプレフィックスではなく「il_」がプレフィックスとして付けられ、すべてのラインアイテムでアプローチが標準化されています。