# Quaderno

Quaderno is a tax compliance platform that automates tax calculations, invoicing, and reporting for businesses worldwide.

- **Category:** taxes
- **Auth:** API_KEY
- **Tools:** 32
- **Triggers:** 0
- **Slug:** `QUADERNO`
- **Version:** 20260211_00

## Tools

### Calculate Tax Rate

**Slug:** `QUADERNO_CALCULATE_TAX_RATE`

Tool to calculate applicable tax rate for given address and transaction type. Use when you need tax details before invoicing.

### Create Contact

**Slug:** `QUADERNO_CREATE_CONTACT`

Tool to create a new contact (customer or vendor). Use when you need to add a person or company contact in Quaderno.

### Create Invoice

**Slug:** `QUADERNO_CREATE_INVOICE`

Creates a new invoice in Quaderno for a customer with line items. Returns invoice with ID, number, permalink, PDF URL, and total amounts in cents. Use this when you need to bill a customer for products or services.

### Create Product

**Slug:** `QUADERNO_CREATE_PRODUCT`

Creates a new product that can be used as a line item in invoices, credit notes, and expenses. Use this to register products with their SKU, pricing, tax classification, and other details in your Quaderno account.

### Delete Coupon

**Slug:** `QUADERNO_DELETE_COUPON`

Tool to permanently delete a coupon. Use when you have confirmed the coupon ID is correct and need to remove it permanently (cannot be undone).

### Delete Expense

**Slug:** `QUADERNO_DELETE_EXPENSE`

Permanently deletes an expense from Quaderno by its ID. This action removes the expense record from your Quaderno account. Use this when you need to delete an expense that was created in error or is no longer needed. The deletion is permanent and cannot be undone. Returns an empty response on success (HTTP 204 No Content).

### Delete Product

**Slug:** `QUADERNO_DELETE_PRODUCT`

Tool to permanently delete a product by ID. Use when you have confirmed the product ID is correct and no longer need the product.

### Delete Tax ID

**Slug:** `QUADERNO_DELETE_TAX_ID`

Permanently deletes a registered tax ID from your Quaderno account. Use this when you need to remove a tax jurisdiction registration that is no longer needed.

### Deliver Credit Note

**Slug:** `QUADERNO_DELIVER_CREDIT_NOTE`

Sends a credit note to the customer via email. The contact associated with the credit note must have a valid email address. Returns the credit note details including the delivery email and PDF link.

### Deliver Invoice

**Slug:** `QUADERNO_DELIVER_INVOICE`

Delivers an invoice to the customer via email. The invoice's contact must have a valid email address. Use this after creating or finalizing an invoice to send it to the customer.

### List Contacts

**Slug:** `QUADERNO_LIST_CONTACTS`

Tool to list contacts, paginated and filterable by name, email, or tax ID. Use when you need to retrieve subsets of your contacts.

### List Coupons

**Slug:** `QUADERNO_LIST_COUPONS`

Tool to list all coupons. Use when you need to retrieve available coupons sorted by creation date (newest first).

### List Evidence

**Slug:** `QUADERNO_LIST_EVIDENCE`

Tool to list all evidence objects. Use when you need to retrieve location evidences, optionally filtered by state or document ID.

### List Expenses

**Slug:** `QUADERNO_LIST_EXPENSES`

List all expenses from Quaderno with pagination support. Returns expenses in reverse chronological order (newest first). Each expense includes complete details: contact information, line items, payments, taxes, and custom metadata. Use the 'limit' parameter to control page size (1-100, default 25). Use 'created_before' with an expense ID to paginate through results. Example: List first 50 expenses: ListExpenses(limit=50) Example: Get next page: ListExpenses(limit=50, created_before=168878750)

### List Tax Jurisdictions

**Slug:** `QUADERNO_LIST_JURISDICTIONS`

Tool to list all tax jurisdictions. Use when you need supported jurisdictions for tax calculations.

### List Products

**Slug:** `QUADERNO_LIST_PRODUCTS`

List all products (goods and services) from your Quaderno account. Supports filtering by name or SKU code using the 'q' parameter. Returns product details including pricing, tax settings, and subscription information.

### List Registered Tax IDs

**Slug:** `QUADERNO_LIST_REGISTERED_TAX_I_DS`

