FreshKDS implementation in Node.JS.
This plugin was built on the documentaton from FreshKDS Developer Documentation
The author of this software is not affiliated with FreshKDS or its associates in any way.
https://www.npmjs.com/package/freshkds
npm install freshkds
var freshKDS = require("freshkds");
Before running any functions you need to create a new token to pass later. freshKDS.token requires three parameters,
- demo or production
- Your API key
- Return method in which you will store your token for later use.
var freshKDS = require("freshkds");
var token;
freshKDS.token("demo",APIKEY,(returns) => {
token = returns;
});
This method will return any valid KDS devices and associated ID's You will need to pass your token as previously mentioned
freshKDS.token(token,(returns) => {});
This method will return a list of all locations. Same situation! Pass your token like before
freshKDS.getKDSLocations(token,(response) => {});
Returns all devices at a location. Along with your token, you also need to pass a location ID to this method.
freshKDS.getKDSLocationDevices(token,location,response){});
Returns all active orders by location and (optionally) device If you would like to get all devices at a location, pass "all" in your device parameter instead of a device ID.
freshKDS.getKDSActiveOrders(token,location,device,(response)=>{});
This (WIP) order managment will help you establish order objects instead of manually coding for them. If you would like to manually code these, please follow the documentation at Send-KDS-Order
All order management functions are provided under a subpackage freshKDS.orderManager.*
The bare minimum for an order to be processed through FreshKDS is in the "Start Order Function"
freshKDS.orderManager.startNewOrder(id,orderName,time,mode,name,qty,mods,terminal,(returns) => {
console.log(returns);
});
The parameters are as follows
- ID (Self generated, UNIQUE, Integer) EX: 001
- orderName (Customer Name or External Order Number, String) Ex: John Smith
- DateTime of Order (ISO 8601 FORMAT, STRING/DATETIME OBJECT) I recomend using Moment.JS to generate these Info
- Mode of Order -- Accepts one of the Following (For Here, ToGo, Pickup, DriveThru, Delivery, CurbSide) (STRING)
- Name of Item (First item in order), follow next function to add more items to this order. (STRING) Ex: Large Expresso
- Quantity of Items (First item in order) EX: 1
- Modifications of order, if none use [] IN ARRAY FORMAT (ARRAY) Ex: ["No Whip Cream"].
- Terminal ID See "Get KDS Location Devices" (STRING)
This will transmit your order to KDS and respond with a status.
function sendKDSOrder(token,order,location,device,response => {
console.log(response);
});
The following additional and optional functions are avaible for order managmenet All of the following can be reviewed here
freshKDS.orderManager.startNewItem(name,qty,mods,returns){}; // creates a new item object
freshKDS.orderManager.addItemsToOrder(order,items,returns){}; // adds item object to order
freshKDS.orderManager.addPickupTime(order,pickupTime,returns){}; // adds phone number to order
freshKDS.orderManager.optInForSMS(order,optIn,returns){}; // adds SMS messaging provided by freshKDS
freshKDS.orderManager.addDeliveryAddress(order,address,returns){}; // adds a delivery address
freshKDS.orderManager.addServer(order,server,returns){}; // adds a server name to an order
freshKDS.orderManager.addSource(order,source,returns){}; // adds a source to an order
freshKDS.orderManager.addSpecialInstructions(order,specialInstructions,returns){}; // adds special instructions to an order
freshKDS.orderManager.addCustomerArrivedUrl(order,customerArrivedUrl,returns){}; // adds customer arrived url instructions to an order
freshKDS.orderManager.freshKDS.orderManager.addVehicleModel(order,vehicleModel,returns){}; // adds vehicle info to order
freshKDS.orderManager.addVehicleColor(order,vehicleColor,returns){}; // adds vehicle color to an order
freshKDS.orderManager.addCosts(order,costs,returns){}; // adds unit costs to an order
freshKDS.orderManager.addDeliveryService(order,deliveryService,returns){}; // adds delivery service information to an order
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent