Updated order notes for your BigCommerce store
We’ve made some changes to the way Harper writes order notes in your BigCommerce store. This document explains what’s new, what’s changing, and what your team needs to do before 1 June 2026.
These changes were driven by feedback from finance teams across our partners. We heard that it wasn’t always easy to know when a Harper order was ready to reconcile. The new structure directly addresses this, introducing dedicated finance and payments values and a clear signal for when an order is ready to audit.
Do you need to take action?
Where to find notes in BigCommerce
Harper notes in your store
Harper order notes appear in the staff notes field on each order in your BigCommerce admin. They are updated dynamically throughout the order lifecycle and can be used to identify the current state of any Harper order.
New values, live now
The new staff note structure
All new values use a consistent hrp/ prefix, making Harper activity easy to identify and filter. Values are grouped into three types: status, service, and finance.
Status values
Mutually exclusive — only one status value appears at a time.
Order placed but not yet received by the customer
Order is currently within the try-on or appointment period
The try-on period has ended (items returned or purchased)
Order was cancelled
Service type values
Written to every Harper order — indicates which service was used.
Order placed via Harper Try Before You Buy
Order placed via Harper Concierge (home appointment model)
Finance & payments values
These values help Finance and Ops teams understand the reconciliation state of each order. Rather than inferring payment status from order state, you now have a dedicated set of values that track the financial position of every Harper order.
Items not yet received by the customer
Order within the try-on period; not yet financially accounted for
On hold: returns with the warehouse but refund not yet processed
Manually placed on hold by Harper
Try-on complete; cash available, pending warehouse confirmation of returns
All items purchased or confirmed returned. Order is ready to reconcile.
Old values, retiring 1 June 2026
Values your team may need to update
If anyone in your team is currently filtering on the values below in reports or workflows, those references will need updating before 1 June 2026.
The following values will stop being written after 1 June 2026. Both old and new values are currently running in parallel to give you time to make the switch.
hrp/service/try
hrp/service/concierge
hrp/status/new
hrp/status/in_trial
hrp/payments/reconcilable
hrp/status/trial_ended + hrp/payments/reconcilable
hrp/status/cancelled
hrp/status/trial_ended
If you need to pass these changes to a developer or analyst to update your reports or workflows, we’re happy to help make that process as smooth as possible.
Reach out to your Harper account manager or contact: support@harperconcierge.com
harper.
BigCommerce partner brief · Order note changes · Deadline 1 June 2026
Old values, retiring 1 June 2026
Values your team may need to update
If anyone in your team is currently filtering on the values below in reports or workflows, those references will need updating before 1 June 2026.
The following values will stop being written after 1 June 2026. Both old and new values are currently running in parallel to give you time to make the switch.