Real Estate & PropTech// diagnostic

The abstract shows the original rent, not the rent being paid

In short

A billed rent and an abstracted rent differing by a clean step is a document-set fault, not an extraction fault. Count the instruments the lease chain recites against the files actually ingested: a gap means an amendment never arrived, and a complete set means the merge ran in the wrong order or read the wrong effective date.

Key takeaways

  • A difference equal to exactly one escalation step is a document problem. A ragged difference is an extraction problem.
  • Count instruments before reading clauses: Amendment 4 recites 1 to 3, so the chain tells you how many files should exist.
  • Ingested and merged are separate states. A complete folder proves nothing about what the merge did with it.
  • Merge by effective date, not by upload order, execution date or file name, and record which rule decided each field.
  • A restatement loaded beside its original leaves 2 files that both look whole, and the last one processed wins.
  • Fix the lineage in the schema. Without a supersession link, the same lease will drift again after the next amendment.

Accounts is billing one figure and the abstract holds another. Before anyone looks at the model, subtract them: if the difference is exactly one escalation step, one negotiated reduction or one deferral, this is a document-set problem and the extraction did its job on the wrong pile of paper. A ragged difference with odd decimals is a different investigation entirely.

That distinction matters because the two fixes touch different systems. A stale value means an instrument is missing or was combined wrongly, which is intake and merge logic. A garbled value means the number was misread, which is extraction. Teams routinely spend a fortnight on the second while the first is sitting in an unopened folder.

Count what the chain says exists against what you actually hold

One count settles it, and it takes about 15 minutes per lease. The point is to separate 2 states that look identical from the outside: the amendment was never ingested, or it was ingested and the merge lost it.

  1. Open the most recent amendment you hold and read its recitals. Amendments almost always name the ones before them, so Amendment 4 tells you that 1, 2 and 3 exist even if you have never seen them.
  2. Count the files in the lease record against that number. Fewer files than the chain recites is a missing document, and you are done diagnosing — the rest of this page is about the case where the count matches.
  3. Check for instruments the chain would not recite. Rent deferral letters, waivers and side letters are frequently unnumbered, filed as correspondence, and never mentioned by any amendment.
  4. Ask which file each abstracted rent value came from. A per-field citation makes this instant; without one, this step is a manual read, which is one reason a citation that will not resolve is treated as its own defect in the cited page that does not contain the clause.
  5. Confirm the schedule you compared against is the whole schedule. A rent table that stops 3 years early looks like a stale value and is not one — it is the structural failure in the rent schedule that lives in an exhibit.
  6. Write down which of the 2 states you are in. Missing document routes to re-ingest. Complete set routes to re-merge. Everything below hangs off that answer.

5 reasons the merge produced last decade's number

Rows 1 and 2 are intake failures and end in a re-ingest. Rows 3 to 5 are merge failures with every file already present, and they are the ones that recur, because nothing about the folder looks wrong afterwards.

CauseWhat the file set showsWhat the record showsRepair
The amendment was never ingestedFewer files than the chain recitesRent matching the original schedule exactlyRe-ingest: locate the instrument, then reprocess the lease
An unnumbered letter changed the rentFile count looks right; a letter sits in correspondenceRent correct for the base term, wrong across one windowRe-ingest, and widen intake beyond documents titled as amendments
A restatement was loaded beside the original2 files each claiming to be the whole leaseRent from whichever was processed last, and it changes between runsRe-merge with supersession recorded as a link, not a filename convention
The merge ran in the wrong orderEvery instrument presentRent from an intermediate amendment rather than the latestRe-merge by effective date, breaking ties on execution date
An effective date was misreadEvery instrument presentThe right new rent, applied from the wrong monthRe-merge after separating execution, effective and rent-commencement dates
Cause, what the file set and the record each show, and where the repair lands

Everything is in the folder and the merge still lost

Ordering is where complete document sets go wrong, because the obvious keys are all wrong. Upload order reflects who scanned what. File name order sorts Amendment 10 before Amendment 2. Execution date is close but breaks whenever a deed is signed after the change it makes has already taken effect, which is common on rent concessions agreed mid-quarter and papered later.

