Call any WeFact controller/action directly.

Use this for endpoints not covered by the dedicated tools below, or to pass parameters that the dedicated tools don't expose.

Args: controller: WeFact controller name (e.g. "debtor", "invoice", "subscription", "creditinvoice", "product", "ticket", "group"). action: Action on that controller (e.g. "list", "show", "add", "edit", "delete", "send", "credit", "markaspaid"). params: Extra parameters as a dict. Field names match the WeFact docs at developer.wefact.com (e.g. "DebtorCode", "Identifier", "InvoiceLines"). Do NOT include the api_key.

Returns: JSON-encoded response from WeFact.

List all debtors (customers).

Args: search_at: Field to search in (e.g. "EmailAddress", "CompanyName", "DebtorCode"). Optional. search_for: Value to search for. Required if search_at is given. modified_since: ISO date or datetime. Only return debtors modified after this point. Critical for incremental sync. limit_pages: If set, fetch at most this many pages (each ~100 items). Default fetches all pages.

Fetch a single debtor by DebtorCode (e.g. 'DB10000') or Identifier.

Create a new debtor.

Args: fields: Dict of WeFact debtor fields. Common ones: CompanyName, Initials, SurName, EmailAddress, Address, ZipCode, City, Country, TaxNumber, Sex. See developer.wefact.com for the full list.

Update an existing debtor. Only fields you provide are changed.

List invoices.

Args: status: WeFact invoice status (0=concept, 1=sent, 2=partly paid, 3=paid, 4=expired, 5=summation, 6=collection). Optional filter. debtor_code: Filter to a specific debtor. modified_since: ISO date for incremental sync. limit_pages: Cap on pages (1 = first page only).

Fetch one invoice by InvoiceCode (e.g. '202401001') or Identifier.

Create a draft invoice.

Args: debtor_code: e.g. 'DB10000'. invoice_lines: list of line dicts. Each can have ProductCode, or free-form Description + PriceExcl + Number + TaxCode etc. extra_fields: any other invoice-level fields (Date, Term, Discount, ReferenceNumber, Comment, ...).

Send an existing draft invoice to the debtor.

Args: invoice_code: e.g. '[concept]0001' for a draft. send_method: optional, e.g. 'email' or 'mail'. Omit for the debtor's default.

Credit (reverse) an existing invoice.

Mark an invoice as paid.

Args: invoice_code: e.g. '202401001'. pay_date: ISO date. Defaults to today. payment_method: e.g. 'cash', 'banktransfer', 'directdebit'.

List all products.

Fetch a single product.

List subscriptions.

Fetch a single subscription.

List purchase invoices (inkoopfacturen).

Fetch a single purchase invoice.

Sanity-check the API connection. Returns a tiny debtor list response.