Megaventory MCP by usefulapi
Read Megaventory products, stock, orders and partners; create clients, sales and purchase orders.
使うべきか
品質と安全性
B
検出事項（11）
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains suspicious base64-like encoded stringmegaventory_get_stock 内
- LOWTool 'megaventory_list_product_categories' name length outside 3-30 rangemegaventory_list_product_categories 内
- LOWTool 'megaventory_list_product_bundles' name length outside 3-30 rangemegaventory_list_product_bundles 内
- LOWTool 'megaventory_list_inventory_locations' name length outside 3-30 rangemegaventory_list_inventory_locations 内
- LOWTool 'megaventory_list_clients_suppliers' name length outside 3-30 rangemegaventory_list_clients_suppliers 内
- LOWTool 'megaventory_list_product_suppliers' name length outside 3-30 rangemegaventory_list_product_suppliers 内
- LOWTool 'megaventory_list_purchase_orders' name length outside 3-30 rangemegaventory_list_purchase_orders 内
- LOWTool 'megaventory_list_document_types' name length outside 3-30 rangemegaventory_list_document_types 内
- LOWTool 'megaventory_create_client_or_supplier' name length outside 3-30 rangemegaventory_create_client_or_supplier 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~7,793トークン数（ツール定義）
~3.6 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 6.09%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"megaventory": {
"url": "https://megaventory.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://megaventory.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール（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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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"
}コミュニティ
エビデンス
最近の観測
検証済みバージョンは記録されていませんツール 20 件