Skip to main content

Invoices

Merge Tag

Type

Description

{{invoice.invoice_id}}integerInvoice ID #
{{invoice.refnumber}}stringInvoice reference number
{{invoice.external_key}}stringExternal key value
{{invoice.invoice_index}}integerThe invoice subscription sequence number on a subscription
{{invoice.package_id}}integerSubscription ID # this invoice was generated from
{{invoice.customer_id}}integerThe customer ID # this invoice belongs to
{{invoice.brand_id}}integerBrand ID #
{{invoice.brand_name}}stringBrand name
{{invoice.write_datetime}}datetimeDate/time the invoice was created
{{invoice.mod_datetime}}datetimeDate/time the invoice was last updated
{{invoice.void_datetime}}datetimeDate/time the invoice was voided
{{invoice.date}}dateInvoice date
{{invoice.currency_id}}integerCurrency ID #
{{invoice.currency_symbol}}stringCurrency symbol
{{invoice.currency_iso4217}}stringCurrency ISO 4217 representation
{{invoice.class_id}}integerClass ID #
{{invoice.class_name}}stringClass name
{{invoice.paycycle}}stringPayment cycle
{{invoice.paycycle_name}}stringPayment cycle name
{{invoice.terms_id}}integerTerms ID #
{{invoice.terms_name}}stringTerms name
{{invoice.terms_days}}integerTerms # of days
{{invoice.admin_id}}integerAdmin/Worker ID #
{{invoice.admin_name}}stringAdmin/Worker name
{{invoice.token}}stringUnique token
{{invoice.bill_addr1}}stringBilling address line 1
{{invoice.bill_addr2}}stringBilling address line 2
{{invoice.bill_addr3}}stringBilling address line 3
{{invoice.bill_city}}stringBilling address city
{{invoice.bill_state}}stringBilling address state/province
{{invoice.bill_postcode}}stringBilling address postal code
{{invoice.bill_country}}stringBilling address country
{{invoice.bill_notes}}string(deprecated)
{{invoice.bill_block}}stringPrintable billing address
{{invoice.ship_addr1}}stringShip address line 1
{{invoice.ship_addr2}}stringShip address line 2
{{invoice.ship_addr3}}stringShip address line 3
{{invoice.ship_city}}stringShip address city
{{invoice.ship_state}}stringShip address state/province
{{invoice.ship_postcode}}stringShip address postal code
{{invoice.ship_country}}stringShip address country
{{invoice.ship_notes}}string(deprecated)
{{invoice.ship_block}}stringPrintable shipping address
{{invoice.cycle_pre_from_date}}dateFor pre-billing cycle start date
{{invoice.cycle_pre_to_date}}dateFor pre-billing cycle end date
{{invoice.cycle_this_date}}dateCycle date (generally the invoice date)
{{invoice.cycle_post_from_date}}dateFor post-billing (in arrears) cycle start date
{{invoice.cycle_post_to_date}}dateFor post-billing (in arrears) cycle end date
{{invoice.url_permalink}}stringURL to view the invoice
{{invoice.url_pdflink}}stringURL to download the invoice PDF
{{invoice.url_paylink}}stringURL to pay for the invoice
{{invoice.url_self}}stringURL for viewing the invoice in the GUI
{{invoice.is_paid}}booleanWhether or not the invoice has been paid
{{invoice.is_void}}booleanWhether or not the invoice has been voided
{{invoice.is_overdue}}booleanWhether or not the invoice is overdue
{{invoice.due_date}}dateDate the invoice is due
{{invoice.days_overdue}}integer# of days overdue the invoice is
{{invoice.paid_date}}dateDate the invoice was paid
{{invoice.balance}}floatBalance of the invoice
{{invoice.applied}}floatAmount applied to the invoice
{{invoice.total}}floatInvoice total
{{invoice.subtotal}}floatInvoice subtotal
{{invoice.taxes}}floatTaxes
{{invoice.credits}}floatAmount of credits applied to the invoice
{{invoice.payments}}floatAmount of payments applied to the invoice
{{invoice.writeoffs}}floatAmount written off
{{invoice.refunds}}floatAmount refunded
{{invoice.overdue}}floatAmount overdue
{{invoice.declines}}integer# of times that payment was attempted and failed for this invoice
{{invoice.sum_base}}floatSum of the amounts of all base fees on the invoice
{{invoice.sum_usage}}floatSum of the amounts of all usage-based/metered fees on the invoice
{{invoice.sum_onetime}}floatSum of the amounts of all the one-time charges on the invoice
{{invoice.invoice_status_name}}stringHuman-friendly invoice status
{{invoice.invoice_status_str}}stringStatus string
{{invoice.invoice_status_state}}stringStatus code
{{invoice.memo}}stringMemo/notes to customer
{{invoice.custom_1}}mixedCustom field #1
{{invoice.custom_2}}mixedCustom field #2
{{invoice.custom_3}}mixedCustom field #3
{{invoice.custom_4}}mixedCustom field #4
{{invoice.custom_5}}mixedCustom field #5
{{invoice.custom_6}}mixedCustom field #6
{{invoice.custom_7}}mixedCustom field #7
{{invoice.custom_8}}mixedCustom field #8
{{invoice.custom_9}}mixedCustom field #9
{{invoice.custom_10}}mixedCustom field #10
{{invoice.custom_11}}mixedCustom field #11
{{invoice.custom_12}}mixedCustom field #12
{{invoice.custom_13}}mixedCustom field #13
{{invoice.custom_14}}mixedCustom field #14
{{invoice.custom_15}}mixedCustom field #15
{{invoice.custom_16}}mixedCustom field #16
{{invoice.custom_17}}mixedCustom field #17
{{invoice.custom_18}}mixedCustom field #18
{{invoice.custom_19}}mixedCustom field #19
{{invoice.custom_20}}mixedCustom field #20
{{invoice.line_items}}arrayA list of line items for the invoice
{{invoice.schedule}}arrayA list of scheduled payments for the invoice
{{invoice.tags}}arrayA list of tags for the invoice