Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updated outdated screenshots


Table of Contents
Table of Contents
maxLevel4
minLevel2
outlinetrue
classtoc

Description

This email template is sent when a scheduled paid invoice is delivered to the client. It will contain a PDF attachment of the invoice. Each Billing contact of the clients' billing contacts will receive this email if any are set, otherwise the primary contact will receive the email.

Supported Tags

The tags described in Blesta are only a list of commonly-used tags, for brevity.

Because the {invoices} tag is an array of objects (i.e. possibly multiple invoices), it should not be used as written. Instead, you should configure the template to loop over through each invoice individually within by using the for notation described under Customizing Emails.

Image RemovedImage Added

The tags below are all of those available for this email template. For other email and tag customizations, see Customizing Emails.

TagDescriptionNotesSince Version
{contact.first_name}The client's first name
 


{contact.last_name}The client's last name
 


{contact.email}The client's email address
 


{contact.id_code}The client's IDe.g. 1500
{autodebit}Whether or not autodebit is enabled for this clienti.e. 1 or 0, denoting yes or no, respectively
{client_url}The URI to Blesta's client interfacee.g. domain.com/billing/client/
{payment_account.first_name}The first name on the payment account assigned for autodebit
v4.4.0
{payment_account.last_name}The last name on the payment account assigned for autodebit
v4.4.0
{payment_account.account_type}The payment account type that is assigned for autodebiti.e. "cc" or "ach"v4.4.0
{payment_account.last4}The last four digits on the payment account assigned for autodebit
v4.4.0


Expand
titleAdditional Tags

Due to the nature of tag objects containing several fields, many of which are likely irrelevant for use in email templates, but may be useful to you in certain circumstances, an example dump of the tag objects are shown below.

Code Block
languagephp
titleThe {contact} object
collapsetrue
stdClass Object
(
    [id] => 1
    [client_id] => 1
    [user_id] => 
    [contact_type] => primary
    [contact_type_id] => 
    [first_name] => First
    [last_name] => Last
    [title] => 
    [company] => Company Co.
    [email] => first.last@domain.com
    [address1] => 123 Main St.
    [address2] => 
    [city] => City
    [state] => CA
    [zip] => 90001
    [country] => stdClass Object
        (
            [alpha2] => US
            [alpha3] => USA
            [name] => United States
            [alt_name] => 
        )
    [date_added] => 2014-05-08 21:35:13
    [contact_type_name] => 
    [contact_type_is_lang] => 
)


