DEV Community

Cover image for One Job, Done Twice: What We Found Inside a Sales Onboarding Process
ksoft technologies
ksoft technologies

Posted on Originally published at ksofttechnologies.com

One Job, Done Twice: What We Found Inside a Sales Onboarding Process

A process can look completely reasonable until you follow it from beginning to end.

That is what happened in a sales onboarding workflow I looked at recently.

A field representative visited a restaurant, collected the business details, completed a checklist, took photos, captured a signature, and recorded location information.

Then the office team received the same information and entered it again.

That second step was the real problem.

Not slow typing.

Not insufficient staff.

Not a lack of software.

The same business record was being created twice.

The Workflow Looked Fine on Paper

At a high level, the process sounded normal:

Field visit
→ collect restaurant data
→ send information to office
→ create account

The problem only became visible when we expanded each step.

The field representative already had to:

Collect restaurant details
Complete checklist
Take kitchen photos
Take menu photos
Capture owner signature
Record location information

Then the office team had to:

Read submitted information
Re-enter restaurant details
Receive photos separately
Match photos to the correct restaurant
Check for missing fields
Contact the field rep when something was incomplete
Verify the final record

Once mapped this way, it stopped looking like a simple onboarding workflow.

It looked like two record-creation workflows connected by a handoff.

The First Wrong Question Would Have Been “How Do We Speed Up Data Entry?”

That would have been an easy mistake.

If office staff are spending too much time entering information, a technical team might naturally start thinking about:

a better admin screen
fewer clicks
bulk entry
keyboard shortcuts
faster APIs
improved form design

All of those could make the office step faster.

None of them would remove the duplicate step.

The better question was:

Why is the office recreating information that was already collected in the field?

That changed the direction of the solution.

The Point of Data Creation Matters

A useful design principle came out of this:

Capture information once, at the point where it is created, in the format that becomes the final business record.

The field representative is physically at the restaurant.

That is where the data originates.

That is where:

the restaurant details are confirmed
the photos are taken
the checklist is completed
the signature is captured
the location information is known

So that is where the final record should start.

If the field team collects the information in a structure that can be saved directly, there is no need for the office to reconstruct it later.

The workflow becomes:

Field visit
→ digital capture
→ validation
→ database record

That is much cleaner than:

Field visit
→ paper + phone
→ office re-entry
→ photo matching
→ corrections
→ final record
Photos Were a Bigger Problem Than They Looked

The photos were not just attachments.

They were part of the business record.

When images arrived through a separate path, someone had to figure out:

which restaurant they belonged to
whether all required photos were present
whether they came from the current visit
whether they had already been attached to the correct record

That is a data-model problem disguised as file handling.

If photos are captured inside the onboarding flow, the relationship is known immediately.

Restaurant record
├── business details
├── checklist
├── kitchen photos
├── menu photos
├── owner signature
└── location data

Now the system does not have to reconstruct relationships later.

Validation Should Happen Before the Context Disappears

Missing fields created another unnecessary loop.

In the old process, a missing value might only be discovered after the field visit was over.

Then the office team had to contact the field representative.

The representative might need to contact the restaurant again.

A small omission suddenly created multiple follow-ups.

A better design moves validation closer to the point of capture.

For example:

required_fields_complete == true
required_photos_present == true
signature_present == true
location_present == true

The implementation does not have to be complicated.

The important part is timing.

If something is missing, the best moment to catch it is while the representative is still at the restaurant.

The Real Architecture Was a Workflow, Not a Form

It would be easy to describe this as “build a digital form.”

That is too shallow.

The form is only the UI.

The real system is a workflow that needs to guarantee that data moves from field capture to a reliable business record.

Conceptually:

Mobile/Web UI

Validation

File handling

Submission API

Database transaction

Audit trail

Each part matters.

If validation is weak, incomplete records enter the system.

If file handling is separate, images become difficult to associate.

If database writes are partial, the system can end up with incomplete onboarding records.

If there is no audit trail, failures become difficult to investigate.

Auditability Matters When You Remove Manual Steps

Manual workflows are inefficient, but they often provide accidental visibility.

Someone in the office sees the form.

They see the images.

They notice something strange.

They remember what they entered.

Once that manual step disappears, the software needs to provide enough traceability to replace that visibility.

Useful audit information might include:

submitted_by
submitted_at
restaurant_id
fields_received
files_received
validation_status
record_creation_status
failure_reason

This is especially important when onboarding happens in the field, where connectivity may not always be perfect.

The system needs to make it clear whether a submission:

completed
partially failed
is waiting for retry
never reached the backend

Automation without observability can create a different kind of operational problem.

Test the Journey, Not Just the Screen

A form can pass unit tests and still fail as a business process.

Every field might save correctly.

The API might return 200.

The upload might work.

But the real test is:

Can a field representative complete the entire restaurant onboarding without creating work for the office afterward?

That means testing the whole journey:

Open onboarding
→ enter restaurant details
→ complete checklist
→ capture photos
→ capture signature
→ validate
→ submit
→ create database record
→ verify record

That end-to-end test is much more meaningful than checking each component in isolation.

What I Would Look for in Similar Workflows

This pattern appears in many systems.

Whenever I see one person collecting information and another person recreating it later, I ask whether the handoff is necessary.

Typical warning signs:

paper form followed by data entry
spreadsheet followed by app entry
photos sent separately from the main record
repeated copy/paste between tools
office staff interpreting field notes
missing-field follow-ups after the original visit
multiple systems recreating the same entity

These are often good automation candidates, but the important part is not “automate everything.”

It is:

remove duplicate record creation.

Practical Checklist

When reviewing a field or sales onboarding process, ask:

Where is the information first created?
Is the same data entered again later?
Are photos or files traveling separately?
Are missing fields discovered too late?
Can validation happen at the point of capture?
Can the first submission become the final database record?
Is the process observable when something fails?
Can the team tell who submitted what and when?
Are we making a bad handoff faster, or removing it?

The best outcome is often not a faster second step.

It is no second step at all.

That was the key lesson here: the company did not need better duplicate data entry.

It needed to stop creating the same restaurant record twice.

For the full case study, see:

One Job, Done Twice: What We Found Inside a Sales Onboarding Process

Top comments (1)

Some comments may only be visible to logged-in visitors. Sign in to view all comments.