Weekly

See the week's payments every Friday

A Friday email lists the payments Xero recorded this week and their total.

Runs: Weekly
Apps: Xero
AI: Not needed
Access: accounting.transactions.read

Send this to your assistant

Create a ClickRuntime automation: every Friday at 5pm, email me the payments received in Xero since Monday with the contact, invoice and total.

Paste it into your assistant. It tells you what it will send or change before it runs live.

Add to ChatGPT Add to Claude

First time? Adding ClickRuntime to your assistant takes about two minutes.

Why use it

Why teams use this automation

For a business with many small customers, the money arriving each week is spread over dozens of payments. An owner checking the bank account sees a list of transfers but not what they relate to, and the bookkeeper totals it up once a month. Weekly cash-in is the quickest health indicator of the business, yet it is calculated rarely and never in the same way.

Every week, payments recorded in Xero since a given date are fetched and totalled, and the summary is emailed to you with the number of payments, their combined value and the individual payments. It reflects what has been applied to invoices in Xero, not what merely appeared in the bank.

Owners who manage the business week by week, and part-time finance staff preparing a Monday briefing, will find it handy.

What you get out of it

Weekly cash-in is a number you know
Seeing that payments totalled $18,400 against $24,000 the week before gives you a quick pulse of the business without opening a report. A number you see every week becomes something you can judge and act on.
Payments are tied to invoices
The list shows payments as recorded against customer invoices, which is more meaningful than a bank line and helps you check that money was allocated correctly. Payments tied to invoices make it easier to spot misallocated or missing money.
Slow weeks are spotted early
A week with unusually few payments can mean a large customer is late or a billing run was missed, which prompts a look before the month is over. Early warning on quiet weeks lets you chase late payers before the month is out.
Forecasting gets a real input
Having actual weekly receipts to hand lets you compare them with your cash forecast and adjust the next month's plan on facts, not hopes. Real receipts make a forecast more believable and easier to adjust.
A simple record for the bookkeeper
Forwarding the weekly summary gives the bookkeeper context for unusual items when reconciling, so there are fewer queries about unidentified deposits later. That context helps clear deposits quickly and keeps month-end work under control.

How it works

What happens, step by step

Every Friday ClickRuntime gets the payments Xero recorded since the start of the week.
It lists each payment with the customer and invoice number, and adds up the total.
The list and the week's total arrive in your inbox as one email.

Before it runs live

Connect Xero

What you get

RunsWeekly

See the week's payments every Fridaytoday, 9:00Succeeded

Email · Payments this weekPayments received since 14 Oct: 6,420.00 Northwind Traders - INV-0405: 3,200.00

Build your own

Need it to work differently?

This template is a starting point. Copy the prompt and change it, or describe a different automation from scratch, with your own conditions, more apps or an AI step. Your assistant writes it, tests it and runs it on ClickRuntime.

Your own rules
Conditions, thresholds, filters and exceptions, written the way you'd explain them to a colleague.
Any number of apps
One automation can read from one app and update several others. Over 248 apps are ready, and anything with an API works too.
AI where it helps
Summaries, classification, extraction and drafts use ClickRuntime's built-in AI, with no extra key.
On a schedule or on each event
Runs as often as every 5 minutes, or the moment an app sends an event, and keeps track of what it already handled.

Changes you can ask for

Run it at a different time, more or less often, or only on weekdays
Add an AI step, for example to summarize, sort or draft a reply
Add another app, for example also send it to Slack
Combine it with other Xero steps into one automation

Under the hood

The code that runs this automation

This is the Python script that runs each time the automation starts. Your AI assistant writes it for you when you send the prompt, and you allow each step in your assistant. To change how the automation works, describe the change to your assistant and it updates the script for you. For every function it can use, see the script reference.

payments_received_summary.pyexample

from datetime import date, timedelta
from clickruntime import on_trigger, credentials, http, notify

API = "https://api.xero.com/api.xro/2.0"

def xero_headers():
    token = credentials.connection("xero", "work")
    tenant = http.get("https://api.xero.com/connections", headers={"Authorization": f"Bearer {token}"}).json()[0]["tenantId"]
    return {"Authorization": f"Bearer {token}", "xero-tenant-id": tenant, "Accept": "application/json"}

@on_trigger
def run(event):
    monday = date.today() - timedelta(days=date.today().weekday())
    where = f"Date>=DateTime({monday.year},{monday.month},{monday.day})"
    payments = http.get(f"{API}/Payments", headers=xero_headers(), params={"where": where}).json()["Payments"]
    lines = [f"{p['Invoice']['Contact']['Name']} - {p['Invoice']['InvoiceNumber']}: {p['Amount']:,.2f}" for p in payments]
    total = sum(p["Amount"] for p in payments)
    notify.email_me(f"Payments received since {monday:%d %b}: {total:,.2f}", "\n".join(lines) or "No payments this week.")
    return {"payments": len(payments), "total": total}

FAQ

Common questions

Does it include refunds and credit note allocations?

It reports payments recorded in Xero for the period. Refunds and overpayments may appear as separate payment records depending on how they were entered, so check with your bookkeeper if you want refunds netted off the total.

What does since a date mean here?

Each run looks at payments dated in the past seven days, from the same weekday last week up to today. Because it uses the payment date in Xero, a payment entered late with a back date can be counted in the right week.

Can I see payments by customer?

Yes. The payment list can be grouped by contact so the email shows what each customer paid. This is handy for businesses with a handful of large accounts, and your AI assistant can change the layout before you approve it.

What permissions does it need?

accounting.transactions.read. Nothing else in your accounts is used.

Does it need AI?

No. It runs without AI, so it doesn't use your plan's AI allowance.

How many runs does it use?

One run each time it runs (weekly). Checks that find nothing to do and stop right away aren't counted.

Can I change how it works?

Yes. Describe the change to your AI assistant, for example a different schedule, channel or filter. It updates the automation, tests it and tells you what changed.

On a schedule