Added
`reference` field now available on Purchase Order additional cost rows
11 days ago by Lasha Tsintsabadze
The reference field, previously available only in the Katana UI, is now exposed in the API for purchase order additional cost rows. You can use it to label what a cost row actually is — for example a customs invoice or freight surcharge — directly when creating the row, instead of editing it manually in the UI afterward.
Affected endpoints:
- POST /po_additional_cost_rows — set reference on creation
- PATCH /po_additional_cost_rows/{id} — update or clear it (pass null to clear)
- GET /po_additional_cost_rows and GET /po_additional_cost_rows/{id} — returned on every row
POST /po_additional_cost_rows
{
"additional_cost_id": 11,
"group_id": 21,
"tax_rate_id": 31,
"price": 100,
"reference": "Customs invoice #123"
}The field is an optional string (max 255 characters, nullable). This change is fully backward compatible, existing integrations are unaffected, and rows created without a reference return null.