Tool to list all registered tax IDs. Use when retrieving jurisdictions where your business has registered tax IDs. Supports optional cursor-based pagination.

### List Reporting Requests

**Slug:** `QUADERNO_LIST_REPORTING_REQUESTS`

Retrieves all reporting requests for the account with their current status and download URLs. Use this tool to check the status of previously created reporting requests and obtain download URLs for completed reports. Reports are generated asynchronously, so use this endpoint to poll for completion status. When a report's state is 'succeeded', the report_url field will contain a temporary download link for the generated CSV file. Common use cases: - Check if a report generation request has completed - Retrieve download URLs for completed reports - Monitor all pending report requests - View historical report generations with their parameters (date ranges, report types)

### List Sessions

**Slug:** `QUADERNO_LIST_SESSIONS`

List Quaderno Checkout sessions with optional filtering and pagination. Supports cursor-based pagination using 'created_before' and 'limit' parameters, and filtering by session status. Use this to retrieve checkout sessions from your Quaderno account.

### List Tax Codes

**Slug:** `QUADERNO_LIST_TAX_CODES`

Tool to list all supported tax codes. Use when you need to retrieve the full set of tax codes for classifying items.

### List Webhooks

**Slug:** `QUADERNO_LIST_WEBHOOKS`

Tool to list all webhooks. Use when you need to retrieve webhook configurations.

### Retrieve Contact

**Slug:** `QUADERNO_RETRIEVE_CONTACT`

Tool to retrieve details of an existing contact by ID. Use after confirming contact ID.

### Retrieve Coupon

**Slug:** `QUADERNO_RETRIEVE_COUPON`

Retrieve detailed information about a specific coupon by its ID. Use this action when you need to fetch coupon details like discount percentage, redemption limits, or expiration dates. You must first obtain a valid coupon ID from the List Coupons action or from a coupon creation operation. Returns coupon code, discount amount/percentage, redemption statistics, and validity information.

### Retrieve Evidence

**Slug:** `QUADERNO_RETRIEVE_EVIDENCE`

Retrieves a specific evidence object by its ID. Evidence objects contain location proofs (billing country, IP address, bank country) used for tax compliance. Use this when you need detailed information about a specific evidence record, typically after obtaining the evidence ID from the LIST_EVIDENCE action.

### Retrieve Invoice

**Slug:** `QUADERNO_RETRIEVE_INVOICE`

Tool to retrieve details of an existing invoice by ID. Use when you need full invoice details for reporting or reconciliation.

### Retrieve Tax Jurisdiction

**Slug:** `QUADERNO_RETRIEVE_JURISDICTION`

Tool to retrieve a tax jurisdiction by ID. Use when you need the name, country, and region of a specific jurisdiction after confirming its ID. Example: "Retrieve jurisdiction 94".

### Retrieve Product

**Slug:** `QUADERNO_RETRIEVE_PRODUCT`

Tool to retrieve details of an existing product by ID. Use after confirming the product ID exists.

### Update Credit Note

**Slug:** `QUADERNO_UPDATE_CREDIT_NOTE`

Tool to update a credit note. Use when you need to modify metadata, tags, notes, billing address, or attach files to an existing credit note. Only limited fields can be updated if it has already been paid or delivered.

### Update Invoice

**Slug:** `QUADERNO_UPDATE_INVOICE`

Updates an existing invoice in Quaderno by modifying allowed fields. This action sends a PUT request to /invoices/{id} and returns the complete updated invoice. Only specific fields can be modified after invoice creation: purchase order number (po_number), tags (tag_list), payment details (payment_details), notes, billing address (street_line_1, street_line_2), custom metadata, and file attachments. Use this when you need to add or modify administrative information on an invoice that hasn't been finalized or paid. Fields not specified in the request remain unchanged.

### Update product

**Slug:** `QUADERNO_UPDATE_PRODUCT`

Tool to update a product; unspecified fields remain unchanged. Use after fetching the product to apply partial updates.

### Validate Tax ID

**Slug:** `QUADERNO_VALIDATE_TAX_ID`

Tool to validate a tax ID. Use when confirming whether a given country-specific tax ID is valid. Example: validate tax ID 'DE303954554' for Germany.

### Void Credit Note

**Slug:** `QUADERNO_VOID_CREDIT_NOTE`

Tool to void a credit note. Use when you need to cancel an existing credit note.
