Skip to main content

Re-scan Extraction

POST 
/api/purchase-invoices/ocr/:purchase_extraction_id/rescan

Re-dispatch the OCR extraction job for an existing PurchaseInvoiceOcrExtraction. Resets status to 'processing', clears any previous error_message, and re-queues a background job against the original PDF in S3. Useful when Azure misread the document (wrong supplier match, missing lines) and the user wants to re-run extraction without re-uploading.

Required scope: orders:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Allowed from any status except 'confirmed' (a confirmed extraction has already produced a PurchaseInvoice and is locked).

Response 200:

{
  "data": {
    "extraction_id": 7,
    "tracked_job_log_id": 1234,
    "status": "processing"
  },
  "message": "Re-scan started."
}

Response 422 — confirmed extraction:

{ "message": "Confirmed extractions cannot be re-scanned." }

Response 422 — file no longer available:

{ "message": "Cannot re-scan — original file is no longer available." }

Poll GET /purchase-invoices/ocr/{id} until status flips back to 'pending_review' (or 'failed').

Request​

Responses​

Successful response