Company logoCentru de Ajutor
Vizitează idealog.ro

Integrare shopify

6 min. cititultima actualizare: 12.16.2025

Sistemul WMS are posibilitatea sa se integreze cu site-urile online dezvoltate in platforma Shopify.

Pentru a putea prelua date din Shopify este necesar ca modulul EDI sa fie activat.

Preluarea comenzilor din Shopify se face prin 2 metode in functie de planul de Shopify utilizat:

Direct prin apelul API-ul Shopify

Aceasta metoda merge doar daca se se folosesc  planurile Shopify Advanced sau Plus. Prin aceasta metoda, WMS-ul apeleaza API-ul Shopify si preia comenzile. In planurile inferioare nu se poate folosi aceasta modalitate deoarece Shopify nu ofera informatii complete despre adresa clientului (bineinteles daca adresa nu este importanta se poate utiliza si aceasta metoda de integrare).

Configurare acestui pas este obligatorie, oricare ar fi planul de Shopify utilizat.

Configurare in WMS:

  1. Se adauga o aplicatie externa de tip Shopify si se activeaza.

Configurare in Shopify:

  1. Se conecteaza in Shopify cu un utilizator cu drept de admin in pagina de administrare 
  2. Se selecteaza meniul "Apps and sales channels"
  3. Se selecteaza optiunea "Develop apps"
  4. Se creaza o aplicatie nou (butonul "Create an app") cu o denumire sugestiva
  5. Se seteaza aplicatiei drept pe urmatoarele:
    • write_assigned_fulfillment_orders
    • read_assigned_fulfillment_orders
    • read_customers
    • write_fulfillments
    • read_fulfillments
    • write_inventory
    • read_inventory
    • write_merchant_managed_fulfillment_orders
    • read_merchant_managed_fulfillment_orders
    • read_orders
    • read_products
    • write_returns
    • read_returns
    • read_shipping
    • write_third_party_fulfillment_orders
    • read_third_party_fulfillment_orders
    • write_custom_fulfillment_services
    • read_custom_fulfillment_services
    • write_fulfillment_constraint_rules
    • read_fulfillment_constraint_rules

Prin configurarea unor WebHook-uri in pagina de administrare Shopify

Aceasta metoda presupune ca la adaugarea, modificarea, sau anularea unei comenzi in Shopify acesta va apela aplicatia WMS si va trimite un mesaj cu datele comenzii. Metoda se poate utiliza indiferent de planul Shopify folosit.

Configurare in WMS:

  1. Se fac configurarile de la pasul de mai sus
  2. Se creaza un utilizator cu rol de API si cu drept pe proprietar
  3. In plus, la aplicatia externa configurata in WMS, se genereaza un token extern (in campul token extern exista un butonas care genereaza o valoare random) si se copiaza valoarea tokenului.

Configurare in Shopify:

  1. Se conecteaza cu un utilizator cu drept de admin in pagina de administrare Shopify
  2. Se selecteaza meniul "Notifications"
  3. Se selecteaza optiunea "Webhooks"
  4. Se apasa pe "Create webhook" si se selecteaza urmatoarele optiuni:
    • Event: Order creation, Order update, Order edit
    • Format: JSON
    • URL: https://adresa aplicatiei/api/shopify/metoda/cod aplicatie?auth=[user si parola in base64]&token=tokenul extern
      • metoda:
        • Order creation: createOrder
        • Order creation: updateOrder
        • Order creation: editOrder
      • cod aplicatie - codul aplicatiei Shopify configurata in WMS.
      • user si parola in base64 - in WMS se creaza un utilizator cu rol Api si se aloca drept pe proprietarul dorit. 
        Se ia denumirea de utilizator si parola si formeaza un text de forma "user:parola". Acest text trebuie encodat in base64 (se poate utiliza https://www.base64encode.org/)
      • tokenul extern - reprezinta valoarea din campul Token extern din aplicatia Shopify configurata in WMS
  5. Se mai creaza un webhook pentru stergerea de comenzi din Shopify si se selecteaza urmatoarele optiuni:

Daca apelul preluarea de comenzi se face prin configurarea unui WebHook in pagina de administrare Shopify, in WMS, nu este posibil reimportul manual al comenzilor.

Daca exista comenzi care se livreaza la persoane juridice si se foloseste un plan mai mic (care nu permite ca la crearea comenzii sa existe informatii complete despre persoana juridica), se recomanda sa se activeze modulul din aplicatie "Companies VAT checker" care atunci cand intalneste o comanda pentru o comanie, incearca sa obtina datele companiei dupa codul fiscal.

Actualizarea comenzilor: chiar daca din Shopify se trimit prin webhook informatii despre actualizarea/modificarea comenzilora cestea nu sunt preluate automat in WMS din motive de organizare operationala (comanda poate fi deja in pregatire sau chiar pregatita si din cauza ca persoana care face modificarea nu primeste nici un feedback daca in WMS s-a reusit sau nu ar duce la diferente de informatii intre WMS si Shopify).

Dupa adaugarea in WMS a unei comenzi (indiferent de metoda de integrare) in Shopify se va adauga la nivel de comanda tag-ul "created_in_wms" si se notita "Order imported in WMS 2025-05-05 21:27:46"

 

 

Filtrare comenzi importate/primite din Shopify

In cazul in care se importa o comanda din Shopify (WMS-ul apeleaza API-ul Shopify) sau sunt primite de la Shopify prin webhook si se doreste sa se aplice anumite filtre asupra comenzii (filtre care sa nu permita crearea unei comenzi in WMS) se poate face urmatorul lucru: se adauga in metoda ImportOutbounds, in campul filtre, criteriul de filtrare dorit. 

Un criteriu de filtrare este de forma [nume camp comanda]=[valoare camp comanda] sau [nume camp comanda]!=[valoare camp comanda].
Daca [valoare camp comanda] nu este completat, filtrul este ignorat.

Acest camp accepta mai multe criterii de filtrare separate prin ; sau , (de exemplu: tags=wms_ready;status=open).

In momentul de fata sunt implementate urmatoarele campuri din comanda;

  • tags - acest camp poate sa aiba mai multe valori (separate prin virgula). Se verifica oricare dintre aceste valori.

Export rezultat comenzi client

Daca nu trebuie sa se trimita si bifa "notifyCustomer" la trimiterea unui fulfillment, adica sa nu se trimita notificare catre client ca s-a pregatit comanda, se vor face urmatoarele configurari:

  • se intra in metoda export outbounds
  • se adauga o mapare cu urmatoare setari:
    • Camp sursa (sourceField) = notifyCustomer
    • Camp destinatie (destinationField) = notifyCustomer
    • Format destinatie = 0

Export retururi initiate in WMS

Retururile de la clienti care sunt initiate din WMS si receptionate se vor trimite automat catre Shopify prin mesajul de anulare comanda (in shopify se va anula comanda).

Daca comanda a fost achitata online, utilizatorului din WMS ii va aparea un mesaj de eroare si nu va putea inchide comanda pana nu se va faca refund in shopify. Daca se doreste ca sa nu se mai faca aceasta verificare, trebuie sa se adauge in tag-urile comenzii din Shopify valoarea "wms_without_refund".

Daca se reuseste confirmarea returului se va adauga in Shopify, la nivel de comanda, tag-ul returned_in_wms.

Pentru ca sa se faca exportul retururilor, trebuie ca in WMS sa se configureze metoda "ConfirmOutboundReturned".

 

 

A fost util acest articol?