Code Block
languagephp
titleThe {invoices} array of objects
collapsetrue
Array (
    [0] => stdClass Object
        (
            [id] => 505
            [id_format] => {num}
            [id_value] => 171
            [client_id] => 1
            [date_billed] => 2014-09-18 07:00:00
            [date_due] => 2014-09-23 07:00:00
            [date_closed] => 2014-09-22 23:56:04
            [date_autodebit] => 
            [status] => active
            [subtotal] => 1.0000
            [total] => 1.0000
            [paid] => 1.0000
            [previous_due] => 829.5010
            [currency] => USD
            [note_public] => 
            [note_private] => 
            [id_code] => 171
            [delivery_date_sent] => 
            [due] => 0
            [line_items] => Array
                (
                    [0] => stdClass Object
                        (
                            [id] => 1181
                            [invoice_id] => 505
                            [service_id] => 
                            [description] => Line Item Description
                            [qty] => 1.0000
                            [amount] => 1.0000
                            [subtotal] => 1.00000000
                            [taxes] => Array
                                (
                                )
                            [taxes_applied] => Array
                                (
                                )
                            [tax_subtotal] => 0
                            [tax_total] => 0
                            [total] => 1
                            [total_w_tax] => 1
                        )
                )
            [delivery] => Array
                (
                     [0] => stdClass Object
                         (
                             [id] => 510
                             [invoice_id] => 505
                             [method] => email
                             [date_sent] => 
                         )
                )
            [meta] => Array
        
Expand
titleAdditional Tags

Due to the nature of tag objects containing several fields, many of which are likely irrelevant for use in email templates, but may be useful to you in certain circumstances, an example dump of the tag objects are shown below.

Code Block
languagephp
titleThe {contact} object
collapsetrue
stdClass Object
(
    [id] => 1
    [id_format] => {num}
    [id_value] => 1500
    [user_id] => 2
    [client_group_id] => 1
    [primary_account_id] => 
    [primary_account_type] => 
    [status] => active
    [id_code] => 1500
    [contact_id] => 1
    [first_name] => First
    [last_name] => Last
    [company] => Company Co.
    [email] => first.last@domain.com
    [address1] => 123 Main St.
    [address2] => 
    [city] => City
    [state] => CA
    [zip] => 90001
    [country] => US
    [group_name] => General
    [company_id] => 1
    [username] => first.last@domain.com
    [two_factor_mode] => none
    [two_factor_key] => 
    [two_factor_pin] => 
    [date_added] => 2014-06-25 18:05:34
)
Code Block
languagephp
titleThe {invoices} array of objects
collapsetrue
Array (
    [0] => stdClass Object
        (
              [id] => 1)
            [idtax_formatsubtotal] => {num}0
            [idtax_valuetotal] => 10
            [client_idtaxes] => 1
 Array
                (
             [date_billed] => 2014-06-25 00:00:00 )
            [date_duebilling] => 2014-07-01 00:00:00
stdClass Object
             [date_closed] => 
   (
             [date_autodebit] => 2014-06-29 00:00:00
    [id] => 1
      [status] => active
            [subtotalclient_id] => 10.00001
            [total] => 10.0000
        [user_id] => 
      [paid] => 10.0000
            [previouscontact_duetype] => 0.0000primary
            [currency] => USD
        [contact_type_id] => 
      [note_public] => 
            [notefirst_privatename] => First
            [id_code] => 1000
            [deliverylast_date_sentname] => 2014-06-25 23:15:00
Last
             [due] => 0.0000
     [title] => 
     [line_items] => Array
             [company] => Company (Co.
                    [0email] => stdClass Objectfirst.last@domain.com
                    [address1] => 123 Main (St.
                    [address2] => 
      [id] => 1
            [city] => City
              [invoice_id] => 1
    [state] => CA
                      [service_idzip] => 1
        90001
                    [descriptioncountry] => Bronze Standard - domain.comstdClass Object
                            [qty] => 1.0000(
                            [amountalpha2] => 10.0000US
                            [subtotalalpha3] => 10.00000000USA
                            [taxesname] => ArrayUnited States
                                (
                [alt_name] => 
                )
 
       )
                     [taxesdate_appliedadded] => Array2014-05-08 21:35:13
                    [contact_type_name] => 
          (
          [contact_type_is_lang] => 
                    )
  
         [client] => stdClass Object
               (
 [tax_subtotal] => 0
                [id] => 1
          [tax_total] => 0
       [id_format] => {num}
                   [totalid_value] => 101500
                   [user_id] => 2
       [total_w_tax] => 10
            [client_group_id] => 1
             )
      [primary_account_id] =>  
       )
 
            [deliveryprimary_account_type] => Array
                  (
  [status] => active
                   [0id_code] => stdClass Object1500
                   [contact_id] => 1
   (
                [first_name] => First
          [id] => 1
       [last_name] => Last
                   [invoice_idcompany] => Company 1Co.
                            [method[email] => emailfirst.last@domain.com
                   [address1] => 123 Main St.
      [date_sent] => 
           [address2] => 
           )
        [city] => City
      )
 
            [metastate] => Array
     > CA
           (
        [zip] => 90001
      )
 
            [tax_subtotalcountry] => 0
       US
     [tax_total] => 0
            [taxesgroup_name] => ArrayGeneral
                (
   [company_id] =>  1
          )
        )
    [1username] => stdClass Object
 first.last@domain.com
       (
            [idtwo_factor_mode] => 2none
            [id_format       [two_factor_key] => {num}
            [id_value] => 2
     [two_factor_pin] => 
     [client_id] => 1
            [date_billedadded] => 2014-0605-2608 0021:0035:00
13
                   [date_duesettings] => 2014-07-01 00:00:00
 Array
                     [date_closed] => (
            [date_autodebit] => 2014-06-29 00:00:00               ...
            [status]  => active
            [subtotallanguage] => 20.0000en_us
            [total] => 20.0000
            [paid] => 20.0000
 ...
              [previous_due] => 0.0000         )
            [currency]  => USD)
            [noteapplied_publictransactions] => Array
               [note_private] => 
(
                   [id_code0] => 1001stdClass Object
            [delivery_date_sent] => 2014-06-26 23:15:00
        (
    [due] => 0.0000
            [line_items] => Array
       [id] => 126
       (
                    [0amount] => stdClass Object
 1.0000
                           [currency] => (USD
                            [iddate_added] => 1
 2014-09-22 23:56:01
                           [invoice_idtype] => 2cc
                            [servicetransaction_type_id] => 1
                            [descriptiontransaction_id] => Gold Standard - domain2.com
 126
                           [qtyinvoice_id] => 1.0000505
                            [applied_amount] => 201.0000
                            [subtotalapplied_date] => 20.00000000 2014-09-22 23:56:01
                            [taxestype_name] => Array
                           [invoice_id_code]     (=> 171
                           [client_id]     )=> 1
 
                            [taxesaccount_appliedid] => Array4
                           [gateway_id]     (=> 5
                                )
 
[gateway_name] => Authorize.Net
                             [taxgateway_subtotaltype] => 0merchant
                            [taxreference_totalid] => 01111
                            [totalstatus] => 20approved
                            [totaltype_wreal_taxname] => 20Credit Card
                        )
                 )
 
          [payment_url]  [delivery] => Array
=> domain.com/billing/client/pay/method/505/?sid=X6V8FU5X%2BdGtT9nZQ5DVOO2SsZdc5hC9k1ct6AiLtBs%3D
           [autodebit_date] => 2014-09-22 07:00:00
    (
       [autodebit_date_formatted] => Sep 22, 2014
       )
)


Code Block
languagetext
titleThe {payment_account} object
collapsetrue
A credit [0] => card payment account:
stdClass Object
(
    [id] => 4
    [contact_id] => 1
    [first_name] => First
    [last_name] => (Last
    [address1] => 123 Main St.
    [address2]           => 
     [idcity] => 2City
    [state] => CA
    [zip] => 90001
    [country] => US
    [number] => d6/No/zCxnjXmcAPxxRvpTm4a84+MiM6IepKj79Nh1gxmDplUl9Gz6ehFLiCjOhDZgGGRHmEx1Z7DRiy+Y97tuAnMi3nEAZppTI4Qs3f8BSZdKWjfGsXiYr9F0miUJ8Ret9/3F+o980q2vQ3SPBIGWk18f0AflMe3R1mapP3IZcrijVpcTYfI1Z99eNmXwcZ5TmeAyqd9+Sj7lbkf2yWtBonMogvrcclH9DhCORW7hQjm2jYFZQT74M6UWT990aOI/yghQVACWWho217vkWB+nwjmBsVbB5QgY/X29BFmjUpmqw73Qi2h/TpYlG3zCFFDrmRyCPy+CjCNWiWxLd/fCd9MR7dXEzEzN/vg3d35nfbM+71vTDRe4SDn4Q9VjQhI7rwDYMlhQ5f7U7HeTt9m/l5ggB7rg//iYoOtTYo+OncN0+qnQ99dQ5pZWatenXfZAhPVDS3eLNdQxZhKpcd2OyU/DjpFEYIA0dytWzbEMWoUO7/rKUv6LvbEpx3M57b
    [invoice_idexpiration] => 2202105
    [last4] => 1234
    [type] => mc
    [gateway_id] => 
    [client_reference_id] => 
    [methodreference_id] => email
    [status] => active
    [client_id] => 1
    [type_name] => Master  Card
        [dateaccount_senttype] => cc
)

An ACH payment account:
stdClass Object
(
    [id] => 2
    [contact_id] => 1
    [first_name] =>   )First
    [last_name] => Last
    [address1] => 123    )
 Main St.
    [address2] =>   
    [metacity] => ArrayCity
    [state] => CA
    [zip]      (=> 90001
    [country] => US
    [account]      )
 
        => m6gfz+Ee2SUldJIiBntBfbdnpLSsosZs7GVgpG24N1+IAqjl57RuxnsZU+COFBlwP26r8TzUmiINRrlh6EhsdzTiiFYHtdF1KT4Ht+UYlp7giLKW8tIYF05Xtt5Q+yNIj6zViYGV/6ZjZWNanfIwafwfcrHfqjBFyuY5a+mjOsf1/eW0lc2RyFIMwNFh8uSUM++bTfUEBSxKnEwSb8yQhrrD35CjNlmHn30Hql45nJkPFQEsbUOlNxeiOo/IAwj+J8X3Zc3WKQrFHD/F92XtRpHeYCyRSVF9QaK71qgeyly/H1xdVOGI2bYYgy7ARV071AXXACSOMHAlp88X1BR5Q0wWjspTeBjRN0fDE5UEjKMaLPa777Bcz5BmlmgGm63A994nPl5xK+DDx+e4c54zOJY7gDR/AUnlumAYZ0Dp4XmFRY3uI5qPQ9Iucpui9cWxH4ItC/Jyh0f2gw93qG3EKQAxY/0YMeRKkDlCqo1spdTvU0YowSz6qmJRm57EhugW
    [routing] => e+p5fZGqTYiFzUcM1eHJo15j/lCnuKKPn6aHYy9Sj1/P4kCawX8AUxAJYUp4jGUzuKUuDV+N5P9tQUb85DIeCPrFqb11lRCe6sSjjEbDxNXlgGoILNzx/OZdcqXo5oUqd8Rt/dLpdLrwUPyNOpTQi7xaOh+APiCk5B3rFE7wq4nPjzl+OvQXp28IkN7ehw1ZOnFj8EoTGFDVfNIspYd6IqLiopDOvO2iDesga6YLbnCBJQ/rVMwCF6/jGpgtXMH1YbMq0qNO8jIjrxudFmIF9TaAPxV4UpQ2adl2u5O6iKhqRYeKxpyylZk07CeqI3PZOVHzdHGvo2AILzfA3BJUtzuYCW4nGVNUwfEaUxE12PHUE7GThdkucBtnOBhJBIQlmr6OEwPLYXa7163slmHUQ/wWLPJNfm09eux32KZhxXx1F+oZo4K+nVXQMaZJQPctKUhvcl8Ssb4i+aVOH/Ei7ga+5kuWT+d7Pzycyi5mGp/K+Y9ZiI/wiwstAtJJSwZH
    [tax_subtotallast4] => 01112
            [tax_total[type] => 0checking
    [gateway_id] => 
      [taxes[client_reference_id] => Array
    [reference_id] => 
    [status]      (=> active
    [client_id] => 1
    [type_name]      )=> Checking
    [account_type] =>   )ach
)