โก JWTC Lien Release & Payment Workflow
Baltimore Snow Emergency โ DPW Contract | v2.1 โ March 1, 2026
๐ง 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.
- All entities in the batch are in the approved sub-subcontractor registry
- Rates match the contracted/agreed rates for this project
- Payable amounts are correctly calculated
- Retainage is correctly calculated (per project setting)
- Payment batch assigned, no duplicate entries
- All unconditional waivers from the prior batch have been received (auto-skip on first batch)
- No outstanding disputes from prior batches blocking this one (auto-skip on first batch)
- 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
| Scenario | Action | MSA |
| Sub-sub disputes amount | Compare source docs. Sub-sub submits proof โ city decides. | ยง11.G (audit rights support investigation) |
| Sub-sub refuses conditional | Their portion held. Subcontractor resolves. | ยง4.A |
| Sub-sub refuses unconditional | Next payment blocked. Investigate fund diversion. Joint check option. | ยง4.B, ยง14 |
| Unknown entity in billing | Payment held. Subcontractor must provide names/addresses. | ยง14 |
| Forged signature suspected | DocuSign audit trail (IP, email, timestamp). Direct confirmation. | ยง22 |
| Fund diversion | Terminate Subcontractor. Joint checks to sub-subs. Report if fraud. | ยง4.B, ยง14, ยง21 |
| "Ready to Send" changes after DocuSign sent | App flags with option to void the envelope. | โ |
| Waiver not returned timely | Payment withheld for that portion. Joint check option. | ยง14 |
| Subcontractor can't manage waivers | JWTC 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