GenniDocs

Guides

Checks and review

After extraction Genni tests every statement, for every column, against accounting rules. Anything that fails becomes a review item and its figures are flagged. A document is completed only when nothing is open.

CheckWhat it tests
Balance sheetTotal assets equal total equity and liabilities; subtotals add up.
ProfitRevenue less cost of sales is gross profit; profit before tax and tax give profit for the year.
Cash flowsOperating, investing and financing add up to the net change; opening cash rolls forward to closing.
EquityOpening equity plus the year's movements equals closing equity, which agrees with the balance sheet.
CompletenessEach statement has its key totals, so a skipped section can't pass unnoticed.
ConsistencyThe same line isn't read twice with different values; every figure is a readable number.
Prior yearThis report's comparatives match last year's report for the same company (a warning: it may be a restatement).

Checks allow for rounding and for the ways reports print signs differently (costs in brackets or not).

Working through review items

bash
curl "https://api.genni.scribblegreen.com/v1/review-items?document_id=$DOCUMENT_ID" -H "Authorization: Bearer $GENNI_KEY"

Each item explains the problem and lists the figures involved. For each figure you can:

bash
# The figure is right as read
curl https://api.genni.scribblegreen.com/v1/figures/$FIGURE_ID/review -H "Authorization: Bearer $GENNI_KEY" \
  -H "Content-Type: application/json" -d '{"action": "approve", "reviewer": "Ada Obi"}'

# Genni misread it: give the figure exactly as printed; the page's units are applied
curl https://api.genni.scribblegreen.com/v1/figures/$FIGURE_ID/review -H "Authorization: Bearer $GENNI_KEY" \
  -H "Content-Type: application/json" -d '{"action": "edit", "value_as_printed": "1,515,107", "reviewer": "Ada Obi"}'

# The line doesn't belong
curl https://api.genni.scribblegreen.com/v1/figures/$FIGURE_ID/review -H "Authorization: Bearer $GENNI_KEY" \
  -H "Content-Type: application/json" -d '{"action": "reject", "reviewer": "Ada Obi"}'

Checks rerun after every action, so fixing a figure closes its item by itself. If the report itself doesn't add up (it happens), dismiss the item with a note:

bash
curl https://api.genni.scribblegreen.com/v1/review-items/$ITEM_ID/resolve -H "Authorization: Bearer $GENNI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "dismissed", "reviewer": "Ada Obi", "note": "Casting error in the published statement"}'

A dismissed item is never raised again for that document.

Next: Exports and datasets →