Order Tracking Notification Update - Neto v6.375.0

What's changed?

When triggering an order tracking notification, Neto can now display the orderline quantity shipped instead of or along with, the total orderline quantity. This improves the accuracy of notifications when orders are partially shipped, or shipped from multiple warehouse.

Tracking notifications can also be filtered down to only show orderlines shipped with the current dispatch. These changes allow the tracking notification to better reflect the products the customer will receive when their package arrives.

What do I need to do?

Check if your order tracking email emplate and tracking notification print doc already has these changes by following the guide below. Before making any code changes, Neto recommends copying or backing up any print/email template contents in case any breaking changes accidentally occur.

Filter tracking notification orderlines

In your control panel, navigate to Settings & Tools > All Settings & Tools > Email Templates then click on Order > Order Tracking Email to access your Order Tracking email template. Alternatively, using SFTP:

private/www/netosuite/SysDoc/emails/order/tracking/default.email.html

To filter the tracking notification to only show orderlines shipped with the current dispatch, add tracking_scope:'[@tracking_scope@]' to the [%show_order%] function near the top of the template.

- [%show_order id:'[@order_id@]' customer:'[@username@]'%][%param *header%]
+ [%show_order id:'[@order_id@]' customer:'[@username@]' tracking_scope:'[@tracking_scope@]'%][%param *header%]

When tracking_scope is available, the [%show_order%] function will

  • only show orderlines associated with the current dispatch
  • set the [@qty@] tag to the quantity shipped in the current dispatch
  • only include tracking and consignment information relevant to the current dispatch

This works with partial dispatches, multiple consignments, or dispatches from different warehouses and prevents orderline items from earlier or future dispatches from appearing in the current tracking email. If the tracking scope is missing, all orderlines will be shown.

Show total 'Ordered Qty' and total 'Shipped Qty' in orderlines table

Unlike the tracking_scope param, this will show the total shipped quantity for an orderline, along with the total ordered quantity. This is a "shipped to date" value and may not reflect the current quantity shipped if there are already consignments against an orderline.

In your control panel, navigate to Settings & Tools > All Settings & Tools > Document Templates then click on Order > Tracking Notification > template.html to access your tracking notification document template. Alternatively, using SFTP:

private/www/netosuite/SysDoc/printdocs/order/tracking_notification/template.html

Location the orderline <table> element under the Ship to section and update the table headings (<th>) to add the new Shipped Qty heading

  <th style="text-align:left;">Image</th>
- <th style="text-align:left;">Qty</th>
+ <th style="text-align:left;">Ordered Qty</th>
+ <th style="text-align:left;">Shipped Qty</th>
  <th style="text-align:left;">Description</th>
  <th style="text-align:left;">Shipping Details</th>

Next, under the [@show_order@] [%param *body%] update the table data (<td>) to add the new [@ship_quantity@] tag

  <td><img class="img-small-thumb" src="[@config:homeurl@]/[%asset_url type:'product' id:'[@sku@]' thumb:'thumb'/%]" style="max-width:100px;margin:0 auto;" alt="[%escape%][@model@][%/escape%]"></td>
  <td>[@qty@]</td>
+ <td>[@ship_quantity@]</td>

Finally, under the [%multi_item_pack%] [%param *header%] update the table data (<td>) to properly space kit components if visible

  <td> </td>
  <td> </td>
+ <td> </td>
  <td>
  <p class="text-muted small">[@sku@] Comprised of :</p>

Your order tracking notification <table> element should now look something like this:

<table class="table" style="width:100%;">
    <tr>
        <th style="text-align:left;">Image</th>
        <th style="text-align:left;">Ordered Qty</th>
        <th style="text-align:left;">Shipped Qty</th>
        <th style="text-align:left;">Description</th>
        <th style="text-align:left;">Shipping Details</th>
    </tr>
[%/param%]
[%param *body%]
    <tr>
        <td><img class="img-small-thumb" src="[@config:homeurl@]/[%asset_url type:'product' id:'[@sku@]' thumb:'thumb'/%]" style="max-width:100px;margin:0 auto;" alt="[%escape%][@model@][%/escape%]"></td>
        <td>[@qty@]</td>
        <td>[@ship_quantity@]</td>
        <td>
            [%escape%][@model@][%/escape%]<br>
            [%extra_options currentextra:'[@extra@]' id:'[@sku@]'%]
            [%param header%]
                <ul>
            [%/param%]
            [%param *text_option%]
                <li>[@currentextra@]</li>
            [%/param%]
            [%param *select_option%]
                <li>[@currentextra@]</li>
            [%/param%]
            [%param *category_option%]
                <li>[@currentextra@]</li>
            [%/param%]
            [%param *choices%]
                <li>[@currentextra@]</li>
            [%/param%]
            [%param footer%]
                </ul>
            [%/param%]
            [%/extra_options%]
            [%if [@aff_id@] eq [@config:aff_ebay_id@]%] <span class="text-muted">EBay ID: <strong>[@aff_ref@]</strong></span>[%/if%]
            [%if [@aff_id@] eq [@config:aff_free_id@]%] <span class="text-muted"><strong>Free Gift</strong></span>[%/if%]
            [%if [@aff_id@] eq [@config:aff_rental_id@]%] <span class="text-muted">Rental</span>[%/if%]
            [%if [@config:invoice_sh_serial@] AND [@itm_serial@]%]<b>Serial # [@itm_serial@]</b>[%/if%]
            [%format type:'date' default:'' format:'<b>Deliver On</b> #{DATETIME}'%][@date_delivery@][%/format%]
            [%if [@config:invoice_sh_note@] AND [@itemnotes@]%][%format type:'text' nohtml:'1' addbr:'y'%][@itemnotes@][%/format%][%/if%]
        </td>
        <td>
            <p><strong>[@ship_method@]</strong></p>
            [%if [@ship_tracking@]%]Tracking #<span class="text-important">[@ship_tracking@]</span>[%/if%]
            [%if [@tracking_url@]%]<p><a class="btn btn-default btn-sm" href="[@tracking_url@]" target="_blank">Track Online</a></p>[%/if%]
        </td>
    </tr>
    [%multi_item_pack id:'[@order_id@]' counter:'[@counter@]'%]
        [%param *header%]
        <tr>
            <td> </td>
            <td> </td>
            <td> </td>
            <td>
            <p class="text-muted small">[@sku@] Comprised of :</p>
        [%/param%]
        [%param *body%]
            <p><b>[@quantity@] ×</b> [%escape%][@description@][%/escape%]</p>
        [%/param%]
        [%param *footer%]
            </td>
            <td> </td>
        </tr>
        [%/param%]
    [%/multi_item_pack%]
[%/param%]
[%param *footer%]
</table>

Using these settings your tracking email and print document can now show current or total dispatch orderline data more clearly to your customers. Keeping customers updated on the status of their order and setting expectations for partially shipped or split orders.

Was this article useful?

Be notified when this page is updated. Optional.