> ## Documentation Index
> Fetch the complete documentation index at: https://help.yournewdoor.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Field packet

> Installer field packet: the six job screens, photos, sign-off and exceptions.

The field packet is the installer’s job surface (PWA). Office assigns; field completes.

## What installers do

**1. Open today’s packet**

After magic-link login, open **Field** and tap one of your stops on the map or in the list to open its job packet. It opens on **01 · Summary**.

**2. On my way, then Start**

On Summary, swipe **"Swipe: On my way"** when you leave. You stay on Summary and the track then reads **"Swipe: Start"**. Swipe it when you arrive: that records Start and takes you to **02 · Before Photos**. If you come back to Summary later, the track reads **"Swipe: Before Photos →"** and only moves you forward.

**3. Take the before photos**

Fill the four photo slots on Before Photos, then swipe **Before photos done**.

**4. Do the work on Job details**

On **03 · Job details and services**, check the sold scope and swipe each step as you finish it: **Remove old door**, **Install frame and door**, then **Hardware and seal**.

**5. Take the after photos**

Fill the four photo slots on **04 · After photos**, then swipe **After photos done**.

**6. Sign off on Ending**

On **05 · Ending Summary and Notes**, check what was done, then get the installer and customer sign-offs. Swipe to **Finish Job**.

**7. Take payment and complete**

On **06 · Finish Job**, take payment if anything is due, swipe **Payment**, then swipe **Complete**.

The hold panel, **Report a problem**, sign-off, **Complete**, **Record payment** and **Text pay link** are also on **Summary**. While a job is on hold, Summary says "This job is on hold. Resume it to sign off or flag a problem." and **Record payment** and **Text pay link** are hidden until the job is resumed. File a **field exception** when the site doesn't match the sold scope.

## Field home (`/field`)

Installers now get the same **Field map** screen as the office: the map, the stop list, **Today / Week**, and **previous / Today / next** to change days. Week shows Monday to Sunday. The header shows the day and your market, for example **"Fri, Oct 30 · Dallas"**.

* **Your stops** show with full details. Tap one to open its job packet (`/field/[id]`).
* **Other installers' stops** in your market show as pins with only the **city and time**. They have no customer, job number or address, and you can't open them. They sit at the center of the market, not at the real house.
* **Texts (company line)** appears at the top when the shared company text line is on.

> [!NOTE]
>
> If your profile has no market set, the map is empty: no pins (not even your own), no other installers' stops, and the header shows a dash where the market name goes. Ask an admin to set your market.

## Money on the packet

The packet uses the admin layout for every role. Next to the job status there's always a sold-price spot:

| Who | What the sold-price spot shows |
| - | - |
| Installers and Design Concierges | **Hidden for your role**. The price is never sent to their screens. |
| Everyone else who can open the packet | The job's sold price, or a dash if there's no price yet |

In the **Site assessment** panel, every role (admins included) sees **Reservation paid** with no dollar amount.

## Only your own jobs

Installers can only open the packet for jobs they're on: as the **lead installer**, or as a helper the office added under **More installers** on an install or a site assessment. See [Add more installers](https://help.yournewdoor.com/guides/readiness-gates.md#add-more-installers).

| On the job as | What they can do in the packet |
| - | - |
| Lead installer | Everything: swipe the job's steps (like **On my way** and **Start**), photos, sign-off, flag a problem, hold and notes |
| Helper | Photos, sign-off, flag a problem, hold and notes. Only the lead swipes the job's steps. |

Helpers see the job on Field home and on **My schedule**. Opening the customer's page stays with the lead. Admins have one exception to all of this, for testing: see [Admin test mode](#admin-test-mode).

## Admin test mode

Admins can walk the whole installer flow at `ops.yournewdoor.com/field/<job id>` as a test, on any job, assigned to them or not.

> [!NOTE]
>
> Only the **admin** role gets test mode. Managers, PMs, dispatchers, CSRs, executives and the Owner still can't advance a job from the field. Installers haven't changed: only the lead installer can advance their job.

> [!WARNING]
>
> Test mode is **not a sandbox**. Every swipe changes the real job's status and step, and it shows in the job's History. Use a test job, never a live customer job.

