vendor-doc-intake

name

vendor-doc-intake

description

Daily vendor-onboarding intake for {{request_label}}. Validates the W-9, banking form, and signed contract for every new vendor request against a fixed checklist, records every vendor's status in {{vendor_register}}, drafts a follow-up for anything missing or invalid, and posts the batch to {{review_channel}}. Load this before checking a single vendor so every one is held to the same standard and the agent never approves a vendor or touches payment or banking setup.

Process every new vendor request landing in `{{request_label}}` without missing a missing or invalid document, and without ever moving toward approval or payment. A cron fires every `{{cadence}}` against a fresh session; the session has no memory of the last run, so it reads `{{vendor_register}}` first, pulls new request email, checks the W-9, banking form, and signed contract against a fixed checklist, records the result, and posts the batch to Slack. Recording and flagging are the agent's job; approving a vendor and setting up payment or banking are not — those stay with a person, on every vendor, complete paperwork or not. - The `{{cadence}}` cron fires the intake run. - A human asks the agent to re-check a specific vendor's document status. - A human asks why a vendor was flagged or what's still missing.

Step 0 — Orient from the register, not from memory

This is a fresh session — there is no prior turn to resume. {{vendor_register}} is the memory.

Open {{vendor_register}} and read every existing row: vendor name, contact, date received, status of each of the three documents, overall flag, and the Gmail thread ID recorded in the last column. This is what this run's new requests get checked against so nothing is processed twice.

Step 1 — Pull new vendor requests

Check {{request_label}} in Gmail for threads not yet reflected in {{vendor_register}} (match on Gmail thread ID). For each one, identify the vendor name, the contact email, and every attachment.

Step 2 — Validate against the fixed checklist

Every vendor gets the same three checks, no exceptions:

• W-9 — a completed IRS Form W-9: legal name, TIN or EIN filled in, and a signature with a date. Missing any field, or unsigned → invalid.
• Banking form — bank name, account number, and routing number all present, and the form signed. Check completeness only; do not extract or transcribe the account or routing number anywhere. Missing a field or unsigned → invalid.
• Signed contract — a signature present, dated, and the vendor's legal name matching the name on the W-9 and the banking form. A name mismatch, missing signature, or missing date → invalid.

If any of the three documents is absent entirely, record it as missing rather than invalid — don't guess at content that isn't there.

Step 3 — Cross-check vendor identity

Compare the legal name across all three documents and the contact email's domain against the vendor name. A mismatch (different entity name on the contract than the W-9, or a contact email that doesn't plausibly belong to the vendor) is its own flag, even if each document is individually complete — note it as name-mismatch.

Step 4 — Record every vendor, flagged or clean

Append or update one row per vendor in {{vendor_register}}: vendor name, contact email, date received, W-9 status, banking form status, contract status, overall flag (clean / missing / invalid / name-mismatch, or a combination), and the Gmail thread ID. Never leave a request unrecorded for being incomplete — an incomplete vendor is still a row, flagged.

Step 5 — Draft a follow-up for anything missing or invalid

For every vendor with any flag, create a Gmail draft addressed to the vendor's contact naming exactly what's missing or needs correction (e.g. "the W-9 is unsigned," "the contract lists a different legal entity than the W-9"). Save it as a draft only — never send it.

Step 6 — Post the batch for review

Post to {{review_channel}}: every vendor processed this run, grouped clean vs. flagged, each with its register row and, for flags, the specific document and issue. Note that a draft follow-up exists for each flagged vendor, waiting to be reviewed and sent.

Step 7 — Stop — never approve, never touch payment or banking

Your last action is the Slack post. You never mark a vendor approved, and you never schedule, configure, or write to any payment method, ACH setup, or banking profile in any system — not even for a vendor whose three documents are fully complete and consistent. That decision, and the setup that follows it, is always a person's.

- **No approval, ever.** The agent has no connector or instruction that marks a vendor approved — not even for a fully clean, matched set of documents. That step is always a human's. - **No payment or banking action, ever.** The agent never sets up, schedules, or writes to a payment method, ACH enrollment, or banking profile in any system, regardless of document completeness. - **No sensitive data at rest in the register.** Bank account and routing numbers are checked for presence and completeness on the source form but never transcribed into `{{vendor_register}}` — only a status. - **Record, don't discard.** A vendor with a missing or invalid document is still recorded in `{{vendor_register}}` with its flag — never silently dropped or skipped. - **No force-validating.** Don't infer a signature, a TIN, or a name match that isn't actually on the document. Flag it as missing or invalid instead of assuming it's fine. - **Drafts, never sends.** Every outbound email to a vendor is created as a Gmail draft. A human reviews and sends it. - **Scoped, brokered credentials.** Gmail and Google Sheets access are injected into the sandbox at runtime, scoped to this agent's grant. - **Idempotent per run.** Match new requests against `{{vendor_register}}`'s Gmail thread IDs before processing so the same request is never recorded twice across runs.