โšก JWTC Lien Release & Payment Workflow

Baltimore Snow Emergency โ€” DPW Contract | v2.1 โ€” March 1, 2026

Excel
App
DocuSign
JWTC Action
Sub Action
Payment Gate
Admin
Retainage

๐Ÿ”ง System Architecture โ€” How the Pieces Connect

๐Ÿ“Š Excel (OneDrive) โ†’ ๐Ÿ“ฑ Waiver App โ†’ โœ๏ธ DocuSign API โ†’ ๐Ÿ“ง Sub-Sub Email
Excel = source of truth for work data, rates, and amounts (Charlene/Lindsey enter data)
App = reads Excel via OneDrive API, presents batch review, runs checklist, triggers DocuSign, writes status back
DocuSign = generates waivers from templates, sends for e-signature, tracks status, returns signed PDFs
Two-way sync: Excel โ†’ App (data) | App โ†’ Excel (waiver status, payment status)

๐Ÿ’ฐ 10% RETAINAGE โ€” Core Principle (MSA ยง4.G)

  • Every progress payment is at 90% of gross billable. JWTC holds 10% retainage.
  • Waiver amounts ALWAYS reflect actual net payment (90%), never the gross amount.
  • Retainage accumulates across all payment batches.
  • Final payment batch releases ALL accumulated retainage.
  • Retainage flow-down to sub-subs: TBD โ€” pending confirmation from Subcontractor on their sub-sub payment terms.
Phase 0 โ€” Onboarding (One-Time Setup)
0A Sub-Subcontractor Registry JWTC + Sub
  • Subcontractor declares ALL sub-subs โ€” legal entity, owner/officer, contact info, insurance, contract
  • JWTC validates and tracks each sub-sub (MSA ยง14 โ€” names/addresses upon request)
  • Registry serves as de facto approval gate โ€” no sub-sub gets paid without being in the system
  • OneDrive folders created per sub-sub (contracts + insurance certs)
  • Registry locked โ€” no new entities without approval
Phase 1 โ€” Data Entry & Batch Preparation
1 Work Records Entered in Excel Charlene / Lindsey
  • Enter work records: operator, equipment, hours, dates (cols A-L, with L auto-calculated)
  • Indy Rate (K) ร— Hours (J) = Indy Payable (L)
  • Retainage (M) auto-calculates: L ร— 10%
  • Assign rows to Payment Batch (P): PR1, PR2, PR3, etc.
โ†“
2 App Syncs Excel Data System (Automatic)
  • App reads from Excel via OneDrive API
  • Groups rows by batch + sub-sub company
  • Calculates per sub-sub: gross, retainage held, net payment (90%)
  • Shows running retainage balance across all batches
  • Flags any rows with missing data, unrecognized entities, or calculation errors
โ†“

โœ… "Ready to Send" โ€” 8-Item Verification Checklist

Designated reviewer (assigned per project โ€” NOT Brian) must check ALL 8 items in the app. Button does not enable until all are verified. Full audit trail: who, when, what batch.

  1. All entities in the batch are in the approved sub-subcontractor registry
  2. Rates match the contracted/agreed rates for this project
  3. Payable amounts are correctly calculated
  4. Retainage is correctly calculated (per project setting)
  5. Payment batch assigned, no duplicate entries
  6. All unconditional waivers from the prior batch have been received (auto-skip on first batch)
  7. No outstanding disputes from prior batches blocking this one (auto-skip on first batch)
  8. Sub-sub insurance certificates are current for all entities in the batch
๐Ÿ” GATE 1 โ€” Reviewer Verification
All 8 checklist items verified by designated reviewer โ†’ Ready to Send = Yes written back to Excel (col Q)
โ†“
Phase 2 โ€” Conditional Waiver Collection
3 App Presents Batch for Final Approval Brian / Designee
  • App shows batch summary: each sub-sub, their gross, retainage, net payment
  • Running retainage balance visible
  • Reviewer verification status: โœ… all 8 items checked
  • Brian (or designee) reviews amounts and clicks "Send Conditional Waivers"