### How you can tell it's a test

* **Banner on every screen.** The swipe panel on all six screens starts with an **Admin test mode** strip: "You are walking the installer flow as a test. Swiping here changes the real job status and step — it is not a sandbox."
* **Every step asks first.** Installers only get a confirm before **Complete**. In test mode, every swipe that records a step asks first: **Run "(step name)" as a test?** with "Test mode. This writes Step (number) (step name) to the real job and the job history." Tap **Yes, run (step name) (test)** to go ahead, or **Cancel**.
* **Complete asks too.** At the end you see **Complete this job as a test?** It warns that this marks a real customer job complete and that Complete can't be undone. The button says **Yes, complete (test)**.
* **History marks it.** Each step (and any undo) you record in test mode is saved in the job history as an admin test, so nobody mistakes it for an installer finishing the job.

**1. Pick a test job**

Open a test job's packet at `ops.yournewdoor.com/field/<job id>` while signed in as an admin. It opens on **01 · Summary** with the **Admin test mode** strip on the swipe panel.

**2. Swipe through the screens**

Swipe as an installer would and confirm each step when asked. Holds still apply: if the job is on hold, the swipe stays locked until it's resumed.

**3. Handle payment yourself**

Step 8 (payment) is the one step test mode won't do for you. See below.

### Payment (Step 8) isn't part of the test

Recording a payment would be a real charge on a real customer invoice, so admins don't get **Record payment** in test mode. Instead, once the job reaches step 7 (so payment is next) and while it's at step 8, **Summary** and **Finish Job** show a notice titled **Admin test mode · Step 8 is not self-serve**:

> Recording a payment would be a real charge on a real customer invoice, so this walkthrough stops at Step 8. If the invoice is already paid, Step 8 still works from here. Otherwise take the payment in Payments, then come back and finish the walkthrough.

## The six job screens

The job packet is six screens, in this order. You move through a job with one swipe at a time, and each of the nine job steps is saved on the job and shows in the office **History** with its time (CT).

| # | Screen | Steps it records |
| - | - | - |
| 01 | **Summary** | 1 On my way, 2 Start (on site) |
| 02 | **Before Photos** | 3 Before photos |
| 03 | **Job details and services** | 4 Remove old door, 5 Install frame and door, 6 Hardware and seal |
| 04 | **After photos** | 7 After photos |
| 05 | **Ending Summary and Notes** | None. Sign-off happens here. |
| 06 | **Finish Job** | 8 Payment, 9 Complete |

Only the lead installer swipes the steps. Helpers can add photos and sign off.

Every screen has the same header: **Back** on the left, the screen number and name with the job number in the middle, and a **Job options** (•••) button on the right.

### How moving between screens works

* **The swipe is the only way forward.** There's no Continue button.
* A swipe with an action name (like **Swipe: On my way**) records that step with its time (CT). When it's the last step on that screen, the same swipe takes you to the next screen.
* A swipe with a screen name and an arrow (like **Swipe: Before Photos →**) only moves you to the next screen. It records nothing. It's a shade lighter so you can tell the two apart.
* **Back** only changes the screen. It never records or undoes a step. On Summary, Back takes you to **My jobs**.
* Going back to a screen whose steps are already done never records them twice.

### 01 · Summary

Summary is the job's home screen. It has two swipes:

1. **"Swipe: On my way"** records step 1. You stay on Summary.
2. **"Swipe: Start"** records step 2 and moves you to Before Photos in the same swipe.

Once both steps are recorded, the Summary track reads **"Swipe: Before Photos →"**. That swipe records nothing; it only moves you to Before Photos when you come back to Summary. A **This screen's steps** list shows each step on the screen with its time (CT), or **Open** if it isn't done yet.

Summary also holds sold scope, notes and history, the **hold panel** (put the job on hold with a reason and a follow-up date; while held it shows the reason, follow-up date, when it was paused and any hold photos), installer and customer sign-off, flag exception, **Record payment** and **Text pay link**, and the **Start** / **Complete** buttons. Only the lead installer can start the job; admins, PMs and the Owner can start it on the installer's behalf with a reason.

