Megaventory MCP by usefulapi
Read Megaventory products, stock, orders and partners; create clients, sales and purchase orders.
사용해야 할까요
품질 및 안전성
발견 사항 (11)
- HIGH
- MEDIUMmegaventory_get_stock에서
- LOWmegaventory_list_product_categories에서
- LOWmegaventory_list_product_bundles에서
- LOWmegaventory_list_inventory_locations에서
- LOWmegaventory_list_clients_suppliers에서
- LOWmegaventory_list_product_suppliers에서
- LOWmegaventory_list_purchase_orders에서
- LOWmegaventory_list_document_types에서
- LOWmegaventory_create_client_or_supplier에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`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"
}커뮤니티
증거