> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spojit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MarketMan

> Restaurant inventory management: orders, inventory, menu items, vendors, and reports.

The MarketMan connector lets your workflows interact with the MarketMan restaurant inventory management platform. Manage inventory, place orders, track waste, view reports, and more.

<Note>
  For the full API reference, see the [MarketMan API documentation](https://api-doc.marketman.com/).
</Note>

<Snippet file="connection-note.mdx" />

## Connection setup

<Steps>
  <Step title="Get API credentials from MarketMan">
    Contact MarketMan or your account manager to obtain your **API Partner Key** and **API Partner Password**.
  </Step>

  <Step title="Find your Buyer/Vendor GUIDs">
    Use the **get-authorised-accounts** tool (or the MarketMan API) to retrieve the GUIDs for the buyers and vendors you want to manage.
  </Step>

  <Step title="Add the connection in Spojit">
    Go to **Connections** in Spojit, click **Add Connection**, select **MarketMan**, and enter:

    * **API Key**: Your API partner key
    * **API Password**: Your API partner password
    * **Buyer GUID** (optional): Default buyer for buyer-side operations
    * **Vendor GUID** (optional): Default vendor for vendor-side operations
  </Step>
</Steps>

<Note>
  MarketMan's API has a limit of **500 calls per 24 hours** per API consumer. All dates use the format `yyyy/mm/dd hh:mm:ss`.
</Note>

## Tools

### Auth & Accounts

<AccordionGroup>
  <Accordion title="get-token: Get access token">
    Get a MarketMan access token. Mainly for debugging; authentication is handled automatically.

    No parameters required.

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "Token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
      "ErrorMessage": null,
      "ErrorCode": null
    }
    ```
  </Accordion>

  <Accordion title="get-authorised-accounts: List accessible accounts">
    List all buyer and vendor accounts accessible with your API credentials.

    No parameters required.

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "Buyers": [
        {
          "BuyerGuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "BuyerName": "Downtown Bistro",
          "ChainGuid": "00000000-0000-0000-0000-000000000000",
          "ChainName": null
        },
        {
          "BuyerGuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
          "BuyerName": "Airport Cafe",
          "ChainGuid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
          "ChainName": "City Restaurants Group"
        }
      ],
      "Vendors": [
        {
          "VendorGuid": "d4e5f6a7-b8c9-0123-defa-234567890123",
          "VendorName": "Fresh Produce Co."
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="get-chain-buyers: Get chain buyers">
    Get all buyers in a chain (for chain/HQ accounts).

    <ParamField body="buyerGuid" type="string">
      Buyer GUID. Uses the default from your connection if not provided.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "buyerGuid": "c3d4e5f6-a7b8-9012-cdef-123456789012"
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "Buyers": [
        {
          "BuyerGuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "BuyerName": "Downtown Bistro"
        },
        {
          "BuyerGuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
          "BuyerName": "Airport Cafe"
        }
      ]
    }
    ```
  </Accordion>
</AccordionGroup>

### Buyer: Inventory

