# Field Sale App releases

<p class="doc-lead">Version release notes for the Freespace <b>Field Sale App</b> (Android and iOS). Newest first.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<div class="doc-toc-links">
<a href="#/version-releases/field-sale-app?id=v2-0-93">2.0.93 / 1.0.27</a>
<a href="#/version-releases/field-sale-app?id=v2-0-92">2.0.92 / 1.0.26</a>
<a href="#/version-releases/field-sale-app?id=v2-0-89">2.0.89 / 1.0.22</a>
<a href="#/version-releases/field-sale-app?id=v2-0-88">2.0.88 / 1.0.20</a>
<a href="#/version-releases/field-sale-app?id=v2-0-86">2.0.86 / 1.0.18</a>
</div>
</div>
</div>

<p>See also: <a href="#/version-releases/">Version Releases</a> · <a href="#/version-releases/web">Web releases</a></p>

<hr class="doc-section-divider">

<h2 id="v2-0-93">Android 2.0.93 · iOS 1.0.27</h2>

<p><b>Released:</b> 19 Oct 2026</p>
<p><b>Build:</b> Android versionCode <b>1176093</b></p>

<h3>Employee Self Attendance</h3>

Employees can check in and check out from the Field Sale App using <b>My Day</b>. Contact the support team or the sales team to enable <b>Employee self punch</b> for the company.

<h4>My Day on Home</h4>

A <b>My Day</b> row appears at the top of Home, above the route selector. It is not a button in the Home grid.

The row is displayed only when Employee self punch is enabled, the role has <b>Self Attendance</b>, and a default Employee is assigned. My Day uses only that employee. If no default Employee is set, the row stays hidden.

<ul>
<li><b>Check in</b> — attendance has not been punched in yet.</li>
<li><b>Check out</b> — checked in, not checked out. The check-in time is not shown on the row.</li>
<li><b>Attendance marked</b> — the day is completed, or punching is not allowed.</li>
</ul>

Home keeps the status for 30 minutes. The refresh icon reloads it. Signing out clears it. Times on the My Day screen follow the company time zone, not the phone clock.

<h4>Check in</h4>

<ul>
<li><b>Plan for the day</b> is required only when the company configures it. A star marks the field as mandatory.</li>
<li><b>Photo</b> opens the front camera when a photo is required.</li>
<li><b>Location</b> captures the current location when required. A reading worse than 100 metres is rejected. A mock location is rejected.</li>
<li><b>Soft geofence</b> — if the punch is outside the permitted place, the app asks for an away reason. The photo already taken is kept.</li>
<li><b>Hard geofence</b> — the punch is rejected outside the place, and no away reason is asked.</li>
</ul>

Check-in records the in time on today's attendance. It does not mark the employee Full Day or Absent.

If an earlier day has a check-in and no check-out, My Day opens that day first. The employee must check out of the pending day before a new check-in. Only one check-in and one check-out are allowed per day.

<h4>Check out</h4>

The screen shows the check-in time, plan, photo, location, and check-in away reason.

<ul>
<li><b>Summary of the day</b> is required only when the company configures it. It is not filled in automatically.</li>
<li>Photo and location follow the same rules as check-in.</li>
<li>A check-out away reason is stored separately and does not replace the check-in reason.</li>
</ul>

After check-out, My Day is read-only: both punch times, the plan, the summary, both away reasons, map links, and both photos.

<h4>Punch mode</h4>

<ul>
<li><b>Disabled</b> — My Day is off for that employee.</li>
<li><b>Custom</b> — uses that employee's capture and geofence.</li>
<li><b>Inherit</b> — uses HR Settings, when Employee self punch is on there.</li>
</ul>

<h4>Geofence location and radius</h4>

When Soft or Hard is configured, the place is chosen in this order: employee territory, employee point, company territory, company point.

Radius: employee radius, then company radius, then 150 metres.

<h4>Supervisor attendance</h4>

Attendance entry on the <b>More</b> tab is unchanged.

