Establishing a connection for exchange/synchronization


Back in 2022, Shopify changed the configuration method of connectivity between external applications and online stores. Until now, MetaKocka was connected with the Shopify online store via ''Private apps''. That method was suspended in 2022 and changed with a new type of access, named ''Custom apps''. All the functions and permissions stay the same though.


All Shopify online stores that you had connected to MetaKocka up to now will function further on with no changes. Changes will impact online stores that will be connected to MetaKocka for the very first time and that consequently have no ''Private apps'' connected to MetaKocka.



Instructions: Connection method and setting via Private apps (connections until and including 2021)

Instructions: Connection method and settings via Custom Apps (2022 and onwards)


KEY STATEMENT FOR 2024


On January 24th, 2024, Shopify updated its policy for collecting the personal data of its customers in Shopify online stores. Customers who launched their Shopify online store(s) before this date can peacefully use MetaKocka as before. However, for customers who opened their Shopify online store(s) after this date, new rules were adopted: to allow access to customers' data to custom/private apps (such as MetaKocka, which transfers orders and consequently customers' data) an owner of the online store must obtain a plan higher than the Basic one. All the owners of the online stores that were launched after the above-mentioned date and at the same time are run by Shopify Basic plan or lower, stopped receiving customers' data which consequently prevents their orders from being successfully transferred to their stores. For all of our customers who came across such an issue, we are already searching for a solution to this problem, namely through other methods of collecting data from Shopify online stores.


More information can be found here: https://beta-help.shopify.com/en/manual/apps/app-types/custom-apps

The key takeaway from Shopify is: 


In spite of Shopify stating on its web pages that for customers who opened their Shopify accounts before the above-mentioned date, a few cases appeared, where Shopify stopped returning data about customers when communicating/obtaining orders. We advise all of our customers who encountered this issue and consequently are unable to transfer their orders, to directly contact Shopify support stating that you became their customer before 24.1.2024 and that you are using a custom app requesting from them to re-enable sending of customers' data when transferring the orders through REST Admin API / GraphQL API.

The following error may appear when transferring an order. In such a case you are presented with the following options:
1. If you opened the store before 24.1.2024, you may send a request to Shopify support describing the issue. The template can be found below. If you opened the store after 24.1.2024, only (2) is the remaining option.


Dear Shopify,

You have changed your policy for retrieval of customer information via REST Admin API / GraphQL Admin API (we are using version 2023-10). Since 24th January of 2024 (based on https://beta-help.shopify.com/en/manual/apps/app-types/custom-apps), you have hidden customer information on responses for all plans that are Basic or lower. 

This is where we have a problem. Our Shopify store and account are older than that specific date, so we don't understand why are our customer data not visible in API responses. We are using a Custom app (Private app) and we should, based on your public information (https://beta-help.shopify.com/en/manual/apps/app-types/custom-apps) be able to receive our customer data.

We'd like to ask you to fix this as soon as possible since our selling process has stopped completely because of this problem on your part.

Kind regards,

<<company>>

2. Upgrade your plan to "Shopify" or a higher one- https://www.shopify.com/pricing
 


Product synchronization

To transfer the product to MK, the product must have configured the following

  • publish scope must be "global". If web, mobile, or something else is selected, you may receive the following error - "Product "Water" is not on sale".
  • the product must have the name and unique SKU code

More information about functionality can be found here


Stock synchronization

In the case of issues with stock synchronization (supplies are not synchronized), it is most important to check whether the appropriate permissions are activated for you on the previously added Shopify ''Private apps''. Important permissions for stock synchronization are: 

Permission must be set on "Read and write".


Mapping Product fieldsPreslikava polj Artikla MetaKocka <> Shopify


MetaKockaShopify Note
Code
SKU.

Product nameName 
QuantityQuantity 
PricePrice.Since it already contains tax, the price is always entered as gross in MK. Tax information could also be sent on request. If that one is not configured, the product has 0 assigned for tax. 
Selling, PurchasingNot specifiedSpecifying whether the product is selling or purchasing one is mandatory in MK. When adding a new product, it is always specified whether it is selling or purchasing one.
Unit of measurementNot specifiedIf the user has a default value set for the unit of measurement, then that one is used. Otherwise, ''piece'' is used.


Data in Shopify does not contain tax rates, hence shipping costs in Shopify are considered as gross amount in MK, and the default tax rate of the company is assigned. 


Price synchronization

Price synchronization operations from MetaKocka to Shopify transfer gross prices.


Setting up order prefix


In case of having more online stores, we suggest to set up a prefix for each order.

Instructions (source: https://www.speakinginbytes.com/2017/11/shopify-order-numbers/) :


Mapping tax rates

If the online store does not send tax information, the default tax rate from MetaKocka is used for the products belonging to an order. Otherwise, the tax rate may also be configured in the online store (for both products and shipping costs) and only that one will be mapped to MK tax labels accordingly. The following tax rates are supported:


Label
MK Tax rate
0.2222%
0.0959,5%



Still not a MetaKocka user? Register now and test functionality for 30 days free of charge