Reviso MCP by usefulapi
Read customers, invoices and ledger entries; create customers and draft invoices in Reviso.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"reviso": {
"url": "https://reviso.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://reviso.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (23)
🟢reviso_get_company
The connected Reviso agreement: company name, address, VAT number, bank details, base currency, VAT reporting frequency, agreement number and country type, the granting user and the app. Good first call. GET /self.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reviso_list_customers(search, email, filter, sort, page, ...)
List customers with number, name, address, VAT number, currency, payment terms, VAT zone and balance. search matches the name (contains, case-insensitive); filter and sort take the raw Reviso syntax. Paged: pass next_page as page. GET /customers.
Eingabe-Schema
{
"type": "object",
"properties": {
"search": {
"description": "Part of the customer's name.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"email": {
"description": "Part of the customer's email address.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"filter": {
"description": "Raw Reviso filter: predicates property$op:value joined by $and: / $or: (parentheses group), e.g. date$gte:2026-01-01$and:netAmount$gt:500. Operators $eq: $ne: $gt: $gte: $lt: $lte: $like: (contains; * wildcard) $in:[1,2]. Escape $ ( ) * , [ ] in values with a $ prefix. Only properties the collection marks filterable work (else HTTP 400).",
"type": "string",
"maxLength": 1000
},
"sort": {
"description": "Sort by properties, comma-separated; prefix - for descending, e.g. -date,name. Only sortable properties work.",
"type": "string",
"maxLength": 200
},
"page": {
"description": "Page index, 0-based (default 0). Use next_page from the previous reply.",
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"page_size": {
"description": "Results per page, 1-1000 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 1000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reviso_get_customer(customer_number)
One customer by customer number: address, contacts reference, groups, payment terms, VAT zone, credit limit, balance and bank details. GET /customers/{customerNumber}.
Eingabe-Schema
{
"type": "object",
"properties": {
"customer_number": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The customer number (reviso_list_customers)."
}
},
"required": [
"customer_number"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reviso_list_suppliers(search, filter, sort, page, page_size)
List suppliers with number, name, address, VAT number, currency, payment terms and VAT zone. search matches the name (contains). Paged: pass next_page as page. GET /suppliers.
Eingabe-Schema
{
"type": "object",
"properties": {
"search": {
"description": "Part of the supplier's name.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"filter": {
"description": "Raw Reviso filter: predicates property$op:value joined by $and: / $or: (parentheses group), e.g. date$gte:2026-01-01$and:netAmount$gt:500. Operators $eq: $ne: $gt: $gte: $lt: $lte: $like: (contains; * wildcard) $in:[1,2]. Escape $ ( ) * , [ ] in values with a $ prefix. Only properties the collection marks filterable work (else HTTP 400).",
"type": "string",
"maxLength": 1000
},
"sort": {
"description": "Sort by properties, comma-separated; prefix - for descending, e.g. -date,name. Only sortable properties work.",
"type": "string",
"maxLength": 200
},
"page": {
"description": "Page index, 0-based (default 0). Use next_page from the previous reply.",
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"page_size": {
"description": "Results per page, 1-1000 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 1000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reviso_get_supplier(supplier_number)
One supplier by supplier number: address, group, payment terms, VAT zone, bank account and default voucher template. GET /suppliers/{supplierNumber}.
Eingabe-Schema
{
"type": "object",
"properties": {
"supplier_number": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The supplier number (reviso_list_suppliers)."
}
},
"required": [
"supplier_number"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reviso_list_products(search, filter, sort, page, page_size)
List products and services with number, name, group, unit, sales price, cost price and (with the inventory module) stock. search matches the name (contains). Paged: pass next_page as page. GET /products.
Eingabe-Schema
{
"type": "object",
"properties": {
"search": {
"description": "Part of the product's name.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"filter": {
"description": "Raw Reviso filter: predicates property$op:value joined by $and: / $or: (parentheses group), e.g. date$gte:2026-01-01$and:netAmount$gt:500. Operators $eq: $ne: $gt: $gte: $lt: $lte: $like: (contains; * wildcard) $in:[1,2]. Escape $ ( ) * , [ ] in values with a $ prefix. Only properties the collection marks filterable work (else HTTP 400).",
"type": "string",
"maxLength": 1000
},
"sort": {
"description": "Sort by properties, comma-separated; prefix - for descending, e.g. -date,name. Only sortable properties work.",
"type": "string",
"maxLength": 200
},
"page": {
"description": "Page index, 0-based (default 0). Use next_page from the previous reply.",
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"page_size": {
"description": "Results per page, 1-1000 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 1000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reviso_get_product(product_number)
One product by product number (a string): name, description, group, unit, prices, barcode, stock. GET /products/{productNumber}.
Eingabe-Schema
{
"type": "object",
"properties": {
"product_number": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "The product number (reviso_list_products)."
}
},
"required": [
"product_number"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reviso_list_invoices(state, customer_number, date_from, date_to, filter, ...)
List sales invoices by state: drafts (not yet booked), booked (all issued), unpaid, paid, overdue, not-due. Each row has number, customer, date, due date, currency, net/gross/VAT amounts and remaining balance. Filter by customer_number and dates; filter and sort take the raw Reviso syntax. Paged: pass next_page as page. GET /v2/invoices/{state}.
Eingabe-Schema
{
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": [
"drafts",
"booked",
"unpaid",
"paid",
"overdue",
"not-due"
],
"description": "drafts, booked, unpaid, paid, overdue or not-due."
},
"customer_number": {
"description": "Only this customer's invoices.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"date_from": {
"description": "Invoice date on or after this day (yyyy-mm-dd).",
"type": "string"
},
"date_to": {
"description": "Invoice date on or before this day (yyyy-mm-dd).",
"type": "string"
},
"filter": {
"description": "Raw Reviso filter: predicates property$op:value joined by $and: / $or: (parentheses group), e.g. date$gte:2026-01-01$and:netAmount$gt:500. Operators $eq: $ne: $gt: $gte: $lt: $lte: $like: (contains; * wildcard) $in:[1,2]. Escape $ ( ) * , [ ] in values with a $ prefix. Only properties the collection marks filterable work (else HTTP 400).",
"type": "string",
"maxLength": 1000
},
"sort": {
"description": "Sort by properties, comma-separated; prefix - for descending, e.g. -date,name. Only sortable properties work.",
"type": "string",
"maxLength": 200
},
"page": {
"description": "Page index, 0-based (default 0). Use next_page from the previous reply.",
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"page_size": {
"description": "Results per page, 1-1000 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 1000
}
},
"required": [
"state"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reviso_get_invoice(state, number)
One sales invoice with its lines, recipient, payment terms and totals. A draft is addressed by its draft number (the id of a drafts row), a booked invoice by its bookedInvoiceNumber (the voucher number shown in booked, unpaid, paid, overdue and not-due rows). GET /v2/invoices/drafts/{n} or /v2/invoices/booked/{n}.
Eingabe-Schema
{
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": [
"drafts",
"booked"
],
"description": "drafts for an unbooked draft, booked for an issued invoice (also paid/unpaid/overdue ones)."
},
"number": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Draft invoice number (state drafts), or bookedInvoiceNumber (state booked)."
}
},
"required": [
"state",
"number"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reviso_list_orders(customer_number, filter, sort, page, page_size)
List sales orders with number, customer, date, currency, net/gross amounts, sent and archived flags. Filter by customer_number; filter and sort take the raw Reviso syntax. Paged: pass next_page as page. GET /orders.
Eingabe-Schema
{
"type": "object",
"properties": {
"customer_number": {
"description": "Only this customer's sales orders.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"filter": {
"description": "Raw Reviso filter: predicates property$op:value joined by $and: / $or: (parentheses group), e.g. date$gte:2026-01-01$and:netAmount$gt:500. Operators $eq: $ne: $gt: $gte: $lt: $lte: $like: (contains; * wildcard) $in:[1,2]. Escape $ ( ) * , [ ] in values with a $ prefix. Only properties the collection marks filterable work (else HTTP 400).",
"type": "string",
"maxLength": 1000
},
"sort": {
"description": "Sort by properties, comma-separated; prefix - for descending, e.g. -date,name. Only sortable properties work.",
"type": "string",
"maxLength": 200
},
"page": {
"description": "Page index, 0-based (default 0). Use next_page from the previous reply.",
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"page_size": {
"description": "Results per page, 1-1000 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 1000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reviso_get_order(id)
One order with its lines, recipient, delivery, payment terms and totals, by its id (the id of a reviso_list_orders row). GET /orders/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The order id (reviso_list_orders)."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reviso_list_quotations(customer_number, filter, sort, page, page_size)
List quotations with number, customer, date, currency, net/gross amounts, sent and archived flags. Filter by customer_number; filter and sort take the raw Reviso syntax. Paged: pass next_page as page. GET /quotations.
Eingabe-Schema
{
"type": "object",
"properties": {
"customer_number": {
"description": "Only this customer's quotations.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"filter": {
"description": "Raw Reviso filter: predicates property$op:value joined by $and: / $or: (parentheses group), e.g. date$gte:2026-01-01$and:netAmount$gt:500. Operators $eq: $ne: $gt: $gte: $lt: $lte: $like: (contains; * wildcard) $in:[1,2]. Escape $ ( ) * , [ ] in values with a $ prefix. Only properties the collection marks filterable work (else HTTP 400).",
"type": "string",
"maxLength": 1000
},
"sort": {
"description": "Sort by properties, comma-separated; prefix - for descending, e.g. -date,name. Only sortable properties work.",
"type": "string",
"maxLength": 200
},
"page": {
"description": "Page index, 0-based (default 0). Use next_page from the previous reply.",
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"page_size": {
"description": "Results per page, 1-1000 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 1000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reviso_get_quotation(id)
One quotation with its lines, recipient, delivery, payment terms and totals, by its id (the id of a reviso_list_quotations row). GET /quotations/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The quotation id (reviso_list_quotations)."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reviso_list_accounts(search, filter, sort, page, page_size)
List ledger accounts with number, name, type (heading, profitAndLoss, status, sum, ...), debit/credit side, current balance and barred flag. search matches the name. Paged: pass next_page as page. GET /accounts.
Eingabe-Schema
{
"type": "object",
"properties": {
"search": {
"description": "Part of the account name.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"filter": {
"description": "Raw Reviso filter: predicates property$op:value joined by $and: / $or: (parentheses group), e.g. date$gte:2026-01-01$and:netAmount$gt:500. Operators $eq: $ne: $gt: $gte: $lt: $lte: $like: (contains; * wildcard) $in:[1,2]. Escape $ ( ) * , [ ] in values with a $ prefix. Only properties the collection marks filterable work (else HTTP 400).",
"type": "string",
"maxLength": 1000
},
"sort": {
"description": "Sort by properties, comma-separated; prefix - for descending, e.g. -date,name. Only sortable properties work.",
"type": "string",
"maxLength": 200
},
"page": {
"description": "Page index, 0-based (default 0). Use next_page from the previous reply.",
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"page_size": {
"description": "Results per page, 1-1000 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 1000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reviso_list_accounting_years(page, page_size)
List the agreement's accounting years with their year label, start and end date and closed flag. The year label is what reviso_list_account_totals and reviso_list_entries need. GET /accounting-years.
Eingabe-Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page index, 0-based (default 0). Use next_page from the previous reply.",
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"page_size": {
"description": "Results per page, 1-1000 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 1000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reviso_list_account_totals(year, page, page_size)
Total posted per ledger account (in base currency) for one accounting year: a trial balance. Use reviso_list_accounting_years for the year label. Paged: pass next_page as page. GET /accounting-years/{year}/totals.
Eingabe-Schema
{
"type": "object",
"properties": {
"year": {
"type": "string",
"pattern": "^\\d{4}([-/]\\d{2,4})?$",
"description": "Accounting year label, e.g. 2026."
},
"page": {
"description": "Page index, 0-based (default 0). Use next_page from the previous reply.",
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"page_size": {
"description": "Results per page, 1-1000 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 1000
}
},
"required": [
"year"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reviso_list_entries(year, account_number, date_from, date_to, filter, ...)
Ledger entries (postings) of one accounting year: account, date, amount, amount in base currency, currency, entry type (customerInvoice, supplierInvoice, financeVoucher, ...) and voucher number. With account_number only that ledger account's postings are listed. Filter by dates (date_from/date_to); the raw filter works on currency and date. Paged: pass next_page as page. GET /accounting-years/{year}/entries or /accounts/{accountNumber}/accounting-years/{year}/entries.
Eingabe-Schema
{
"type": "object",
"properties": {
"year": {
"type": "string",
"pattern": "^\\d{4}([-/]\\d{2,4})?$",
"description": "Accounting year label, e.g. 2026."
},
"account_number": {
"description": "Only postings on this ledger account.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"date_from": {
"description": "Posting date on or after this day (yyyy-mm-dd).",
"type": "string"
},
"date_to": {
"description": "Posting date on or before this day (yyyy-mm-dd).",
"type": "string"
},
"filter": {
"description": "Raw Reviso filter: predicates property$op:value joined by $and: / $or: (parentheses group), e.g. date$gte:2026-01-01$and:netAmount$gt:500. Operators $eq: $ne: $gt: $gte: $lt: $lte: $like: (contains; * wildcard) $in:[1,2]. Escape $ ( ) * , [ ] in values with a $ prefix. Only properties the collection marks filterable work (else HTTP 400).",
"type": "string",
"maxLength": 1000
},
"sort": {
"description": "Sort by properties, comma-separated; prefix - for descending, e.g. -date,name. Only sortable properties work.",
"type": "string",
"maxLength": 200
},
"page": {
"description": "Page index, 0-based (default 0). Use next_page from the previous reply.",
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"page_size": {
"description": "Results per page, 1-1000 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 1000
}
},
"required": [
"year"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reviso_list_projects(filter, sort, page, page_size)
List projects (needs the Projects module) with number, name, customer, dates and status. Paged: pass next_page as page. GET /project/projects.
Eingabe-Schema
{
"type": "object",
"properties": {
"filter": {
"description": "Raw Reviso filter: predicates property$op:value joined by $and: / $or: (parentheses group), e.g. date$gte:2026-01-01$and:netAmount$gt:500. Operators $eq: $ne: $gt: $gte: $lt: $lte: $like: (contains; * wildcard) $in:[1,2]. Escape $ ( ) * , [ ] in values with a $ prefix. Only properties the collection marks filterable work (else HTTP 400).",
"type": "string",
"maxLength": 1000
},
"sort": {
"description": "Sort by properties, comma-separated; prefix - for descending, e.g. -date,name. Only sortable properties work.",
"type": "string",
"maxLength": 200
},
"page": {
"description": "Page index, 0-based (default 0). Use next_page from the previous reply.",
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"page_size": {
"description": "Results per page, 1-1000 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 1000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢reviso_list_reference(resource, page, page_size)
List one lookup table: customer-groups, supplier-groups, product-groups, payment-terms, payment-types, vat-zones, vat-accounts, currencies, units, layouts (invoice layouts), departments, employees, employee-groups, price-groups or country-codes. The numbers in these rows are what the create tools and invoices reference (customerGroupNumber, paymentTermsNumber, vatZoneNumber, layoutNumber, ...). Paged: pass next_page as page. GET /{resource}.
Eingabe-Schema
{
"type": "object",
"properties": {
"resource": {
"type": "string",
"enum": [
"customer-groups",
"supplier-groups",
"product-groups",
"payment-terms",
"payment-types",
"vat-zones",
"vat-accounts",
"currencies",
"units",
"layouts",
"departments",
"employees",
"employee-groups",
"price-groups",
"country-codes"
],
"description": "Which lookup table to list."
},
"page": {
"description": "Page index, 0-based (default 0). Use next_page from the previous reply.",
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"page_size": {
"description": "Results per page, 1-1000 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 1000
}
},
"required": [
"resource"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴reviso_create_customer(name, currency, customer_group_number, payment_terms_number, vat_zone_number, ...)
Create a new customer in Reviso. Needs a name, currency and three reference numbers from reviso_list_reference (customer-groups, payment-terms, vat-zones). Not idempotent: calling it twice creates two customers, so search with reviso_list_customers first. Returns the new customer with its customerNumber. POST /customers.
Eingabe-Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Customer name."
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "ISO 4217 currency code, e.g. EUR, GBP, DKK (reviso_list_reference with resource currencies lists them)."
},
"customer_group_number": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Customer group number (reviso_list_reference, resource customer-groups)."
},
"payment_terms_number": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Payment terms number (reviso_list_reference, resource payment-terms)."
},
"vat_zone_number": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "VAT zone number (reviso_list_reference, resource vat-zones): domestic, EU or abroad."
},
"telephone": {
"description": "Telephone number.",
"type": "string",
"maxLength": 50
},
"website": {
"description": "Website.",
"type": "string",
"maxLength": 255
},
"address": {
"description": "Street and number.",
"type": "string",
"maxLength": 255
},
"zip": {
"description": "Postal code.",
"type": "string",
"maxLength": 20
},
"city": {
"description": "City.",
"type": "string",
"maxLength": 50
},
"country": {
"description": "Country name.",
"type": "string",
"maxLength": 50
},
"email": {
"description": "Email address (invoices are emailed here).",
"type": "string",
"maxLength": 255
},
"vat_number": {
"description": "VAT number.",
"type": "string",
"maxLength": 40
},
"corporate_id": {
"description": "Company identification number.",
"type": "string",
"maxLength": 40
}
},
"required": [
"name",
"currency",
"customer_group_number",
"payment_terms_number",
"vat_zone_number"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴reviso_create_supplier(name, currency, supplier_group_number, payment_terms_number, vat_zone_number, ...)
Create a new supplier in Reviso. Needs a name, currency and three reference numbers from reviso_list_reference (supplier-groups, payment-terms, vat-zones). Not idempotent: calling it twice creates two suppliers, so search with reviso_list_suppliers first. Returns the new supplier with its supplierNumber. POST /suppliers.
Eingabe-Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Supplier name."
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "ISO 4217 currency code, e.g. EUR, GBP, DKK (reviso_list_reference with resource currencies lists them)."
},
"supplier_group_number": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Supplier group number (reviso_list_reference, resource supplier-groups)."
},
"payment_terms_number": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Payment terms number (reviso_list_reference, resource payment-terms)."
},
"vat_zone_number": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "VAT zone number (reviso_list_reference, resource vat-zones)."
},
"phone": {
"description": "Telephone number.",
"type": "string",
"maxLength": 50
},
"bank_account": {
"description": "Bank account (IBAN or local number).",
"type": "string",
"maxLength": 50
},
"address": {
"description": "Street and number.",
"type": "string",
"maxLength": 255
},
"zip": {
"description": "Postal code.",
"type": "string",
"maxLength": 20
},
"city": {
"description": "City.",
"type": "string",
"maxLength": 50
},
"country": {
"description": "Country name.",
"type": "string",
"maxLength": 50
},
"email": {
"description": "Email address (invoices are emailed here).",
"type": "string",
"maxLength": 255
},
"vat_number": {
"description": "VAT number.",
"type": "string",
"maxLength": 40
},
"corporate_id": {
"description": "Company identification number.",
"type": "string",
"maxLength": 40
}
},
"required": [
"name",
"currency",
"supplier_group_number",
"payment_terms_number",
"vat_zone_number"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴reviso_create_product(product_number, name, product_group_number, sales_price, cost_price, ...)
Create a new product or service in Reviso. Needs a product number (your own code, unique), a name and a product group number (reviso_list_reference, resource product-groups). Not idempotent in effect: an existing product number is rejected by Reviso. Returns the new product. POST /products.
Eingabe-Schema
{
"type": "object",
"properties": {
"product_number": {
"type": "string",
"minLength": 1,
"maxLength": 25,
"description": "Your product code (unique, e.g. SKU-100)."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 300,
"description": "Product name."
},
"product_group_number": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Product group number (reviso_list_reference, resource product-groups)."
},
"sales_price": {
"description": "Net sales price per unit in the base currency.",
"type": "number",
"minimum": 0,
"maximum": 1000000000000
},
"cost_price": {
"description": "Cost price per unit (ignored when the inventory module is on).",
"type": "number",
"minimum": 0,
"maximum": 1000000000000
},
"unit_number": {
"description": "Unit number (reviso_list_reference, resource units), e.g. each, hour.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"description": {
"description": "Free-text description.",
"type": "string",
"maxLength": 500
},
"barcode": {
"description": "Barcode.",
"type": "string",
"maxLength": 50
}
},
"required": [
"product_number",
"name",
"product_group_number"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴reviso_create_draft_invoice(customer_number, date, due_date, currency, layout_number, ...)
Create a DRAFT sales invoice for an existing customer. It is not booked and not sent: the user reviews, books and sends it in Reviso. Currency, invoice layout, payment terms and the recipient address are copied from the customer (override with the optional fields). Each line names a product_number and a quantity; the product's unit and sales price apply unless unit_net_price is given. Not idempotent: calling it twice creates two drafts. Returns the new draft with its draft number. Makes up to 3 requests. POST /v2/invoices/drafts.
Eingabe-Schema
{
"type": "object",
"properties": {
"customer_number": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The customer number (reviso_list_customers)."
},
"date": {
"type": "string",
"description": "Invoice date, yyyy-mm-dd."
},
"due_date": {
"description": "Due date, yyyy-mm-dd; only used by payment terms of type due date, otherwise Reviso computes it.",
"type": "string"
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "ISO 4217 currency code, e.g. EUR, GBP, DKK (reviso_list_reference with resource currencies lists them)."
},
"layout_number": {
"description": "Invoice layout number (reviso_list_reference, resource layouts); default: the customer's, else the agreement's default layout.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"payment_terms_number": {
"description": "Payment terms number (reviso_list_reference, resource payment-terms); default: the customer's.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"heading": {
"description": "Heading printed on the invoice.",
"type": "string",
"maxLength": 250
},
"text": {
"description": "Text printed above the lines.",
"type": "string",
"maxLength": 2000
},
"lines": {
"minItems": 1,
"maxItems": 200,
"type": "array",
"items": {
"type": "object",
"properties": {
"product_number": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Product number (reviso_list_products). Its unit and sales price are used unless you override the price."
},
"quantity": {
"type": "number",
"minimum": -1000000000,
"maximum": 1000000000,
"description": "Quantity (negative for a credit line)."
},
"unit_net_price": {
"description": "Net unit price in the invoice currency; omit to use the product's sales price.",
"type": "number",
"minimum": -1000000000000,
"maximum": 1000000000000
},
"discount_percentage": {
"description": "Line discount in percent.",
"type": "number",
"minimum": 0,
"maximum": 100
},
"description": {
"description": "Line text; omit to use the product's name.",
"type": "string",
"maxLength": 2000
}
},
"required": [
"product_number",
"quantity"
]
},
"description": "1-200 invoice lines."
}
},
"required": [
"customer_number",
"date",
"lines"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis