# InvoiceLineItemDto

A model the API reference uses in a request or a response. The operation pages link every field typed as this model here.

Read DTO for an invoice line item.

## Fields
- `id` (string(uuid)): Stable identity for update/delete operations.
- `sortOrder` (integer(int32)): Display order on the invoice.
- `parentLineItemId` (string(uuid)): Parent line item ID for bundle/discount/tax line hierarchies. (nullable)
- `name` (string): Product name snapshot (formal product name). (nullable)
- `description` (string): Line item description shown on PDF and HPP. (nullable)
- `notes` (string): Per-line notes visible to the biller only. (nullable)
- `productId` (string(uuid)): Optional link to the product catalog. (nullable)
- `productCode` (string): SKU or product code. (nullable)
- `unitOfMeasure` (string): Unit of measure (e.g., "each", "hour", "GB"). (nullable)
- `commodityCode` (string): Commodity code sent as enhanced (Level 3) card data when the invoice is paid by card. At most  25 characters. (nullable)
- `quantity` (number(double)): Quantity.
- `unitPrice` (number(double)): Unit price.
- `grossAmount` (number(double)): Computed: Quantity * UnitPrice.
- `cost` (number(double)): Cost for margin tracking. (nullable)
- `pricingSource` ([PricingSource](https://devportal.demo.winkpg.io/docs/api/models/PricingSource.md)): How the unit price was determined. (nullable)
  Values:
  - `Catalog`: Price taken from the product catalog at time of invoicing.
  - `Override`: Price manually overridden by the user.
  - `Promotion`: Price determined by a promotion or coupon.
  - `Contract`: Price from a negotiated contract or quote.
- `discountType` ([DiscountType](https://devportal.demo.winkpg.io/docs/api/models/DiscountType.md)): Type of discount applied to this line item. (nullable)
  Values:
  - `Percent`: Percentage discount (e.g., 10%).
  - `Flat`: Flat dollar amount discount (e.g., $5.00).
- `discountValue` (number(double)): Discount value (percentage or flat amount). (nullable)
- `discountAmount` (number(double)): Resolved discount amount. (nullable)
- `netAmount` (number(double)): After discount, before tax.
- `taxRateId` (string(uuid)): Reference to a reusable tax rate definition. (nullable)
- `taxRatePercent` (number(double)): Snapshot of the tax rate percentage. (nullable)
- `taxableAmount` (number(double)): Explicit taxable base amount. (nullable)
- `taxAmount` (number(double)): Computed tax amount.
- `taxJurisdiction` (string): Tax jurisdiction (state/country). (nullable)
- `taxRateSource` ([InvoiceTaxRateSource](https://devportal.demo.winkpg.io/docs/api/models/InvoiceTaxRateSource.md)): Where `taxRatePercent` came from. Always populated on read: a line stored before  provenance existed reads as Catalog when it names a `taxRateId`, otherwise Manual. (nullable)
  Values:
  - `Manual`: The operator typed the percentage, or nothing recorded where it came from.
  - `Catalog`: The percentage was snapshotted from one of the biller's named tax rates.
  - `Provider`: The percentage was sourced from the merchant's bound tax provider.
- `taxRateProviderName` (string): The tax provider that sourced the percentage, when `taxRateSource` is Provider. (nullable)
- `taxCode` (string): Tax code snapshotted from product or overridden. (nullable)
- `isTaxable` (boolean): Whether tax applies to this line. (nullable)
- `lineTotal` (number(double)): Line total including tax.
- `isDiscountLine` (boolean): Indicates this is a discount adjustment line. (nullable)
- `isSystemGenerated` (boolean): Indicates this line was auto-generated. (nullable)
- `isOptional` (boolean): For quotes-to-invoices flow: whether this line is optional. (nullable)
- `revenueAccount` (string): GL account for revenue recognition. (nullable)
- `recognitionStartDate` (string(date-time)): Revenue recognition start date. (nullable)
- `recognitionEndDate` (string(date-time)): Revenue recognition end date. (nullable)
- `attributes` (object): Extensibility metadata (key-value pairs). (nullable)

## See also

- [All documentation](https://devportal.demo.winkpg.io/llms.txt): the machine-readable index of every public page on this site.