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 condition by choosing to add a condition, the workflow will only work if the condition or the number of conditions you added are met select from the drop down the field you want to add the condition on select the condition you want the record to meet click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using functions https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#rknxi and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps a d for all the fields you want to populate 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 update more fields of the item to learn more about managing activity data click here https //shared archbee space/public/preview ixqqblwfxopjg0nave78y/preview ycdmxhmvfcwesvtyflkox#managing activity data 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 update more fields of the item to learn more about managing activity data click here https //shared archbee space/public/preview ixqqblwfxopjg0nave78y/preview ycdmxhmvfcwesvtyflkox#managing activity data objects array https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview lnwrkrs8bwtcauvjjnhnq#d0mts 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 //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview lnwrkrs8bwtcauvjjnhnq#d0mts , and each object is added to it with append to object array https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview lnwrkrs8bwtcauvjjnhnq#xn8k7 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 update more fields of the item to learn more about managing activity data click here https //shared archbee space/public/preview ixqqblwfxopjg0nave78y/preview ycdmxhmvfcwesvtyflkox#managing activity data object array fields items \[] required, list of returned deposit items is an array of objects the array is initialized using initialize object array https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview lnwrkrs8bwtcauvjjnhnq#d0mts , and each object is added to it with append to object array https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview lnwrkrs8bwtcauvjjnhnq#xn8k7 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 update more fields of the item to learn more about managing activity data click here https //shared archbee space/public/preview ixqqblwfxopjg0nave78y/preview ycdmxhmvfcwesvtyflkox#managing activity data update delivery provider this activity update the delivery provider add field click add field to update more fields of the item to learn more about managing activity data click here https //shared archbee space/public/preview ixqqblwfxopjg0nave78y/preview ycdmxhmvfcwesvtyflkox#managing activity data 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 update more fields of the item to learn more about managing activity data click here https //shared archbee space/public/preview ixqqblwfxopjg0nave78y/preview ycdmxhmvfcwesvtyflkox#managing activity data 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 //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview lnwrkrs8bwtcauvjjnhnq#d0mts , and each object is added to it with append to object array https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview lnwrkrs8bwtcauvjjnhnq#xn8k7 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 update more fields of the item to learn more about managing activity data click here https //shared archbee space/public/preview ixqqblwfxopjg0nave78y/preview ycdmxhmvfcwesvtyflkox#managing activity data 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 //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview lnwrkrs8bwtcauvjjnhnq#d0mts , and each object is added to it with append to object array https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview lnwrkrs8bwtcauvjjnhnq#xn8k7 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 //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview lnwrkrs8bwtcauvjjnhnq#d0mts and each object is added to it with append to object array https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview lnwrkrs8bwtcauvjjnhnq#xn8k7 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 update more fields of the item to learn more about managing activity data click here https //shared archbee space/public/preview ixqqblwfxopjg0nave78y/preview ycdmxhmvfcwesvtyflkox#managing activity data 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 update more fields of the item to learn more about managing activity data click here https //shared archbee space/public/preview ixqqblwfxopjg0nave78y/preview ycdmxhmvfcwesvtyflkox#managing activity data update venue opening times update the opening times of the venue add field click add field to update more fields of the item to learn more about managing activity data click here https //shared archbee space/public/preview ixqqblwfxopjg0nave78y/preview ycdmxhmvfcwesvtyflkox#managing activity data object array fields availability \[] venue's operating hours is an array of objects the array is initialized using intialize object array https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview lnwrkrs8bwtcauvjjnhnq#d0mts , and each object is added to it with append to object array https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview lnwrkrs8bwtcauvjjnhnq#xn8k7 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 update more fields of the item to learn more about managing activity data click here https //shared archbee space/public/preview ixqqblwfxopjg0nave78y/preview ycdmxhmvfcwesvtyflkox#managing activity data 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 a dd field click add field to update more fields of the item to learn more about managing activity data click here https //shared archbee space/public/preview ixqqblwfxopjg0nave78y/preview ycdmxhmvfcwesvtyflkox#managing activity data 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’ a dd field click add field to update more fields of the item to learn more about managing activity data click here https //shared archbee space/public/preview ixqqblwfxopjg0nave78y/preview ycdmxhmvfcwesvtyflkox#managing activity data