pub const INVOICE_NUMBER_FORMAT_HINT: &str = "\
Applied when posting a draft that has no invoice number (blank or unset). \
If the draft already has a number, that value is kept unchanged.
This is not a template engine — only these literal placeholders are replaced at post time:
• {{FISCAL_CODE}} — Indian fiscal year code for the invoice date (Apr–Mar, e.g. 24-25)
• {{YY}} — two-digit year of the invoice date (e.g. 26)
• {{YYYY}} — four-digit year (e.g. 2026)
• {{POSTED_SEQ}} — next posted_invoices row id (MAX(id)+1 among live rows), not a per-year sequence counter
• {{FISCAL_POSTED_SEQ}} — count of posted invoices whose invoice date falls in the same Indian fiscal year as this invoice, plus one (resets each Apr–Mar FY)
Leave blank to default to INV-{{YYYY}}-{{POSTED_SEQ}}.
Example: INV/{{FISCAL_CODE}}/{{FISCAL_POSTED_SEQ}}";
pub const INVOICE_DATE_FORMAT_HINT: &str = "\
Chrono strftime used when rendering calendar dates in the invoice PDF template context \
(DeliveryDateDisplay, payment-term DueDateDisplay).
Examples:
• %d/%m/%Y — 08/02/2026 (default when blank)
• %Y-%m-%d — 2026-02-08
• %d %b %Y — 08 Feb 2026";
pub const INVOICE_DATETIME_FORMAT_HINT: &str = "\
Chrono strftime used when rendering datetimes in the invoice PDF template context \
(DatetimeDisplay on the invoice and on Payments[]).
The value is formatted in the user’s timezone. Examples:
• %d/%m/%Y — 08/02/2026 (default when blank; matches prior PDF date-only display)
• %d/%m/%Y %H:%M — 08/02/2026 14:30
• %Y-%m-%d %H:%M:%S — 2026-02-08 14:30:00";
pub const INVOICE_PDF_TEMPLATE_HINT: &str = "\
Minijinja (Jinja2-style) template. Minijinja expands {% … %} and {{ … }; the result must be valid Typst source, which is then compiled to PDF. Leave blank to use the built-in example template.
Root context (PascalCase field names):
• ID, Number, Reference, PaymentReference, BankAccount
• DatetimeDisplay (from invoice datetime format pref; default DD/MM/YYYY), DatetimeYear, DatetimeMonth, DatetimeDay
• DeliveryDate (ISO when set), DeliveryDateDisplay (from invoice date format pref; default DD/MM/YYYY; empty when unset)
• CustomerId, Customer.Name, Customer.Address, Customer.GSTIN, Customer.PAN, Customer.Phone, Customer.Email, Customer.Website
• PaymentTerm.Summary, PaymentTerm.Lines (due date + amount per line)
• Taxes[] — invoice-level taxes: Name, Percentage, TaxType (levied or withholding)
• Lines[] — Product.Name, Product.HSNCode, Product.Reference, Quantity, Rate, line Taxes[]
• Payments[] — Amount, DatetimeDisplay
• Sites[] — optional related sites from deployment addons: ID, Name, Address (empty list if none; use Sites|default([]) )
Template functions:
• num2words(n), num2wordsAnd(n) — English cardinal words
• num2wordsRupees(n) — amount in words with \"Rupees\"
• invoiceGrandTotalWords() — receivable grand total in words (computed from lines + header taxes)
• vnodeImage(vnode_id) — copy a filesystem file VNode into the Typst work directory for #image(\"…\")
• urlImage(url) — download a remote image into the Typst work directory (legacy; prefer vnodeImage)
Use Preview sample PDF below the template field to render the built-in example invoice data before saving. Use default template to restore the shipped example (you will be asked to confirm before the field is overwritten).
Configure logo, signature, name, address, phone, GSTIN, and place of supply under the invoice presentation fields above. Template context exposes company_name, company_address, company_phone, company_gstin, place_of_supply, company_logo_vnode_id, and company_signature_vnode_id.
Write Typst markup (#set, #let, #table, …) literally; only {% %} and {{ }} regions are evaluated by Minijinja. Reset this field to empty and save to restore the shipped example layout.";