Effective date is the correct key, and it has to be extracted as its own field rather than inferred from the signature block. A lease already carries several dates that are routinely collapsed into one — the separation argued in the three start dates a lease actually has — and an amendment adds its own. Where 2 instruments share an effective date, fall back to execution date, then to the recital chain, and record which rule decided the outcome.

Contradictions are the case nobody designs for and every long chain contains. Two amendments that both purport to set the rent for the same year, or an amendment referring to a document that was never signed, cannot be resolved by ordering alone; they are resolved by a person, and the system's job is to surface them rather than to pick. The full reconstruction of a chain that behaves like this is worked through in a retail lease with eleven amendments.

The folder was complete, the extraction was accurate, and the number was 4 years old. Nothing in the pipeline was wrong except the order it read things in.

Re-ingest or re-merge, decided in 4 questions

  1. Does the file count match the recited chain? No — stop here and re-ingest. Nothing downstream can be assessed until the missing instrument is in the record.
  2. Does any abstracted rent value cite a file older than the newest instrument? Yes — re-merge. The newer document was present and was not applied.
  3. Does the same lease produce different rents on 2 runs? Yes — re-merge, and look for 2 files that both claim to be the whole agreement, because a non-deterministic result almost always means an unresolved tie.
  4. Is the value right and the date it starts from wrong? Yes — re-merge after fixing date extraction. This one is worth isolating because it produces correct-looking rent with incorrect arrears.

Re-ingest is cheap and one-off. Re-merge is the one worth engineering, because it will run again after every future amendment, and a merge that cannot be re-run safely over an existing record turns each new instrument into a manual reconciliation. Building that as a repeatable operation rather than a rescue is ordinary internal tools and operations software.

What the corrected rent still does not prove

One repaired lease is one repaired lease. The same fault is almost certainly present across the portfolio, silently, on every lease with a chain — and the detector is not the abstract, it is the comparison against what is being billed, which is why a rent roll that does not tie to the leases is the standing check rather than a one-off exercise.

The durable fix is in the schema. A field set that stores rent as a value, with no room for the instrument that set it, the date it took effect and the instrument it superseded, will drift again after the next amendment however carefully this one was repaired. Designing for lineage before extraction begins is the argument in designing the lease field schema before you extract anything, and it sits with the rest of lease abstraction and property document AI in our work with real estate teams.

Frequently asked questions

Short answers to the follow-ups this page tends to raise.

Why does a lease abstract show the wrong rent after an amendment?

Usually because the amendment was never ingested, or was ingested and merged in the wrong order. The tell is the size of the gap: a difference equal to exactly one escalation step or one negotiated reduction points at a missing or misapplied instrument, while a ragged difference points at a misread number. Count the files you hold against the chain the newest amendment recites before investigating anything else.

What order should lease amendments be merged in?

By effective date, with execution date as the tie-break and the recital chain as the last resort. Upload order, file name and execution date all fail in ordinary cases — file names sort Amendment 10 before Amendment 2, and concessions are often signed after they take effect. Record which rule decided each field, because a merge you cannot explain is a merge you cannot re-run with confidence.

How do I tell a missing amendment from a bad merge?

Count the instruments the chain recites and compare with the files in the record. Fewer files than recited is a missing document and routes to re-ingest. A matching count with a stale value routes to re-merge, and the confirming signal is provenance: if any rent field cites a file older than the newest instrument you hold, the newer document was present and simply not applied.

What happens when two amendments contradict each other?

A person decides, and the system's job is to raise it rather than to choose. Long chains routinely contain 2 instruments purporting to set the same year's rent, or an amendment referencing a draft that was never executed. Ordering rules cannot resolve a genuine conflict, and a pipeline that silently picks one has converted a question a lawyer should answer into a number nobody knows is contested.

  • amendments
  • lease abstraction
  • rent
  • diagnosis
// shipped work

The work behind this page

Builds from our portfolio that this page draws on.

Read next

Working on something in this space?

Tell us where you are in a sentence or two. We'll tell you honestly whether we're the right team, and what a sensible first slice of the work looks like.

Start the conversation