flan
527f662189
Add-on rows already carried quantity, unit and extended price; only the name was exposed. The attribute now renders the full line and a new monetary sensor reports the add-ons subtotal separately from the box. The fixture totals were copied from a seven-add-on cart while the fixture itself had one, so they are now self-consistent and a test asserts that add-ons plus box price equals the portal's subtotal.
ha-freshharvest
Unofficial Home Assistant integration for Fresh Harvest, the Georgia local-produce delivery subscription.
Entities
| Entity | Example | Notes |
|---|---|---|
sensor.fresh_harvest_next_delivery |
2026-08-04 |
Attributes: delivery_day, box |
sensor.fresh_harvest_next_delivery_total |
109.06 |
Attributes: subtotal, tax, delivery_fee |
sensor.fresh_harvest_next_delivery_add_ons |
72.88 |
Add-ons only, excluding the box. Attributes: box_price, add_ons |
sensor.fresh_harvest_next_delivery_items |
14 |
Attributes: box, box_price, produce, add_ons, add_ons_total |
sensor.fresh_harvest_open_order_delivery |
2026-08-11 |
The order you can still change |
sensor.fresh_harvest_shopping_window |
Shop tomorrow |
closed when nothing is customizable |
Each add_ons entry carries its quantity, unit, and extended price — a
multi-quantity line bills as one amount, so 4 smoothies read
4 Complete Recovery Smoothie 15.2 fl oz — $17.96. add_ons_total plus
box_price always equals the portal's own subtotal, which a test asserts.
The next delivery and the open order are usually two different deliveries. Once an order passes its cutoff it locks for packing, and the cart you can still edit is the following week's.
How it works
Fresh Harvest is not on Shopify, Farmigo, or Local Line — the page metadata
reports Vy Technology - Custom Code. It is a server-rendered jQuery site with
no JSON API and no mobile app, so this integration signs in and parses HTML.
Login is a two-step handshake:
GET /s/popup/loginreturns the form plus two hidden anti-replay fields,LoginSecurityandSubmitToken, minted per session.POST /s/submit/loginwithLoginEmail,LoginPassword, both tokens, and an emptyRedirect, yielding anfh_session_authenticatedcookie.
The tokens are bound to the cookie issued by step 1, so both requests must
share a cookie jar. Everything the integration needs then comes from a single
GET /p/dashboard/details, which carries the delivery day, next arrival date,
both upcoming carts, their contents, and their totals.
Markup notes
Two traps are worth recording, since neither is guessable from the outside:
- HTTP status means nothing. Every
/p/*path returns 200, including invented ones. Signed-in state is detected by the presence of a Sign Out control, not by a status code. cart-contents-skippeddoes not mean the order was skipped. It marks the locked cart — the one past its cutoff and arriving next. Treating it as "skipped" reports the wrong delivery as cancelled. The reliable signal for "can still be changed" is a non-empty.cart-customize-wrapper.
Dashboard
examples/dashboard-view.yaml is a ready-made tab
for these sensors — a countdown heading ("Arriving tomorrow"), tiles for the
date, total and item count, the full box contents rendered from the attributes,
and the still-changeable order with a link back to the portal. Paste it under
views: in the raw configuration editor.
Installation
Copy custom_components/freshharvest/ into your Home Assistant
config/custom_components/ directory and restart Home Assistant, then add the
integration from Settings → Devices & Services. Credentials are your normal
freshharvest.com email and password.
Tests
pip install beautifulsoup4 pytest
pytest tests/
The fixture is synthetic but mirrors the real markup; the live page carries the account holder's name, address, and phone number, so it is not committed.
Disclaimer
Unofficial and unaffiliated. Polls once every 6 hours; please do not lower that — this is a small business's website, not an API.