> For the complete documentation index, see [llms.txt](https://kb.bevica.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.bevica.com/documentation/integration/shopify/business_central_bevica_shopify_connector.md).
# Bevica Shopify Connector
Use Bevica’s enhancements on top of the standard Shopify connector.
The **Bevica Shopify Connector** introduces additional features to the standard Microsoft Shopify Connector to make it a more relevant experience.
{% hint style="info" %}
For the purposes of this section, **Shopify Product** relates to the product record and its details on Shopify. **Bevica Item** or **Item** relates to the item record and its details in Bevica.
{% endhint %}
### Shopify Shop Card
The Shopify Shop Card has a **Bevica** section with the following options.
| Field | Note |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Use Brand for Shopify Vendor | The standard Shopify Connector populates the Shopify Product Brand field with the Name associated to the Vendor No. attached to each Bevica item. Selecting this option will change that to use Name associated to the Item's Brand Code |
| Shop Domain / Shopify Access Token | These fields give Bevica access to update your Shopify store. Required for the Adjust Product Variants routine |
| API Version | This field will let you know which version of Shopify's API you are connected to |
| Shopify Force Unique Variant | Set this to the Variant to be retained when the Adjust Product Variants routine is run, e.g Duty Paid. See Shopify Products below |
| Check Order Amounts Match on Release | If there is a discrepancy between the Shopify Order Amount and the Sales Order Amount the order is not set to Released |
| Auto Reserve on Order Creation | If this is set the Bevica Auto Reserve function will be run when the order is created |
| Copy Shopify Order No. to External Document No. | If this is set the External Document No. on the sales order will be populated with the Shopify Order No. |
| Default Customer Dimension / Value / Value Posting | You can choose to apply a specific dimension to customers that are created via Shopify. Useful if you have a single store/channel |
| Convert Gift Message to Comment | Creates the gift message on the Shopify Order as a 'Gift Note' comment on the sales order |
| Convert Work Description to Comment (Del. Instr.) | Creates a Delivery Instruction sales order comment using the work description |
| Map Sales Line Location | If this is ticked the location on the sales lines is replaced with the Location Code in the Order Source Mappings table |
| Refund Return Reason Code | When using Enhanced Refund Processing, this is the return reason code that will be used on item sales lines which are not to be restocked. If a return reason code is used that has Automatic Neg. Adjustment set, the stock will be returned but then negatively adjusted, |
| Enhanced Refund Processing | See Bevica Shopify Enhanced Refund Processing |
| Force Duty Paid Variant on Sales orders | All sales order lines created from Shopify orders will be created with the Duty Paid variant. |
| Source Mapping Type | - Single Location - Order Source Mappings relate to a single shopify location
- Multi Location - Order Source Mappings relate to multiple shopify locations. If this is selected, additional columns for Shopify Location Code and Shopify Location Name will appear in the Order Source Mappings page
|
| Default Duty Free Ship-to Template | See [Shopify Duty Free Orders](/documentation/integration/shopify/shopify-duty-free-orders.md) |
| Default Duty Free Transaction Type | See [Shopify Duty Free Orders](/documentation/integration/shopify/shopify-duty-free-orders.md) |
| Enable GraphQL for Shopify API Calls | Tick this to change to GraphQL for API calls to remove duty variant. Note that a new Bevica App will need to be installed in Shopify in conjunction with this. See [#shopify-products](#shopify-products "mention") |
### Order Source Mappings
From the Shopify Shop page, click on Related - Source Mappings to open the Order Source Mappings page.
| Field | Note |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| App Name | This will vary depending on whether your order originated from "Draft Orders", "Online Store" or "Point of Sale" |
| Channel Name | The Channel Name will match the App Name |
| Default Order Source | To make it easier to identify Shopify Orders, select the Order Source that will be defaulted onto sales orders for the App Name/Channel |
| Check Order Amounts Match on Release | If there is a discrepancy between the Shopify Order Amount and the Sales Order Amount the order is not set to Released. |
| Location Code | If the Map Sales Line Location field on the Shopify Shop is ticked, the location on the sales lines created for the App/Channel will default to this location |
| Default | Set a default App Name/Channel |
| Shopify Location Code | This column will appear if you have set Source Mapping Type on the Shopify Shop to Multi Location. Select the relevant Shopify location code. |
| Shopify Location Name | This column will appear if you have set Source Mapping Type on the Shopify Shop to Multi Location. It will be populated with the shopify location name when the Shopify Location Code has been selected. |
### Order Source Dimensions
From the Shopify Shop page, click on Related - Source Dimensions to open the Order Source Mappings page.
| Field | Note |
| -------------------- | ------------------------------------------------------------------------------ |
| Order Source Code | Enter the relevant Order Source Code to set the dimension for |
| Location Code | Enter the relevant Location Code to set the dimension for |
| Dimension Code | Select the Dimension Code for the Order Source/Location Code combination |
| Dimension Value Code | Select the Dimension Value Code for the Order Source/Location Code combination |
### Shopify Products
Where your shop is selling purely Duty Paid stock, you may want to remove Duty Free Variants from your Shopify products. This can be achieved by setting the **Shopify Force Unique Variant** field on **Shopify Shop** to Duty Paid and running the **Adjust Product Variants** routine. This deletes the Duty Free Variant against the Shopify product. Navigate to Shopify Products page and select Actions, **Adjust Product Variants**.
{% hint style="info" %}
To run the Adjust Product Variants routine, a Bevica app will need to be installed in Shopify, depending on the **Enable GraphQL for Shopify API Calls** field on the Shopify Shop.
* If **Enable GraphQL for Shopify API Calls** is not enabled, Bevica API will need to be installed and the Shopify Shop Card's **Shop Domain** and **Shopify Access Token** must be populated.
* If **Enable GraphQL for Shopify API Calls** is enabled, Bevica Integration V3 will need to be installed, and the Shopify Shop Card's **Shop Domain**, **Shopify Client ID** and **Shopify Client Secret** will need to be populated.
{% endhint %}
### Shopify Bundles
It is possible to set an item which has a bill of materials (BOM) as a Shopify Bundle. The available inventory in Shopify will be based on the component product with the least amount of inventory in the relevant location. In addition, when the sales order for a Shopify Bundle item is created in Bevica, the BOM will automatically be exploded so the component items will be listed with the total bundle price evenly distributed across the component lines.
To set an item as a Shopify bundle:
1. Navigate to the relevant item card
2. Select **Related**, **Bill of Materials**, **Assembly**, **Assembly BOM** and ensure the relevant items have been added
3. Go back to the item card and toggle on the **Shopify Bundle Case** field
### Marketing Text
Marketing Text can be added to items, either on the item record itself or via an import routine. Any Marketing Text entered will be synchronised to Shopify. To add or amend marketing text manually, select Edit on the Marketing Text factbox on the item record.
You are also able to import item marketing text which will be synchronised to Shopify.
1. From the Shopify Shop page, click on **Actions** - **Import/Export Marketing Text**
2. Optionally filter on item/s and set the Direction to **Export**
3. This will create a csv file with the item numbers in column A and any marketing text that has already been entered in column B
4. Add any new marketing text to the relevant items. Note that you just need to add the text, not any formatting
5. Once the file is complete, save it as a **.csv** file \[CSV (Comma Delimited)]
6. Go back to the Shopify Shop page, click on **Actions** - **Import/Export Marketing Text**
7. Set the Direction to **Import**, click on OK and select the file.
8. The file will be imported and you will see the Marketing Text against the item.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://kb.bevica.com/documentation/integration/shopify/business_central_bevica_shopify_connector.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.