๐Ÿ” GATE 2 โ€” Final Approval (Brian / Designee)
  • โ˜ Gate 1 passed (all 8 checklist items verified)
  • โ˜ Brian/designee confirms amounts and approves

BOTH gates required before DocuSign fires. No exceptions.
โ†“
4 Conditional Waivers Sent via DocuSign System โ†’ Sub-Subs
  • App generates conditional waivers from MD ยง9-113 templates
  • Auto-fills: project, period, sub-sub name, net payment amount (after retainage)
  • DocuSign sends directly to each sub-sub at their registered email
  • Sub-sub signs electronically (verified email, IP, timestamp)
  • Signed PDF auto-tracked โ†’ Excel col R updates via app
โ†“
5 App Tracks Waiver Status System (Automatic)
  • Dashboard: โœ… Signed / โณ Pending / โŒ Refused per sub-sub
  • Auto-reminders at 3, 7, 14 days if unsigned
  • If sub-sub disputes amount โ†’ flagged for review
  • If sub-sub refuses โ†’ their portion held, escalation triggered
  • Status synced back to Excel in real-time
โ†“
6 Subcontractor Signs Consolidated Conditional Subcontractor (1st Tier)
  • After ALL sub-sub conditionals signed โ†’ Subcontractor's conditional fires
  • Covers full net payment (gross minus retainage) from JWTC โ†’ Subcontractor
  • Includes certification that all sub-subs are disclosed and covered
โ†“
๐Ÿšซ PAYMENT GATE โ€” ALL CONDITIONS REQUIRED
  • โ˜ ALL sub-sub conditional waivers signed
  • โ˜ Subcontractor conditional waiver signed
  • โ˜ No disputed amounts outstanding
  • โ˜ If Payment 2+: ALL unconditional waivers from prior payment received

ALL met = PAYMENT UNLOCKED | ANY missing = PAYMENT BLOCKED
Phase 3 โ€” Payment Release (at 90%)
7 JWTC Releases Payment JWTC Admin
  • Payment = Indy Payable minus 10% Retainage
  • ACH/check issued to Subcontractor
โ†“
8 App Updates Excel โ€” Payment Recorded System + Admin
  • Excel updated: Payment Status (T) = Paid
  • Payment Date (U) recorded
  • Check/ACH Ref (V) recorded
  • App shows: ๐ŸŸก PAYMENT SENT โ€” AWAITING UNCONDITIONALS
โ†“
9 Subcontractor Pays Sub-Subs Directly Subcontractor
  • Subcontractor pays all sub-subs directly (no cascading)
  • Retainage flow-down: TBD โ€” pending Subcontractor confirmation
Phase 4 โ€” Unconditional Waiver Collection
10 App Triggers Unconditional Waivers Brian / Designee
  • Brian clicks "Send Unconditional Waivers" for the paid batch
  • App auto-fills: actual payment amount + check/ACH ref
  • No dual-gate required โ€” amounts are auto-filled from verified payment records, not manually entered
โ†“
11 Unconditional Waivers Sent via DocuSign System โ†’ Sub-Subs + Subcontractor
  • Sent directly to each sub-sub + Subcontractor
  • "Payment of $XX,XXX received. Sign to confirm waiver of lien rights."
  • Each sub-sub confirms they were paid by Subcontractor
  • Signed โ†’ Excel col S updates to "Signed"
โš ๏ธ If a sub-sub WON'T sign the unconditional: Subcontractor may not have passed the money down. Triggers investigation. Next payment blocked. Joint check option activated (MSA ยง14).
โ†“
12 App Confirms Cycle Complete System
  • All conditionals + unconditionals for the batch = signed โœ…
  • Status: ๐ŸŸข BATCH COMPLETE โ€” FULL LIEN PROTECTION
  • Next payment cycle can begin (back to Phase 1)
Phase 5 โ€” Final Retainage Release
$ Retainage Accumulation System
  • App tracks total retainage held across all batches
  • Example: PR1 $18K + PR2 $22K + PR3 $15K = $55K total
