How to work with the plugin

General information on working with the plugin.

Step-by-step Instructions

  1. 1.
    Open the plugin settings WooCommerce -> Settings -> iikoCloud (tab General). Enter API-key. Click the Save Changes button.
  2. 2.
    Go to the plugin page WooCommerce -> iikoCloud and click the Get Organizations button.
  3. 3.
    Select the required organization and click the Get Terminals button.
  4. 4.
    Select the required terminal and click the Get nomenclature button.
  5. 5.
    Select the desired groups and click the Import Selected Groups and Products button. The selected groups and products they contain will be uploaded to the site.
  6. 6.
    Click the Get Cities button.
  7. 7.
    Select the city for which you want to load streets and click the Get Streets button.
  8. 8.
    Click the Get Payment Types button.
  9. 9.
    Click the Update Webhooks Settings button.
  10. 10.
    Enter the default street name in the plugin settings (tab Export). It will be used when the client enters a street name that is not in iiko. This street must be added to iiko.
  11. 11.
    Fill in the WooCommerce payment method codes corresponding to the iiko payment types in the plugin settings (tab Payment). For example, the settings for the standard Cash payment method are available at /wp-admin/admin.php?page=wc-settings&tab=checkout&section=cod, where cod stands for the Cash payment method.
  12. 12.
    Check Import nomenclature automatically and set recurrence period in the plugin settings (tab Auto import) if you want to use it.
  13. 13.
    Check Use webhooks and check StopListUpdate in the plugin settings (tab Webhooks) if you want to use it.
  14. 14.
    Orders are exported to iiko automatically when placing orders on the website.

Notes

  1. 1.
    You can upload an item to the site without selecting a terminal, but it is impossible to export orders to iiko without specifying a terminal.
  2. 2.
    Groups highlighted in green are optional to load, since these are modifier groups loaded as individual attributes of goods. Strikethrough groups - marked for deletion in iiko.
  3. 3.
    The plugin settings contain the names and IDs of the selected organization, terminal and city, as well as the number of loaded streets. These fields are not available for editing in the plugin settings and are filled in automatically:
    • the name and ID of the organization and the terminal - by clicking on the Get Nomenclature button;
    • city name and ID, as well as the number of loaded streets - by clicking on the Get Streets button.
  4. 4.
    When placing an order, the fields Name, Phone, Address, and Address line 2 must be required.
  5. 5.
    The phone number must start with the "+" symbol and be at least 8 digits long.
  6. 6.
    To change a customer's phone when exporting an order, you can use the wc_iikocloud_order_phone filter.
  7. 7.
    To change a customer's data when exporting an order, you can use the wc_iikocloud_order_customer filter.
  8. 8.
    To add the date and time of order preparation when exporting orders, you can use the wc_iikocloud_order_complete_before filter.
  9. 9.
    To add additional address data when exporting orders, you can use the wc_iikocloud_order_delivery_point filter.
  10. 10.
    To add additional data to the comment when exporting orders, you can use the wc_iikocloud_order_comment filter.
  11. 11.
    To add the number of guests when exporting orders, you can use the wc_iikocloud_order_guests filter.
  12. 12.
    To add payment methods when exporting orders, you can use the wc_iikocloud_order_payments filter or use the logic implemented by the plugin.
  13. 13.
    To process table numbers in orders use filter wc_iikocloud_order_table_ids.
  14. 14.
    Supports downloading a list of streets for one city.
  15. 15.
    Photo size uploaded in iiko should be less than 10 MB (iiko restriction).