List Fortnox Supplier Invoices
fortnox_list_supplier_invoicesRetrieve supplier invoices from Fortnox with filters for status, supplier, date, and amount. Get paginated accounts payable results for analysis.
Instructions
List supplier invoices (accounts payable) from Fortnox.
Retrieves a paginated list of supplier invoices with optional filtering by status, supplier, date range, or amount.
Args:
limit (number): Max results per page, 1-100 (default: 20)
page (number): Page number for pagination (default: 1)
filter ('cancelled' | 'fullypaid' | 'unpaid' | 'unpaidoverdue' | 'unbooked' | 'pendingpayment'): Filter by invoice status
supplier_number (string): Filter by supplier number
from_date (string): Filter invoices from this date (YYYY-MM-DD)
to_date (string): Filter invoices to this date (YYYY-MM-DD)
period ('today' | 'yesterday' | ... | 'last_year'): Convenience date period, overrides from_date/to_date
from_final_pay_date (string): Filter by due date from (YYYY-MM-DD)
to_final_pay_date (string): Filter by due date to (YYYY-MM-DD)
sortby ('suppliername' | 'suppliernumber' | 'invoicenumber' | 'invoicedate' | 'total'): Field to sort by
sortorder ('ascending' | 'descending'): Sort order (default: ascending)
fetch_all (boolean): Fetch all results by auto-paginating (max 10,000 results)
min_amount (number): Filter invoices >= this amount (client-side)
max_amount (number): Filter invoices <= this amount (client-side)
response_format ('markdown' | 'json'): Output format
Returns: List of supplier invoices with supplier, dates, amounts, and status.
Examples:
List unpaid supplier invoices: filter="unpaid"
Last month's supplier invoices: period="last_month"
Supplier invoices this year: supplier_number="1", period="this_year"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination | |
| limit | No | Maximum number of results to return (1-100) | |
| filter | No | Filter supplier invoices by status | |
| period | No | Convenience date period filter (e.g., 'last_month', 'this_quarter'). Overrides from_date/to_date if provided. | |
| sortby | No | Field to sort results by | |
| to_date | No | Filter invoices to this date (YYYY-MM-DD) | |
| fetch_all | No | Fetch all results by auto-paginating through all pages. WARNING: May take time for large datasets (max 10,000 results). | |
| from_date | No | Filter invoices from this date (YYYY-MM-DD) | |
| sortorder | No | Sort order for results | ascending |
| max_amount | No | Filter invoices with total <= this amount (client-side filter) | |
| min_amount | No | Filter invoices with total >= this amount (client-side filter) | |
| response_format | No | Output format: 'markdown' or 'json' | markdown |
| supplier_number | No | Filter by supplier number | |
| to_final_pay_date | No | Filter by due date to (YYYY-MM-DD) | |
| from_final_pay_date | No | Filter by due date from (YYYY-MM-DD) |