The supplier emailer integration has been reworked to support the same functionality of the dispatch notification integrations.

This now allows the email to be sent from a different address to the standard as per the dispatch notification integration and allows the use of certain variable placeholder values.

The standard functionality of it remains the same; When enabled it will email the specified email template to the specified “Email To” email and set the order to sent to supplier, by default it is set to do the legacy email so as not to break currently setup Emailer Integrations, this can be toggled with the “Legacy Enabled” tick box.

SES Verification

After the domain is properly verified you receive 4 DNS records which will need adding to the domains DNS by the administrator of the sender’s domain, example below;

Also the administrator of the sender’s domain needs to include _spf.custom-gateway.net within their domain’s SPF record. For example:

"v=spf1 include:_spf.custom-gateway.net"

Email Templates & Placeholder Values

The content of the Email is specified in the HTML and plain text input boxes, both of which should be filled where possible.

These templates support the use of certain placeholder variables a list of which can be located at the end of this post.

Any attribute available on the order or the item can be added to the template as can the name, description and URL of any of the print jobs assets these are added in the following way (where x equals the attribute name):

{{ order.x }}

{% for item in order.items  %}
  {{ item.x }}
  {% for asset in item.print_job %}
    {{ asset.x }}
  {% endfor %}
{% endfor %}

As you can see from the above example the item must be contained within a loop which goes over every item in the orders items attribute the same has to be done for the assets but this loop must be contained within the items loop as each item has a print_job which is a list of assets and their attributes.

Lastly if you want to display parts of the email only if a certain attribute exists are is set to a specific value then a if must be used as follows:

{% order.shipping_method == "RM1" %}

Order is First Class

{% endif %}

{% if order.shipping_tracking %}

Order tracking ID: {{ order.shipping_tracking }}.

{% endif %}

The first if will display the contents if the shipping method of the order is RM1 exactly whereas the second if will display its contents as long as the shipping tracking is set no matter the values

Variable reference

order.id  
order.company_ref_id  
order.secondary_company_ref_id  
order.ref  
order.status  
order.shipping_company  
order.shipping_address_1  
order.shipping_address_2  
order.shipping_address_3  
order.shipping_address_4  
order.shipping_address_5  
order.shipping_postcode  
order.shipping_country  
order.shipping_country_code  
order.billing_company  
order.billing_address_1  
order.billing_address_2  
order.billing_address_3  
order.billing_address_4  
order.billing_address_5  
order.billing_postcode  
order.billing_country  
order.customer_name  
order.customer_telephone  
order.customer_telephone_mobile  
order.sale_datetime  
order.external_ref  
order.has_been_completed  
order.completion_datetime  
order.shipping_method  
order.customer_email  
order.shipping_carrier  
order.shipping_tracking  
order.shipping_note_url  
order.payment_trans_id  
order.payment_type  
order.creation_datetime  
order.additional_info  
order.has_error  
order.error_message  
order.required_dispatch_date  
order.consolidate  
order.has_been_invoiced  
order.billing_customer_name  
order.billing_customer_email  
order.billing_customer_telephone  
order.shipping_price  
order.shipping_price_inc_tax  
order.shipping_tax_rate  
order.is_urgent  
order.tag  
order.coupon_code  
order.currency_code  
order.is_free_of_charge  
order.status_name  

Must be contained within

item.id  
item.sale_vat_rate  
item.external_ref  
item.ref  
item.order_id  
item.sku  
item.mapped_sku  
item.description  
item.colour  
item.size  
item.quantity  
item.type  
item.print_job_id  
item.print_job_promise_ref  
item.external_url  
item.external_thumbnail_url  
item.status  
item.print_on_demand_ref  
item.plain_stock_item_ref  
item.license  
item.license_percentage  
item.unit_sale_price  
item.unit_sale_price_inc_tax  
item.unit_cost_price  
item.shipping_price  
item.shipping_price_inc_tax  
item.bundle_ref  
item.textual_product_id  
item.product_variant_id  
item.quantity_batched  
item.quantity_dispatched  
item.stock_request_id  
item.artwork_barcode  
item.status_name  

Must be contained within which itself must be contained in

asset.name  
asset.description  
asset.client_url