Shopware <> Odoo integration: User Documentation
  • Anmelden
    • 📖

    Shopware <> Odoo 17 integration: User Documentation


    Product Description can be found on the page above.

    The following documentation will provide you with the information you need to use the much. Shopware - Odoo 17 integration. The objective is to get you familiarised with the integration by providing relevant information as to the main business processes it covers, and how you can configure it to best suits your needs.


    Some of Odoo's standard features may be included in this documentation. For Odoo’s standard functionalities and instructions, we recommend you check out Odoo’s official tutorials. The same applies to the Shopware Platform itself, where we recommend you to check out the official website of Shopware and its Learning Center.

    Shopware <> Odoo 17 integration: User DocumentationQuick start guide​Odoo configuration pre-requisites​Install the much. Shopware integrationEnable the Shopware - Odoo integrationSynchronise your first productExport products from Odoo​ Import products from ShopwareImport your first orderShopware - Odoo workflowsAutomated product synchronisationAutomated order importAutomated product stock exportAutomated shipment exportAutomated return exportMulti-company supportMulti-instance support



    Quick start guide



    ​Odoo configuration pre-requisites


    For the Shopware - Odoo integration to function, please make sure that you have the following Odoo standard modules installed : 


    • Sales
    • Invoicing
    • Accounting
    • Inventory


    ​Install the much. Shopware integration


    ​1.  Install much. Integration Hub, Order base integration and much_notify modules from the Apps. 

    In Integration Hub > Settings, make sure you have the following settings enabled : 

    • iHub Logs
    • iHub Mappers

    much. Integration Hub is the base for all much. integrations. Make sure to check out the complete Integration Hub documentation here. 

                                      

    2. Install much. Shopware integration module.

    • Go to Odoo > Apps and search for Shopware. ​
    • Click Activate
    • Go to Integration Hub > Integrations and click New
    • Add an integration name
    • In the Integration Type field, select Shopware.
    • In the Company field, select the Odoo company that this integration will be applied to. 

    If multiple Odoo companies need to use an integration, you should create a new integration for each company.

    • Click Save. 





    Enable the Shopware - Odoo integration



    1. Retrieve your Shopware API credentials

    • Login to your Shopware admin account
    • Go to Settings > System > Integrations
    • Click Add Integration
    • Give it a name, enable Administrator, securely save the Access key ID and Secret access key
    • Click Save Integration



    2. Enable the integration in Odoo

    • Go back to Odoo.
    • Go to Integration Hub > Integrations > Shopware > Integration Settings.
    • In the Url field, paste your Shopware Url - ex : https://shopware.muchconsulting.com/
    • In the API key field, paste your Shopware Access key ID.
    • In the API Password field, paste your Shopware Secret access key.
    • Save.
    • Back to Integration Hub > Integrations > Shopware, click Enable Integration.


    Integration installed and enabled!



    Synchronise your first product



    Product template synchronised data


    Odoo field

    Shopware field

    Product Name

    Name

    Sales Channels

    Sales Channels

    Image

    Media Cover

    Sales Price 

    Price (gross)

    Customer Taxes

    Tax rate

    Product Category

    Categories

    Internal Reference* used to map the products

    Product number used to map the products

    Barcode*

    GTIN/EAN

    Sales description 

    Description

    Available Quantity  only Odoo to Shopware

    Stock


    *if a product has variants, the internal reference and barcode fields won't be visible in Odoo


    Product variant synchronised data


    Odoo field

    Shopware field

    Product Name

    Name

    Sales Channels

    Sales Channels

    Image

    Media Cover

    Sales Price

    Price (gross)

    Customer Taxes

    Tax rate

    Product Category

    Categories

    Internal Reference used to map the products

    Product number used to map the products

    Barcode 

    GTIN/EAN

    Sales description 

    Description

    Available Quantities only Odoo to Shopware

    Stock




    Before you start synchronising products, the 2 following steps need to be performed : 


    • Tax Mapping : in Odoo > Integration Hub > Shopware > Integration, click the Import Taxes button at the top left corner. This will allow the integration to set the proper taxes on Sales Order. Each tax in Odoo should then be set to "Included in Price".
    • Currency Mapping : in Odoo > Integration Hub > Shopware > Integration, click the Map system default currency button. This will allow the integration to map currencies between both apps.


                                        

    You are now all set to start synchronising Products.


    Export products from Odoo​

     

    • In Odoo, go to Sales > Products.
    • Open the product of your choice, open the ⚙️ ​action menu and click Export to connectors.


    • Select Shopware from the drop down menu and click Execute.




    • A pop-up appears, informing you of the successful export of the product to Shopware. You can also navigate to Integration Hub > Shopware > Logs to visualise the log associated with your recently exported product.


    Import products from Shopware


    • In Shopware admin, go to Catalogues > Products and select the product you would like to import to Odoo.
    • In the product page, copy the product ID from the page URL.

                                      


    • In Odoo, navigate to Integration Hub > Shopware and click the Import button.
    • In the Resource field, select Products.
    • If your product already exists in Odoo, select the Update existing products option. 
    • In the Specific ids field, paste the product ID from the Shopware URL.
    • Click Execute.
    • Click on the Logs or Products smart button to access your newly imported product.


    You successfully synchronised your first product!



    Import your first order

    Order imported data

    Odoo field

    Shopware field

    Order number

    Order number

    Order date

    Order date

    Order line data 

    • Product (template or variant)
    • Description
    • Quantity
    • Unit Price
    • Taxes

    Order line data

    • Product Name
    • Product Description
    • Quantity
    • Price (gross)
    • VAT

    Customer adresses (billing and shipping)

    • Name
    • Street
    • Street 2
    • ZIP
    • City
    • Country
    • Email used for matching client info

    Customer adresses

    • Name
    • Street
    • Street 2
    • ZIP
    • City
    • Country
    • Email used for matching client info


    Payment Terms

    Payment method

    Shipping data

    • Shipping method
    • Shipping cost

    Shipping

    • Shipping method
    • Shipping costs



    • In Shopware admin, go to Orders > Overview and select the order you would like to import to Odoo.
    • In the order page, copy the order ID from the page URL.



    • In Odoo, navigate to Integration Hub > Shopware and click the Import button.
    • In the Resource field, select Orders
    • In the Specific ids, paste the order ID from the Shopware URL.
    • Click Execute.
    • Click on the Logs or Orders smart button to access your newly imported order.



    You successfully imported your first order!


    Shopware - Odoo workflows


    In this section, you will learn how to use the integration in your daily workflows. 

    Automated product synchronisation

    1. Shopware to Odoo (Import)

    By default, the integration will automatically import new products from Shopware to Odoo, on a daily basis.

     To modify this scheduled action, you can go to Integration Hub > Shopware and click the Scheduled Actions smart button at the top of the page. 

    To learn more about scheduled actions configuration, make sure to check out the complete Scheduled Actions documentation here. 

    If you want the scheduled action to also automatically update existing products in Odoo when a modification is made in Shopware : 

    • Go to Integration Hub > Shopware > Integration Settings
    • In the Product Settings tab, check the Update Existing Products option.
    • Save your changes. 

    2. Odoo to Shopware (Export)

    There is no scheduled action that automatically exports your products to Shopware.

    If you manage your product information in Odoo, products must have been exported manually to Shopware at least once to enable automatic updates.

    💡 TIP - You can export products to Shopware in bulk by going to Odoo Sales > Products and selecting the list view icon on the top right corner. Once in List view, select the products to be exported, click Actions > Export to Connectors > Shopware


    💡 TIP - You can export products to Shopware in bulk by going to Odoo Sales > Products and selecting the list view icon on the top right corner. Once in List view, select the products to be exported, click Actions > Export to Connectors > Shopware

    To automatically reflect in Shopware updates that you might do on your products in Odoo : 

    • Go to Integration Hub > Shopware > Integration Settings
    • In the Product Settings tab, check the Export on save option.
    • Save your changes. 

    The option enables real-time updates of your products (template or variants) in Shopware when you make changes and save them in Odoo. 


    Automated order import

    By default, the integration will automatically import new orders from Shopware to Odoo, on a daily basis. 

    To modify this scheduled action, you can go to Integration Hub > Shopware and click the Scheduled Actions smart button at the top of the page. 

    To learn more about scheduled actions configuration, make sure to check out the complete Scheduled Actions documentation here. 

    To ensure the automated order workflow happens seamlessly, you first need to configure the integration default order settings. To do so, navigate to Integration Hub > Shopware > Integration Settings > Sales Settings.

    Default sales settings 

    • Warehouse : define the default warehouse where your products are located. This setting will be overwritten if the Products are configured to be in a different warehouse.
    • Locations : define, if applicable, the default location from which your products should be shipped within the default warehouse 
    • Shipping policy : choose whether you would like to ship an order as soon as possible, meaning that the order should have multiple shipment based on product availability, or if you prefer to ship an order in one shipment when all product are ready
    • Shipping method : define a default shipping method for your incoming orders.
    • Set prefix before order : this allows you to differentiate orders coming from Shopware by adding a prefix before the order ID. You can for example use SW as a prefix.

    Default sales workflows

    • Confirm order on import : by activating this option, all incoming orders will be confirmed automatically, which will trigger the creation of a delivery order for your warehouse to ship the order.
    • Create invoice on order import : by activating this option, all incoming orders will trigger the creation of an invoice.

    If your invoicing policy in Odoo is set to "Invoice on delivered quantities", this setting should not be activated as it will generate an empty invoice.

    After configuring all these settings, click Save.

    You are now ready to automatically receive orders!


    Automated product stock export

    After an order is imported and confirmed, the stock of the included products is updated in the Odoo Inventory App based on the quantities ordered. 

    To keep your shop up-to-date on products stock, the integration will automatically export product stock on a daily basis.

    To modify this scheduled action, you can go to Integration Hub > Shopware and click the Scheduled Actions smart button at the top of the page. 

    To learn more about scheduled actions configuration, make sure to check out the complete Scheduled Actions documentation here. 


    Automated shipment export

    After an order is imported and confirmed, a delivery order is automatically created for your warehouse to dispatch the order. Once the order is dispatched, and the delivery status is set to Done, it needs to be reflected in Shopware. 

    The integration will automatically export delivery shipment on a daily basis. 

    To modify this scheduled action, you can go to Integration Hub > Shopware and click the Scheduled Actions smart button at the top of the page. 

    To learn more about scheduled actions configuration, make sure to check out the complete Scheduled Actions documentation here. 

    Delivery shipment can also be exported in real-time. To activate this option : 

    • Go to Integration Hub > Shopware > Integration Settings
    • In the Product Settings tab, check the Auto-export Shipment option.
    • Save your changes. 


    Automated return export

    The same applies to returned orders. When an order is marked as returned in Odoo, and the associated delivery order is reversed and validated, the Delivery status in Shopware will be automatically marked as Returned.

    Your end-to-end order automated workflow is now set and running.


    Multi-company support

    If you are using Odoo with multiple companies, you can simply create a new integration for each of the companies you want to use the Shopware integration for. You can select the company in the New Integration form.


    Multi-instance support

    If you want to integrate Odoo with multiple Shopware instances, you can simply create an new integration for each instance. You can fill the connection settings of each instance after creating the integration.