Difference between revisions of "Liquid Template Variables - order"

From Spiffy Stores Knowledge Base

Line 90: Line 90:
  
 
== <code>order.name</code> ==
 
== <code>order.name</code> ==
 +
 +
Returns the name of the order using the format set in the ''Standards & formats'' section of the Preferences settings of your Spiffy Stores toolbox.
 +
 +
<pre>
 +
{{ order.name }} => #100234
 +
</pre>
  
 
== <code>order.order_number</code> ==
 
== <code>order.order_number</code> ==

Revision as of 13:40, 12 February 2016

The Liquid template variable order has the following attributes:

order.id

Returns the unique internal number of the order.

This is normally only for internal usage.

order.customer

Return the customer who placed this order.

order.email

Returns the email address associated with the order.

order.currency

order.credit

order.cancelled

Returns true if the order has been cancelled.

order.cancelled_at

Returns the date and time that the order was cancelled.

{{ order.cancelled_at | date: "%B %d, %Y %I:%M%p" }}

order.cancel_reason

Returns one of the following cancellation reasons, if the order was cancelled.

  • Customer changed/cancelled order
  • Items unavailable
  • Fraudulent order
  • Other

order.cancel_reason_label

order.created_at

order.customer_url

order.discounts

order.discount_price

order.financial_status

Returns the financial status of an order. The possible values are:

  • pending
  • authorized
  • paid
  • partially_paid
  • refunded
  • partially_refunded
  • voided

order.financial_status_label

Returns the display text for the financial status of an order. The possible values are:

  • Pending
  • Paid
  • Partially Paid
  • Cancelled

order.fulfilment_status

Returns the display text for the financial status of an order. The possible values are:

  • unshipped
  • partial
  • shipped

order.fulfilment_status_label

Returns the display text for the fulfillment status of an order. The possible values are:

  • Unshipped
  • Partial
  • Shipped

order.line_items

order.name

Returns the name of the order using the format set in the Standards & formats section of the Preferences settings of your Spiffy Stores toolbox.

{{ order.name }} => #100234

order.order_number

This is the number of the order.

1234

order.shipping_address

Returns the shipping address of the order.

order.billing_address

Returns the billing address of the order.

order.shipping_methods

order.shipping_price

Returns the amount of shipping included in the order.

order.subtotal_price

Returns the total amount of the order less discounts.

This amount will not include any additional taxes or shipping costs.

order.taxes_included

order.tax_lines

Returns an array of tax_line objects for the order.

{% for tax_line in order.tax_lines %}
  Tax ({{ tax_line.title }} {{ tax_line.rate | times: 100 }}%): {{ tax_line.price | money }}
{% endfor %}

=>

Tax (GST 10.0%): $25

order.tax_price

Returns the total amount of tax for the order.

order.included_tax_price

Returns the amount of taxes included in the order subtotal price. Included taxes occur when the amount of tax is included as part of an item's price as opposed to taxes which are added to the item's price.

order.total_price

Returns the total of the order, which is the subtotal plus tax and shipping, if applicable.

If the order total includes taxes which are not applicable for export orders, then these taxes are not included in the total price for the order.

order.surcharge_price

order.surcharge_rate

order.surcharge_description

order.transactions

order.unique_gateway

order_name

The is the name of the order.

By default, the name is formatted as a hash (#) followed by the order number. For example,

#01234

order_date

This is the date of the order.

12th September, 2008

order_time

This is the time of the order.

14:39

shop_name

Returns the name of your shop.

discounts_savings

Returns the amount of any discounts that have been applied to the order (as a negative amount).

discount_price

Returns the amount of any discounts that have been applied to the order.

discount_code

Returns the discount code that was used, if any.

gateway

Returns the name of the payment gateway that was used.

shipping_method

Returns a the shipping method used for the order.


order_quantity

Returns the total number of items in the order.

line_items

Returns an array of Line_Item objects.

fulfilled_line_items

Returns an array of fulfilled Line_Item objects.

unfulfilled_line_items

Returns an array of Line_Item objects that have not been fulfilled.

note

Returns the note that was attached to the order.

attributes (Not Currently Implemented)

Returns any attributes which where attached to the order.

Example usage:

{{ attributes.gift-note }}

order.metafields

Return the metafields for the order.

Metafields can only be managed using the Spiffy Stores API.