Provider live jobs and external imports

Refresh a live provider feed

Force a provider fetch when the cache is stale or an authorised refresh is needed.

Audience: Courier operations staffPermission: Courier: Manage integrationsModule v2.0.0
Exact navigationAdmin Area → Courier & Logistics → Live Jobs → Refresh

What this guide covers

Force a provider fetch when the cache is stale or an authorised refresh is needed. The instructions below follow the supplied module’s controller, form and model rules, including server-side validation and downstream effects.

Exact step-by-step process

  1. Select the provider.
  2. Use Refresh/force sync.
  3. Review response and sync log.
  4. Verify normalised jobs in the cache.

Fields, choices and supported possibilities

This action uses the values already stored on the selected source record. Review that record before continuing.

Code-backed validations and workflow rules

  • Normal cache use respects provider interval and a minimum live-cache age.
  • Courier Exchange detail calls are throttled and normalisation is capped at 500 jobs.

Expected result and verification

  • The source record, status/history and any downstream notification, provider, POD or finance record should agree after the action.

Security, audit and operational checks

  • Use the exact record and least-privilege role before changing any state.
  • Verify the saved record after every action; a browser message alone is not evidence that every downstream step completed.
  • Use protected document and image routes rather than exposing server filesystem paths.
  • Keep customer, driver, provider, financial and credential data within the authorised workflow.
  • For provider, finance, employment, transport and compliance decisions, follow the organisation’s authorised professional process.
Do not bypass the code flowDo not force database values, invent a status, mark a job completed without signed POD evidence, or expose encrypted credentials to make a screen appear successful.