โ†“
13 Final Payment โ€” Release All Retainage JWTC
  • All work complete, all prior unconditionals signed
  • Final batch = sum of all accumulated retainage
  • Final conditionals โ†’ signed โ†’ final payment โ†’ final unconditionals
  • Final waivers cover total contract value
  • Status: ๐ŸŸข CONTRACT CLOSED โ€” FULL LIEN PROTECTION

Retroactive Mode (PR1/PR2 Already Paid)
R1 Handle Already-Paid Batches Brian via App
  • PR1/PR2 paid without unconditional waivers from sub-subs
  • Skip conditionals โ€” payment already happened
  • App generates unconditionals pre-filled with actual payment details
  • Send via DocuSign โ†’ sub-subs sign โ†’ legal exposure closed

Dispute Resolution
D Source Documentation = Truth JWTC Admin
  • Project-specific source docs (sign-in sheets, daily reports, etc.) are the single source of truth
  • No documentation = no payment, period
  • If sub-sub disputes: they can submit proof
  • Proof goes to the city/client for review
  • City/client approves โ†’ JWTC pays. Status: "Pending City Approval"

Escalation Procedures

When Things Go Wrong

ScenarioActionMSA
Sub-sub disputes amountCompare source docs. Sub-sub submits proof โ†’ city decides.ยง11.G (audit rights support investigation)
Sub-sub refuses conditionalTheir portion held. Subcontractor resolves.ยง4.A
Sub-sub refuses unconditionalNext payment blocked. Investigate fund diversion. Joint check option.ยง4.B, ยง14
Unknown entity in billingPayment held. Subcontractor must provide names/addresses.ยง14
Forged signature suspectedDocuSign audit trail (IP, email, timestamp). Direct confirmation.ยง22
Fund diversionTerminate Subcontractor. Joint checks to sub-subs. Report if fraud.ยง4.B, ยง14, ยง21
"Ready to Send" changes after DocuSign sentApp flags with option to void the envelope.โ€”
Waiver not returned timelyPayment withheld for that portion. Joint check option.ยง14
Subcontractor can't manage waiversJWTC takes over waiver collection on Subcontractor's behalf. Separate indemnification agreement required.โ€”

๐Ÿ“Š Excel Tracker โ€” Column Layout (v5 โ€” 22 Columns: A-V)

IDENTITY (Aโ€“F)
A: 1st Tier Sub B: 2nd Tier Sub C: 3rd Tier Sub D: 4th Tier Sub E: Operator Name F: Phone
WORK (Gโ€“J)
G: Date H: Equipment I: Equip Count J: Total Hours
MONEY (Kโ€“O)
K: Indy Rate L: Indy Payable M: Retainage (10%) N: Sub Rate O: Sub Payable
WAIVER & PAYMENT (Pโ€“V)
P: Payment Batch Q: Ready to Send R: Conditional Waiver S: Unconditional Waiver T: Payment Status U: Payment Date V: Check/ACH Ref
Payment Status options: Hold | Approved | Paid | Blocked | Disputed | Pending City Approval
๐Ÿ”‘ Key Principles:
โ€ข 10% retainage on every progress payment โ€” waivers reflect net (90%), not gross
โ€ข Double gate: 8-item reviewer checklist + Brian's approval before DocuSign fires
โ€ข Designated reviewer per project โ€” not Brian (accountability + audit trail)
โ€ข No city rates or billable amounts visible in any sub-facing system
โ€ข Waivers go direct to sub-subs via DocuSign โ€” not through Subcontractor
โ€ข Source documentation = truth. No docs = no payment.
โ€ข Every dollar tracked, every signature verified, every payment gated
โ€ข No money moves without paper
โ€ข Maryland ยง9-113 compliant waivers
โ€ข JWTC can take over waiver management if Subcontractor can't handle it (separate agreement)
JWTC Lien Release & Payment Workflow v2.1 | Generated by Jax | March 1, 2026