Ga naar hoofdinhoud

AI-assisted Receipt & Bill Capture

Photographing a receipt or dropping in a PDF supplier invoice should not mean re-typing every field by hand. Shillinq consumes docudesk's document intelligence (ADR-010, ADR-022) to pre-fill a draft with the extracted values — but a person always confirms before anything is booked. Shillinq never runs OCR itself and never shows a fabricated field: every value comes either from docudesk's extraction or from you.

Goal​

By the end of this guide you will understand how an extraction draft appears, what the confidence badges mean, how to correct a field, and how to ask docudesk to try again.

Prerequisites​

  • A Nextcloud account with Shillinq and docudesk both installed and enabled.
  • A receipt photo or supplier-invoice PDF already stored in docudesk (via the normal upload/scan flow).

Section 1 — How a draft appears​

When docudesk finishes extracting a document it notifies shillinq, which creates an uncommitted draft:

  • A photographed receipt becomes a Receipt draft under Receipts.
  • A PDF supplier invoice becomes a pending entry in the Import bill dialog's upload step, under "Extracted fields".

Nothing is booked yet — the draft only becomes a real bill or expense once you review and save it.

Section 2 — Reading the confidence badges​

Every field the extraction touched shows a badge: a percentage plus a short label — never colour alone, so the status is always readable.

BadgeMeaning
Extracteddocudesk populated this field; confidence is at or above the review threshold.
Needs reviewConfidence is below the review threshold (80%) — double-check this value before saving.
CorrectedYou already edited this field; your value is what will be saved.
ManualThis field is not something docudesk extracts (e.g. the GL account) — you always fill it in.

When the draft's overall confidence is 90% or higher, saving can be a single click. Below that, you are asked to look over the fields first. In both cases saving is always an explicit action you take — a high confidence score never books anything automatically.

Section 3 — Correcting a field​

Every extracted field is a normal, editable input. Change whatever is wrong and click Save. Shillinq records, on the server, which fields you changed — the original extracted value and its confidence stay available for audit even after your correction, they are never silently discarded.

Section 4 — Asking docudesk to try again​

If a draft's confidence is low (for example a blurry photo), open the draft and click Request extraction. This asks docudesk to re-run extraction on the same source document; once it completes, the draft updates in place with the new values — no duplicate record is created.

Section 5 — When docudesk has no result​

If you upload a PDF directly into the Import bill dialog and no docudesk extraction is available for it, the dialog tells you honestly that PDF extraction is not available yet and asks for a UBL/e-invoice XML or CSV file instead — it never shows made-up "extracted" values.

Troubleshooting​

ProblemCauseSolution
No draft appears after scanningdocudesk has not finished, or callbackEvent was not requestedWait a moment, or use Request extraction on the source document.
"Request extraction" shows an errordocudesk is unreachable or not installedRetry later; the existing UBL/CSV import paths are unaffected.
A field stays empty after extractiondocudesk could not determine that valueFill it in manually — the field will show as Manual/Corrected.