Skip to content
SurogateDocs

Example: file and approve a contract

Radu Florea files the street-lighting maintenance contract, attaches its technical annex, validates it and asks the Secretary General to sign it. The Secretary General signs, approves and publishes it. The example is for staff.

The pictures were taken in a demo city hall, Example City Hall, with made-up people and documents.

WhoDoes what
Radu Florea, contracts clerk in the Legal DepartmentUploads the contract into Contracts 2026, fills in its metadata, attaches the annex, validates it and asks for a signature
Mihai Stan, Secretary GeneralSigns the contract internally, approves it and publishes it

The DMS has no approval workflow of its own. (A flow that spans several people and systems can run in Keel: see Workflows and cases with Keel.) The states, the signing request and the permissions carry the approval: Radu may validate, and only a person who holds the permissions to approve and publish, here Mihai, may take the document further.

Radu opens Library › Legal Department › Contracts 2026 and presses Upload. He chooses the file, gives it a title, chooses the type Contract and fills in the two required fields, Contract number and Counterparty.

Radu's Upload a document dialog for the contract: type Contract, Contract number and Counterparty

On the Metadata tab Radu presses Edit and fills in the value, the dates and the person responsible, then presses Save. A Person field offers the people of your institution.

The metadata of the contract in edit mode: value, dates and responsible person

The technical annex is a document of its own, filed in the same folder and validated. On the contract’s Attachments tab Radu attaches it. A document takes attachments only while it is a draft or validated, so Radu attaches the annex before the contract is approved. See The document page.

The Attachments tab of a building permit, with its site plan attached

Radu validates the contract and, on the Signatures tab, presses Request a signature for Mihai, with Internal allowed. The page now says “Waiting for one signature”.

The contract validated, waiting for one signature

The DMS may also tell Radu that a document with the same name or the same content exists in the folder. It is a notice; it does not stop him.

Mihai finds the request in Notifications and on To sign, opens the contract, chooses Sign › Internal and presses Sign internally.

Mihai's Notifications page with the signature request
The Sign internally dialog

On the signed contract the button Approve is offered to Mihai. After it he can Publish it.

The signed contract with Approve offered to Mihai

Radu sees the contract Published, with its signature.

The contract published, with the signature of Mihai Stan
  • A staff member with Standard user validates; approving and publishing need their own permissions.
  • A signing request asks named people; they sign internally, or with a token when the request allows it.
  • See Signing and The life of a document.