The Quaderno connector lets your AI agent act in each user's Quaderno account. Each user connects their own Quaderno API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.
- Tools
- 60
- What they doRead · write · destructive
- 28 · 23 · 928 read23 write9 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Quaderno connection
In AgentKit > Connections, create a Quaderno connection. The name you give it is the
connection_nameyour code passes. See Configure connections.
Tools
Pass the exact name toexecute_toolquaderno_contact_getGet one contact by ID.Read-onlyGet Contact
Get one contact by ID. Returns kind, names, email, full address, tax ID, tax status, language, discount, processor IDs and billing area permalink.
Inputs
idstringrequired- ID of the contact. Example: 123456.
quaderno_contacts_listList customers and vendors (contacts), newest first, optionally filtered by name, email or tax ID text, or by payment processor ID.Read-onlyList Contacts
List customers and vendors (contacts), newest first, optionally filtered by name, email or tax ID text, or by payment processor ID. Returns per contact its ID, kind, name, email, address, tax ID, tax status and processor IDs. Use this to find a contact. Use quaderno_contact_get for one contact.
Inputs
created_beforeinteger- Pagination cursor: return objects created before the object with this ID (newest first). Pass the last ID of the previous page. Example: 123456.
limitinteger- Page size, up to 100 (default 25). Example: 25.
processor_idstring- Only records with this payment processor ID. Example: cus_PQ9xY2.
qstring- Text to match against the contact's full name, email or tax ID (case-sensitive). Example: Acme.
quaderno_credit_getGet one credit note by ID.Read-onlyGet Credit Note
Get one credit note by ID. Returns number, dates, contact, items, taxes, totals, payments, state and URLs.
Inputs
idstringrequired- ID of the credit note. Example: 123456.
quaderno_credits_listList credit notes (refunds), newest first, filtered by text, issue date range, state or processor ID.Read-onlyList Credit Notes
List credit notes (refunds), newest first, filtered by text, issue date range, state or processor ID. Returns per credit note its ID, number, date, contact, totals, taxes and state.
Inputs
created_beforeinteger- Pagination cursor: return objects created before the object with this ID (newest first). Pass the last ID of the previous page. Example: 123456.
datestring- Issue date range as start,end, e.g. 2026-01-01,2026-06-30. Example: 2026-01-01,2026-06-30.
limitinteger- Page size, up to 100 (default 25). Example: 25.
processor_idstring- Only records with this payment processor ID. Example: cus_PQ9xY2.
qstring- Text to match against the credit note number or customer name. Example: Acme.
statestring- Filters a credit notes list based on the credit state. One of: outstanding, late, paid. Example: outstanding.one of
outstandinglatepaid
quaderno_evidence_listList location evidence records, optionally by state or document ID.Read-onlyList Location Evidence
List location evidence records, optionally by state or document ID. Returns per record the document, billing, IP and bank countries and state.
Inputs
document_idinteger- Only evidence of this invoice ID. Example: 778899.
statestring- Evidence state: unsettled, conflicting or confirmed. Example: conflicting.
quaderno_expense_getGet one expense by ID.Read-onlyGet Expense
Get one expense by ID. Returns date, vendor, items, taxes, totals, payments and attachment.
Inputs
idstringrequired- ID of the expense. Example: 123456.
quaderno_expenses_listList expenses (purchases), newest first, filtered by text, date range, state or vendor contact.Read-onlyList Expenses
List expenses (purchases), newest first, filtered by text, date range, state or vendor contact. Returns per expense its ID, date, vendor, totals and taxes.
Inputs
contactinteger- Only expenses of this vendor contact ID. Example: 4321.
created_beforeinteger- Pagination cursor: return objects created before the object with this ID (newest first). Pass the last ID of the previous page. Example: 123456.
datestring- Issue date range as start,end, e.g. 2026-01-01,2026-06-30. Example: 2026-01-01,2026-06-30.
limitinteger- Page size, up to 100 (default 25). Example: 25.
qstring- Text to match against the expense subject or vendor name. Example: Acme.
statestring- Filters an expenses list based on the expense state: outstanding, late and paid. One of: outstanding, late, paid. Example: outstanding.one of
outstandinglatepaid
quaderno_invoice_getGet one invoice by ID.Read-onlyGet Invoice
Get one invoice by ID. Returns its number, dates, contact, items, taxes, totals, payments, state, PDF and permalink URLs.
Inputs
idstringrequired- ID of the invoice. Example: 123456.
quaderno_invoices_listList invoices, newest first, filtered by number, customer name or PO text, issue date range, state, processor ID or contact.Read-onlyList Invoices
List invoices, newest first, filtered by number, customer name or PO text, issue date range, state, processor ID or contact. Returns per invoice its ID, number, issue date, contact, currency, totals, taxes, state and permalink. Use this to find invoices.
Inputs
contactinteger- Only documents of this contact (customer) ID. Example: 4321.
created_beforeinteger- Pagination cursor: return objects created before the object with this ID (newest first). Pass the last ID of the previous page. Example: 123456.
datestring- Issue date range as start,end, e.g. 2026-01-01,2026-06-30. Example: 2026-01-01,2026-06-30.
limitinteger- Page size, up to 100 (default 25). Example: 25.
processor_idstring- Only records with this payment processor ID. Example: cus_PQ9xY2.
qstring- Text to match against the invoice number, customer name or PO number. Example: Acme.
statestring- Filters an invoices list based on the invoice state. One of: outstanding, late, uncollectible, paid. Example: outstanding.one of
outstandinglateuncollectiblepaid
quaderno_jurisdiction_getGet one tax jurisdiction by ID.Read-onlyGet Tax Jurisdiction
Get one tax jurisdiction by ID. Returns its name, country and region.
Inputs
idstringrequired- ID of the jurisdiction. Example: 45.
quaderno_jurisdictions_listList tax jurisdictions (countries, states and regions where taxes apply), optionally by country or region.Read-onlyList Tax Jurisdictions
List tax jurisdictions (countries, states and regions where taxes apply), optionally by country or region. Returns per jurisdiction its ID, name, country and region. Use this to find the jurisdiction ID for quaderno_registration_create.
Inputs
countrystring- Case-sensitive filter based on the jurisdiction's country 2-letter ISO 3166-1 code. Example: US.
regionstring- Case-sensitive filter based on the jurisdiction's region. Accepts the special string none to return jurisdictions that specifically have no region. Example: CA.
quaderno_pingCheck that the API key and account host work, without using up a regular API call.Read-onlyCheck Connection
Check that the API key and account host work, without using up a regular API call. Returns a success flag and the remaining requests in the current rate-limit window. Use this to test the connection.
Inputs
This tool takes no inputs.
quaderno_product_getGet one product by ID.Read-onlyGet Product
Get one product by ID. Returns code, name, description, unit cost, currency, kind, tax settings and stock.
Inputs
idstringrequired- ID of the product. Example: 123456.
quaderno_products_listList products (items) in the catalog, optionally filtered by name or code text.Read-onlyList Products
List products (items) in the catalog, optionally filtered by name or code text. Returns per product its ID, code, name, description, unit cost, currency, kind, product type and tax class. Use this to find a product code for transactions.
Inputs
created_beforeinteger- Pagination cursor: return objects created before the object with this ID (newest first). Pass the last ID of the previous page. Example: 123456.
limitinteger- Page size, up to 100 (default 25). Example: 25.
qstring- Text to match against the product name or code. Example: Acme.
quaderno_proforma_getGet one proforma by ID.Read-onlyGet Proforma
Get one proforma by ID. Returns number, dates, contact, items, taxes, totals and state.
Inputs
idstringrequired- ID of the proforma. Example: 123456.
quaderno_proformas_listList proformas (quotes), filtered by text, date range, state or contact.Read-onlyList Proformas
List proformas (quotes), filtered by text, date range, state or contact. Returns per proforma its ID, number, date, contact, totals and state.
Inputs
contactinteger- Only documents of this contact (customer) ID. Example: 4321.
created_beforeinteger- Pagination cursor: return objects created before the object with this ID (newest first). Pass the last ID of the previous page. Example: 123456.
datestring- Issue date range as start,end, e.g. 2026-01-01,2026-06-30. Example: 2026-01-01,2026-06-30.
limitinteger- Page size, up to 100 (default 25). Example: 25.
qstring- Text to match against the proforma number or customer name. Example: Acme.
statestring- Filters a proformas list based on the proforma state. One of: outstanding, accepted, declined, invoiced, late. Example: outstanding.one of
outstandingaccepteddeclinedinvoicedlate
quaderno_receipt_getGet one receipt by ID.Read-onlyGet Receipt
Get one receipt by ID. Returns number, date, items, taxes, totals and URLs.
Inputs
idstringrequired- ID of the receipt. Example: 123456.
quaderno_receipts_listList sales receipts (simplified invoices), newest first, filtered by text, date range, processor ID or contact.Read-onlyList Receipts
List sales receipts (simplified invoices), newest first, filtered by text, date range, processor ID or contact. Returns per receipt its ID, number, date, totals and taxes.
Inputs
contactinteger- Only documents of this contact (customer) ID. Example: 4321.
created_beforeinteger- Pagination cursor: return objects created before the object with this ID (newest first). Pass the last ID of the previous page. Example: 123456.
datestring- Issue date range as start,end, e.g. 2026-01-01,2026-06-30. Example: 2026-01-01,2026-06-30.
limitinteger- Page size, up to 100 (default 25). Example: 25.
processor_idstring- Only records with this payment processor ID. Example: cus_PQ9xY2.
qstring- Text to match against the receipt number or customer name. Example: Acme.
quaderno_recurring_getGet one recurring document.Read-onlyGet Recurring Document
Get one recurring document. Returns frequency, dates, contact, items, taxes and state.
Inputs
idstringrequired- ID of the recurring document. Example: 123456.
quaderno_recurring_listList recurring invoices and expenses, filtered by text, date range, state or contact.Read-onlyList Recurring Documents
List recurring invoices and expenses, filtered by text, date range, state or contact. Returns per document its ID, frequency, start and end dates, contact, items and state.
Inputs
contactinteger- Only documents of this contact (customer) ID. Example: 4321.
created_beforeinteger- Pagination cursor: return objects created before the object with this ID (newest first). Pass the last ID of the previous page. Example: 123456.
datestring- Issue date range as start,end, e.g. 2026-01-01,2026-06-30. Example: 2026-01-01,2026-06-30.
limitinteger- Page size, up to 100 (default 25). Example: 25.
qstring- Text to match against the subject or contact name. Example: Acme.
statestring- Filters a recurring list based on the recurring state. One of: active, archived. Example: active.one of
activearchived
quaderno_registration_getGet one of your tax registrations.Read-onlyGet Tax Registration
Get one of your tax registrations. Returns jurisdiction, value, validity dates and flags.
Inputs
idintegerrequired- ID of the tax registration. Example: 123456.
quaderno_registrations_listList your business's tax registrations (tax IDs registered in jurisdictions).Read-onlyList Tax Registrations
List your business's tax registrations (tax IDs registered in jurisdictions). Returns per registration its ID, jurisdiction, value and validity dates. Use this to see where you collect tax.
Inputs
This tool takes no inputs.
quaderno_report_request_getGet a report request.Read-onlyGet Report Request
Get a report request. Returns its type, state and, when finished, the URL of the report file.
Inputs
idintegerrequired- ID of the report request. Example: 123456.
quaderno_tax_code_getGet one tax code.Read-onlyGet Tax Code
Get one tax code. Returns its name and description.
Inputs
idstringrequired- The tax code. One of: consulting, ebook, eservice, exempt, reduced, saas, standard. Example: eservice.one of
consultingebookeserviceexemptreducedsaasstandard
quaderno_tax_codes_listList the tax codes Quaderno supports (consulting, ebook, eservice, saas, standard, reduced, exempt and so on).Read-onlyList Tax Codes
List the tax codes Quaderno supports (consulting, ebook, eservice, saas, standard, reduced, exempt and so on). Returns each code with its name and description. Use this to choose a tax_code for tax calculations and products.
Inputs
This tool takes no inputs.
quaderno_tax_id_validateValidate a customer's tax ID (EU VAT, UK VAT, Swiss VAT, Australian ABN, NZBN, Quebec QST...) against the official registry.Read-onlyValidate Tax ID
Validate a customer's tax ID (EU VAT, UK VAT, Swiss VAT, Australian ABN, NZBN, Quebec QST...) against the official registry. Returns whether it is valid and the registered name and address when available. Use this for B2B reverse-charge checks.
Inputs
countrystringrequired- Country of the tax ID, as a 2-letter ISO code. Example: ES.
tax_idstring- The tax ID to validate, e.g. a VAT number. Example: ESB12345678.
quaderno_tax_rate_calculateCalculate the tax that applies to a sale for a customer location, product type or tax code and optional amount, including tax ID validation for B2B reverse charge.Read-onlyCalculate Tax Rate
Calculate the tax that applies to a sale for a customer location, product type or tax code and optional amount, including tax ID validation for B2B reverse charge. Returns the tax name, rate, country, region, taxable and tax amounts and status (taxable, reverse charge, exempt). Use this before charging. Use quaderno_transaction_create to record the sale.
Inputs
to_countrystringrequired- The customer's country. 2-letter ISO country code (https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes). Example: DE.
amountstring- The transaction's amount. Example: 100.00.
currencystring- The transaction's currency. Three-letter ISO currency code (https://en.wikipedia.org/wiki/ISO_4217), in uppercase. Defaults to the account's currency. Example: EUR.
datestring- Issue date range as start,end, e.g. 2026-01-01,2026-06-30. Example: 2026-06-15.
from_countrystring- The seller's country. 2-letter ISO country code (https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes). Defaults to the account's country. Example: ES.
from_postal_codestring- The seller's ZIP or postal code. Defaults to the account's postal code. Example: 08008.
product_typestring- Specifies whether the product is a good or a service. Defaults to the account's default. One of: good, service. Example: service.one of
goodservice tax_behaviorstring- Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of: inclusive, exclusive. Example: exclusive.one of
inclusiveexclusive tax_codestring- The transaction's tax code. Tax codes can be obtained via GET /tax_codes. Defaults to the account's default tax code. One of: consulting, eservice, ebook, saas, standard, reduced, exempt. Example: eservice.one of
consultingeserviceebooksaasstandardreducedexempt tax_idstring- The customer's tax ID. Quaderno can validate VAT/GST numbers from the EU, United Kingdom, Switzerland, Québec (Canada), Australia, and New Zealand. Example: ESB12345678.
to_citystring- The customer's city. Recommended for US Sales Tax calculations. Example: Berlin.
to_postal_codestring- The customer's ZIP or postal code. Example: 10115.
to_streetstring- The customer's street address. Recommended for US Sales Tax calculations. Example: Unter den Linden 1.
quaderno_webhooks_listList webhook endpoints.Read-onlyList Webhooks
List webhook endpoints. Returns per endpoint its ID, URL, event types and delivery stats.
Inputs
This tool takes no inputs.
quaderno_contact_createCreate a customer or vendor contact (a person or a company).WriteCreate Contact
Create a customer or vendor contact (a person or a company). Returns the new contact with its ID. Use quaderno_contact_update to change it.
Inputs
first_namestringrequired- First name for a person, or the company name for a company. Example: Jane.
citystring- City/District/Suburb/Town/Village. Example: Barcelona.
contact_personstring- If the contact is a company, this is its contact person. Example: Jane Doe.
countrystring- 2-letter ISO country code (https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes). Example: ES.
departmentstring- If the contact is a company, this is the deparment. Example: Finance.
discountnumber- Default discount for this contact. Example: 10.
emailstring- The contact's email address. Example: jane@example.com.
kindstring- The type of contact. One of: company, person. Example: person.one of
companyperson languagestring- The contact's preferred language. 2-letter ISO language code (https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes). Should be included in the account's translations list. Example: EN.
last_namestring- The contact's last name. Only if the contact is a person. Example: Doe.
notesstring- Internal notes about the contact. Example: Key account.
phone_1string- The contact's phone number. Example: +34 600 000 000.
postal_codestring- ZIP or postal code. Example: 08008.
processorstring- The external platform where the contact was imported from, if applicable. Example: stripe.
processor_idstring- Only records with this payment processor ID. Example: cus_PQ9xY2.
regionstring- State/Province/Region. Example: Barcelona.
street_line_1string- Address line 1 (Street address/PO Box). Example: Carrer de Balmes 1.
street_line_2string- Address line 2 (Apartment/Suite/Unit/Building). Example: Floor 2.
tax_idstring- The contact's tax identification number. Quaderno can validate EU VAT numbers, ABN, and NZBN. Example: ESB12345678.
tax_statusstring- Specifies the tax status of the contact. One of: taxable, exempt, reverse. Example: taxable.one of
taxableexemptreverse webstring- The contact's website. Example: https://example.com.
quaderno_contact_updateUpdate the fields you pass on one contact; other fields are unchanged.WriteUpdate Contact
Update the fields you pass on one contact; other fields are unchanged. Returns the updated contact.
- Idempotent
Inputs
idintegerrequired- ID of the contact. Example: 123456.
citystring- City/District/Suburb/Town/Village. Example: Barcelona.
contact_personstring- If the contact is a company, this is its contact person. Example: Jane Doe.
countrystring- 2-letter ISO country code (https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes). Example: ES.
departmentstring- If the contact is a company, this is the deparment. Example: Finance.
discountnumber- Default discount for this contact. Example: 10.
emailstring- The contact's email address. Example: jane@example.com.
first_namestring- First name for a person, or the company name for a company. Example: Jane.
kindstring- The type of contact. One of: company, person. Example: person.one of
companyperson languagestring- The contact's preferred language. 2-letter ISO language code (https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes). Should be included in the account's translations list. Example: EN.
last_namestring- The contact's last name. Only if the contact is a person. Example: Doe.
notesstring- Internal notes about the contact. Example: Key account.
phone_1string- The contact's phone number. Example: +34 600 000 000.
postal_codestring- ZIP or postal code. Example: 08008.
processorstring- The external platform where the contact was imported from, if applicable. Example: stripe.
processor_idstring- Only records with this payment processor ID. Example: cus_PQ9xY2.
regionstring- State/Province/Region. Example: Barcelona.
street_line_1string- Address line 1 (Street address/PO Box). Example: Carrer de Balmes 1.
street_line_2string- Address line 2 (Apartment/Suite/Unit/Building). Example: Floor 2.
tax_idstring- The contact's tax identification number. Quaderno can validate EU VAT numbers, ABN, and NZBN. Example: ESB12345678.
tax_statusstring- Specifies the tax status of the contact. One of: taxable, exempt, reverse. Example: taxable.one of
taxableexemptreverse webstring- The contact's website. Example: https://example.com.
quaderno_credit_createIssue a credit note (full or partial refund) for an invoice.WriteCreate Credit Note
Issue a credit note (full or partial refund) for an invoice. Returns the new credit note. Use quaderno_invoice_void to cancel a whole invoice.
Inputs
invoice_idintegerrequired- The ID of the refunded invoice. Example: 778899.
credited_amountnumber- Total amount to be credited, equal or lower than the total amount of the related invoice. Only works for refunds of invoices with one single item. When empty, defaults to the total amount of the related invoice. Example: 50.50.
payment_methodstring- Payment method used to refund the credited amount. One of: credit_card, cash, wire_transfer, direct_debit, check, iou, paypal, other. Example: credit_card.one of
credit_cardcashwire_transferdirect_debitcheckioupaypalother
quaderno_credit_deliverEmail a credit note to its customer.WriteEmail Credit Note
Email a credit note to its customer. Returns the delivery result.
Inputs
idstringrequired- ID of the credit note. Example: 123456.
quaderno_credit_payment_createRecord a refund payment against a credit note.WriteRecord Credit Note Payment
Record a refund payment against a credit note. Returns the payment.
Inputs
idstringrequired- ID of the credit note. Example: 123456.
amountnumber- Paid amount. Example: 121.50.
datestring- Payment date (YYYY-MM-DD); defaults to today. Example: 2026-06-20.
payment_methodstring- payment method. One of: credit_card, cash, wire_transfer, direct_debit, check, iou, paypal, other, credit, offset. Example: credit_card.one of
credit_cardcashwire_transferdirect_debitcheckioupaypalothercreditoffset processorstring- The payment processor used to process the payment. Example: stripe.
processor_idstring- Only records with this payment processor ID. Example: re_3PQ9xY2.
quaderno_credit_updateUpdate a credit note's tags, payment details, notes or custom metadata.WriteUpdate Credit Note
Update a credit note's tags, payment details, notes or custom metadata. Returns the updated credit note.
- Idempotent
Inputs
idintegerrequired- ID of the credit note. Example: 123456.
custom_metadataobject- Set of key-value pairs that you can attach to an object. Example: {"order_id":"A-1001"}
notesstring- Extra notes about the document. Example: Key account.
payment_detailsstring- Detailed information about the accepted payment methods. Example: Pay by bank transfer to ES12 3456 7890.
tag_listarray- Multiple tags should be separated by commas. Example: ["q3"]
quaderno_expense_createRecord an expense (a purchase from a vendor) with its line items and taxes.WriteCreate Expense
Record an expense (a purchase from a vendor) with its line items and taxes. Returns the new expense.
Inputs
contactobjectrequired- Vendor of the expense: {"id": <contact ID>} or contact fields such as first_name and country. Example: {"id":4321}
itemsarrayrequired- Line items, each with a description, quantity and unit_price (or total_amount), and optional tax_1_* and tax_2_* fields (name, rate, country, region). Example: [{"description":"Laptop stand","quantity":2,"unit_price":30.0,"tax_1_name":"IVA","tax_1_rate":21,"tax_1_country":"ES"}]
countrystring- The customer’s billing country. 2-letter ISO country code (https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes). Example: ES.
currencystring- Three-letter ISO currency code (https://en.wikipedia.org/wiki/ISO_4217), in uppercase. Example: EUR.
issue_datestring- Date when the expense was issued. Example: 2026-06-15.
notesstring- Extra notes about the expense. Example: Key account.
payment_methodstring- Payment method used. One of: credit_card, cash, wire_transfer, direct_debit, check, iou, paypal, other. Example: credit_card.one of
credit_cardcashwire_transferdirect_debitcheckioupaypalother po_numberstring- Purchase order number. Example: PO-2026-001.
subjectstring- An optional summary description of the document. Example: Office supplies.
tag_listarray- Multiple tags should be separated by commas. Example: ["q3"]
quaderno_expense_updateUpdate the fields you pass on one expense.WriteUpdate Expense
Update the fields you pass on one expense. Returns the updated expense.
- Idempotent
Inputs
idintegerrequired- ID of the expense. Example: 123456.
contactobject- Vendor of the expense: {"id": <contact ID>} or contact fields such as first_name and country. Example: {"id":4321}
countrystring- The customer’s billing country. 2-letter ISO country code (https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes). Example: ES.
currencystring- Three-letter ISO currency code (https://en.wikipedia.org/wiki/ISO_4217), in uppercase. Example: EUR.
issue_datestring- Date when the expense was issued. Example: 2026-06-15.
itemsarray- Line items, each with a description, quantity and unit_price (or total_amount), and optional tax_1_* and tax_2_* fields (name, rate, country, region). Example: [{"description":"Laptop stand","quantity":2,"unit_price":30.0,"tax_1_name":"IVA","tax_1_rate":21,"tax_1_country":"ES"}]
notesstring- Extra notes about the expense. Example: Key account.
payment_methodstring- Payment method used. One of: credit_card, cash, wire_transfer, direct_debit, check, iou, paypal, other. Example: credit_card.one of
credit_cardcashwire_transferdirect_debitcheckioupaypalother po_numberstring- Purchase order number. Example: PO-2026-001.
subjectstring- An optional summary description of the document. Example: Office supplies.
tag_listarray- Multiple tags should be separated by commas. Example: ["q3"]
quaderno_invoice_deliverEmail an invoice to its customer.WriteEmail Invoice
Email an invoice to its customer. Returns the delivery result. Use this to send or resend an invoice.
Inputs
idstringrequired- ID of the invoice. Example: 123456.
quaderno_invoice_mark_uncollectibleMark an unpaid invoice as uncollectible (bad debt).WriteMark Invoice Uncollectible
Mark an unpaid invoice as uncollectible (bad debt). Returns the updated invoice.
- Idempotent
Inputs
idstringrequired- ID of the invoice. Example: 123456.
quaderno_invoice_payment_createRecord a payment against an invoice.WriteRecord Invoice Payment
Record a payment against an invoice. Returns the payment. Use this when a customer pays an outstanding invoice.
Inputs
idstringrequired- ID of the invoice. Example: 123456.
amountnumber- Paid amount. Example: 121.50.
datestring- Payment date (YYYY-MM-DD); defaults to today. Example: 2026-06-20.
payment_methodstring- payment method. One of: credit_card, cash, wire_transfer, direct_debit, check, iou, paypal, other, credit, offset. Example: credit_card.one of
credit_cardcashwire_transferdirect_debitcheckioupaypalothercreditoffset processorstring- The payment processor used to process the payment. Example: stripe.
processor_idstring- Only records with this payment processor ID. Example: ch_3PQ9xY2.
quaderno_invoice_updateUpdate an invoice's tags, payment details, notes or custom metadata (amounts and taxes cannot change).WriteUpdate Invoice
Update an invoice's tags, payment details, notes or custom metadata (amounts and taxes cannot change). Returns the updated invoice.
- Idempotent
Inputs
idintegerrequired- ID of the invoice. Example: 123456.
custom_metadataobject- Set of key-value pairs that you can attach to an object. Example: {"order_id":"A-1001"}
notesstring- Extra notes about the document. Example: Key account.
payment_detailsstring- Detailed information about the accepted payment methods. Example: Pay by bank transfer to ES12 3456 7890.
tag_listarray- Multiple tags should be separated by commas. Example: ["q3"]
quaderno_product_createCreate a product (good or service, one-off or subscription) with its price and tax settings.WriteCreate Product
Create a product (good or service, one-off or subscription) with its price and tax settings. Returns the new product with its ID. Use its code as product_code in quaderno_transaction_create.
Inputs
codestringrequired- The product’s SKU (Stock Keeping Unit) describe specific product variations, taking into account any combination of: attributes, currency, and cost. Example: PRO-MONTHLY.
descriptionstringrequired- The product’s description, meant to be displayable to the customer. Use this field to optionally store a long form explanation of the product being sold for your own rendering purposes. Example: Pro plan, billed monthly.
kindstringrequired- The type of transaction: one-off purchase or subscription. One of: one_off, subscription. Example: subscription.one of
one_offsubscription namestringrequired- The product’s name, meant to be displayable to the customer. Example: Pro plan.
product_typestringrequired- The type of the product. The product is either a tangible good or a service. One of: good, service. Example: service.one of
goodservice stockstringrequired- Stock count of a physical good; use 0 for services and digital goods. Example: 0.
tax_based_onstringrequired- How taxes are going to be calculated: based on the customer country or a particular country. One of: customer_country, country. Example: customer_country.one of
customer_countrycountry tax_classstringrequired- The tax class that applies to the product. One of: consulting, eservice, ebook, saas, standard, reduced. Example: saas.one of
consultingeserviceebooksaasstandardreduced tax_typestringrequired- Specify if taxes are included or excluded in the unit_cost. One of: excluded, included. Example: excluded.one of
excludedincluded unit_coststringrequired- The unit amount to be charged. Example: 29.00.
countrystring- 2-letter ISO country code (https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes). Required if tax_based_on is country. Example: ES.
currencystring- Three-letter ISO currency code (https://en.wikipedia.org/wiki/ISO_4217), in uppercase. Must be a supported currency in your payment processors. Example: EUR.
stripe_plan_idstring- Only for Stripe subscriptions. ID of the Stripe price related to the subscription. Example: price_1PQ9xY2.
quaderno_product_updateUpdate the fields you pass on one product, such as name, price or tax class.WriteUpdate Product
Update the fields you pass on one product, such as name, price or tax class. Returns the updated product.
- Idempotent
Inputs
idintegerrequired- ID of the product. Example: 123456.
codestring- The product’s SKU (Stock Keeping Unit) describe specific product variations, taking into account any combination of: attributes, currency, and cost. Example: PRO-MONTHLY.
countrystring- 2-letter ISO country code (https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes). Required if tax_based_on is country. Example: ES.
currencystring- Three-letter ISO currency code (https://en.wikipedia.org/wiki/ISO_4217), in uppercase. Must be a supported currency in your payment processors. Example: EUR.
descriptionstring- The product’s description, meant to be displayable to the customer. Use this field to optionally store a long form explanation of the product being sold for your own rendering purposes. Example: Pro plan, billed monthly.
kindstring- The type of transaction: one-off purchase or subscription. One of: one_off, subscription. Example: subscription.one of
one_offsubscription namestring- The product’s name, meant to be displayable to the customer. Example: Pro plan.
product_typestring- The type of the product. The product is either a tangible good or a service. One of: good, service. Example: service.one of
goodservice stockstring- The stock of the physical product. Example: 0.
stripe_plan_idstring- Only for Stripe subscriptions. ID of the Stripe price related to the subscription. Example: price_1PQ9xY2.
tax_based_onstring- How taxes are going to be calculated: based on the customer country or a particular country. One of: customer_country, country. Example: customer_country.one of
customer_countrycountry tax_classstring- The tax class that applies to the product. One of: consulting, eservice, ebook, saas, standard, reduced. Example: saas.one of
consultingeserviceebooksaasstandardreduced tax_typestring- Specify if taxes are included or excluded in the unit_cost. One of: excluded, included. Example: excluded.one of
excludedincluded unit_coststring- The unit amount to be charged. Example: 29.00.
quaderno_proforma_acceptMark a proforma as accepted by the customer.WriteAccept Proforma
Mark a proforma as accepted by the customer. Returns the updated proforma.
- Idempotent
Inputs
idstringrequired- ID of the proforma. Example: 123456.
quaderno_proforma_convertConvert an accepted proforma into an invoice.WriteConvert Proforma to Invoice
Convert an accepted proforma into an invoice. Returns the new invoice.
Inputs
idstringrequired- ID of the proforma. Example: 123456.
quaderno_proforma_deliverEmail a proforma to its customer.WriteEmail Proforma
Email a proforma to its customer. Returns the delivery result.
Inputs
idstringrequired- ID of the proforma. Example: 123456.
quaderno_receipt_deliverEmail a receipt to its customer.WriteEmail Receipt
Email a receipt to its customer. Returns the delivery result.
Inputs
idstringrequired- ID of the receipt. Example: 123456.
quaderno_registration_createRegister a tax ID for your business in a jurisdiction so Quaderno starts collecting tax there.WriteCreate Tax Registration
Register a tax ID for your business in a jurisdiction so Quaderno starts collecting tax there. Returns the new registration. Use quaderno_jurisdictions_list for the jurisdiction ID.
Inputs
jurisdiction_idintegerrequired- ID of the tax jurisdiction where the tax ID is registered. Example: 45.
valuestringrequired- Value of the tax ID. For instance, a VAT number. Example: ESB12345678.
import_schemeboolean- Whether the business is registered or not in the EU import scheme for foreign sellers of physical goods. Example: false.
permanent_establishmentboolean- Whether your business has physical presence (office, warehouse, etc) in the given jurisdiction. Example: true.
valid_fromstring- The tax ID's validity date. Defaults to the beginning of the year. Example: 2026-01-01.
valid_untilstring- The tax ID's expiration date, or null if the tax ID has no expiration date. Example: 2027-12-31.
quaderno_registration_updateUpdate the value, validity dates or flags of a tax registration.WriteUpdate Tax Registration
Update the value, validity dates or flags of a tax registration. Returns the updated registration.
- Idempotent
Inputs
idstringrequired- ID of the tax registration. Example: 123456.
import_schemeboolean- Whether the business is registered or not in the EU import scheme for foreign sellers of physical goods. Example: false.
permanent_establishmentboolean- Whether your business has physical presence (office, warehouse, etc) in the given jurisdiction. Example: true.
valid_fromstring- The tax ID's validity date. Defaults to the beginning of the year. Example: 2026-01-01.
valid_untilstring- The tax ID's expiration date, or null if the tax ID has no expiration date. Example: 2027-12-31.
valuestring- Value of the tax ID you need fixing. Example: ESB12345678.
quaderno_report_request_createRequest a report (tax summary, invoices list or credits list) for a period; Quaderno builds it in the background.WriteRequest Report
Request a report (tax summary, invoices list or credits list) for a period; Quaderno builds it in the background. Returns the report request with its state. Use quaderno_report_request_get to fetch the download URL when it is ready.
Inputs
parametersobject- Report parameters, such as {"from_date": "2026-01-01", "to_date": "2026-03-31"}. Example: {"from_date":"2026-01-01","to_date":"2026-03-31"}
report_typestring- The type of report. One of: tax_summary, invoices_list, credits_list. Example: tax_summary.one of
tax_summaryinvoices_listcredits_list
quaderno_transaction_createRecord a sale or refund: Quaderno calculates the taxes from the customer and evidence and issues the matching invoice, receipt or credit note.WriteRecord Transaction
Record a sale or refund: Quaderno calculates the taxes from the customer and evidence and issues the matching invoice, receipt or credit note. Returns the created document with its taxes and totals. Use quaderno_tax_rate_calculate first if you only need a quote.
Inputs
itemsarrayrequired- Line items, each with a description or product_code, the total amount, an optional quantity and an optional tax object such as {"tax_code": "eservice"}. Example: [{"description":"Pro plan, June","amount":29.0,"quantity":1,"tax":{"tax_code":"eservice"}}]
paymentobjectrequired- Payment: method (credit_card, cash, wire_transfer, direct_debit, check, iou, paypal, other) and optionally processor and processor_id. Example: {"method":"credit_card","processor":"stripe","processor_id":"ch_3PQ9xY2"}
currencystring- Three-letter ISO currency code (https://en.wikipedia.org/wiki/ISO_4217), in uppercase. Defaults to the account’s default currency. Example: EUR.
customerobject- Customer: {"id": <contact ID>} for an existing contact, or the contact fields (first_name, last_name or company, email, country, postal_code...). Example: {"first_name":"Jane","last_name":"Doe","email":"jane@example.com","country":"DE","postal_code":"10115"}
datestring- Issue date range as start,end, e.g. 2026-01-01,2026-06-30. Example: 2026-06-15.
evidenceobject- Location evidence such as billing_country, ip_address and bank_country; recommended for EU sales. Example: {"billing_country":"DE","ip_address":"203.0.113.10"}
notesstring- Optional notes attached to the transaction. Example: Key account.
po_numberstring- The number of the related order. **Recommended**. Example: PO-2026-001.
processorstring- The name of the platform that processed the transaction. E.g. shopify, woocommerce or any user agent you may want to use to identify yourself… **Recommended**. Example: stripe.
processor_idstring- Only records with this payment processor ID. Example: ch_3PQ9xY2.
shipping_addressobject- The mailing address to where the order will be shipped. Use it if the order contains physical goods. Example: {"street_line_1":"Unter den Linden 1","city":"Berlin","postal_code":"10115","country":"DE"}
tagsstring- Tags attached to the transaction, formatted as a string of comma-separated values. Tags are additional short descriptors, commonly used for filtering and searching. Each individual tag is limited to 40 characters in length. Example: web,june.
typestring- The transaction’s type. One of: sale, refund. Example: sale.one of
salerefund
quaderno_webhook_createCreate a webhook endpoint that receives the chosen event types (e.g.WriteCreate Webhook
Create a webhook endpoint that receives the chosen event types (e.g. invoice.created). Returns the endpoint with its signing auth_key.
Inputs
events_typesarrayrequired- Event types to send, e.g. invoice.created, credit.created, contact.updated. Example: ["invoice.created","credit.created"]
urlstringrequired- The URL of the webhook endpoint. Example: https://example.com/quaderno-webhook.
quaderno_contact_deleteDelete a contact that has no documents.DestructiveDelete Contact
Delete a contact that has no documents. Returns nothing on success.
- Idempotent
Inputs
idstringrequired- ID of the contact. Example: 123456.
quaderno_credit_voidVoid a credit note with a reason.DestructiveVoid Credit Note
Void a credit note with a reason. Returns the voided credit note.
- Idempotent
Inputs
idintegerrequired- ID of the credit note. Example: 123456.
void_reasonstringrequired- void reason. Example: Issued by mistake.
quaderno_expense_deleteDelete an expense.DestructiveDelete Expense
Delete an expense. Returns nothing on success.
- Idempotent
Inputs
idstringrequired- ID of the expense. Example: 123456.
quaderno_invoice_voidVoid an invoice with a reason; Quaderno issues the matching credit note.DestructiveVoid Invoice
Void an invoice with a reason; Quaderno issues the matching credit note. Returns the voided invoice. Use quaderno_credit_create for a partial refund instead.
- Idempotent
Inputs
idstringrequired- ID of the invoice. Example: 123456.
void_reasonstringrequired- void reason. Example: Issued by mistake.
quaderno_product_deleteDelete a product from the catalog.DestructiveDelete Product
Delete a product from the catalog. Returns nothing on success.
- Idempotent
Inputs
idstringrequired- ID of the product. Example: 123456.
quaderno_receipt_voidVoid a receipt with a reason.DestructiveVoid Receipt
Void a receipt with a reason. Returns the voided receipt.
- Idempotent
Inputs
idstringrequired- ID of the receipt. Example: 123456.
void_reasonstringrequired- void reason. Example: Issued by mistake.
quaderno_recurring_deleteDelete a recurring document so no further documents are issued.DestructiveDelete Recurring Document
Delete a recurring document so no further documents are issued. Returns nothing on success.
- Idempotent
Inputs
idstringrequired- ID of the recurring document. Example: 123456.
quaderno_registration_deleteDelete one of your tax registrations.DestructiveDelete Tax Registration
Delete one of your tax registrations. Returns nothing on success.
- Idempotent
Inputs
idstringrequired- ID of the tax registration. Example: 123456.
quaderno_webhook_deleteDelete a webhook endpoint.DestructiveDelete Webhook
Delete a webhook endpoint. Returns nothing on success.
- Idempotent
Inputs
idstringrequired- ID of the webhook. Example: 123456.
No tools match.