Documentation Index
Fetch the complete documentation index at: https://docs.arcuserp.com/llms.txt
Use this file to discover all available pages before exploring further.
Open Document Manager
Open Documents from the main app navigation. The page is scoped to the active entity and requires document access through the same app permission model used by operational records.

Understand The Counters
- Total Documents: active, non-archived documents for the current entity.
- Invoices: documents categorized as invoices.
- Shipping Labels: label files created from shipping workflows.
- Tax Documents: tax records and exemption certificates.
- This Month: active documents created during the current calendar month.
Search And Filter
Use search when you know part of the file name, description, source reference, or tag. Use filters when you need a narrower operational set, such as invoices, purchase orders, shipping labels, product images, account attachments, receipts, reports, or general files.
- Search: searches file names, descriptions, source labels, and tags.
- Category: groups documents by business use, such as invoice, quote, sales order, purchase order, packing slip, shipping label, tax document, product image, account attachment, receipt, report, or general.
- Source Type: filters by the record that produced or owns the document, such as order, account, product, package, return, purchase order, or manual upload.
- List view: best for auditing category, source, uploader, date, and actions.
- Grid view: best for quickly scanning images, PDFs, and document cards.

Upload A Document
Use Upload Document for files that were not generated automatically by an order, invoice, shipping, tax, or purchasing workflow. Manual uploads are useful for signed forms, vendor files, receipts, customer attachments, report exports, product images, and supporting records.

- Click Upload Document.
- Drop a file into the upload area or click to browse.
- Choose the correct category.
- Select a source type when the file belongs to a record.
- Enter a source reference that users will recognize, such as an order, invoice, purchase order, account, package, return, or product reference.
- Add a short description and tags when they will help future search.
- Click Upload and wait for the upload to complete.
Use Document Actions
Each row or card exposes actions for the selected document. Use these actions instead of bookmarking storage links, because download and copy-link actions request fresh secure links from the backend.

- Download: downloads the file through a short-lived signed URL.
- Preview: opens a modal for previewable PDFs, images, and CSV files.
- Edit Metadata: updates category, source reference, description, and tags.
- Copy Link: copies a temporary secure link for short-term sharing.
- Archive: hides the document from the active library while preserving the record.
Edit Metadata
Edit metadata when the file is real but the category, source reference, description, or tags need cleanup. Metadata changes do not replace the uploaded file.

Security And Storage Behavior
- Entity isolation: document list, stats, reads, updates, and archive operations are scoped by entity.
- Private storage: the app stores files in a private bucket rather than relying on public object URLs.
- Signed access: previews, downloads, and copied links use short-lived presigned URLs generated by the backend.
- Upload confirmation: a document record is created first, then the file uploads, then the app confirms size and completion.
- Activity logging: create, upload, update, archive, and version events are logged for audit history when the backend can record them.
- Version records: replacement uploads can be represented as new versions under the original document family.
Common Scenarios
- Find an invoice PDF: search the invoice number, filter by Invoice, then preview or download.
- Attach a vendor document: upload the file, choose a purchasing or purchase order source type, and enter the purchase order reference.
- Store a tax certificate: choose a tax category and include the account, exemption, or certificate reference in the source field or tags.
- Clean up duplicate files: confirm which file is valid, update metadata if needed, and archive the duplicate.
- Share a file temporarily: use Copy Link, then remember that the copied link will expire.
- Find generated labels or packing slips: filter by Shipping Label or Packing Slip, then use the source reference to match the order or package.
Common Blocks
- No documents found: clear filters, search a broader term, or confirm the file belongs to the active entity.
- Preview will not open: the file type may not support inline preview. Download or open the file in a new tab.
- Copied link stopped working: copy a fresh link from Document Manager.
- Wrong category: edit metadata and select the category users will search for later.
- Upload failed: retry after confirming the file is available locally and the connection is stable.
- File should not be active: archive it instead of changing the file name or metadata to hide it.

