v1.3.0-beta.1

🧪 Pre-release

First beta for v1.3.0. Closes #23 — buyer name and net payout on the Last Order sensor for replacing Etsy Seller app notifications.

What's new

sensor.etsy_last_order now exposes the following additional attributes (omitted when null):

• buyer_name — the recipient name from the receipt
• grandtotal — total the buyer paid (subtotal + shipping + tax − discounts)
• subtotal, total_shipping_cost, total_tax_cost, discount_amount
• amount_gross, amount_fees, amount_net — seller's gross, Etsy's fees, and the net payout that hits the bank
• message_from_buyer, is_gift, gift_message
• status, is_paid, is_shipped

The etsyapp_new_order event payload's receipts[] entries are enriched with the same fields, so notification automations can template buyer name + grandtotal directly off the trigger.

Example automation

trigger:
  - platform: device
    device_id: YOUR_DEVICE_ID
    domain: etsyapp
    type: new_order
action:
  - service: notify.mobile_app
    data:
      message: >-
        New order from {{ trigger.event.data.receipts[0].buyer_name }} —
        {{ trigger.event.data.receipts[0].currency_code }}{{ trigger.event.data.receipts[0].grandtotal }}

Backward compatibility

• The existing order_total attribute is preserved with its original meaning (items-only subtotal). New templates can use grandtotal or amount_net for different figures.
• etsyapp_new_order event outer keys (device_id, shop_name, new_orders, orders, receipts) unchanged.
• EtsyRecentOrders and EtsyShopStats sensors unchanged.

⚠️ Proxy mode users

Requires proxy version 1.1.0 or newer for the new fields. Older proxies still work — the integration falls back to the legacy /transactions path automatically — but buyer_name, grandtotal, amount_net, etc. will not appear until the proxy is upgraded.

Direct mode users don't need to do anything beyond updating the integration.

How to install this beta

In HACS, open Etsy Shop Integration → ⋮ menu → Redownload. If you don't see v1.3.0-beta.1 in the version dropdown:

1. Open Etsy Shop Integration in HACS
2. Click the ⋮ menu (top right)
3. Toggle "Show beta versions"
4. Restart the redownload flow and select v1.3.0-beta.1

Feedback

Try it against a real shop and report anything weird at #23 or open a new issue.