Megaventory MCP by usefulapi
Read Megaventory products, stock, orders and partners; create clients, sales and purchase orders.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (11)
- HIGH
- MEDIUMin megaventory_get_stock
- LOWin megaventory_list_product_categories
- LOWin megaventory_list_product_bundles
- LOWin megaventory_list_inventory_locations
- LOWin megaventory_list_clients_suppliers
- LOWin megaventory_list_product_suppliers
- LOWin megaventory_list_purchase_orders
- LOWin megaventory_list_document_types
- LOWin megaventory_create_client_or_supplier
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": {
"megaventory": {
"url": "https://megaventory.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://megaventory.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (20)
🟢megaventory_get_current_user
The Megaventory user this API key belongs to (user name and whether they are an administrator). The key itself and the mobile PIN are never returned. POST /User/UserGet.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢megaventory_list_products(product_id, sku, search, category_id, main_supplier_id, ...)
Search the product catalog: SKU, description, category, prices (selling, purchase, unit cost), dimensions, main supplier, sellable/purchasable flags and more. Filter by id, exact SKU, category, main supplier or words in the description. Empty text fields are omitted. POST /Product/ProductGet.
Eingabe-Schema
{
"type": "object",
"properties": {
"product_id": {
"description": "Only the product with this id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"sku": {
"description": "Only the product with exactly this SKU.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"search": {
"description": "Products whose description contains this text.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"category_id": {
"description": "Only products in this category (see megaventory_list_product_categories).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"main_supplier_id": {
"description": "Only products whose main supplier has this id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"show_deleted": {
"description": "Whether to include deleted records (default: only undeleted).",
"type": "string",
"enum": [
"showOnlyUndeleted",
"showOnlyDeleted",
"showAllDeletedAndUndeleted"
]
},
"filters": {
"description": "Extra filters, all combined with AND. Field names are the property names shown in the results (case-insensitive).",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,79}$",
"description": "A field of the record, for example SalesOrderClientID or ProductSellingPrice."
},
"operator": {
"type": "string",
"enum": [
"Equals",
"NotEquals",
"BeginsWith",
"EndsWith",
"Contains",
"GreaterThan",
"LessThan"
]
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"required": [
"field",
"operator",
"value"
]
}
},
"limit": {
"description": "How many records to return, 1-100 (default 25). Megaventory returns the newest records first (highest id) and has no page offset: narrow with filters instead of paging.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢megaventory_list_product_categories(search, show_deleted, filters, limit)
List product categories (id, name, description). Use the ids to filter products. POST /ProductCategory/ProductCategoryGet.
Eingabe-Schema
{
"type": "object",
"properties": {
"search": {
"description": "Categories whose name contains this text.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"show_deleted": {
"description": "Whether to include deleted records (default: only undeleted).",
"type": "string",
"enum": [
"showOnlyUndeleted",
"showOnlyDeleted",
"showAllDeletedAndUndeleted"
]
},
"filters": {
"description": "Extra filters, all combined with AND. Field names are the property names shown in the results (case-insensitive).",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,79}$",
"description": "A field of the record, for example SalesOrderClientID or ProductSellingPrice."
},
"operator": {
"type": "string",
"enum": [
"Equals",
"NotEquals",
"BeginsWith",
"EndsWith",
"Contains",
"GreaterThan",
"LessThan"
]
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"required": [
"field",
"operator",
"value"
]
}
},
"limit": {
"description": "How many records to return, 1-100 (default 25). Megaventory returns the newest records first (highest id) and has no page offset: narrow with filters instead of paging.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢megaventory_get_product_bom(sku, category_id, include_referenced_objects, limit)
The bill of materials (BOM) of a manufactured product: its raw materials (id, SKU, description, quantity per unit). POST /ProductBOM/ProductBOMGet.
Eingabe-Schema
{
"type": "object",
"properties": {
"sku": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "SKU of the finished product."
},
"category_id": {
"description": "Restrict to products in this category.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"include_referenced_objects": {
"description": "Also return the referenced product objects.",
"type": "boolean"
},
"limit": {
"description": "How many records to return, 1-100 (default 25). Megaventory returns the newest records first (highest id) and has no page offset: narrow with filters instead of paging.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"sku"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢megaventory_list_product_bundles(bundle_ids, bundle_skus, included_product_ids, included_product_skus, show_deleted)
List product bundles (a bundle sells several products together). Filter by bundle id or SKU, or by a product the bundle includes. POST /Product/ProductBundleGetAll.
Eingabe-Schema
{
"type": "object",
"properties": {
"bundle_ids": {
"description": "Only these bundle product ids.",
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"bundle_skus": {
"description": "Only these bundle SKUs.",
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"included_product_ids": {
"description": "Bundles that include any of these product ids.",
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"included_product_skus": {
"description": "Bundles that include any of these product SKUs.",
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"show_deleted": {
"description": "Whether to include deleted records (default: only undeleted).",
"type": "string",
"enum": [
"showOnlyUndeleted",
"showOnlyDeleted",
"showAllDeletedAndUndeleted"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢megaventory_get_stock(product_ids, sku, category_ids, location_ids, main_supplier_ids, ...)
Stock per product per inventory location: physical stock, on hand, on hold, not yet shipped (open sales orders), not yet received (open purchase orders / work orders) and the alert level. Filter by product ids, SKU, category, location or supplier, or show only products below their alert level. POST /InventoryLocationStock/InventoryLocationStockGet.
Eingabe-Schema
{
"type": "object",
"properties": {
"product_ids": {
"description": "Only these product ids.",
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"sku": {
"description": "Only the product with exactly this SKU.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"category_ids": {
"description": "Only products in these categories.",
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"location_ids": {
"description": "Only these inventory locations (see megaventory_list_inventory_locations).",
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"main_supplier_ids": {
"description": "Only products whose main supplier is one of these ids.",
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"search": {
"description": "Products whose description contains this text.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"only_positive_quantity": {
"description": "Only products with a positive quantity.",
"type": "boolean"
},
"only_needing_reorder": {
"description": "Only products that need to be ordered (at or below their alert level).",
"type": "boolean"
},
"include_product_details": {
"description": "Also return the product objects.",
"type": "boolean"
},
"filters": {
"description": "Extra filters, all combined with AND. Field names are the property names shown in the results (case-insensitive).",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,79}$",
"description": "A field of the record, for example SalesOrderClientID or ProductSellingPrice."
},
"operator": {
"type": "string",
"enum": [
"Equals",
"NotEquals",
"BeginsWith",
"EndsWith",
"Contains",
"GreaterThan",
"LessThan"
]
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"required": [
"field",
"operator",
"value"
]
}
},
"limit": {
"description": "How many records to return, 1-100 (default 25). Megaventory returns the newest records first (highest id) and has no page offset: narrow with filters instead of paging.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢megaventory_list_inventory_locations(include_transit, show_deleted, filters, limit)
List inventory locations (warehouses, shops, transit): id, abbreviation, name, address. Use the ids for stock filters and order locations. POST /InventoryLocation/InventoryLocationGet.
Eingabe-Schema
{
"type": "object",
"properties": {
"include_transit": {
"description": "Also include transit locations.",
"type": "boolean"
},
"show_deleted": {
"description": "Whether to include deleted records (default: only undeleted).",
"type": "string",
"enum": [
"showOnlyUndeleted",
"showOnlyDeleted",
"showAllDeletedAndUndeleted"
]
},
"filters": {
"description": "Extra filters, all combined with AND. Field names are the property names shown in the results (case-insensitive).",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,79}$",
"description": "A field of the record, for example SalesOrderClientID or ProductSellingPrice."
},
"operator": {
"type": "string",
"enum": [
"Equals",
"NotEquals",
"BeginsWith",
"EndsWith",
"Contains",
"GreaterThan",
"LessThan"
]
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"required": [
"field",
"operator",
"value"
]
}
},
"limit": {
"description": "How many records to return, 1-100 (default 25). Megaventory returns the newest records first (highest id) and has no page offset: narrow with filters instead of paging.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢megaventory_list_clients_suppliers(type, search, show_deleted, filters, limit)
List clients and suppliers (one record type in Megaventory): id, type, name, addresses, phone, email, tax id, currency, payment terms and contacts. Filter by type or words in the name. POST /SupplierClient/SupplierClientGet.
Eingabe-Schema
{
"type": "object",
"properties": {
"type": {
"description": "Only clients, only suppliers, or records that are both.",
"type": "string",
"enum": [
"Client",
"Supplier",
"Both"
]
},
"search": {
"description": "Records whose name contains this text.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"show_deleted": {
"description": "Whether to include deleted records (default: only undeleted).",
"type": "string",
"enum": [
"showOnlyUndeleted",
"showOnlyDeleted",
"showAllDeletedAndUndeleted"
]
},
"filters": {
"description": "Extra filters, all combined with AND. Field names are the property names shown in the results (case-insensitive).",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,79}$",
"description": "A field of the record, for example SalesOrderClientID or ProductSellingPrice."
},
"operator": {
"type": "string",
"enum": [
"Equals",
"NotEquals",
"BeginsWith",
"EndsWith",
"Contains",
"GreaterThan",
"LessThan"
]
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"required": [
"field",
"operator",
"value"
]
}
},
"limit": {
"description": "How many records to return, 1-100 (default 25). Megaventory returns the newest records first (highest id) and has no page offset: narrow with filters instead of paging.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢megaventory_list_product_suppliers(include_referenced_objects, filters, limit)
Which suppliers sell which products: supplier SKU, description and purchase price per product-supplier pair. POST /ProductSupplier/ProductSupplierGet.
Eingabe-Schema
{
"type": "object",
"properties": {
"include_referenced_objects": {
"description": "Also return the product and supplier objects.",
"type": "boolean"
},
"filters": {
"description": "Extra filters, all combined with AND. Field names are the property names shown in the results (case-insensitive).",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,79}$",
"description": "A field of the record, for example SalesOrderClientID or ProductSellingPrice."
},
"operator": {
"type": "string",
"enum": [
"Equals",
"NotEquals",
"BeginsWith",
"EndsWith",
"Contains",
"GreaterThan",
"LessThan"
]
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"required": [
"field",
"operator",
"value"
]
}
},
"limit": {
"description": "How many records to return, 1-100 (default 25). Megaventory returns the newest records first (highest id) and has no page offset: narrow with filters instead of paging.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢megaventory_list_sales_orders(order_no, status, client_id, filters, limit)
List sales orders with client, dates, totals (subtotal, tax, discount, grand total), status and the order rows (SKU, quantity, shipped/invoiced quantity, unit price). Filter by order number or status. POST /SalesOrder/SalesOrderGet.
Eingabe-Schema
{
"type": "object",
"properties": {
"order_no": {
"description": "Only the sales order with this number.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"status": {
"description": "Only orders in this status (ValidStatus = every non-cancelled order).",
"type": "string",
"enum": [
"ValidStatus",
"Pending",
"Verified",
"PartiallyShipped",
"PartiallyShippedAndPartiallyInvoiced",
"FullyShipped",
"PartiallyInvoiced",
"FullyInvoiced",
"Closed",
"Cancelled"
]
},
"client_id": {
"description": "Only orders of this client.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"filters": {
"description": "Extra filters, all combined with AND. Field names are the property names shown in the results (case-insensitive).",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,79}$",
"description": "A field of the record, for example SalesOrderClientID or ProductSellingPrice."
},
"operator": {
"type": "string",
"enum": [
"Equals",
"NotEquals",
"BeginsWith",
"EndsWith",
"Contains",
"GreaterThan",
"LessThan"
]
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"required": [
"field",
"operator",
"value"
]
}
},
"limit": {
"description": "How many records to return, 1-100 (default 25). Megaventory returns the newest records first (highest id) and has no page offset: narrow with filters instead of paging.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢megaventory_list_purchase_orders(order_no, status, supplier_id, filters, limit)
List purchase orders with supplier, dates, totals, status and the order rows (SKU, quantity, received/invoiced quantity, unit price). Filter by order number, status or supplier. POST /PurchaseOrder/PurchaseOrderGet.
Eingabe-Schema
{
"type": "object",
"properties": {
"order_no": {
"description": "Only the purchase order with this number.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"status": {
"description": "Only orders in this status (ValidStatus = every non-cancelled order).",
"type": "string",
"enum": [
"ValidStatus",
"Pending",
"Verified",
"PartiallyReceived",
"PartiallyReceivedAndPartiallyInvoiced",
"FullyReceived",
"PartiallyInvoiced",
"FullyInvoiced",
"Closed",
"Cancelled"
]
},
"supplier_id": {
"description": "Only orders to this supplier.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"filters": {
"description": "Extra filters, all combined with AND. Field names are the property names shown in the results (case-insensitive).",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,79}$",
"description": "A field of the record, for example SalesOrderClientID or ProductSellingPrice."
},
"operator": {
"type": "string",
"enum": [
"Equals",
"NotEquals",
"BeginsWith",
"EndsWith",
"Contains",
"GreaterThan",
"LessThan"
]
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"required": [
"field",
"operator",
"value"
]
}
},
"limit": {
"description": "How many records to return, 1-100 (default 25). Megaventory returns the newest records first (highest id) and has no page offset: narrow with filters instead of paging.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢megaventory_list_sales_quotes(quote_no, status, filters, limit)
List sales quotes with client, totals, status and rows. Filter by quote number or status. POST /SalesQuote/SalesQuoteGet.
Eingabe-Schema
{
"type": "object",
"properties": {
"quote_no": {
"description": "Only the quote with this number.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"status": {
"description": "Only quotes in this status.",
"type": "string",
"enum": [
"ValidStatus",
"Pending",
"Verified",
"Closed",
"Cancelled"
]
},
"filters": {
"description": "Extra filters, all combined with AND. Field names are the property names shown in the results (case-insensitive).",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,79}$",
"description": "A field of the record, for example SalesOrderClientID or ProductSellingPrice."
},
"operator": {
"type": "string",
"enum": [
"Equals",
"NotEquals",
"BeginsWith",
"EndsWith",
"Contains",
"GreaterThan",
"LessThan"
]
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"required": [
"field",
"operator",
"value"
]
}
},
"limit": {
"description": "How many records to return, 1-100 (default 25). Megaventory returns the newest records first (highest id) and has no page offset: narrow with filters instead of paging.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢megaventory_list_work_orders(work_order_no, status, filters, limit)
List work (production) orders: finished product, quantity, location, status, priority and the materials allocated. Filter by work order number or status. POST /WorkOrder/WorkOrderGet.
Eingabe-Schema
{
"type": "object",
"properties": {
"work_order_no": {
"description": "Only the work order with this number.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"status": {
"description": "Only work orders in this status.",
"type": "string",
"enum": [
"Pending",
"InProcess",
"InProcessPartiallyCompleted",
"Completed",
"Closed",
"Cancelled"
]
},
"filters": {
"description": "Extra filters, all combined with AND. Field names are the property names shown in the results (case-insensitive).",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,79}$",
"description": "A field of the record, for example SalesOrderClientID or ProductSellingPrice."
},
"operator": {
"type": "string",
"enum": [
"Equals",
"NotEquals",
"BeginsWith",
"EndsWith",
"Contains",
"GreaterThan",
"LessThan"
]
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"required": [
"field",
"operator",
"value"
]
}
},
"limit": {
"description": "How many records to return, 1-100 (default 25). Megaventory returns the newest records first (highest id) and has no page offset: narrow with filters instead of paging.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢megaventory_list_documents(document_type_ids, document_no, status, filters, limit)
List transaction documents of any type: shipments, invoices, receipts, credit notes, returns, adjustments and so on, with totals and status. Narrow by document type ids (megaventory_list_document_types), document number or status. POST /Document/DocumentGet.
Eingabe-Schema
{
"type": "object",
"properties": {
"document_type_ids": {
"description": "Only documents of these type ids (built-in types have negative ids).",
"maxItems": 50,
"type": "array",
"items": {
"type": "integer",
"minimum": -1000000,
"maximum": 9007199254740991
}
},
"document_no": {
"description": "Only the document with this number.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"status": {
"description": "Only documents in this status.",
"type": "string",
"enum": [
"ValidStatus",
"Pending",
"ApprovalInProcess",
"Verified",
"PartiallyShipped",
"PartiallyShippedInvoiced",
"FullyShipped",
"PartiallyReceived",
"PartiallyReceivedInvoiced",
"FullyReceived",
"PartiallyInvoiced",
"FullyInvoiced",
"Closed",
"ClosedWO",
"Cancelled"
]
},
"filters": {
"description": "Extra filters, all combined with AND. Field names are the property names shown in the results (case-insensitive).",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,79}$",
"description": "A field of the record, for example SalesOrderClientID or ProductSellingPrice."
},
"operator": {
"type": "string",
"enum": [
"Equals",
"NotEquals",
"BeginsWith",
"EndsWith",
"Contains",
"GreaterThan",
"LessThan"
]
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"required": [
"field",
"operator",
"value"
]
}
},
"limit": {
"description": "How many records to return, 1-100 (default 25). Megaventory returns the newest records first (highest id) and has no page offset: narrow with filters instead of paging.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢megaventory_list_document_types(show_deleted, filters, limit)
List the document types of the account (sales order, purchase order, shipment, invoice and so on) with their ids and abbreviations. POST /DocumentType/DocumentTypeGet.
Eingabe-Schema
{
"type": "object",
"properties": {
"show_deleted": {
"description": "Whether to include deleted records (default: only undeleted).",
"type": "string",
"enum": [
"showOnlyUndeleted",
"showOnlyDeleted",
"showAllDeletedAndUndeleted"
]
},
"filters": {
"description": "Extra filters, all combined with AND. Field names are the property names shown in the results (case-insensitive).",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,79}$",
"description": "A field of the record, for example SalesOrderClientID or ProductSellingPrice."
},
"operator": {
"type": "string",
"enum": [
"Equals",
"NotEquals",
"BeginsWith",
"EndsWith",
"Contains",
"GreaterThan",
"LessThan"
]
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"required": [
"field",
"operator",
"value"
]
}
},
"limit": {
"description": "How many records to return, 1-100 (default 25). Megaventory returns the newest records first (highest id) and has no page offset: narrow with filters instead of paging.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢megaventory_list_taxes(show_deleted, filters, limit)
List the tax rates defined in the account (id, name, rate). POST /Tax/TaxGet.
Eingabe-Schema
{
"type": "object",
"properties": {
"show_deleted": {
"description": "Whether to include deleted records (default: only undeleted).",
"type": "string",
"enum": [
"showOnlyUndeleted",
"showOnlyDeleted",
"showAllDeletedAndUndeleted"
]
},
"filters": {
"description": "Extra filters, all combined with AND. Field names are the property names shown in the results (case-insensitive).",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,79}$",
"description": "A field of the record, for example SalesOrderClientID or ProductSellingPrice."
},
"operator": {
"type": "string",
"enum": [
"Equals",
"NotEquals",
"BeginsWith",
"EndsWith",
"Contains",
"GreaterThan",
"LessThan"
]
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"required": [
"field",
"operator",
"value"
]
}
},
"limit": {
"description": "How many records to return, 1-100 (default 25). Megaventory returns the newest records first (highest id) and has no page offset: narrow with filters instead of paging.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢megaventory_list_currencies(filters, limit)
List the currencies of the account (code, description, exchange rate to the default currency, default flag). POST /Currency/CurrencyGet.
Eingabe-Schema
{
"type": "object",
"properties": {
"filters": {
"description": "Extra filters, all combined with AND. Field names are the property names shown in the results (case-insensitive).",
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,79}$",
"description": "A field of the record, for example SalesOrderClientID or ProductSellingPrice."
},
"operator": {
"type": "string",
"enum": [
"Equals",
"NotEquals",
"BeginsWith",
"EndsWith",
"Contains",
"GreaterThan",
"LessThan"
]
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"required": [
"field",
"operator",
"value"
]
}
},
"limit": {
"description": "How many records to return, 1-100 (default 25). Megaventory returns the newest records first (highest id) and has no page offset: narrow with filters instead of paging.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴megaventory_create_client_or_supplier(type, name, email, phone, billing_address, ...)
WRITE: create a NEW client, supplier or both in Megaventory (Insert only: an existing record is never updated, nothing is deleted). Creating the same name twice creates two records, so search with megaventory_list_clients_suppliers first. POST /SupplierClient/SupplierClientUpdate.
Eingabe-Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"Client",
"Supplier",
"Both"
],
"description": "Whether the record is a client, a supplier or both."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Company or person name."
},
"email": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"phone": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"billing_address": {
"description": "Billing address, free text.",
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"shipping_address": {
"description": "Shipping address, free text.",
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"tax_id": {
"description": "Tax / VAT id.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"comments": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"contact_name": {
"description": "Optionally add one contact person.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"contact_email": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"contact_phone": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"type",
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴megaventory_create_sales_order(client_id, rows, location_id, reference_no, comments, ...)
WRITE: create a NEW sales order for an existing client in the PENDING status. A pending order is only a draft document: it is not verified, nothing is shipped, invoiced or paid, and stock is not touched. Verifying, shipping and invoicing happen in Megaventory, not through this server. POST /SalesOrder/SalesOrderUpdate.
Eingabe-Schema
{
"type": "object",
"properties": {
"client_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Client id (megaventory_list_clients_suppliers)."
},
"rows": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"sku": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "SKU of an existing product (megaventory_list_products)."
},
"quantity": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000000
},
"unit_price": {
"description": "Unit price before tax and discount; omitted = the product's default price.",
"type": "number",
"minimum": 0,
"maximum": 1000000000
}
},
"required": [
"sku",
"quantity"
]
},
"description": "The order rows."
},
"location_id": {
"description": "Inventory location the order is served from (megaventory_list_inventory_locations).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"reference_no": {
"description": "Your own reference number.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"comments": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"type_id": {
"description": "Document type id of the sales order (default 3, the standard Sales Order type; see megaventory_list_document_types).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"client_id",
"rows"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴megaventory_create_purchase_order(supplier_id, rows, location_id, reference_no, comments, ...)
WRITE: create a NEW purchase order to an existing supplier in the PENDING status. A pending order is only a draft document: it is not verified or sent, nothing is received, invoiced or paid, and stock is not touched. Verifying and receiving happen in Megaventory, not through this server. POST /PurchaseOrder/PurchaseOrderUpdate.
Eingabe-Schema
{
"type": "object",
"properties": {
"supplier_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Supplier id (megaventory_list_clients_suppliers)."
},
"rows": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"sku": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "SKU of an existing product (megaventory_list_products)."
},
"quantity": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000000
},
"unit_price": {
"description": "Unit price before tax and discount; omitted = the product's default price.",
"type": "number",
"minimum": 0,
"maximum": 1000000000
}
},
"required": [
"sku",
"quantity"
]
},
"description": "The order rows."
},
"location_id": {
"description": "Inventory location the goods are received into (megaventory_list_inventory_locations).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"reference_no": {
"description": "Your own reference number.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"comments": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"type_id": {
"description": "Document type id of the purchase order (default 4, the standard Purchase Order type; see megaventory_list_document_types).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"supplier_id",
"rows"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis