South Africa Payroll Deadline Calendar — connector documentation

MCP endpoint: https://za-emp201-calendar.connectorbay.com/mcp
REST API: POST https://za-emp201-calendar.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://za-emp201-calendar.connectorbay.com/openapi.json
Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
Authentication: none required. An optional Authorization: Bearer <key> raises rate limits.
Health: https://za-emp201-calendar.connectorbay.com/health · Tool schemas: https://za-emp201-calendar.connectorbay.com/tools.json
Publisher: Unify Dynamics LLC · connectorbay.com/za-emp201-calendar · agent@connectorbay.com

What South Africa Payroll Deadline Calendar is for

South Africa Payroll Deadline Calendar tells an employer what is owed to SARS and when, built for a Monday-morning what-is-due check. next_emp201_due applies the SARS rule (EMP201 paid within seven days after the end of the month of deduction, moved to the last business day before a weekend or public holiday) to a deduction month or finds the next one due. due_in_next_days lists every EMP201 date and EMP501 window opening or closing inside a look-ahead. emp501_windows returns the interim and annual reconciliation windows for the 2026 and 2027 reconciliation years with their status; emp501_penalty_estimate applies the published late-submission wording (1% of annual PAYE liability, 1% more for every month outstanding, up to 10%). sdl_liability_check applies the SDL test (more than R500,000 expected over 12 months, 1% of salaries). public_holiday_adjust and sa_public_holidays compute the South African public holidays from the Public Holidays Act rule as listed on gov.za, so weekend and holiday moves are exact; one-off proclaimed holidays can be supplied. Everything is computed locally from figures the caller supplies; nothing is stored, filed or paid. General information only, not tax advice.

Ask your assistant things like:

"What payroll deadlines fall in the next 14 days?"
"When is my EMP201 for October 2026 due, given 7 November is a Saturday?"
"When does the interim EMP501 reconciliation window close and is it open today?"
"My annual PAYE liability is R240,000 and my EMP501 is two months late: what penalty does the SARS wording give?"
"I expect to pay R620,000 in salaries over the next 12 months: am I liable for SDL and how much per month?"
"Which South African public holidays fall in 2026, so I can plan payroll dates?"

What it does

next_emp201_due: Return the EMP201 declaration and payment date (seven days after month end, moved to the last business day before a weekend or public holiday) for a month, or the next one due.
emp501_windows: Return the EMP501 interim and annual reconciliation submission windows for a reconciliation year with their status on the date asked.
emp501_penalty_estimate: Estimate the late-EMP501 administrative penalty: 1% of annual PAYE liability, plus 1% for every month outstanding, capped at 10%, with the full ladder.
due_in_next_days: List every employer payroll deadline falling from the date asked up to N days ahead: EMP201 dates and the opening and closing days of the EMP501 windows.
sdl_liability_check: Check whether expected payroll is more than R500,000 over the next 12 months (the SDL liability test) and return the 1% Skills Development Levy amount.
public_holiday_adjust: Move a due date to the last business day on or before it, skipping weekends and South African public holidays, and say which days were skipped and why.
sa_public_holidays: List the South African public holidays of a year: fixed dates, Good Friday and Family Day from Easter, and the Monday observed when a holiday falls on a Sunday.

Data sources

Reference data from official sources (gov.za, sars.gov.za); every answer states its source, date and validity period.

What it is not

South Africa Payroll Deadline Calendar is independent; not affiliated with, endorsed by or operated by any government body, central bank, standards body or scheme operator. Names of rails, schemes and standards are used only to say what a tool works with. It is read-only: it never sends, pays, files or signs anything for you, and it never looks up private individuals.

Not advice. General information only, not legal, tax, accounting or payment advice. South Africa Payroll Deadline Calendar is an independent tool: it is not affiliated with, endorsed by or operated by any government body, central bank, standards body or scheme operator. Rates, thresholds and rules change; check the cited official source and confirm with a qualified professional before you rely on a result.

Built for: South Africa. Languages: English.

Tools

Reference & guides

next_emp201_due — Return the EMP201 declaration and payment date (seven days after month end, moved to the last business day before a weekend or public holiday) for a month, or the next one due. Use for "When is my EMP201 for September 2026 due?". Args: on_date, deduction_month, extra_holidays.

emp501_windows — Return the EMP501 interim and annual reconciliation submission windows for a reconciliation year with their status on the date asked. Use for "When does the interim EMP501 reconciliation window open and close, and is it open today?". Args: tax_year, on_date.

emp501_penalty_estimate — Estimate the late-EMP501 administrative penalty: 1% of annual PAYE liability, plus 1% for every month outstanding, capped at 10%, with the full ladder. Use for "My annual PAYE liability is R240,000 and the EMP501 is two months late: what penalty does the SARS rule give?". Args: annual_paye_liability, months_late.

due_in_next_days — List every employer payroll deadline falling from the date asked up to N days ahead: EMP201 dates and the opening and closing days of the EMP501 windows. Use for "What payroll deadlines fall in the next 14 days?". Args: days, on_date, extra_holidays.

sdl_liability_check — Check whether expected payroll is more than R500,000 over the next 12 months (the SDL liability test) and return the 1% Skills Development Levy amount. Use for "I expect to pay R620,000 in salaries over the next 12 months: do I have to pay SDL and how much per month?". Args: expected_annual_leviable_payroll, monthly_leviable_remuneration.

public_holiday_adjust — Move a due date to the last business day on or before it, skipping weekends and South African public holidays, and say which days were skipped and why. Use for "7 November 2026 is a Saturday: which day counts as the last business day before it?". Args: due_date, extra_holidays.

sa_public_holidays — List the South African public holidays of a year: fixed dates, Good Friday and Family Day from Easter, and the Monday observed when a holiday falls on a Sunday. Use for "Which South African public holidays fall in 2026 and on which weekdays?". Args: year, extra_holidays.

Conventions

Read-only. Every tool reads public data or computes; nothing is written anywhere and nothing about the user is stored.
Result envelope. ok: true with data, or ok: false with a structured error (bad_input, not_found, upstream_error). degraded lists optional sources that were unreachable.
Rate limits. Free tier 60 tool calls/minute and 300/day per user (keyed on the user identifier supplied by the host agent, else client IP); Pro keys raise this. Over-limit calls return HTTP 429 with Retry-After. initialize and tools/list are never counted.

Support

agent@connectorbay.com · connectorbay.com/za-emp201-calendar/support