Skip to main content
A Job (job_…) represents a single transactional run of a file or set of files through a validation, preflight, or optimization pipeline. Jobs are generated automatically when customer uploads flow through a storefront Workflow, but they can also be initiated manually by administrators for instant preflight or optimization (saving you from running a workflow “ritual”). As a job progresses, it emits interactive, real-time status events.

​
Job statuses

Filecheck tracks the lifecycle of every file through standard statuses:
“Manual review” uploads. When a Rule’s onFail policy is Manual review, the file is accepted but held for an admin to approve before it proceeds.TODO(filecheck): document the status value a held-for-review file reports, whether canProceed is false while held, and how it clears once an admin approves.

​
Gating with canProceed

To protect your checkout pipeline, Filecheck exposes a simple canProceed boolean alongside the job status.
  • canProceed is true only when the job is in a ready or partial status.
  • When canProceed is false, your e-commerce plugin or custom submit button remains disabled.
Important Integration Guideline: Never attempt to re-derive the canProceed flag by reading individual status values or raw file structures. Filecheck automatically evaluates the assigned Upload Rule’s onFail policy and encapsulates it in canProceed. Always gate directly on this flag.

​
Persisting and retrieving job output

When canProceed is true, the browser receives a finalized jobId.
  1. At Checkout: The jobId is passed and stored as meta-data on the customer’s order.
  2. Post-Purchase Fulfillment: The validated, fixed, or optimized production files can be retrieved in two ways:
    • E-commerce Dashboard: Attached directly to the WooCommerce, Shopify, OpenCart, or PrestaShop order page for immediate download.
    • Filecheck Portal: Searched and downloaded under the Jobs tab at admin.filecheck.io/jobs.
    • REST API: Downloaded programmatically via GET /jobs/{id} using your secret key. See Verify jobs.