Docs: <a href="#/field-sale-app/hr-and-payroll/my-day">My Day</a> · <a href="#/hr/employee-self-attendance">Employee self attendance</a>

<hr class="doc-section-divider">

<h2 id="v2-0-92">Android 2.0.92 · iOS 1.0.26</h2>

<p><b>Released:</b> 13 Oct 2026</p>
<p><b>Build:</b> Android versionCode <b>1176092</b> · iOS build <b>28</b></p>

<h3>Require an active route to view data</h3>

New company-wide setting <b>Require an active route to view data</b> in <a href="#/settings/field-sale-app-settings?id=route-restriction">Settings → Field Sale → App Settings → Route Restriction</a>. It is off by default, so nothing changes until an admin turns it on.

When it is on, the app shows <b>no customers or transactions</b> unless the employee has an active route selected. Before, an employee with no route assigned saw every customer, invoice, quotation, order and credit note.

<ul>
<li><b>No route assigned</b> — blocked.</li>
<li><b>All routes suspended</b>, including every route in an assigned <b>route group</b> — blocked.</li>
<li><b>Selected route suspended</b> while the app is in use — the app drops it and selects the first active route, or blocks if none is left. This is checked when the Home tab regains focus and when the app returns to the foreground, so users don't need to log in again.</li>
<li><b>Clear Selection</b> is hidden in the Route selector, so a route is always selected when one is available. The first active route is selected automatically.</li>
<li>Users without <b>Employee Route</b> access or a default <b>Employee</b> have no route selector, so they are blocked while the setting is on.</li>
</ul>

Blocked screens skip the data request and show <b>No route selected</b>. This covers:

<ul>
<li>Customers, Customers Near Me, and the customer picker on every document</li>
<li>Sale Invoices, Sale Quotations, Sale Orders, Credit Notes</li>
<li>Receipt Vouchers, Opportunities, Leads</li>
<li>RP Deposits and Customer RP</li>
<li>QR customer lookup on Home</li>
</ul>

<b>Setup:</b> an admin turns on the setting, then field users <b>re-login</b> (or reselect the company) to pick it up.

Docs: <a href="#/settings/field-sale-app-settings?id=route-restriction">Field Sale App Settings — Route Restriction</a> · <a href="#/field-sale-app/?id=route-selector">Field Sale App — Route selector</a>

<h3>Prevent printing draft transactions</h3>

The Field Sale App now follows the web print setting <b>Prevent printing draft transactions</b> (<a href="#/settings/print-settings?id=display-options">Settings → Print Settings → Display Options</a>).

<ul>
<li>When the setting is on, the <b>Print</b> button is <b>hidden on draft documents</b>. Print returns after the document is approved.</li>
<li>Applies to <b>Sale Invoice</b>, <b>Sale Order</b>, <b>Sale Quotation</b>, <b>Credit Note</b> and <b>Receipt Voucher</b>. On a Receipt Voucher it also covers printing the linked draft invoice.</li>
<li>If a print is still triggered on a draft, the app shows: <i>Printing is not allowed for draft documents. Approve the document to print it.</i></li>
<li>With the setting off, nothing changes. The existing <b>Hide Draft Status in bills</b> setting still only removes the <b>-DRAFT-</b> tag from the receipt.</li>
</ul>

Docs: <a href="#/field-sale-app/print-formats?id=web-print-settings">Print Formats — Web Print Settings</a>

<hr class="doc-section-divider">

<h2 id="v2-0-89">Android 2.0.89 · iOS 1.0.22</h2>

<p><b>Released:</b> 29 Sep 2026</p>
<p><b>Build:</b> Android versionCode <b>1176089</b> · iOS build <b>24</b></p>

Printing is no longer limited to Bluetooth thermal printers. <b>Printer Settings</b> now has a <b>Connection Type</b> with three options: <b>Bluetooth (receipt)</b>, <b>WiFi / Network (receipt)</b> and <b>A4 / Office printer (any brand)</b>. The existing <b>Print</b> button on every document sends the job to whichever type is selected. Existing users stay on Bluetooth, with nothing to change.

<h3>WiFi / Network thermal receipt printer</h3>

