Download the PHP package shopgate/cart-integration-shopware6 without Composer

Shopgate Shopware6 Integration

Install

Packagist install (recommended)

This plugin is available on packagist.org. To install simply add the composer package to the shopware's root composer:

Afterward just increment the plugin version inside root/composer.json, and run composer update to get the latest version.

Folder install

It can be installed manually by copying the plugin folder to custom/plugins directory. Like so custom/plugins/SgateShopgatePluginSW6. Then you can install & enable like any other plugin. For this install method, please make sure that there is a vendor directory inside the plugin folder as we have composer dependencies. You could do it yourself by running:

Composer symlink (development)

Place the plugin in the custom/plugins folder. You can now link it to composer by running this command in the root directory:

Enable & Activate

Install and activate the module:

You may install and activate via the Shopware administration panel instead, if you prefer.

Indexing

A full re-index is required after installation or update to 3.3.0+ for product->category export to work. Can be done via Admin: Admin > Settings > System > Cache & Indexes > Update Indexes

Can be done via CLI:

Can also be done with the API as well, see tests/Postman/indexer_check.collection.json for details

Known errors

• No SaleChannel domain exists corresponding to the SaleChannel default language - indicates an issue when there is a default language set for a domain, but no domain URL exists that has that language. In short:
  1. go to SalesChannels
  2. select SaleChannel that is being queried by Shopgate API
  3. Check General Settings default language (e.g., English)
  4. Check Domains list, see that there is no domain URL with default language (e.g., English)
• Cannot declare interface XXX, because the name is already in use - happens after installing of our plugin via symlink. This is because there is a vendor directory inside our plugin folder. Either remove vendor directory from our plugin directory or do not install via symlink. These are two different ways of installing our plugin.
• ConstraintViolationException: Caught 1 violation errors during a check_cart or customer registration. One of the known errors is when the Shopgate App does not require the phone number to be set, but the Shopware does. So when the check_cart attempts to create the address a constraint violation occurs.
• Export prices are too long (e.g. "unit_amount":2.3999999999999999) - there is a server setting that should help narrow down prices to 3 decimals, in short try php.ini setting serialize_precision = -1. Link to issue on stack.

Configuration

Administration

Export

• Flysystem - uses Flysystem to write SDK file export

Email template variable usage

For create order emails:

Set settings API

• server - live, pg or custom
• api_url - http://my.url.com
• product_types_to_export - simple,variant (a comma separated list)

Custom fields

These values can be set inside Shopgate admin panel or script to pass to Shopware & will bind to the Entities. One can also pass non-existing or existing customFields to Shopware. If a Custom Set exists for an entity (e.g. Order), and it has a customField defined, it will map.

Customer

• title - customer title
• affiliate_code
• campaign_code
• account_type - business or private
• vat_ids - provide a single VAT ID, accountType must be business for this to be set

Customer Address

• department - department of a company
• phone_number - phone number can be passed via customFields as an alternative to address->phone

Order

• affiliate_code
• campaign_code
• customer_comment - a comment string from the customer