get_xero_outstanding_receivables
get_xero_outstanding_receivablesWho owes this business money in Xero right now, and how much - aggregated per contact from unpaid and partially-paid sales invoices (Type ACCREC, Status AUTHORISED). Read-only. Chosen over Xero's own AgedReceivablesByContact report because that report requires naming ONE contact per call and cannot answer an organisation-wide question. Amounts are grouped by currency (a Xero organisation can invoice in more than one) - if currencies has more than one entry, report each currency total separately rather than adding them together. truncated: true means more unpaid invoices exist than this tool scanned; say so rather than presenting the totals as exhaustive. unusableAmountCount (when greater than 0) means that many AUTHORISED sales invoices had no reliable amount-due figure from Xero and were EXCLUDED from every total, count and contact below - say so too, and never treat them as paid off just because they are absent from the numbers. OVERDUE MEANS THE DUE DATE IS STRICTLY BEFORE overdueAsOf, the calendar day this call was measured against: an invoice due ON that day is NOT overdue and is not in overdueTotal, because the customer still has that whole day to pay. timeZone is the zone that day was computed in and timeZoneSource says where it came from: 'organisation' means it is the organisation's own timezone from Xero, and any other value means Xero did not give one and the day was computed in UTC instead, so an invoice due within a day of now may be classified against a date up to a day away from the organisation's own. Do not recompute overdue yourself from oldestDueDate and your own clock - your clock is not the organisation's.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| organisation | No | The Xero organisation to use, by its display name. Only needed if this connection reaches more than one organisation - omit it when there is only one. |