> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vinmake.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 3 · Hand it to the Clerk

> Submit to clerk. The document enters the intake queue as a normal reviewable row, and the handoff becomes permanent record.

# 3 · Hand it to the Clerk

**What you are doing.** Moving a signed document out of the composition lane and into the review lane.

One button.
The document enters the Clerk's intake queue as a normal reviewable row, and the document page records the handoff.

## Submit

```http theme={null}
POST /typewriter/documents/{document_id}/submit
X-WorthState-Org-Id: <org>
```

```json theme={null}
200 OK

{
  "handoff_id": "<handoff id>",
  "intake_id": "<intake row id>",
  "outcome": "created",
  "created_at": "2026-07-26T21:35:04Z",
  "duplicate_of": null,
  "duplicate_of_version": null
}
```

<Note>
  `duplicate_of` and `duplicate_of_version` ride back on the response because **"filed" and "filed as a
  second version somebody now has to choose between" are different facts on a money path**, and a bare
  success would report them identically.
  Both are `null` on an ordinary submit.
</Note>

<Note>
  The submit is **idempotent**, through the intake queue's own partial unique index.
  A double-submit resolves to the same intake row and is reported as `"outcome": "duplicate"` rather
  than as either a second row or a silent no-op.

  That distinction matters: a silent no-op and a successful submit look identical to a caller, so the
  caller cannot tell whether a retry worked.
</Note>

## What just happened underneath

The handoff is not a status change on the document.
It creates a row in a different system - the Clerk's intake queue - and records the link in both directions.

The document page keeps the handoff as part of its permanent record: **Submitted**, the timestamp, the identity that submitted it, and an **open in review** link that carries the intake id.

That link is one direction of a durable lineage chain.
After posting, Transactions resolves the accounting event back to its native source, approved workpaper and intake document when those records exist; unresolved historical evidence remains `missing` or `legacy_unverified` rather than being guessed.

## It arrives in the review inbox

Follow **open in review**, or go to **Books → Review**.

The new row is *drafted by typewriter* and ordinarily lands at **ready to review** with no Clerk extraction flags.
That is because the handoff projects the schema payload directly into `intake_queue`; it does not re-run the Clerk graph, classification, extraction or Teable master resolution.
A conflict with another live version in the same document group can instead land as **flagged** for a human to choose.

<Note>
  Line items are shown as raw JSON in the detail pane.
  The count underneath - "1 line item extracted" - is the readable version.
</Note>

## What you cannot do here, and why

**Submitting is not approving.**
A composed document arrives in the queue as something a human still has to judge, exactly like a PDF someone dropped into chat.

It arrives *unflagged* rather than *pre-approved*, and those are different.
Unflagged here means no Clerk extraction pass produced a doubt, because no such pass ran.
It does not mean the amount is right, the supplier is right, or that the document should be in your books at all.
That is what gate 1 is for.

<Warning>
  **Send back will not work on this row.**
  A Typewriter-composed document lands at *ready to review*, and send-back is only accepted for rows the
  Clerk actually **flagged**.
  The control is present and enabled on a row that can never accept it, and the server refuses the click.

  There is nothing to send back to: a schema-built document has no agent extraction to redo.
  If it is wrong, **reject** the queue row and **revise** the document in the Typewriter.
  The full explanation is on [Working the review inbox](/greatbook/guides/review-inbox).
</Warning>

## Next

<Card title="4 · Gate 1, the intake approval" icon="inbox" href="/greatbook/guides/intake-gate" horizontal>
  Read the flags, then decide. Nothing is in the ledger yet.
</Card>

## Related

* [2 · Sign it](/greatbook/guides/approve-a-document)
* [The other lane: uploading a document](/greatbook/guides/upload-a-document) - where non-composed documents join this same queue
* [Typewriter to posted journal entry](/greatbook/technical/typewriter-to-ledger) - the technical chain, source evidence and unverified deployed handoff