Summary shows every photo already on the job, but you add new photos on Before Photos.

> [!NOTE]
>
> The customer's phone number now shows only the last four digits (for example **••• 1234**). Tapping it still calls the full number.

### 02 · Before Photos

Before Photos has four named photo slots: **Before**, **Detail**, **Wide shot** and **House number**. Tap an empty slot (it says **Tap to add**) to take or pick a photo for it. Each slot shows **Added** or **Not yet**.

Once a photo saves, its slot shows the photo itself as a thumbnail with a **✓ Added** strip, so you can see at a glance which slots are done. The strip shows right away, even while the picture is still loading on a slow connection. Every role sees the same thing.

> [!NOTE]
>
> Tapping a filled slot again doesn't replace its photo yet. It adds a second photo with the same name, so only do that if you mean to add another. Replacing a single slot's photo is coming in a later update.

Below the slots is the same bulk uploader as before, with the **Before / During / After / Site assessment** picker, so you can still add several photos at once.

The **Swipe: Before photos done** track stays grey until there are four before photos, and the line under it says how many are missing (for example "Add 2 more photos to swipe on."). Swiping records step 3 and moves you to screen 03.

### 03 · Job details and services

Job details shows the sold scope you work from: each sold line with its opening and options, any **Customer conditions**, and **Site assessment notes** when there are any. There are no prices on this screen. If nothing was sold yet, it says **"No sold lines on this job yet."**

It has three swipes, one per step, each saved with its own time (CT):

1. **"Swipe: Remove old door"** records step 4.
2. **"Swipe: Install frame and door"** records step 5.
3. **"Swipe: Hardware and seal"** records step 6 and moves you to After photos.

If something is wrong, the line **"Something wrong? Report a problem from Summary."** links back to Summary, where **Report a problem** lives.

### 04 · After photos

After photos works like Before Photos, with four named slots: **Installed**, **Detail**, **Inside** and **House number**. Each slot shows **Added** or **Not yet**, and the bulk uploader is below the slots.

The **Swipe: After photos done** track stays grey until there are four after photos, and the line under it says how many are missing. Swiping records step 7 and moves you to Ending Summary and Notes.

### 05 · Ending Summary and Notes

Ending is where you check the job and get it signed off. It shows:

* **Ending summary:** steps 1 to 7 with the time each was recorded, or **Open** if it isn't done.
* The photo counts, for example **"Before photos: 4 · After photos: 4"**.
* **Notes for the office**, when the job has notes.
* **Sign-off:** the same installer and customer sign-off as on Summary.

Until both sign-offs are in, the line under the swipe says **"Sign off below, then swipe to Finish Job."** The swipe on this screen, **"Swipe: Finish Job →"**, only moves you to Finish Job. It records nothing.

### 06 · Finish Job

Finish Job has the payment box from Summary and two separate swipes:

1. **"Swipe: Payment"** records step 8. You stay on Finish Job.
2. **"Swipe: Complete"** records step 9 and completes the job.

Amounts stay off this screen. A line at the bottom shows which sign-offs are done, for example **"Sign-offs: installer done · customer open. Use Ending or Summary if either is still open."**

Payment can be swiped when every invoice on the job is paid. Complete needs both sign-offs and nothing left to pay. When a swipe is locked, the screen tells you why:

| Message | What it means |
| - | - |
| **"Take payment to continue"** with **"Take payment below, then swipe Payment."** | There's a balance due. Take the payment with **Record payment** or **Text pay link**, then swipe. |
| **"Cannot verify payment — no invoice linked to this job"** | The job has no invoice, or its invoice was voided. Call the office. |
| **"Cannot verify payment — invalid invoice balance"** | The invoice balance can't be read. Call the office. |
| **"Need technician sign-off and customer sign-off to continue"** with **"Both sign-offs required — use Ending or Summary."** | One or both sign-offs are missing. The message names the one you still need. |

