Wolt

learn how to connect wolt to engini, allowing businesses to connect their own software through engini to wolt’s delivery network and marketplace getting started with wolt prerequisites a wolt account active access token connecting engini to wolt enter your engini account at https //app engini io https //engini io/ navigate to connections page by clicking on the connections on the left side bar or by clicking here https //app engini io/connections click on the “new integration” option located at the top bar choose “wolt” option from available applications enter the following details in the “new integration” form connection name – a unique identifier for the connection within engini environment choose one of the environment production the production environment is the "live" version of the api where real business happens sandbox the sandbox is your "practice field " it is an isolated testing environment where you can build and test your application without any real world consequences api url the base url provided by wolt depending on the environment you selected above venue id your id will be paste automatically after sign in signin click signin and log in with the wolt account used to create the project this ensures access to the correct oauth credentials and permissions click on the save button to the save the connection trigger order notification trigger a webhook message sent from wolt to engini whenever an order's status changes add conditions click add conditions to define conditions that narrow down the data list and return only the relevant items to learn more about using filters, click here https //help engini ai/workflow editor#add conditions actions accept order sent from your system to wolt to confirm you have received and started preparing the order order id provide the unique identification string for the order you are accepting add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields create a menu this activity sends your entire list of products, prices, and categories from your system to wolt venue id provide a unique identification code assigned by wolt to a specific venue add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields objects array https //help engini ai/wolt#initialize object array fields some fields in the create a menu activity are object arrays, meaning they accept a list of objects, not a single value categories\[] (required) the menu must include at least one category each category is added as a separate object inside the categories array name\[] / description\[] (translations) category and item names are provided as translation arrays each entry includes a language (lang) and its text value (value) nested objects a category can include additional nested data such as items, availability windows, and item configuration these are also defined as arrays inside the parent object how to build the structure start by initializing the object array (e g , categories) then append one object at a time (one category, one item, etc ), following the same nesting hierarchy required to create a valid menu, the following fields are required currency primary language categories each one of them is an array of objects the array is initialized using initialize object array https //help engini ai/wolt#initialize object array , and each object is added to it with append to object array https //help engini ai/wolt#append to object array in case of a single object, the append to object array is not required get current delivery provider this activity checks and retrieve who is currently responsible for delivering your orders get menu this activity retrieve the current menu that is live on the wolt venue id provide a unique identification code assigned by wolt to a specific menu get order this activity retrieve the complete details of a specific order from wolt order id provide a unique identification code assigned by wolt to a specific order get timeslots for next 7 days for a venue this activity retrieves the schedule of available delivery or pickup windows for a specific store over the coming week get venue status this activity retrieves whether a specific store is currently open and able to receive new orders on the wolt app mark deposits returned this activity tells wolt that you have successfully returned the deposit to a customer for a specific order order id provide a unique identification code assigned by wolt to a specific order add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields object array fields items \[] required, list of returned deposit items is an array of objects the array is initialized using initialize object array https //help engini ai/wolt#initialize object array , and each object is added to it with append to object array https //help engini ai/wolt#append to object array in case of a single object, the append to object array is not required mark order delivered this activity tells wolt that the order has been successfully handed over to the customer order id provide a unique identification code assigned by wolt to a specific order mark order ready this activity notifies wolt that the order has been prepared and is now waiting to be picked up order id provide a unique identification code assigned by wolt to a specific order mark pickup completed this activity tells wolt that the courier or customer has physically picked up the order from your store order id provide a unique identification code assigned by wolt to a specific order reject order this activity allows you to decline an order order id provide a unique identification code assigned by wolt to a specific order add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields update delivery provider this activity update the delivery provider add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields update menu's item inventory this activity lets you quickly update how much of a specific item you have left in stock venue id provide a unique identification code assigned by wolt to a specific menu add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields object array fields data \[] item inventories to update you must define either external id, gtin or sku fields for each item to update is an array of objects the array is initialized using initialize object array https //help engini ai/wolt#initialize object array , and each object is added to it with append to object array https //help engini ai/wolt#append to object array in case of a single object, the append to object array is not required update menu items update specific fields of menu items venue id provide a unique identification code assigned by wolt to a specific menu add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields object array fields data \[] item inventories to update you must define either external id, gtin or sku fields for each item to update is an array of objects the array is initialized using initialize object array https //help engini ai/wolt#initialize object array , and each object is added to it with append to object array https //help engini ai/wolt#append to object array in case of a single object, the append to object array is not required update menu options update specific fields of menu options venue id provide a unique identification code assigned by wolt to a specific menu object array fields data \[] item inventories to update you must define either external id, gtin or sku fields for each item to update is an array of objects the array is initialized using intialize object array, https //help engini ai/wolt#initialize object array and each object is added to it with append to object array https //help engini ai/wolt#append to object array in case of a single object, the append to object array is not required update time slot order capacities for a venue update order capacities for given timeslots for a venue add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields update venue online update the online status of the venue this can be used to manually toggle a venue online or offline add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields update venue opening times update the opening times of the venue add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields object array fields availability \[] venue's operating hours is an array of objects the array is initialized using intialize object array https //help engini ai/wolt#initialize object array , and each object is added to it with append to object array https //help engini ai/wolt#append to object array in case of a single object, the append to object array is not required initialize object array this activity initializes an object array in wolt and stores a single structured entry based on the selected object type variable name choose a significant name object element type this field defines the type of data the array will store, such as addresses and emails the selected type determines the structure of the array and its use in subsequent actions add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields append to object array this action allows you to add a new item to an existing object array within your workflow variable select the variable that contains the object array you want to append to the chosen variable should already be defined in your workflow add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields map object array we use this activity when there is an array of data that requires transformation into a different structure data list choose a data list that you’ve obtained from previous activities in your workflow this data list contains an array of objects that you want to process and transform object name define the type of objects from the drop down that will be stored within the array according to the object element type you chose, the fields in step 3 will be defined to learn more about object element types, go to ‘object element types’ add field click add field to add and populate additional fields for the selected activity to learn more about managing activity data, click here https //help engini ai/workflow editor#add fields send api request the send api request action allows you to call any wolt api endpoint directly, giving you full control over the url, http method, headers, query parameters, and request body base url – the salesforce instance domain that serves as the root for the api call relative url – the specific api path appended to the base url (for example, a rest resource) method – the http method used for the request (get, post, put, patch, delete) body type – defines the content type of the request payload (commonly application/json) body – the request payload sent to salesforce, structured according to the selected api endpoint add headers – used to include additional http headers such as authorization or custom headers add queries – adds query string parameters to the request url