MarketMan provides API (Application Programming Interface) for integration with third-party applications such as: accounting, ERP, e-commerce, self-service portals and others.
With the MarketMan API, you can extract data in JSON format and develop new applications or integrate with your existing business applications.
As the MarketMan API is independent of programming languages, you can develop applications in any programming language (Java, .Net, C, C++, PHP, etc.).
In all requests we use the following variables:
\nAPIKey: put your API Partner key.
\nAPIPassword: put your API Partner password.
\nBuyerGuid: put the buyer GUID that you wish to work on (for working on Buyer API).
\nVendorGuid: put the Vendor GUID that you wish to work on (for working on Vendor API).
\nThe GetToken request which gets the access token will automatically set the access token to the global variable 'accessToken' and will be auto included in all future requests (Using Tests section).
\nSame will be done for the Query Token for Async method (for example, SetSAlesAsync and GetAsyncTokenStatus)
\nFor your own calls (within or outside of Postman) make sure to put your own correct info.
\nThe total number of API calls that can be made by a single API consumer is limited to 500 calls per 24 hours.
If this limit is reached, a notification will be sent in the response.
Example:
\n{\n \"IsSuccess\": false,\n \"ErrorMessage\": \"Reached max calls\"\n}\n\nWhen sending date value to the server, it should be represented as yyyy/mm/dd hh:mm:ss.
When receiving date value from the server, it should be parsed as yyyy/mm/dd hh:mm:ss.
for further infromation you are welcome to contact our team at www.marketman.com
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Postman Variables:","slug":"postman-variables"},{"content":"API Limitations","slug":"api-limitations"},{"content":"Date format:","slug":"date-format"},{"content":"Order statuses","slug":"order-statuses"},{"content":"Additional information","slug":"additional-information"}],"owner":"10610779","collectionId":"7102e738-61b6-4e3e-8dd7-d66480576403","publishedId":"T1LPET6f","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-09-29T12:27:49.000Z"},"item":[{"name":"Authentication","item":[{"name":"GetToken","event":[{"listen":"test","script":{"id":"18060bfc-aa7f-4b9b-9698-121824507c81","exec":["let jsonResponse = pm.response.json(),\r"," newAccessToken = jsonResponse.Token;\r","\r"," console.log({jsonResponse, newAccessToken })\r","\r"," pm.environment.set('accessToken', newAccessToken);\r"," pm.variables.set('accessToken', newAccessToken);"],"type":"text/javascript"}}],"id":"b99a6586-95d0-456f-98d1-fbc1c53fd98c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text","description":"always use application/json
\n"}],"body":{"mode":"raw","raw":"{\n\t\"APIKey\":\"{{apiKey}}\",\n\t\"APIPassword\":\"{{apiPassword}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.marketman.com/v3/buyers/auth/GetToken","description":"Use you API Partner key and password to get the access token.\nPlease note that the token has an expiration date in which it will need to be renewd.
\nNone
\nQuery for the status of a QueryToken after an Async operation.
\nTo use the API, a MarketMan Authentication Token is required.\nPlease make sure you have the permission to access the API service. \nIf you do not have permission, please contact your customer manager.
\nTo generate the Auth Token, you need to send an authentication request to MarketMan API using the URL format below.
\nhttps://api.marketman.com/v3/vendors/auth/GetToken
\nThe authentication token should be sent to the API in every request in the Headers with the variable name AUTH_TOKEN
\n","event":[{"listen":"prerequest","script":{"id":"37474f50-f2c2-4a81-bb1a-832e386057a1","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"2d0f0b26-8a11-4762-9c5b-77886f2f2870","type":"text/javascript","exec":[""]}}],"_postman_id":"616f6332-ca00-4e75-bc28-92c887c6254f"},{"name":"Accounts","item":[{"name":"GetAuthorisedAccounts","id":"1a979696-d354-4e20-8da6-2751ff1f2871","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"key":"AUTH_TOKEN","value":"{{accessToken}}","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://api.marketman.com/v3/buyers/partneraccounts/GetAuthorisedAccounts","description":"Get a list of all the accounts you have access to.
\nNone
\nBuyers Array
\nVendors Array
\nChains Array
\nIn case a location im MarketMan has more than one POS of type API, this method will return a list of all POSs of type API
\nThe API Patrner Accounts are the list of all the buyers and vendors you have access to with you API Partner credentials.
\n","event":[{"listen":"prerequest","script":{"id":"0d0a808d-4590-43d3-b86e-bf32cd64a0a1","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"db922e82-6a09-4d68-97d8-e9f4199c293c","type":"text/javascript","exec":[""]}}],"_postman_id":"219d753b-eef0-4a16-a8d0-16313e316f24"},{"name":"Buyers","item":[{"name":"Chain","item":[{"name":"GetChainBuyers","id":"ec482a5b-fc3c-45dd-99a4-7a02312896e9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"key":"AUTH_TOKEN","type":"text","value":"{{accessToken}}"}],"body":{"mode":"raw","raw":"{\n\t\"BuyerGuid\" : \"{{buyerGuid}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.marketman.com/v3/buyers/chain/GetChainBuyers","description":"Get all the chain buyers.\nRelevant only to chain manager
\nChain data for chains
\n","event":[{"listen":"prerequest","script":{"id":"60f19e90-592b-4b7c-9a4f-a3a2590e855b","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"84d21b04-a5ed-407c-a219-6d8b9cd9eb9d","type":"text/javascript","exec":[""]}}],"_postman_id":"a5fa71c2-2e1d-419e-96b7-af7f85ae3931","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","name":"Buyers","type":"folder"}}},{"name":"Inventory","item":[{"name":"GetItems","id":"7a9e2867-2709-47b2-b1b4-1f231fb9e277","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"AUTH_TOKEN","value":"{{accessToken}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n\t\"itemIDs\" :[\"201591138\"],\r\n \"Take\": 100,\r\n \"Skip\": 0,\r\n\t\"BuyerGuid\": \"{{buyerGuid}}\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://api.marketman.com/v3/buyers/inventory/GetItems","description":"Get all items for a specific buyer.
\nGet all preps
\nItems Array
\nAssortments Array
\nSubItems Array
\nGet all invetnory items
\nCreates a new Inventory count.
\nDelete an inventory count.
\nGets all transfers.
\nonly available for chains
\nTransfers array
\nLines array
\nGets all waste events
\nWasteEvents array
\nLines array
\nGets all inventory counts
\nGet all menu items
\nGets list of uom types
\nUOMs Array
\nGet all menu items availability
\nItems Array
\nIngredients Array
\nInsert/Update a menu item
\nSet par level for inventory item
\nGet all menu items
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","name":"Buyers","type":"folder"}},"urlObject":{"path":["v3","buyers","inventory","GetMenuItemsAvailability"],"host":["https://api.marketman.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"f63b53d0-e091-4898-9005-f023242183e0"},{"name":"GetProductionEventsByDate","id":"1d465665-6ad0-444e-989f-ec19e73c9c17","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"key":"AUTH_TOKEN","type":"text","value":"{{accessToken}}"}],"body":{"mode":"raw","raw":"{\n \"StartDateUTC\": \"2024/02/19 23:00:00\",\n \"EndDateUTC\": \"2024/02/28 23:00:00\",\n \"BuyerGuid\": \"{{buyerGuid}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.marketman.com/v3/buyers/inventory/GetProductionEventsByDate","description":"Buyer Inventory related methods
\n","event":[{"listen":"prerequest","script":{"id":"f177a2f0-994d-4495-ac4f-2495ea41e1cd","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"2edff110-80af-40f1-932d-173f3bbc161c","type":"text/javascript","exec":[""]}}],"_postman_id":"11c3b4bb-8e9e-4fa1-a122-88463f5bdfc8","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","name":"Buyers","type":"folder"}}},{"name":"GetVendors","item":[{"name":"GetVendors","id":"3b05f174-3a48-4c10-b0c8-d826aa994abf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"key":"AUTH_TOKEN","type":"text","value":"{{accessToken}}"}],"body":{"mode":"raw","raw":"{\r\n\t\"BuyerGuid\": \"{{buyerGuid}}\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://api.marketman.com/v3/buyers/items/GetVendors","description":"Gets all vendors your account is connected to
\nVendors Array
\nBuyer items mangement.
\n","event":[{"listen":"prerequest","script":{"id":"5e3a2f83-cc3d-47ba-8075-9ae0d8c45f38","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"8b275561-835e-439c-8d06-085c8ced1dc3","type":"text/javascript","exec":[""]}}],"_postman_id":"e0dd581f-b660-4b4f-b222-636273a71b9d","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","name":"Buyers","type":"folder"}}},{"name":"Categories","item":[{"name":"GetCategories","id":"aeb8b26e-5117-4f17-bc4a-0df79288127a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"key":"AUTH_TOKEN","type":"text","value":"{{accessToken}}"}],"body":{"mode":"raw","raw":"{\r\n\t\"BuyerGuid\": \"{{buyerGuid}}\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://api.marketman.com/v3/buyers/categories/GetCategories","description":"Gets all categories
\nCategories array
\nDelete a category
\nCreate/Update a category
\nBuyer categories mangement
\n","event":[{"listen":"prerequest","script":{"id":"1bfb59c4-9758-4ad8-a21a-8de7196da2ba","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"a3c54da7-edff-42ba-bfef-6a1465862978","type":"text/javascript","exec":[""]}}],"_postman_id":"735513c1-4c0f-452e-9bca-2286e6c5fac6","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","name":"Buyers","type":"folder"}}},{"name":"Sales","item":[{"name":"RegisterInitiateSetSales","id":"4553f3fc-726e-4dc2-99b2-7089b6fe0846","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"AUTH_TOKEN","type":"text","value":"{{accessToken}}"},{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"InitiateSetSalesURL\": \"https://user.api.path/method/name\",\n \"BuyerGuid\": \"{{buyerGuid}}\"\n}"},"url":"https://api.marketman.com/v3/buyers/sales/RegisterInitiateSetSales","description":"Datasource will register a webhook that will be used to initiate sending of sales for MarketMan
\nImportant: This endpoint is intended for legacy integrations only.
\nNew partners must not use this endpoint and should integrate via the POS APIs under the /pos folder
Set sales data for a location, can’t be used for setting sales of a HQ.
\nThe set sales will delete existing sales for the time frame between DateTimeFrom and DateTimeTo.
Parallel invocation is not allowed and will result with a “Locked“ error.
2nd call should only be made after 1st call is finished.
SetSalesAsync is also available.
importnat note:
each call to the SetSales method should include full menu with all the items of the location (both items that will be included in the transcation list and also items that were not sold but still exists in the menu)
Items Array
\nTransactions Array
\nImportant: This endpoint is intended for legacy integrations only.
\nNew partners must not use this endpoint and should integrate via the POS APIs under the /pos folder
Async Operation for set sales
\nimportnat note:
each call to the SetSales method should include full menu with all the items of the location (both items that will be included in the transcation list and also items that were not sold but still exists in the menu)
ParameterTypeDescriptionTypeStringOptional. Two options: 1.MenuItem (Default) 2, ModifierIDStringNameStringPriceWithVATDecimalPriceWithoutVATDecimalSKUStringPOS codeCategoryString
\nTransactions Array
\nSet sales data for a location, can’t be used for setting sales of a HQ\nThe set sales will delete existing sales for the time frame between DateTimeFrom and DateTimeTo\nParallel invocation is not allowed and will result with a “Locked“ error.\n2nd call should only be made after 1st call is finished.\nSetSalesAsync is also available
\nSaleSummaries Array
\nCategorySummaries Array
\nGets the transactions per sale summey
\nTransactions Array
\nSales management
\n","event":[{"listen":"prerequest","script":{"id":"c00484ec-624a-43f1-95b2-c7e6bb8d3a44","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"a12a8ed9-2687-4ba5-b370-d557c6d93718","type":"text/javascript","exec":[""]}}],"_postman_id":"930b3a26-06e6-408d-bc8a-309fa143cf1e","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","name":"Buyers","type":"folder"}}},{"name":"Docs","item":[{"name":"GetDocsByDocDate","id":"d0197a4e-5374-4869-8a34-3b528990115f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"AUTH_TOKEN","type":"text","value":"{{accessToken}}"},{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \r\n \"DateTimeFromUTC\" : \"2020/01/01 00:00:00\",\r\n \"DateTimeToUTC\": \"2020/01/20 23:59:59\",\r\n \"BuyerGuid\": \"{{buyerGuid}}\"\r\n}\r\n"},"url":"https://api.marketman.com/v3/buyers/docs/GetDocsByDocDate","description":"** Docs Array **
\n** HistoryLog Array **
\n** Items Array **
\n** Credits Array **
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","name":"Buyers","type":"folder"}},"urlObject":{"path":["v3","buyers","docs","GetDocsByDocDate"],"host":["https://api.marketman.com"],"query":[{"disabled":true,"key":"","value":""}],"variable":[]}},"response":[{"id":"5911f58a-4080-4dd5-a342-36efd3ce0c25","name":"GetDocsByDocDate Success","originalRequest":{"method":"POST","header":[{"key":"AUTH_TOKEN","type":"text","value":"{{accessToken}}"},{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"DateTimeFromUTC\" : \"2021/03/08 14:00:00\",\r\n \"DateTimeToUTC\": \"2021/03/08 23:59:59\",\r\n \"BuyerGuid\": \"{{buyerGuid}}\"\r\n}\r\n"},"url":{"raw":"https://api.marketman.com/v3/buyers/docs/GetDocsByDocDate","host":["https://api.marketman.com"],"path":["v3","buyers","docs","GetDocsByDocDate"],"query":[{"key":"","value":"","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Content-Length","value":"4734"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Encoding","value":"gzip"},{"key":"Expires","value":"-1"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"Request-Context","value":"appId=cid-v1:aa7de11f-c2f8-492b-9087-262956b65d27"},{"key":"Access-Control-Expose-Headers","value":"Request-Context"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Sun, 01 Mar 2020 10:17:48 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"Docs\": [\n {\n \"DocNumber\": \"test 234r243\",\n \"Guid\": \"97ed7c3eef9a434cba508b3bf556f5c9\",\n \"BuyerName\": \"Chillout [dev]\",\n \"BuyerGuid\": \"c2a660f1ebc34305b20f1e4e73dcde22\",\n \"VendorName\": \"Baci Gelato\",\n \"DocTypeID\": 2,\n \"DocType\": \"Invoice\",\n \"DateUTC\": \"2021/03/08 14:18:31\",\n \"DueDateUTC\": \"2021/03/08 14:18:30\",\n \"PriceTotalWithVAT\": 225.0,\n \"PriceTotalWithoutVAT\": 225.0,\n \"Comments\": \"\",\n \"VendorGuid\": \"0ab839a11dda4db3b685441070065ea4\",\n \"OrderNumber\": \"\",\n \"OpenCredits\": 0.0,\n \"IsAccountingSynced\": false,\n \"DocStatusID\": 3,\n \"DocStatusType\": \"Approved\",\n \"PriceDiscountValue\": 0.0,\n \"PriceDiscountPercentage\": 0.0,\n \"PriceCredit\": \"Open\",\n \"QuantityCredit\": \"Open\",\n \"HistoryLog\": [\n {\n \"ID\": 5545851,\n \"DocID\": 9796385,\n \"ActionTitle\": \"Saved\",\n \"Name\": \"Noam Wolf\",\n \"CreatedDateUTC\": \"2021/03/08 14:18:31\",\n \"TotalPrice\": 225.00000,\n \"CreatedByBuyer\": \"Noam Wolf\",\n \"BuyerUserName\": \"noamchill\",\n \"BuyerGUID\": \"c2a660f1ebc34305b20f1e4e73dcde22\",\n \"ActionID\": 2\n },\n {\n \"ID\": 5545852,\n \"DocID\": 9796385,\n \"ActionTitle\": \"Approve for payment\",\n \"Name\": \"Noam Wolf\",\n \"CreatedDateUTC\": \"2021/03/08 14:18:32\",\n \"TotalPrice\": 225.00000,\n \"CreatedByBuyer\": \"Noam Wolf\",\n \"BuyerUserName\": \"noamchill\",\n \"BuyerGUID\": \"c2a660f1ebc34305b20f1e4e73dcde22\",\n \"ActionID\": 5\n }\n ],\n \"Items\": [\n {\n \"ItemName\": \"Amarena Cherry - Natural Milk Gelato with the Famous Amarena Cherry Swirl (2.5 Qt)\",\n \"SKU\": \"102 QA\",\n \"OrderQuantity\": 0.0,\n \"Quantity\": 3.0,\n \"Price\": 25.0,\n \"ReceiveQuantity\": 2.0,\n \"PriceTotal\": 75.0,\n \"PriceTotalWithoutVAT\": 75.0,\n \"PriceTotalWithVAT\": 75.00000000,\n \"CatalogItemID\": 6029693,\n \"CatalogItemCode\": 983597,\n \"TaxLevelID\": 1,\n \"TaxValue\": 0.00000000,\n \"ItemMeasureTypeID\": 75,\n \"ItemMeasureTypeName\": \"Qt\",\n \"PackQuantity\": 2.5,\n \"PacksPerCase\": null,\n \"CategoryID\": 282261,\n \"CategoryName\": \"Alcohol drinks\",\n \"Credits\": [\n {\n \"StatusName\": \"Close\",\n \"StatusId\": 2,\n \"TypeId\": 1,\n \"TypeName\": \"Quantity Credit\",\n \"Quantity\": 1.0,\n \"Price\": 25.0,\n \"TotalPrice\": 25.0\n }\n ]\n },\n {\n \"ItemName\": \"Pistachio 2\",\n \"SKU\": \"1003\",\n \"OrderQuantity\": 0.0,\n \"Quantity\": 5.0,\n \"Price\": 22.0,\n \"ReceiveQuantity\": 5.0,\n \"PriceTotal\": 110.0,\n \"PriceTotalWithoutVAT\": 110.0,\n \"PriceTotalWithVAT\": 110.00000000,\n \"CatalogItemID\": 4504068,\n \"CatalogItemCode\": 937447,\n \"TaxLevelID\": 1,\n \"TaxValue\": 0.00000000,\n \"ItemMeasureTypeID\": 34,\n \"ItemMeasureTypeName\": \"gal\",\n \"PackQuantity\": 2.5,\n \"PacksPerCase\": null,\n \"CategoryID\": 9988,\n \"CategoryName\": \"Food - Dry/Canned Goods\",\n \"Credits\": [\n {\n \"StatusName\": \"Open\",\n \"StatusId\": 1,\n \"TypeId\": 2,\n \"TypeName\": \"Price Credit\",\n \"Quantity\": 5.0,\n \"Price\": -8.0,\n \"TotalPrice\": -40.0\n }\n ]\n },\n {\n \"ItemName\": \"Banana Nutella - Fresh Banana with Nutella Swirl (2.5 Qt)\",\n \"SKU\": \"106\",\n \"OrderQuantity\": 0.0,\n \"Quantity\": 5.0,\n \"Price\": 8.0,\n \"ReceiveQuantity\": 4.0,\n \"PriceTotal\": 40.0,\n \"PriceTotalWithoutVAT\": 40.0,\n \"PriceTotalWithVAT\": 40.00000000,\n \"CatalogItemID\": 983601,\n \"CatalogItemCode\": 983601,\n \"TaxLevelID\": 1,\n \"TaxValue\": 0.00000000,\n \"ItemMeasureTypeID\": 75,\n \"ItemMeasureTypeName\": \"Qt\",\n \"PackQuantity\": 2.5,\n \"PacksPerCase\": null,\n \"CategoryID\": 21462,\n \"CategoryName\": \"Dairy-Ice Creams\",\n \"Credits\": [\n {\n \"StatusName\": \"Open\",\n \"StatusId\": 1,\n \"TypeId\": 1,\n \"TypeName\": \"Quantity Credit\",\n \"Quantity\": 1.0,\n \"Price\": 8.0,\n \"TotalPrice\": 8.0\n },\n {\n \"StatusName\": \"Open\",\n \"StatusId\": 1,\n \"TypeId\": 2,\n \"TypeName\": \"Price Credit\",\n \"Quantity\": 4.0,\n \"Price\": -2.0,\n \"TotalPrice\": -8.0\n }\n ]\n }\n ]\n }\n ],\n \"IsSuccess\": true,\n \"ErrorMessage\": null,\n \"ErrorCode\": null,\n \"RequestID\": \"26ccc7fe-d8b0-46c4-b7dd-c0c281a8ca70\"\n}"}],"_postman_id":"d0197a4e-5374-4869-8a34-3b528990115f"},{"name":"SetDocsExported","id":"ce0abd5c-0932-49af-8882-c45f6010a5ca","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"AUTH_TOKEN","value":"{{accessToken}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"BuyerGUID\": \"{{buyerGuid}}\",\r\n \"docs\": [ \"Doc Guids\" ]\r\n}\r\n"},"url":"https://api.marketman.com/v3/buyers/docs/SetDocsExported","description":"Docs Management
\n","event":[{"listen":"prerequest","script":{"id":"1581409a-d672-4c0e-9bc3-a5272f1ec022","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"1f6a01cc-b0b1-45cb-aff6-7c64ca5c64b3","type":"text/javascript","exec":[""]}}],"_postman_id":"2336e0ac-3833-486a-b774-2753839bb84a","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","name":"Buyers","type":"folder"}}},{"name":"Orders","item":[{"name":"GetOrdersByDeliveryDate","id":"d158cc7c-6b61-41f2-9d65-607366d0db27","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"AUTH_TOKEN","value":"{{accessToken}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \r\n \"DateTimeFromUTC\" : \"2025/02/18 00:00:00\",\r\n \"DateTimeToUTC\": \"2025/02/20 23:59:59\",\r\n \"BuyerGuid\": \"{{buyerGuid}}\"\r\n}\r\n"},"url":"https://api.marketman.com/v3/buyers/orders/GetOrdersByDeliveryDate","description":"Gets all orders according to delivery date range.
\nOrders array
\nHistoryLog Array
\nItems array
\nGets all orders according to sent date range.
\nOrders array
\nHistoryLog Array
\nItems array
\nGet all the vendor catalog items.
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","name":"Buyers","type":"folder"}},"urlObject":{"path":["v3","buyers","orders","GetCatalogItems"],"host":["https://api.marketman.com"],"query":[],"variable":[]}},"response":[{"id":"b606659c-e0cf-4a71-a027-3f328befbb6a","name":"GetCatalogItems","originalRequest":{"method":"POST","header":[{"key":"AUTH_TOKEN","type":"text","value":"{{accessToken}}"}],"body":{"mode":"raw","raw":"{\n\t\"BuyerGuid\": \"{{buyerGuid}}\",\n \"VendorGuid\": \"{{vendorGuid}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.marketman.com/v3/buyers/orders/GetCatalogItems"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Content-Length","value":"1605"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Encoding","value":"gzip"},{"key":"Expires","value":"-1"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"Request-Context","value":"appId=cid-v1:aa7de11f-c2f8-492b-9087-262956b65d27"},{"key":"Access-Control-Expose-Headers","value":"Request-Context"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Mon, 11 May 2020 07:37:09 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"IsSuccess\": true,\n \"ErrorMessage\": null,\n \"ErrorCode\": null,\n \"CatalogItems\": [\n {\n \"Name\": \"Test Item 1.7 - 1\",\n \"SupplierName\": \"Test1.7\",\n \"VendorName\": \"Test1.7\",\n \"PackQty\": 1,\n \"PacksPerCase\": null,\n \"UOMName\": \"EA\",\n \"UOMID\": 35,\n \"ProductCode\": \"231541a\",\n \"Price\": null,\n \"MinOrderQty\": null,\n \"PriceType\": \"Product\",\n \"Ratio\": null,\n \"VendorGuid\": null,\n \"CatalogItemCode\": 3315144,\n \"TaxLevelID\": 1,\n \"TaxValue\": 0,\n \"PriceWithVat\": 0,\n \"ScanBarcode\": null\n },\n {\n \"Name\": \"Test 1.7 - 2\",\n \"SupplierName\": \"Test1.7\",\n \"VendorName\": \"Test1.7\",\n \"PackQty\": 1,\n \"PacksPerCase\": null,\n \"UOMName\": \"EA\",\n \"UOMID\": 35,\n \"ProductCode\": \"a23412a\",\n \"Price\": null,\n \"MinOrderQty\": null,\n \"PriceType\": \"Product\",\n \"Ratio\": null,\n \"VendorGuid\": null,\n \"CatalogItemCode\": 3315147,\n \"TaxLevelID\": 1,\n \"TaxValue\": 0,\n \"PriceWithVat\": 0,\n \"ScanBarcode\": null\n }\n ]\n}"}],"_postman_id":"d56b217a-c45e-44a8-956c-b46ecbd61f8b"},{"name":"CreateOrder","id":"40f1930a-b70c-491a-a450-c46e6f1f9c1b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"AUTH_TOKEN","type":"text","value":"{{accessToken}}"}],"body":{"mode":"raw","raw":"{\n\t\"BuyerGuid\": \"{{buyerGuid}}\",\n \"VendorGuid\": \"{{vendorGuid}}\",\n \"OrderStatus\" : \"Sent\",\n \"deliveryDateUTC\": \"2020/05/06 00:00:00\",\n \"sentDateUTC\": \"2020/05/06 00:00:00\",\n \"BuyerUserGuid\" : \"{{buyerUserGuid}}\",\n \"comment\": \"Order Comment\",\n \"catalogItems\": [\n {\n \t\"CatalogItemCode\" : \"3589795\",\n \t\"Quantity\" : 2\n },\n \n {\n \t\"CatalogItemCode\" : \"2782153\",\n \t\"Quantity\" : 2\n },\n \n {\n \t\"CatalogItemCode\" : \"2782154\",\n \t\"Quantity\" : 1\n }\n \n ]\n \n}","options":{"raw":{"language":"json"}}},"url":"https://api.marketman.com/v3/buyers/orders/CreateOrder","description":"Creates a new order and send it to the vendor
\nItems Array
\nOrder managmenets
\n","event":[{"listen":"prerequest","script":{"id":"8af8ecba-e096-4ddb-b2c7-4391d1f226db","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"e9155e9a-3b37-4b64-aa5d-7c7b1b58b6fe","type":"text/javascript","exec":[""]}}],"_postman_id":"3166651c-3d6e-4ea8-9953-b50dccdea25f","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","name":"Buyers","type":"folder"}}},{"name":"Taxes","item":[{"name":"GetTaxLevels","id":"b7fdfce5-9228-4413-95d5-39184d9f1c40","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"key":"AUTH_TOKEN","type":"text","value":"{{accessToken}}"}],"body":{"mode":"raw","raw":"{\n\t\"BuyerGuid\": \"{{buyerGuid}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.marketman.com/v3/buyers/Taxes/GetTaxLevels","description":"Gets all the tax levels of the buyer
\nReturns info of tax level by its ID.
\nTax Management
\n","event":[{"listen":"prerequest","script":{"id":"c2cbbfb3-8dc9-4510-b975-21cd89187073","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"08c132ae-d1f9-4756-a285-05abc55008b2","type":"text/javascript","exec":[""]}}],"_postman_id":"e7d02ce6-5365-4d8f-9a9e-310a512f83ce","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","name":"Buyers","type":"folder"}}},{"name":"Webhooks","item":[{"name":"CreateWebhook","id":"36cfebfe-a0a4-4477-b970-83033c7cd78c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"AUTH_TOKEN","value":"{{accessToken}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"Type\": \"Order create\",\n \"URL\": \"URL-test.com\",\n \"BuyerGuid\": \"{{buyerGuid}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.marketman.com/v3/buyers/webhooks/CreateWebhook","description":"Create a new webhook
\nGets a list of all webhooks
\nWebhooks Array
\nGet hook event by order id
\nHook event Object
\nData Object
\nItems Array
\nGets a list of all webhooks
\nThese webhook types apply to buyer integrations
vendor integrations use a separate webhook set and endpoints.
To ensure data integrity, each Webhook Event Type can only be created once. The data payload delivered depends on the organizational level selected:
\nGet valid dates to use in GetActualTheoDataByBuyer method
\nStartDateCountsUTC Array
\nEndtDateCountsUTC Array
\nGets Actual Vs Theoretical data by buyer (new format)
\nActualTheoDataRows array
\nActualTheoCategoriesTotalsRows array
\nGets the output data for Actual VS Theoretical report (old format)
\nGets the output data for Menu Profitability report
\nItems Array
\nSubRows Array
\nParent Hierarchy Array
\nReports
\n","event":[{"listen":"prerequest","script":{"id":"fd5d487b-2d46-49aa-9e4b-4fb98161b10a","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"d5ffdfb2-883e-4bc9-b810-b2f31deddf02","type":"text/javascript","exec":[""]}}],"_postman_id":"765bb4ce-4cab-42e3-a9e2-3c5bb4365d17","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","name":"Buyers","type":"folder"}}},{"name":"Users","item":[{"name":"GetBuyerUsers","id":"2fc79e9d-85b9-4be9-8b21-344c46d0dde6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"AUTH_TOKEN","type":"text","value":"{{accessToken}}"}],"body":{"mode":"raw","raw":"{\n\t\"BuyerGuid\": \"{{buyerGuid}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.marketman.com/v3/buyers/users/GetBuyerUsers","description":"Get all the users of the given buyer
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","name":"Buyers","type":"folder"}},"urlObject":{"path":["v3","buyers","users","GetBuyerUsers"],"host":["https://api.marketman.com"],"query":[],"variable":[]}},"response":[{"id":"691ed53f-326b-4d0c-8a68-658fe2151292","name":"GetBuyerUsers","originalRequest":{"method":"POST","header":[{"key":"AUTH_TOKEN","type":"text","value":"{{accessToken}}"}],"body":{"mode":"raw","raw":"{\n\t\"BuyerGuid\": \"{{buyerGuid}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.marketman.com/v3/buyers/users/GetBuyerUsers"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Expires","value":"-1"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-SourceFiles","value":"=?UTF-8?B?UDpcTWFya2V0TWFuXENvZGUtUm95LURldjRcYXBpLm1hcmtldG1hbi5iaXpcdjNcYnV5ZXJzXHVzZXJzXEdldEJ1eWVyVXNlcnM=?="},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Wed, 06 May 2020 09:39:13 GMT"},{"key":"Content-Length","value":"7533"}],"cookie":[],"responseTime":null,"body":"{\n \"IsSuccess\": true,\n \"ErrorMessage\": null,\n \"ErrorCode\": null,\n \"BuyerUsers\": [\n {\n \"ID\": 6971,\n \"FirstName\": \"John\",\n \"LastName\": \"Doe\",\n \"Email\": \"JohnDoe@marketman.com\",\n \"MobilePhone\": \"+123456\",\n \"UserName\": \"John\",\n \"Role\": \"Manager\",\n \"BuyerUserGuid\": \"01b0595130132423402194b367ec9ce\"\n }\n ]\n}"}],"_postman_id":"2fc79e9d-85b9-4be9-8b21-344c46d0dde6"}],"id":"0e9a3e96-a157-45ae-a0ed-b0e88fe88a45","_postman_id":"0e9a3e96-a157-45ae-a0ed-b0e88fe88a45","description":"","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","name":"Buyers","type":"folder"}}},{"name":"POS","item":[{"name":"Sales Container","item":[{"name":"GetSalesPeriodContainersByDate","id":"088c529b-c54a-4960-848d-3aae73fc65a1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"},{"key":"AUTH_TOKEN","type":"text","value":"{{accessToken}}"}],"body":{"mode":"raw","raw":"{\r\n \"DateTimeFromUTC\": \"2020/07/01 00:00:00\",\r\n \"DateTimeToUTC\": \"2020/07/02 00:00:00\",\r\n \"BuyerGuid\": \"{{buyerGuid}}\"\r\n}"},"url":"https://api.marketman.com/v3/buyers/pos/GetSalesPeriodContainersByDate","description":"SalesPeriodContainer Object
\nSalesPeriodContainer Object
\nSalesPeriodContainer Object
\nSalesPeriodContainer Object
\nSalesPeriodContainer Object
\nSalesPeriodContainer Object
\nThis also deletes all the checks within the sales container.
\nSale containers mangement
\n","event":[{"listen":"prerequest","script":{"id":"19645853-f1af-4961-8550-02ada4a3cb0b","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"58251e1d-dfc1-4ad0-953c-8bf5afbc31e0","type":"text/javascript","exec":[""]}}],"_postman_id":"bad2d2f2-7d32-4a11-8457-3f3b9251dc46","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","name":"Buyers","type":"folder"}}},{"name":"Checks","item":[{"name":"GetChecks","id":"c8fc7cb6-4798-4d69-90f2-983fa3320dd2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"key":"AUTH_TOKEN","type":"text","value":"{{accessToken}}"}],"body":{"mode":"raw","raw":"{\r\n\t\"BuyerGuid\": \"{{buyerGuid}}\",\r\n\t\"SalesPeriodContainerID\" : \"2020/07/01 00:00:00\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://api.marketman.com/v3/buyers/pos/GetChecks","description":"Each check includes all the items sold within it.
\nCheck Object
\nCheckItem Object
\nEach check includes all the items sold within it.
\nEach check includes all the items sold within it.
\nMenuItem Object
\nTop most can be a Menu Item or Modifier Group.
Within Menu Item, can only be Modifier Group (as a sub item).
Within Modifier Group, can only be Modifier (as a sub item).
Within Modifier, can only be Modifier Group (as a sub item).
When a price is set to a modifier as a sub item within a menu item, it is used as the price of that modifier only when sold as a modifier to the topmost menu item!
To set a default price for a modifier, it must be set within a topmost Modifier Group (so the modifier is at 2nd level).
Top most can be a Menu Item or Modifier Group.
Within Menu Item, can only be Modifier Group (as a sub item).
Within Modifier Group, can only be Modifier (as a sub item).
Within Modifier, can only be Modifier Group (as a sub item).
When a price is set to a modifier as a sub item within a menu item, it is used as the price of that modifier only when sold as a modifier to the topmost menu item!
To set a default price for a modifier, it must be set within a topmost Modifier Group (so the modifier is at 2nd level).
Example Menu:
\n{\n\"ID\": \"1001\",\n\"Name\": \"Coffee\",\n\"SKUs\": \"1001\",\n\"Type\": \"Item\",\n\"CategoryPOSID\": \"3d8be47b0459430db501563b9d44b306\",\n\"SalePriceWithTax\": 5,\n\"SalePriceWithoutTax\" : 4\n\"Items\" : [{\n \"ID\": \"2001\",\n \"Items\" : [{\n \"ID\": \"3001\", \n },{\n \"ID\": \"3002\", \n }] \n },{\n \"ID\": \"2002\",\n \"Items\" : [{\n \"ID\": \"3003\", \n },{\n \"ID\": \"3004\", \n }] \n}] \n},{\n\"ID\": \"1002\",\n\"Name\": \"Tea\",\n\"SKUs\": \"1002\",\n\"Type\": \"Item\",\n\"CategoryPOSID\": \"3d8be47b0459430db501563b9d44b306\",\n\"SalePriceWithTax\": 10,\n\"SalePriceWithoutTax\" : 8\n \"Items\" : [{\n \"ID\": \"2001\",\n \"Items\" : [{\n \"ID\": \"3001\",\n \"SalePriceWithTax\": 2,\n \"SalePriceWithoutTax\" : 1.6 \n },{\n \"ID\": \"3002\", \n \"SalePriceWithTax\": 4,\n \"SalePriceWithoutTax\" : 3.2\n }] \n },{\n \"ID\": \"2002\",\n \"Items\" : [{\n \"ID\": \"3003\", \n },{\n \"ID\": \"3004\", \n }] \n}] \n},{\n\"ID\": \"2001\",\n\"Name\": \"Size\",\n\"SKUs\": \"2001\",\n\"Type\": \"Modifier Group\",\n\"CategoryPOSID\": \"3d8be47a85nfsacb501563b9d44b307\",\n\"Items\" : [{\n \"ID\": \"3001\", \n },{\n \"ID\": \"3002\", \n}] \n},{\n\"ID\": \"3001\",\n\"Name\": \"Small\",\n\"SKUs\": \"3001\",\n\"Type\": \"Modifier\",\n\"CategoryPOSID\": \"3d8bemfkref4n32sxaa3563b9d44b306\",\n\"SalePriceWithTax\": 1,\n\"SalePriceWithoutTax\" : 0.8,\n\"Items\" : [] \n},{\n\"ID\": \"3002\",\n\"Name\": \"Large\",\n\"SKUs\": \"3002\",\n\"Type\": \"Modifier\",\n\"CategoryPOSID\": \"3d8bemfkref4n32sxaa3563b9d44b306\",\n\"SalePriceWithTax\": 2,\n\"SalePriceWithoutTax\" : 1.6,\n\"Items\" : [] \n},{\n\"ID\": \"2002\",\n\"Name\": \"Milk\",\n\"SKUs\": \"2002\",\n\"Type\": \"Modifier Group\",\n\"CategoryPOSID\": \"3d8be47a85nfsacb501563b9d44b307\",\n\"Items\" : [{\n \"ID\": \"3003\", \n },{\n \"ID\": \"3004\", \n}] \n},{\n\"ID\": \"3003\",\n\"Name\": \"Whole\",\n\"SKUs\": \"3003\",\n\"Type\": \"Modifier\",\n\"CategoryPOSID\": \"a62be47015dejn6359430d1b9d44b306\",\n\"SalePriceWithTax\": 3,\n\"SalePriceWithoutTax\" : 2.4\n\"Items\" : [] \n},{\n\"ID\": \"3004\",\n\"Name\": \"Skimmed\",\n\"SKUs\": \"3004\",\n\"Type\": \"Modifier\",\n\"CategoryPOSID\": \"a62be47015dejn6359430d1b9d44b306\",\n\"SalePriceWithTax\": 5,\n\"SalePriceWithoutTax\" : 4\n\"Items\" : [] \n}\nPOSCategory Object
\nNote: Once created, categories cannot be changed or deleted via the API.
\nPOSCategory Object
\nPOSCategory Object
\nValidationResult Object
\nPOSCategory Object
\nPOSCategory Object
\nValidationResult Object
\n Note: If any of the POSCategories are not updated, the API response will return true; however, the corresponding Category Validation Results will indicate a failure. In such cases, it is required to review and validate the affected categories accordingly.
POSCategories Object
\nValidationResult Object
\nMenuItem Object
\nCreates Modifier groups with their inner modifiers.
Only one level of modifiers is allowed here (meaning the modifier cannot have other modifier groups inside them).
The prices on the modifiers are set to the default price of those modifiers (unlike when provided within a menu item, where the price is the price of that modifier only when sold under that menu item).
The topmost item must be a modifier group, and the inner sub-items must be modifiers.
MenuItem Object
\nCreates Modifier groups with their inner modifiers.
Only one level of modifiers is allowed here (meaning the modifier cannot have other modifier groups inside them).
The prices on the modifiers are set to the default price of those modifiers (unlike when provided within a menu item, where the price is the price of that modifier only when sold under that menu item).
The topmost item must be a modifier group, and the inner sub-items must be modifiers.
MenuItem Object
\nBuyer Point Of Sale managmenet
\nFlow:
\nCreate the POS categories using the CreatePOSCategories method.\nplease note, a category cannot be changed nor deleted via the API after it was created.
\nCreate the menu using the SetMenuItems method (this create or update the menu items)\nany item (menu item or modifier) sold must first be created in the menu.\neach item can have a category which was created in advanced.
\nfirst you need to create the sales container which holds all the sales within it (like z Z report from the POS)\neach container holds a list of checks within it.
\nafter the container was created , you should create/update checks within it.\neach check holds a list of the items that were sold.
\n","event":[{"listen":"prerequest","script":{"id":"750cf1bf-a144-4f8c-9181-9eb123425ead","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"d242ecfd-2f76-4197-af1c-41c51335f5f0","type":"text/javascript","exec":[""]}}],"_postman_id":"55520673-df8c-4b12-a1ac-42f47c84827b","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","name":"Buyers","type":"folder"}}},{"name":"SuggestiveOrdering","item":[{"name":"GetSuggestiveOrdering","id":"3b98e89d-03ff-44ef-aa2e-29d7c73c95ae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"},{"key":"AUTH_TOKEN","type":"text","value":"{{accessToken}}"}],"body":{"mode":"raw","raw":"{\r\n \"BuyerGuid\": \"{{buyerGuid}}\"\r\n}"},"url":"https://api.marketman.com/v3/buyers/suggestiveOrdering/GetLatestSuggestiveOrderingResults","description":"Get some base data used to calculate the par values of the latest Suggestive ordering result of the given buyer.
\nGet some base data used to calculate the par values of the latest Suggestive ordering result of the given buyer.
\nBuyer Point Of Sale managmenet
\nFlow:
\nCreate the POS categories using the CreatePOSCategories method.\nplease note, a category cannot be changed nor deleted via the API after it was created.
\nCreate the menu using the SetMenuItems method (this create or update the menu items)\nany item (menu item or modifier) sold must first be created in the menu.\neach item can have a category which was created in advanced.
\nfirst you need to create the sales container which holds all the sales within it (like z Z report from the POS)\neach container holds a list of checks within it.
\nafter the container was created , you should create/update checks within it.\neach check holds a list of the items that were sold.
\n","event":[{"listen":"prerequest","script":{"id":"750cf1bf-a144-4f8c-9181-9eb123425ead","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"d242ecfd-2f76-4197-af1c-41c51335f5f0","type":"text/javascript","exec":[""]}}],"_postman_id":"17df7998-eb69-44a7-a011-f93b7501f424","auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","name":"Buyers","type":"folder"}}}],"id":"62b5e2e7-ade7-4033-a623-c6869e825e2d","description":"The buyers section is used to manage buyer data.
\nGet a list of all the accounts you have access to.
\nNone
\nBuyers Array
\nVendors Array
\nChains Array
\nused to connect buyer to a vendor.\nfor this to work you must have access to both the buyer and the vendor with your api partner
\n","urlObject":{"path":["v3","vendors","buyers","ConnectBuyerVendor"],"host":["https://api.marketman.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"3d8a226b-3d67-4a15-9ada-d57e08843470"}],"id":"212ffc3a-7ff3-4e8a-99de-faaef34e198e","description":"The API Patrner Accounts are the list of all the buyers and vendors you have access to with you API Partner credentials.
\n","event":[{"listen":"prerequest","script":{"id":"71e0da77-9c0e-4380-b3b4-c808e4546339","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"7c9386c6-4630-4859-b788-4ef299019ab3","type":"text/javascript","exec":[""]}}],"_postman_id":"212ffc3a-7ff3-4e8a-99de-faaef34e198e"},{"name":"Webhooks","item":[{"name":"CreateWebhook","id":"c94756af-5dbe-450f-8b77-d0a88c92383a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"AUTH_TOKEN","value":"{{accessToken}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"Type\": \"Order create\",\n \"URL\": \"URL - DEMO.com\",\n \"VendorGuid\": \"{{VendorGuid}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.marketman.com/v3/vendors/webhooks/CreateWebhook","description":"Create a new webhook
\nWebhook Object
\nGets a list of all webhooks
\nGet hook event by order id
\nHook event Object
\nData Object
\nItems Array
\nGets a list of all webhooks
\nWebhooks Management
These webhook types apply to Vendor integrations
Buyer integrations use a separate webhook set and endpoints.
Webhook Types
\nValidate the invoice/delivery note before sending it with SetDocs.\nThis will result with a list of all the errors found if any.\nThe input is the same as for the SetDocs method.
\nErrors Array
\nWarnings Array
\nCreate an invoice/delivery note for a specified restaurant
\nItems Array
\nGets confirmed Delivery Notes
\nDeliveryNotes Array
\nItems Array
\nDocs ( Invlices and delivery notes) management
\nGets list of assortments
\nDelete an assortment
\nAdd an item to an existing assortment (if the item already in the assortment nothing will be done and the operation will end with success)
\nGets the customers that are connected to the supplier
\nCustomers Array
\nCreate/update a Customer
\nGets list of products from the supplier
\nProducts Array
\nCreate/update a product
\nDelete a product
\nCreate/update products
\nGets list of uom types
\nGets list of price levels
\nPriceLevels Array
\nLines Array
\nInsert/update a price level
\nInsert/update a price level.\nTo get the price level ID copy the query token from the response and use it in the GetAsyncTokenStatus endpoint.
\nLines Array
\nDelete a price level
\nAdd Or Updates an item to a Price level object
\nSet sales data for a location, can’t be used for setting sales of a HQ\nThe set sales will delete existing sales for the time frame between DateTimeFrom and DateTimeTo\nParallel invocation is not allowed and will result with a “Locked“ error.\n2nd call should only be made after 1st call is finished.\nSetSalesAsync is also available
\n","urlObject":{"path":["v3","buyers","sales","GetTransactions"],"host":["https://api.marketman.com"],"query":[{"disabled":true,"key":"","value":""}],"variable":[]}},"response":[],"_postman_id":"3c9112c7-d79e-4aad-a563-32b87b692a51"}],"id":"d6645438-e280-42c6-9f04-8936c75119f5","description":"Price level Mangement
\n","event":[{"listen":"prerequest","script":{"id":"809106bc-8058-4bc4-ae4b-7f8e198e41fa","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"6d8d53d3-1d99-4546-bf4c-cea767cb7141","type":"text/javascript","exec":[""]}}],"_postman_id":"d6645438-e280-42c6-9f04-8936c75119f5"},{"name":"TaxLevels","item":[{"name":"GetTaxLevels","id":"1b9be617-62fc-4463-bcb0-ad1741b75712","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"AUTH_TOKEN","type":"text","value":"{{accessToken}}"},{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"VendorGuid\": \"{{vendorGuid}}\"\n}\n","options":{"raw":{"language":"json"}}},"url":"https://api.marketman.com/v3/vendors/Taxes/GetTaxLevels","description":"Gets the logged-in buyer’s tax levels
\nTaxLevels Array
\nMappings Array
\nGets the logged-in buyer’s tax levels
\nTaxLevels Array
\nMappings Array
\nTax levels Mangement
\n","event":[{"listen":"prerequest","script":{"id":"90166e04-eafb-450d-823c-69a528e2e874","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"fa1ab5c0-c0f0-4838-9f3f-8b92d29c40d7","type":"text/javascript","exec":[""]}}],"_postman_id":"e44caf49-3de8-4575-875d-0a73a9379661"},{"name":"Orders","item":[{"name":"GetOrdersByDeliveryDate","id":"ee4cc815-014d-4f59-b006-1cc8b8545669","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"AUTH_TOKEN","type":"text","value":"{{accessToken}}"},{"key":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \r\n \"DateTimeFromUTC\" : \"2020/01/01 00:00:00\",\r\n \"DateTimeToUTC\": \"2022/01/02 23:59:59\",\r\n \"VendorGuid\": \"{{VendorGuid}}\"\r\n}\r\n"},"url":"https://api.marketman.com/v3/vendors/orders/GetOrdersByDeliveryDate","description":"Gets all orders according to delivery date range.
\nOrders array
\nItems array
\nGets all orders according to sent date range.
\nOrders array
\nItems array
\nSets order as approved by vendor.
\nOrder managmenets
\n","event":[{"listen":"prerequest","script":{"id":"3d3dbbc6-0eb4-48ef-93d3-242fcd050328","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"e72370e2-4bbb-43b1-af83-767791715680","type":"text/javascript","exec":[""]}}],"_postman_id":"005ea376-1dbe-4282-b657-17f66eed3d24"},{"name":"Weekly Orders","item":[{"name":"GetWeeklyOrdersByDate","id":"5749ecfe-e9b7-4c76-9dcb-fc9e50cbcb36","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"AUTH_TOKEN","type":"text","value":"{{accessToken}}"}],"body":{"mode":"raw","raw":"{\n \n \"DateTimeFromUTC\" : \"2022/09/26 07:00:00\",\n \"DateTimeToUTC\": \"2022/10/03 23:59:59\",\n \"VendorGuid\": \"VendorGuid\",\n \"BuyerGuid\": \"BuyerGuid\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.marketman.com/v3/vendors/weekly/GetWeeklyOrdersByDate","description":"Endpoint to retrieve the weekly order schedule.
\nThe use case is mainly starting to plan production in the commissary, before the daily order is sent, based on the schedule.
\nNote: Buyers can edit the weekly schedule up to ~ 60 min before cutoff time.
\nReturns only item with an order (items with qty > 0)
\n","urlObject":{"protocol":"https","path":["v3","vendors","weekly","GetWeeklyOrdersByDate"],"host":["api","marketman","com"],"query":[],"variable":[]}},"response":[{"id":"69381ba6-6d9b-4a98-b04f-17ee6a35abf1","name":"GetWeeklyOrdersByDate","originalRequest":{"method":"POST","header":[{"key":"AUTH_TOKEN","value":"{{accessToken}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \n \"DateTimeFromUTC\" : \"2022/09/26 07:00:00\",\n \"DateTimeToUTC\": \"2022/10/03 23:59:59\",\n \"VendorGuid\": \"VendorGuid\",\n \"BuyerGuid\": \"BuyerGuid\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.marketman.com/v3/vendor/weekly/GetWeeklyOrdersByDate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache"},{"key":"Pragma","value":"no-cache"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Expires","value":"-1"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-SourceFiles","value":"=?UTF-8?B?UDpcTWFya2V0TWFuXENvZGUtUm95LURldjRcYXBpLm1hcmtldG1hbi5iaXpcdjNcYnV5ZXJzXG9yZGVyc1xDcmVhdGVPcmRlcg==?="},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Wed, 06 May 2020 08:40:06 GMT"},{"key":"Content-Length","value":"145"}],"cookie":[],"responseTime":null,"body":"{\n \"Schedule\": {\n \"DateTimeFromUTC\": \"2022-09-26T07:00:00Z\",\n \"DateTimeToUTC\": \"2022-10-03T06:59:59.998Z\"\n },\n \"Orders\": [\n {\n \"DeliveryDate\": \"2022-09-26T00:00:00\",\n \"Items\": [\n {\n \"CatalogItemID\": 000000,\n \"CatalogItemCode\": 222222,\n \"ItemName\": \"Pizza rolls\",\n \"SKU\": \"555555\",\n \"Quantity\": 1.0,\n \"ItemMeasureTypeID\": 35,\n \"ItemMeasureTypeName\": \"EA\",\n \"PackQuantity\": 1.0,\n \"PacksPerCase\": null\n },\n {\n \"CatalogItemID\": 111111,\n \"CatalogItemCode\": 333333,\n \"ItemName\": \"Box of tomatoes / 100\",\n \"SKU\": \"444444\",\n \"Quantity\": 1.0,\n \"ItemMeasureTypeID\": 35,\n \"ItemMeasureTypeName\": \"EA\",\n \"PackQuantity\": 1.0,\n \"PacksPerCase\": null\n \n }\n \n ]\n }\n ]\n}"}],"_postman_id":"5749ecfe-e9b7-4c76-9dcb-fc9e50cbcb36"}],"id":"9ecbaa45-eb93-4cac-ae23-0d167aafbb1c","_postman_id":"9ecbaa45-eb93-4cac-ae23-0d167aafbb1c","description":""},{"name":"Categories ","item":[{"name":"GetCategories","id":"34a64c8b-b2d0-4504-8667-29171f79f6eb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"key":"AUTH_TOKEN","type":"text","value":"{{accessToken}}"}],"body":{"mode":"raw","raw":"{\r\n\t\"BuyerGuid\": \"{{buyerGuid}}\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://api.marketman.com/v3/vendors/products/GetCategories","description":"Gets all categories
\nDelete a category
\nCreate/Update a category
\nVendor categories mangement
\n","event":[{"listen":"prerequest","script":{"id":"be3b3d54-4109-4fc3-8e13-8a5b12d50441","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"f98c4847-578c-411e-927c-a141e333a65c","type":"text/javascript","exec":[""]}}],"_postman_id":"0b6cb4f7-6423-4764-928c-6425f90260ce"}],"id":"17402f34-01df-40ce-b3f7-c19ca3dfe89c","description":"The Vendor API use to manage Vednors data
\n","event":[{"listen":"prerequest","script":{"id":"d302ad70-f547-45d1-a954-6676ef58be66","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"010e9faf-6406-4afc-8bd0-f5765ae08508","type":"text/javascript","exec":[""]}}],"_postman_id":"17402f34-01df-40ce-b3f7-c19ca3dfe89c"}],"event":[{"listen":"prerequest","script":{"id":"473ecbcc-f02c-418f-9df0-40246417e975","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"1ec9a605-ee6c-408a-933e-017e54c0394e","type":"text/javascript","exec":[""]}}],"variable":[{"key":"baseUrl","value":"https://api.marketman.com"}]}