create_purchase_invoice

Added value: +{
+  "description": "YOUR OWN company's country on this invoice's Party Details (voucher-level COUNTRYOFRESIDENCE). Normally constant; check get_company_info.",
+  "type": "string"
+}

Added value: +{
+  "description": "YOUR OWN company's Emirate/state on this invoice's Party Details (voucher-level STATENAME) — you are the buyer on a purchase. Normally constant; check get_company_info.",
+  "type": "string"
+}

Added value: +{
+  "description": "YOUR OWN company's TRN, as it should appear on this purchase invoice (Tally's BASICBUYERSSALESTAXNO field) — you are the buyer on a purchase. Check get_company_info or an existing purchase invoice for the correct value; this is normally constant across all purchase invoices for one company.",
+  "type": "string"
+}

Added value: +{
+  "description": "Real batch/lot number for this line, if the item has batch tracking. Defaults to 'Primary Batch'.",
+  "type": "string"
+}

Added value: +{
+  "description": "Discount percentage applied to this line's amount (e.g. 10 for 10% off). Optional.",
+  "type": "number"
+}

Added value: +{
+  "description": "Per-item VAT ledger override, if this line has a different tax rate than the invoice default. Requires vatRatePercent.",
+  "type": "string"
+}

Added value: +{
+  "description": "Per-item VAT rate override, e.g. 5. Required if this item's vatLedger is set.",
+  "type": "number"
+}

Added value: +{
+  "description": "UAE VAT Place of Supply Country (Tally's PLACEOFSUPPLYCOUNTRY field), e.g. 'UAE'.",
+  "type": "string"
+}

Added value: +{
+  "description": "UAE VAT Place of Supply Emirate for this invoice (Tally's EMIRATEPOS field).",
+  "type": "string"
+}

Added value: +{
+  "description": "Free-text reference for this invoice (Tally's voucher-level REFERENCE field) — typically the supplier's own bill/invoice number.",
+  "type": "string"
+}

Added value: +{
+  "description": "Date for the reference above, in DD-MM-YYYY format. Independent of the invoice's own date.",
+  "type": "string"
+}

Added value: +{
+  "description": "The supplier's (party's) TRN as it should appear on THIS invoice — Tally's TRADERCONSVATTINNO field. NOTE the asymmetry vs create_sales_invoice: on a purchase, the party is the supplier, not the buyer, so this is a distinct field from buyerTrn below (they held different real values in a reverse-engineered example — do not set them to the same value).",
+  "type": "string"
+}

Previous value: -"Input VAT/tax ledger to apply against the invoice total (optional — omit for a non-taxable invoice)."New value: +"Default Input VAT ledger applied to any item that doesn't set its own vatLedger (optional — omit for a fully non-taxable invoice)."

Previous value: -"VAT rate as a percentage, e.g. 5. Required if vatLedger is set."New value: +"Default VAT rate as a percentage, e.g. 5. Required if vatLedger is set. Items with mixed rates can override this per-line."

Added value: +{
+  "description": "Explicit voucher number. Normally omit this and let Tally auto-number — but some Tally configurations (confirmed live: after a Company Data → Rewrite in at least one case) stop auto-numbering item-invoice vouchers via the XML gateway and fail with a blank EXCEPTIONS:1/no error text unless a number is given explicitly. If a create call fails with no error text, check get_vouchers for the highest existing number of this voucher type and retry with voucherNumber set to the next one.",
+  "type": "string"
+}