Print receipts to a WiFi or LAN thermal printer (ESC/POS, RAW port 9100), with the same receipt layout as Bluetooth.

<ul>
<li><b>No pairing.</b> The phone and the printer only need to be on the same WiFi network.</li>
<li><b>Find printers</b> scans the WiFi network (about 5 seconds) and lists printers found. Or enter the printer's <b>IP address</b> (printed on its self-test page) and <b>Port</b> (default 9100).</li>
<li><b>Save &amp; Test</b> connects, saves the printer and prints a short test slip.</li>
<li>The printer is <b>saved once</b> and kept after logout. You don't need to enter the address again for each print.</li>
<li><b>Automatic recovery:</b> if the printer's IP address changes (for example after a router restart), the app searches the network and finds it again. It switches silently when it can confirm it's the same printer, and asks first otherwise.</li>
<li><b>Cut paper after each print</b> switch (on by default) for printers with an auto-cutter. Printers without one ignore it.</li>
<li>Clear messages for common problems: phone not on WiFi, printer off or unreachable, printer busy (retried automatically), and out of paper or cover open on printers that report it.</li>
<li>Works when the phone joins the printer's own hotspot, even with mobile data on (Android), without affecting the app's internet connection.</li>
</ul>

<b>Setup tip</b>

Give the printer a <b>fixed IP address</b> (in the printer's network settings or as a DHCP reservation on the router), so the address never changes.

<b>iOS:</b> on the first connection, iPhone asks to allow <b>Local Network</b> access. Tap <b>Allow</b>, otherwise the app can't reach the printer.

Docs: <a href="#/field-sale-app/printer-settings?id=wifi-printer">Printer Settings — WiFi / Network printer</a>

<h3>A4 / Office printer (any brand)</h3>

Print full A4 documents on regular WiFi office printers (for example HP Laser 107w, Canon, Epson, Brother, Samsung, Xerox, Ricoh, Kyocera, Pantum) through the phone's own print dialog.

<ul>
<li>Tap <b>Print</b> on a document: the app prepares the A4 PDF and opens the phone's print dialog. Choose the printer there, and the phone remembers it next time.</li>
<li>Works with any <b>AirPrint</b> printer on iPhone, and any <b>Mopria</b> or brand print-plugin printer on Android. No brand-specific setup in the app.</li>
<li>A4 print is available for <b>Sale Invoice</b>, <b>Sale Quotation</b>, <b>Sale Order</b>, <b>Receipt Voucher</b> (including printing its linked invoice), <b>Customer Statement</b> and <b>Customer Outstanding</b>.</li>
<li><b>Credit Note</b> and <b>Day Report</b> have no A4 layout yet; they show a message to use a receipt printer. Draft documents can be printed in A4 once approved.</li>
<li><b>Test A4 print</b> prints a sample page.</li>
<li>On Android, Printer Settings has <b>Open print settings</b> and <b>Get Mopria</b> buttons for phones where the printer doesn't appear in the dialog.</li>
</ul>

Docs: <a href="#/field-sale-app/printer-settings?id=a4-printer">Printer Settings — A4 / Office printer</a>

<h3>Bluetooth printing</h3>

<ul>
<li>No change to Bluetooth setup or receipt layout.</li>
<li>Switching between Bluetooth, WiFi and A4 keeps each saved printer, so switching back doesn't need setting up again.</li>
</ul>

Docs: <a href="#/field-sale-app/printer-settings">Field Sale App — Printer Settings</a>

<hr class="doc-section-divider">

<h2 id="v2-0-88">Android 2.0.88 · iOS 1.0.20</h2>

<p><b>Released:</b> 12 Sep 2026</p>
<p><b>Build:</b> Android versionCode <b>1176088</b> · iOS build <b>23</b></p>

<h3>Opportunity</h3>

Create and follow CRM opportunities on the Field Sale App, matching the web <a href="#/crm/opportunity">CRM → Opportunity</a> workflow.

<ul>
<li><b>Home → Opportunities</b> — list, create, view, edit, approve, cancel, and mark lost.</li>
<li>Party is <b>customer or lead</b> (not both), same as ERP <code>eitherRequired</code>.</li>
<li>Create an opportunity from a <b>lead</b> (Create Opportunity). The lead is pre-filled.</li>
<li>On an approved opportunity, <b>Create Sale Quotation</b> copies items, employee, address, and the party. A lead-only opportunity sets <b>Lead</b> on the quotation (no customer required).</li>
<li>The quotation view shows the linked opportunity (tap to open) and shows <b>Lead</b> when the quotation is against a lead.</li>
<li><b>My Tasks</b> reminders linked to an opportunity now open the opportunity view.</li>
</ul>

<b>Access (user role)</b>

Opportunity — List / New / View / Edit / Delete / Approve / Cancel / Lost. Create Sale Quotation also needs Sale Quotation — New.

Docs: <a href="#/field-sale-app/opportunities">Field Sale App — Opportunities</a> · <a href="#/crm/opportunity">CRM → Opportunity</a>

<h3>Project task priority</h3>

Project tasks now carry the same <b>Low / Medium / High</b> priority as the web ERP (1 / 2 / 3).

<ul>
<li><b>New Task</b> on Daily Schedule includes an optional <b>Priority</b> picker.</li>
<li>Priority badges appear on Daily Schedule, Work Schedule, task selector, and task detail.</li>
</ul>

Docs: <a href="#/field-sale-app/daily-schedule">Daily Schedule</a> · <a href="#/field-sale-app/reports?id=work-schedule">Work Schedule</a>

<h3>Sale Invoice revise</h3>

A cancelled sale invoice can be revised in the app, same as ERP.

<ul>
<li>On a cancelled invoice, <b>Revise Invoice</b> opens a new invoice pre-filled from the cancelled bill (items, customer, amounts).</li>
<li>The new invoice links to the cancelled invoice as its parent revision.</li>
<li>Requires <b>Sale Invoice — Revise</b> on the user role. Only cancelled invoices can be revised.</li>
</ul>

Docs: <a href="#/field-sale-app/transactions?id=sale-invoice">Field Sale App — Sale Invoice</a>

<hr class="doc-section-divider">

<h2 id="v2-0-86">Android 2.0.86 · iOS 1.0.18</h2>

<p><b>Released:</b> 13 Aug 2026</p>

<h3>Default Sale Return Reason</h3>

The Field Sale App now respects the user’s <b>Default Sale Return Reason</b> from web User Settings when creating a credit note (sale return).

<b>Setup (web)</b>

1. Go to <b>Settings → Users</b> and open the field user’s settings.
2. Under <b>Default values</b>, set <b>Sale return reason</b> to the reason that should be used most often (for example Damaged, Wrong item, Excess stock).
3. Optionally set <b>Sale Return Center</b> if returns should go to a dedicated return warehouse.
4. Ensure the user role includes <b>Sale Return Reason — List</b> so the reason field appears on the credit note form.

Sale return reasons themselves are maintained under <b>Sales → Settings → Sale Return Reasons</b>.

<b>Behaviour in the app</b>

<ul>
<li>On a <b>new Credit Note</b>, <b>Sale Return Reason</b> is pre-filled from the user’s default.</li>
<li>The user can still change the reason before saving (unless defaults/visibility restrict it).</li>
<li>If the selected reason has <b>Is Return To Return Center</b> enabled, shipping/inventory uses the user’s default <b>Sale Return Center</b> (falls back to <b>Inventory Center</b> when Sale Return Center is not set).</li>
<li>Editing an existing draft keeps the reason already saved on that document — the default applies to new documents only.</li>
</ul>

<b>Why it helps</b>

Field teams often use the same return reason. Prefilling it avoids picking the reason on every return and keeps return reporting consistent.

Docs: <a href="#/field-sale-app/transactions?id=credit-note">Field Sale App — Credit Note</a> · <a href="#/settings/user-management?id=default-values">User Settings — Defaults</a> · <a href="#/sales/sale-return-reason">Sale Return Reason</a>