<AccordionGroup>
  <Accordion title="get-inventory-items: Get inventory items">
    Get all inventory items for a buyer, including stock levels and details.

    <ParamField body="buyerGuid" type="string">
      Buyer GUID. Uses the default from your connection if not provided.
    </ParamField>

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "Items": [
        {
          "ItemGuid": "e5f6a7b8-c9d0-1234-efab-345678901234",
          "ItemName": "Whole Milk",
          "CategoryID": 1,
          "CategoryName": "Dairy",
          "QuantityOnHand": 24.0,
          "UnitOfMeasure": "Gallon",
          "StorageAreaName": "Walk-in Cooler",
          "LastPurchasePrice": 3.49,
          "AveragePrice": 3.52,
          "TotalValue": 84.48
        },
        {
          "ItemGuid": "f6a7b8c9-d012-3456-fabc-456789012345",
          "ItemName": "All-Purpose Flour",
          "CategoryID": 2,
          "CategoryName": "Dry Goods",
          "QuantityOnHand": 50.0,
          "UnitOfMeasure": "lb",
          "StorageAreaName": "Dry Storage",
          "LastPurchasePrice": 0.75,
          "AveragePrice": 0.72,
          "TotalValue": 36.00
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="get-items: Get all items">
    Get all items (ingredients, products) for a buyer.

    <ParamField body="buyerGuid" type="string">
      Buyer GUID.
    </ParamField>

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "Items": [
        {
          "ID": 10001,
          "Name": "Whole Milk",
          "CategoryID": 1,
          "CategoryName": "Dairy",
          "UnitOfMeasure": "Gallon",
          "MinOnHand": 10,
          "MaxOnHand": 50,
          "IsActive": true
        },
        {
          "ID": 10002,
          "Name": "Espresso Beans",
          "CategoryID": 3,
          "CategoryName": "Coffee",
          "UnitOfMeasure": "lb",
          "MinOnHand": 5,
          "MaxOnHand": 30,
          "IsActive": true
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="get-inventory-counts: Get inventory counts">
    Get inventory count records for a buyer.

    <ParamField body="buyerGuid" type="string">
      Buyer GUID.
    </ParamField>

    <ParamField body="dateTimeFromUTC" type="string">
      Start date (`yyyy/mm/dd hh:mm:ss`).
    </ParamField>

    <ParamField body="dateTimeToUTC" type="string">
      End date (`yyyy/mm/dd hh:mm:ss`).
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "dateTimeFromUTC": "2025/03/01 00:00:00",
      "dateTimeToUTC": "2025/03/31 23:59:59"
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "InventoryCounts": [
        {
          "CountID": 5001,
          "CountDateUTC": "2025/03/15 08:00:00",
          "CountType": "Full",
          "UserName": "John Doe",
          "Items": [
            {
              "ItemName": "Whole Milk",
              "CountQuantity": 22.0,
              "UnitOfMeasure": "Gallon",
              "StorageAreaName": "Walk-in Cooler"
            },
            {
              "ItemName": "All-Purpose Flour",
              "CountQuantity": 48.0,
              "UnitOfMeasure": "lb",
              "StorageAreaName": "Dry Storage"
            }
          ]
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="set-inventory-count: Create inventory count">
    Create a new inventory count.

    <ParamField body="buyerGuid" type="string">
      Buyer GUID.
    </ParamField>

    <ParamField body="countData" type="object" required>
      Inventory count data object.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "countData": {
        "CountDateUTC": "2025/04/01 08:00:00",
        "Items": [
          {
            "ItemID": 10001,
            "CountQuantity": 20.0,
            "StorageAreaID": 1
          },
          {
            "ItemID": 10002,
            "CountQuantity": 12.0,
            "StorageAreaID": 2
          }
        ]
      }
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "CountID": 5010
    }
    ```
  </Accordion>

  <Accordion title="get-menu-items: Get menu items">
    Get all menu items for a buyer.

    <ParamField body="buyerGuid" type="string">
      Buyer GUID.
    </ParamField>

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "MenuItems": [
        {
          "MenuItemID": 201,
          "MenuItemName": "Cappuccino",
          "MenuItemCategoryName": "Hot Drinks",
          "SalePrice": 4.50,
          "CostPrice": 1.20,
          "FoodCostPercentage": 26.67,
          "IsActive": true,
          "Ingredients": [
            { "ItemName": "Espresso Beans", "Quantity": 0.04, "UnitOfMeasure": "lb" },
            { "ItemName": "Whole Milk", "Quantity": 0.06, "UnitOfMeasure": "Gallon" }
          ]
        },
        {
          "MenuItemID": 202,
          "MenuItemName": "Caesar Salad",
          "MenuItemCategoryName": "Salads",
          "SalePrice": 12.00,
          "CostPrice": 3.85,
          "FoodCostPercentage": 32.08,
          "IsActive": true
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="get-waste-events: Get waste events">
    Get waste events for a buyer within a date range.

    <ParamField body="buyerGuid" type="string">
      Buyer GUID.
    </ParamField>

    <ParamField body="dateTimeFromUTC" type="string">
      Start date.
    </ParamField>

    <ParamField body="dateTimeToUTC" type="string">
      End date.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "dateTimeFromUTC": "2025/03/01 00:00:00",
      "dateTimeToUTC": "2025/03/31 23:59:59"
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "WasteEvents": [
        {
          "WasteEventID": 301,
          "WasteDateUTC": "2025/03/10 14:30:00",
          "WasteReason": "Expired",
          "UserName": "Sarah Miller",
          "Items": [
            {
              "ItemName": "Whole Milk",
              "Quantity": 2.0,
              "UnitOfMeasure": "Gallon",
              "Cost": 6.98
            }
          ],
          "TotalCost": 6.98
        }
      ]
    }
    ```
  </Accordion>
</AccordionGroup>

### Buyer: Orders

<AccordionGroup>
  <Accordion title="get-orders-by-delivery-date: Get orders by delivery date">
    Get all orders within a delivery date range.

    <ParamField body="buyerGuid" type="string">
      Buyer GUID.
    </ParamField>

    <ParamField body="dateTimeFromUTC" type="string" required>
      Start date (`yyyy/mm/dd hh:mm:ss`).
    </ParamField>

    <ParamField body="dateTimeToUTC" type="string" required>
      End date.
    </ParamField>

    <ParamField body="orderStatus" type="string">
      Filter: `Approved`, `Sent`, or `Pending`.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "dateTimeFromUTC": "2025/04/01 00:00:00",
      "dateTimeToUTC": "2025/04/07 23:59:59",
      "orderStatus": "Sent"
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "Orders": [
        {
          "OrderGuid": "a1b2c3d4-0001-0000-0000-000000000001",
          "OrderNumber": "PO-2025-0401",
          "VendorName": "Fresh Produce Co.",
          "VendorGuid": "d4e5f6a7-b8c9-0123-defa-234567890123",
          "OrderStatus": "Sent",
          "SentDateUTC": "2025/03/30 10:00:00",
          "DeliveryDateUTC": "2025/04/02 06:00:00",
          "TotalPrice": 245.80,
          "Comment": "Please deliver before 7am",
          "Items": [
            {
              "CatalogItemCode": "FP-TOM-001",
              "ItemName": "Roma Tomatoes",
              "Quantity": 20,
              "UnitOfMeasure": "lb",
              "Price": 2.49,
              "TotalPrice": 49.80
            },
            {
              "CatalogItemCode": "FP-LET-001",
              "ItemName": "Romaine Lettuce",
              "Quantity": 10,
              "UnitOfMeasure": "head",
              "Price": 1.99,
              "TotalPrice": 19.90
            }
          ]
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="get-orders-by-sent-date: Get orders by sent date">
    Get all orders within a sent date range.

    <ParamField body="dateTimeFromUTC" type="string" required>
      Start date.
    </ParamField>

    <ParamField body="dateTimeToUTC" type="string" required>
      End date.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "dateTimeFromUTC": "2025/03/25 00:00:00",
      "dateTimeToUTC": "2025/03/31 23:59:59"
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "Orders": [
        {
          "OrderGuid": "a1b2c3d4-0001-0000-0000-000000000001",
          "OrderNumber": "PO-2025-0401",
          "VendorName": "Fresh Produce Co.",
          "OrderStatus": "Sent",
          "SentDateUTC": "2025/03/30 10:00:00",
          "DeliveryDateUTC": "2025/04/02 06:00:00",
          "TotalPrice": 245.80
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="get-catalog-items: Get vendor catalog items">
    Get all vendor catalog items available for ordering.

    <ParamField body="buyerGuid" type="string">
      Buyer GUID.
    </ParamField>

    <ParamField body="vendorGuid" type="string">
      Filter by specific vendor.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "vendorGuid": "d4e5f6a7-b8c9-0123-defa-234567890123"
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "CatalogItems": [
        {
          "CatalogItemCode": "FP-TOM-001",
          "CatalogItemName": "Roma Tomatoes",
          "VendorGuid": "d4e5f6a7-b8c9-0123-defa-234567890123",
          "VendorName": "Fresh Produce Co.",
          "Price": 2.49,
          "UnitOfMeasure": "lb",
          "MinOrderQuantity": 5,
          "IsActive": true
        },
        {
          "CatalogItemCode": "FP-LET-001",
          "CatalogItemName": "Romaine Lettuce",
          "VendorGuid": "d4e5f6a7-b8c9-0123-defa-234567890123",
          "VendorName": "Fresh Produce Co.",
          "Price": 1.99,
          "UnitOfMeasure": "head",
          "MinOrderQuantity": 1,
          "IsActive": true
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="create-order: Create order">
    Create a new purchase order and send it to a vendor.

    <ParamField body="vendorGuid" type="string" required>
      Vendor GUID to send the order to.
    </ParamField>

    <ParamField body="catalogItems" type="array" required>
      Array of `{ CatalogItemCode, Quantity }` objects.
    </ParamField>

    <ParamField body="orderStatus" type="string">
      Order status (e.g., `Sent`).
    </ParamField>

    <ParamField body="deliveryDateUTC" type="string">
      Delivery date.
    </ParamField>

    <ParamField body="comment" type="string">
      Order comment (up to 800 characters).
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "vendorGuid": "d4e5f6a7-b8c9-0123-defa-234567890123",
      "catalogItems": [
        { "CatalogItemCode": "FP-TOM-001", "Quantity": 20 },
        { "CatalogItemCode": "FP-LET-001", "Quantity": 10 }
      ],
      "orderStatus": "Sent",
      "deliveryDateUTC": "2025/04/05 06:00:00",
      "comment": "Please deliver before 7am"
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "OrderGuid": "b2c3d4e5-0002-0000-0000-000000000002",
      "OrderNumber": "PO-2025-0405"
    }
    ```
  </Accordion>
</AccordionGroup>

### Buyer: Categories, Vendors & Users

<AccordionGroup>
  <Accordion title="get-categories: Get categories">
    Get all buyer categories.

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "Categories": [
        { "ID": 1, "Name": "Dairy" },
        { "ID": 2, "Name": "Dry Goods" },
        { "ID": 3, "Name": "Coffee" },
        { "ID": 4, "Name": "Produce" },
        { "ID": 5, "Name": "Meat & Poultry" },
        { "ID": 6, "Name": "Cleaning Supplies" }
      ]
    }
    ```
  </Accordion>

  <Accordion title="set-category: Create/update category">
    <ParamField body="name" type="string" required>
      Category name.
    </ParamField>

    <ParamField body="id" type="string">
      Category ID. Omit to create, include to update.
    </ParamField>

    **Example request (create):**

    ```json theme={null}
    {
      "name": "Beverages"
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "ID": 7
    }
    ```
  </Accordion>

  <Accordion title="get-vendors: Get connected vendors">
    Get all vendors connected to the buyer account.

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "Vendors": [
        {
          "VendorGuid": "d4e5f6a7-b8c9-0123-defa-234567890123",
          "VendorName": "Fresh Produce Co.",
          "ContactEmail": "orders@freshproduce.com",
          "ContactPhone": "555-0100",
          "MinimumOrder": 50.00,
          "DeliveryDays": "Mon,Wed,Fri"
        },
        {
          "VendorGuid": "e5f6a7b8-c9d0-1234-efab-345678901234",
          "VendorName": "Metro Meats",
          "ContactEmail": "sales@metromeats.com",
          "ContactPhone": "555-0200",
          "MinimumOrder": 100.00,
          "DeliveryDays": "Tue,Thu"
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="get-buyer-users: Get buyer users">
    Get all users for a buyer.

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "Users": [
        {
          "UserGuid": "f6a7b8c9-d012-3456-fabc-456789012345",
          "UserName": "John Doe",
          "Email": "john@downtownbistro.com",
          "Role": "Admin",
          "IsActive": true
        },
        {
          "UserGuid": "a7b8c9d0-1234-5678-abcd-567890123456",
          "UserName": "Sarah Miller",
          "Email": "sarah@downtownbistro.com",
          "Role": "Manager",
          "IsActive": true
        }
      ]
    }
    ```
  </Accordion>
</AccordionGroup>

### Buyer: Reports & Documents

<AccordionGroup>
  <Accordion title="get-actual-theo-data: Actual vs Theoretical data">
    Get Actual vs Theoretical inventory data for variance analysis.

    <ParamField body="fromDateUTC" type="string">
      Start date.
    </ParamField>

    <ParamField body="toDateUTC" type="string">
      End date.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "fromDateUTC": "2025/03/01 00:00:00",
      "toDateUTC": "2025/03/31 23:59:59"
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "Items": [
        {
          "ItemName": "Whole Milk",
          "CategoryName": "Dairy",
          "ActualUsage": 120.0,
          "TheoreticalUsage": 115.5,
          "Variance": 4.5,
          "VariancePercentage": 3.90,
          "VarianceCost": 15.84,
          "UnitOfMeasure": "Gallon"
        },
        {
          "ItemName": "Espresso Beans",
          "CategoryName": "Coffee",
          "ActualUsage": 28.0,
          "TheoreticalUsage": 26.5,
          "Variance": 1.5,
          "VariancePercentage": 5.66,
          "VarianceCost": 18.75,
          "UnitOfMeasure": "lb"
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="get-menu-profitability: Menu profitability report">
    Get menu profitability report data.

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "MenuItems": [
        {
          "MenuItemName": "Cappuccino",
          "CategoryName": "Hot Drinks",
          "SalePrice": 4.50,
          "CostPrice": 1.20,
          "Profit": 3.30,
          "FoodCostPercentage": 26.67,
          "QuantitySold": 520,
          "TotalRevenue": 2340.00,
          "TotalCost": 624.00,
          "TotalProfit": 1716.00
        },
        {
          "MenuItemName": "Caesar Salad",
          "CategoryName": "Salads",
          "SalePrice": 12.00,
          "CostPrice": 3.85,
          "Profit": 8.15,
          "FoodCostPercentage": 32.08,
          "QuantitySold": 180,
          "TotalRevenue": 2160.00,
          "TotalCost": 693.00,
          "TotalProfit": 1467.00
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="get-docs-by-doc-date: Get documents by date">
    Get invoices and delivery notes within a date range.

    <ParamField body="dateTimeFromUTC" type="string" required>
      Start date.
    </ParamField>

    <ParamField body="dateTimeToUTC" type="string" required>
      End date.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "dateTimeFromUTC": "2025/03/01 00:00:00",
      "dateTimeToUTC": "2025/03/31 23:59:59"
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "Documents": [
        {
          "DocGuid": "c3d4e5f6-0003-0000-0000-000000000003",
          "DocNumber": "INV-2025-0315",
          "DocType": "Invoice",
          "DocDateUTC": "2025/03/15 00:00:00",
          "VendorName": "Fresh Produce Co.",
          "TotalAmount": 245.80,
          "Items": [
            {
              "ItemName": "Roma Tomatoes",
              "Quantity": 20,
              "UnitOfMeasure": "lb",
              "Price": 2.49,
              "TotalPrice": 49.80
            }
          ]
        }
      ]
    }
    ```
  </Accordion>
</AccordionGroup>

### Vendor

<AccordionGroup>
  <Accordion title="vendor-get-products: Get product catalog">
    Get the vendor's product catalog.

    <ParamField body="vendorGuid" type="string">
      Vendor GUID.
    </ParamField>

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "Products": [
        {
          "ProductGuid": "e5f6a7b8-0004-0000-0000-000000000004",
          "ProductName": "Roma Tomatoes",
          "ProductCode": "FP-TOM-001",
          "Price": 2.49,
          "UnitOfMeasure": "lb",
          "CategoryName": "Vegetables",
          "IsActive": true,
          "MinOrderQuantity": 5
        },
        {
          "ProductGuid": "f6a7b8c9-0005-0000-0000-000000000005",
          "ProductName": "Romaine Lettuce",
          "ProductCode": "FP-LET-001",
          "Price": 1.99,
          "UnitOfMeasure": "head",
          "CategoryName": "Vegetables",
          "IsActive": true,
          "MinOrderQuantity": 1
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="vendor-set-product: Create/update product">
    <ParamField body="productData" type="object" required>
      Product data object.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "productData": {
        "ProductName": "Organic Basil",
        "ProductCode": "FP-BAS-001",
        "Price": 3.99,
        "UnitOfMeasure": "bunch",
        "CategoryName": "Herbs",
        "IsActive": true,
        "MinOrderQuantity": 2
      }
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "ProductGuid": "a7b8c9d0-0006-0000-0000-000000000006"
    }
    ```
  </Accordion>

  <Accordion title="vendor-get-orders-by-delivery-date: Get vendor orders">
    Get vendor orders within a delivery date range.

    <ParamField body="dateTimeFromUTC" type="string" required>
      Start date.
    </ParamField>

    <ParamField body="dateTimeToUTC" type="string" required>
      End date.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "dateTimeFromUTC": "2025/04/01 00:00:00",
      "dateTimeToUTC": "2025/04/07 23:59:59"
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "Orders": [
        {
          "OrderGuid": "a1b2c3d4-0001-0000-0000-000000000001",
          "OrderNumber": "PO-2025-0401",
          "BuyerName": "Downtown Bistro",
          "OrderStatus": "Sent",
          "DeliveryDateUTC": "2025/04/02 06:00:00",
          "TotalPrice": 245.80,
          "Items": [
            {
              "ProductCode": "FP-TOM-001",
              "ProductName": "Roma Tomatoes",
              "Quantity": 20,
              "UnitOfMeasure": "lb",
              "Price": 2.49,
              "TotalPrice": 49.80
            }
          ]
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="vendor-get-customers: Get connected customers">
    Get customers (buyers) connected to the vendor.

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "Customers": [
        {
          "BuyerGuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "BuyerName": "Downtown Bistro",
          "ContactEmail": "orders@downtownbistro.com",
          "ContactPhone": "555-0300"
        },
        {
          "BuyerGuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
          "BuyerName": "Airport Cafe",
          "ContactEmail": "orders@airportcafe.com",
          "ContactPhone": "555-0400"
        }
      ]
    }
    ```
  </Accordion>
</AccordionGroup>

### Advanced

<AccordionGroup>
  <Accordion title="raw-request: Execute any API endpoint">
    Execute any MarketMan API endpoint not covered by other tools. Authentication is handled automatically, and `BuyerGuid`/`VendorGuid` are auto-injected from your connection defaults.

    See the [MarketMan API documentation](https://api-doc.marketman.com/) for the full endpoint reference.

    <ParamField body="path" type="string" required>
      API path relative to `/v3/` (e.g., `buyers/webhooks/CreateWebhook`).
    </ParamField>

    <ParamField body="body" type="object">
      Request body as JSON.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "path": "buyers/inventory/GetTransfers",
      "body": {
        "DateTimeFromUTC": "2025/03/01 00:00:00",
        "DateTimeToUTC": "2025/03/31 23:59:59"
      }
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "IsSuccess": true,
      "Transfers": [
        {
          "TransferID": 801,
          "TransferDateUTC": "2025/03/10 11:00:00",
          "FromLocation": "Downtown Bistro",
          "ToLocation": "Airport Cafe",
          "Items": [
            {
              "ItemName": "Espresso Beans",
              "Quantity": 5.0,
              "UnitOfMeasure": "lb"
            }
          ]
        }
      ]
    }
    ```
  </Accordion>
</AccordionGroup>