Line

One item line or one tax summary line. Lines carry only what can differ within an invoice. Gross is never sent: it is always net plus VAT. Line vat must add up to the invoice's VAT per rate; where your ERP rounds at invoice level, put the rounding difference on one line.

goods_or_services
Type: "goods" or "services"enum
required
line_id
Type: string
max length:
255
required

Your id for the line, for example the ERP entry id, or its sequence number. Unique within the document and stable across versions.
net
Type:
required

As printed. Usually negative on a credit note, and negative on a discount line.
tax_code
required

The line's VAT treatment. Either a VAT IT tax code, or your own tax code as it is in your ERP, where VAT IT keeps the mapping from your codes to VAT IT tax codes for that client. A code with no mapping yet makes the line wait with tax_code_unmapped until VAT IT adds it. See the Tax codes guide.
Type: enum

The line's VAT treatment. Either a VAT IT tax code, or your own tax code as it is in your ERP, where VAT IT keeps the mapping from your codes to VAT IT tax codes for that client. A code with no mapping yet makes the line wait with tax_code_unmapped until VAT IT adds it. See the Tax codes guide.

values
sale_domestic
sale_domestic_exempt
sale_domestic_reverse_charge
sale_intra_eu_goods
sale_intra_eu_services
sale_intra_eu_triangular
sale_distance_goods
sale_export
vat
Type:
required

The VAT charged on the line, as printed. Zero when none.
vat_rate
Type: string
required

Percent, so 23 and not 0.23.
ship_from_country
Type:

Only when this line's goods left from a different country than the document's.
ship_to_country
Type:

Only when this line's goods arrived in a different country than the document's.
tax_jurisdiction
Type:

Only when this line falls under a different registration than the document. Leave it out otherwise.

DocumentUpsert

DocumentVoid