Skip to main content
The Odoo module follows the same pattern as the other store plugins: the Element on the product page, Add to cart gated on canProceed, and the jobId persisted on the order. It differs in how the job reaches the cart, because Odoo’s add-to-cart is a JSON call that posts none of the product page’s own inputs. Merchants install it from the Odoo installation guide. The source is on GitHub.

Product page

Above Odoo’s quantity and Add to cart block, the module renders a mount point, its settings as JSON, and the per-key script:
A small script then calls Filecheck.mount with the product’s workflowId, presentation, connectorId and artworkTiming, and cartButtonSelector: '#add_to_cart, .o_we_buy_now'. Odoo’s Add to cart and Buy now are links rather than buttons, so mount() can only mark them aria-disabled and .filecheck-gated; the module blocks clicks on gated links itself.

From the page to the order

1

Each status goes to the session

On every status event the script posts the jobId, whether it can proceed, and the file names to the module’s /filecheck/save_job JSON route, which keeps them in the Odoo session for that product. Add to cart stays gated until the save lands.
2

Add to cart copies the job onto the line

When the product is added to the cart, a job that can proceed is copied onto the new sale order line, with the file names in the line description. Each uploaded file gets a cart line of its own.
3

Confirmation sends the order to Filecheck

When the order is confirmed, the module sends it to POST /orders/{id} from a background job, with retries. Lines with a file carry their jobId. Lines of a Filecheck product without one carry "awaitArtwork": true and the product’s workflowId, whatever the product’s timing, since such a line exists only when the upload could not run. Cancelling the order sends its new status.
4

Print files are saved on the order

Once a job has finished, the module reads its runs and downloads each run’s downloadUrl (the corrected file, else the upload) as an attachment on the sale order. Those URLs are presigned and short-lived, so they are fetched fresh each time and never stored.
For orders waiting for artwork, the module fetches GET /orders/{id}/upload-link for the confirmation page, the portal and the email. It asks again every 30 minutes for 60 days, and puts the jobs customers create on the upload page onto their order lines.

Settings

Keys and defaults live on each Odoo website: publishable key, secret key (system administrators only, never sent to the storefront), agentId, default Workflow, artwork timing and presentation. Each product chooses off, the website’s default Workflow, or a specific one, plus its own timing, presentation and Connector. Two System Parameters change the defaults: