The payroll total of a window of whole months, summed on the server from the payslips: gross pay, net pay, employee deductions, employer charges and the payslip cost, one group per currency, and per month when axes holds "month". It draws nothing.

Use it for any payroll or payslip total: "what did payroll cost last month", "total employer charges this quarter", "masse salariale", "coût employeur total". State the figures it returns and never add payslip amounts yourself, and never sum payslips with well_query_records or a records statistic: this read applies one rule on every surface, so the same question gives the same figure. For the payslips behind a figure, read the rows with well_show_records.

The window is from (inclusive) to to (exclusive), each the first day of a month as YYYY-MM-01, at most 12 months, cut on the pay period end. One month is from: "2026-09-01", to: "2026-10-01".

The rule is fixed, and rule echoes it. Statuses summed: approved and paid, and a payslip with no status, unless statuses names others. employee_deductions adds each deduction line by its magnitude; employer_charges adds the charge lines as printed, so a negative one is a reversal. Memo lines count nowhere. payslip_cost is gross_pay + employer_charges.

Every figure is per currency and never converted. Do not add two groups of different currencies.

What the figures leave out is returned so you can say it: gross_unread_count and net_unread_count (payslips that printed no amount there, in no total: say unread, never zero), printed_lines_incomplete_count (payslips whose extraction could not keep every printed line, so the total is built from the lines Well kept: say the total is incomplete, never call it the full payroll), unclassified_line_count and unclassified_line_amount (lines with no side, in no side total), held_back (payslips of other statuses, by status: drafts, pending, cancelled), unplaced_count (no pay period end, in no window) and no_currency_count.

People floor. On a WhatsApp turn each amount needs at least 3 people (distinct employment contracts) behind it: payslips that printed it for gross_pay and net_pay, deduction or charge lines for employee_deductions and employer_charges, both of those for payslip_cost. A person counts toward an amount only when their share of it is not zero: a payslip or line of 0.00, or none, adds no one. An amount under 3 people, or a total over several months where one month is under 3 people for it, is null and listed in suppressed as { amount, reason: "below_people_floor" }. An amount no person is behind at all (no payslip gives a non-zero amount for it that the sum adds up: no non-zero gross or net pay, or no non-zero deduction or charge line) is null with reason: "not_printed". unclassified_line_amount is always null there (reason: "not_on_whatsapp"). State the amounts that remain. For each suppressed entry, name the amount and its reason in one plain line: below_people_floor is hidden on WhatsApp so no one's pay can be worked out, not_printed means no payslip line gives it an amount the sum can add up (the header tax withheld and social contributions are never added, so the payslips may still print them, and a line of 0.00 may be printed: never say that no line or no amount was printed; a not_printed payslip_cost has no total because the part it adds that is also not_printed, most often the employer charges, gives no such amount), not_on_whatsapp means the lines with no side, whose amount shows in Well. Then give records_url once per workspace, under that workspace's totals, as the link to see its hidden amounts in Well: each workspace has its own link, so never point one workspace's hidden amounts to another's. When it is null, name the Well web app with no link. On WhatsApp payslip_count and contract_count are null and meets_people_floor says whether at least 3 people of the group have a non-zero gross or net pay: never state or guess a headcount there. On WhatsApp omit statuses; the read refuses it there. Never rebuild a held-back amount from other reads, other amounts or other windows. There is no per-person total.

partial: true means part of the payroll is not in the figures, and partial_reasons says why: read_cut_short (a read was cut short and a figure may be a floor) or currency_cap (the window holds more than 4 currencies; currencies_not_summed names those in no group, so say they are left out) or deadline (the read ran out of time: months_not_summed names the months in no group, so say those months are missing and never read them as zero; a month with no group that is not listed there had no payslip to sum) or printed_lines_incomplete (a payslip of the total kept fewer printed lines than its extraction read, so the total may be missing a line: say so, and name the count from printed_lines_incomplete_count). When success is false the read failed: the empty groups is not a measured zero.

When the token authorizes one workspace, call this directly — no workspace call is needed first. When it authorizes several, this read will not guess which one you mean: pass workspace_id on the call.