Help CenterSign In

Fixing a Failed Dispatch

Find the failed VLX attempt, repair its connection or mapping and retry the recorded job.

For Owners, Admins, Office Staff · Updated

On This Page

Open the Failed Job

Home's Needs Attention lists VLX Dispatch Failed. Open the job: its Next Step names the form VLX refused and the first sentence of the reason, with Retry. The VLX Inspection row in the job's Status box opens on the failure and shows the whole error recorded for the attempt. A failed dispatch is not the same as a completed inspection whose report has not been refreshed.

Check the Connection

An owner or admin can open Settings, VLX Connection and test the saved key with the input empty. If the key was replaced or removed, enter it again and choose Save & Connect, then check the service mappings. Office Staff can manage jobs but cannot repair company Settings; ask an owner or admin for that step.

Check Form and Assignee Mapping

Confirm each service has a suitable inspection form. A service with no form is skipped rather than failed: Dispatch sends the job's other forms and names the service it skipped, and is refused only when no service on the job has a form. If a failed attempt says VLX no longer has this form, or after Sync from VLX a service in Inspection Forms shows No longer in your VLX workspace, pick another form for that service, then return to the job to send the replacement. Forms that share a name and team end with a short ID, the start of each form's VLX ID, so you can tell them apart. When the inspector has no VLX account, the inspection goes to the company owner, or to the account named in Who Inspections Are Assigned To. An owner or admin sees a link to the right Settings section in the error itself. Check the job's inspector and appointment too: editing a company mapping does not change who was already recorded on the job.

Retry the Recorded Attempt

Return to the job. While a failed attempt is listed in the VLX Inspection row, Next Step offers Retry, which sends its form again; Retry is also in the row's More VLX Actions menu. If you picked another form for its service, the failed attempt leaves the row and Home's Needs Attention once no service on the job uses the old form. Then choose Dispatch Again in the row's menu to send the replacement, or Dispatch to VLX in Next Step when nothing else on the job was sent. The job does not complete until the replacement's inspection does; a job whose other inspections are done stays In Progress until then. Check each inspection's status in the row afterward. The row never shows VLX's own inspection ID; if VLX support asks for it, choose Copy VLX ID in that inspection's menu. If the connection was unreachable and the result is uncertain, check the inspection in VLX before choosing Dispatch Again or creating an inspection manually. Dispatch Again is not a general refresh button: Refresh is.

Contact Support With the Page

If retry still fails, use Contact Support from Help and Support. Describe the action, time and error in the popup form. Do not send connection keys, passwords or client details. Use Refresh when the inspection already exists and field work has completed; use VLX Help for the field-app side.

Was This Helpful?

Need More Help?