Megaventory MCP by usefulapi
Read Megaventory products, stock, orders and partners; create clients, sales and purchase orders.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (11)
- HIGH
- MEDIUMen megaventory_get_stock
- LOWen megaventory_list_product_categories
- LOWen megaventory_list_product_bundles
- LOWen megaventory_list_inventory_locations
- LOWen megaventory_list_clients_suppliers
- LOWen megaventory_list_product_suppliers
- LOWen megaventory_list_purchase_orders
- LOWen megaventory_list_document_types
- LOWen megaventory_create_client_or_supplier
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"megaventory": {
"url": "https://megaventory.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://megaventory.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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"
}Comunidad
Evidencia