Dotypos MCP by usefulapi

WRITE: create a customer record. At least one of first_name, last_name or company_name is required. Creates a new record every time (not idempotent). POST /clouds/{cloud}/customers.

One branch by id. GET /clouds/{cloud}/branches/{id}.

One product category by id. GET /clouds/{cloud}/categories/{id}.

One customer by id. Contains personal data. GET /clouds/{cloud}/customers/{id}.

One order / receipt by id: status, totals, document number, customer, employee, table, notes, tags. GET /clouds/{cloud}/orders/{id}.

One product by id with all its fields (prices, VAT, codes, allergens, packaging, notes). GET /clouds/{cloud}/products/{id}.

The base sales report of one branch for a time range of at most 26 hours (one business day; Dotypos limits a report to 26 hours, so ask for one day at a time): sales and cancel counts and values, revenue with VAT and payment-type breakdown, discounts, cash in/out, sales by category, product, tag, employee and customer, tips and write-offs. For longer periods use dotypos_list_order_items with a time range. GET /clouds/{cloud}/branches/{id}/sales-report.

List the branches (shops / points of sale) of the connected Dotypos cloud. Use the ids to filter orders, reservations and reports. GET /clouds/{cloud}/branches.

List product categories (name, VAT, colour, sort order). GET /clouds/{cloud}/categories.

List or search customers (name, company, email, phone, address, points, tags). All given filters must match. Contains personal data. GET /clouds/{cloud}/customers.

List imported supplier delivery notes: document number, supplier, branch, dates, status, download URL. GET /clouds/{cloud}/delivery-notes.

List employees (name, e-mail, phone, enabled flag, access levels). Login barcodes and PINs are never returned. GET /clouds/{cloud}/employees.

List sold line items: product, name, quantity, unit prices before and after discount, VAT, category, employee, order. Give order_id for one order's lines, or a time range for sales analysis. GET /clouds/{cloud}/order-items.

List orders and receipts (documents): number, type, status, totals, customer, employee, table, branch, paid flag, created/completed dates. Filter by time, status, type, branch, customer, employee or paid state; newest first by default. Line items are in dotypos_list_order_items. GET /clouds/{cloud}/orders.

List or search the product catalog: name, prices with and without VAT, VAT, category, EAN/PLU codes, unit, tags, stock-deduction setting. Filter by name text, category, EAN or PLU code, tag or visibility. GET /clouds/{cloud}/products.

List table reservations: customer, table, branch, start and end time, seats, status, note. Filter by start time window, branch or customer; each reservation carries its status (NEW, CONFIRMED, CANCELLED). GET /clouds/{cloud}/reservations.

Stock status of the products in one warehouse: each product with its quantity on hand (stockQuantityStatus), last stock change and purchase price. Filter by name or by maximum quantity to find low stock. GET /clouds/{cloud}/warehouses/{id}/products.

List suppliers (name, company ids, contact and address). GET /clouds/{cloud}/suppliers.

List restaurant tables: name, location, seats, branch, enabled flag. GET /clouds/{cloud}/tables.

List tags used on products, customers and orders. GET /clouds/{cloud}/tags.

List warehouses (stock locations). Use the ids with dotypos_list_stock. GET /clouds/{cloud}/warehouses.

WRITE: change fields of one customer; only the fields you pass are changed. The record is read first and updated with its ETag, so a concurrent change makes the update fail instead of overwriting it. PATCH /clouds/{cloud}/customers/{id}.

WRITE: change the name, net price, description or visibility of one product; only the fields you pass are changed. The price with VAT is derived by Dotypos from the net price and the product's VAT. The record is read first and updated with its ETag, so a concurrent change makes the update fail. PATCH /clouds/{cloud}/products/{id}.