If the job was unsold, Finish Job shows the unsold notice and no payment can be taken. See [Take a payment](#take-a-payment).

### Job options (•••)

**Job options** only tells you where things are: putting a job on hold and reporting a problem are on Summary, next to sign-off. If something has to stop right now, do it from Summary and call the office. A dot on the ••• button means the job is on hold.

## Site assessment

The packet includes a **Site assessment** panel for recording opening measurements and a link to open the address in Maps. Photos, including the bulk uploader, are added on **Before Photos**. The assessment result is recorded as **Go** or **No-go**. Go moves the job to Pre-job; No-go puts it on hold.

On a job with a site assessment that isn't cancelled, or one that already has a site inspection draft or saved form, a **Site inspection** box sits at the top of the packet. **Open site inspection** walks each door with **Back** and **Next**, saves a draft as you go, and saves the answers on the job when you tap **Complete**. If you left partway, the button reads **Continue site inspection**. Go or No-go isn't part of that form. See [Fill out the site inspection form](https://help.yournewdoor.com/jobs/site-inspection-form.md).

## Take a payment

On **Summary**, **Record payment** and **Text pay link** let you collect cash or a check, or text the customer their pay link to pay by card. The lead installer can use it, and so can a crew helper on a visit for this job that is today (CT) or in progress. A visit that is cancelled, completed or a no-show doesn't count.

**1. Record cash or a check**

Tap **Record payment** and enter the payment. Cards aren't recorded in the field: the panel says **"Run cards through Text pay link — the customer pays on the secure pay page."**

**2. Or text the pay link for a card**

Tap **Text pay link**. The panel says **"Sends a fixed pay-link text to the customer. No amount and no link are shown here."** The message is fixed: **"Hi — this is Your New Door. Your invoice is ready to pay securely:"**, followed by the secure link and the opt-out line, which are added when it sends. Field Ops picks the customer's first phone that hasn't replied STOP. Tap **Send text**.

You never see the amount due, the link itself or the customer's phone numbers, and you can't copy the link. If you need a copy, ask the office.

A sold job gets its invoice on its own when the proposal is signed, so you can usually collect at the door. See [Invoice on a sold job](https://help.yournewdoor.com/jobs/billing-and-invoices.md#invoice-on-a-sold-job).

### When there's nothing to collect

Summary shows a **Take payment** box that tells you why:

| Message | What it means |
| - | - |
| **"No invoice yet — office needs to create one."** | The job has no invoice, for example a financed job or a half now, half later job waiting on its final invoice. Ask the office. |
| **"Paid in full — nothing due on this job."** | Every invoice on the job is paid. |

While the job is on hold, these buttons are hidden until the job is resumed.

### When it doesn't work

| Message | What it means |
| - | - |
| **"You're not on this job."** | You aren't the lead, and you aren't on a visit for this job today or in progress. |
| **"This job was unsold. Ask the office before taking a payment."** | The job was unsold, so no payment can be taken in the field. |
| **"Your texting line isn't connected. Ask the office to text the pay link, or connect RingCentral first."** | You don't have a texting line set up. |
| **"A pay link was just texted for this invoice. Wait a few minutes before sending again."** | The same pay link went to the same phone in the last 15 minutes. |
| **"Add a phone to text"** and the customer's name | The customer has no phone number. Ask the office. |

## Office view after field activity

> [tab] Completed
>
> Job shows complete on the Jobs desk; packet artifacts remain for QC.

> [tab] Exception
>
> Exception appears for office follow-up. Do not silently edit sold scope from the truck.

> [!TIP]
>
> Sandbox: **Acting as** an installer (e.g. demo tech) to rehearse packet completion before production roster invites.

## Boundaries

| Field packet can | Field packet cannot |
| - | - |
| Photos, sign-off, field exceptions | Rewrite sold lines |
| Take payment on jobs you lead or are on today | Open other installers' jobs |
| Complete assigned work | Schedule other trucks |
| Surface site mismatch | Push ServiceTitan estimates |

## Related

> [card] [Dispatch map](https://help.yournewdoor.com/guides/dispatch-map.md)
>
> How the job got on today’s truck.

> [card] [Sold to complete](https://help.yournewdoor.com/sales/sold-to-complete.md)
>
> Full pipeline context.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.