Integrare shopify

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.

Configurare in WMS:

1. Se adauga o aplicatie externa de tip Shopify si genereaza un token (butonul refresh).
   • 
2. Se copiaza si se salveaza undeva urmatoarele valori din aplicatia EDI creata:
   • Adresa confirmare Shopify
   • Adresa redirectionare
   • WebHook: Adresa creare comanda
   • WebHook: Adresa anulare comanda

Configurare in Shopify:

1. Se conecteaza in Shopify cu un utilizator cu drept de admin in pagina de administrare (Settings)
2. Se selecteaza meniul "Apps"
3. Se selecteaza optiunea "Develop apps" si apoi se apasa pe "Build apps in Dev Dashboard".
   
   
4. Se va deschide platforma de DEV din Shopify.
5. Se creaza o aplicatie nou (butonul "Create app") cu o denumire sugestiva (de exemplu Idealog WMS)
   
   
6. La App URL - se pune adresa aplicatiei WMS (de exemplu https://wms.idealog.ro). Se poate utiliza Adresa redirectionare copiata mai sus din WMS.
   
   
7. La Access / Scopes - se completeaza - read_all_orders, read_assigned_fulfillment_orders, write_assigned_fulfillment_orders, read_customers, read_fulfillments, write_fulfillments, write_inventory, read_inventory, write_inventory_shipments, read_inventory_shipments, write_inventory_transfers, read_inventory_transfers, read_locations, write_order_edits, read_order_edits, read_orders, write_orders, read_product_feeds, write_product_feeds, read_product_listings, write_product_listings, read_products, write_products, read_returns, write_returns, read_third_party_fulfillment_orders, write_third_party_fulfillment_orders, customer_write_customers, read_content, read_merchant_managed_fulfillment_orders, write_merchant_managed_fulfillment_orders
   
8. Se apasa butonul Release (din partea de jos)
9. Se intra in meniu Setari (din partea stanga) si se copiaza valorile din Client ID si Secret.
   Aceste 2 valori trebuie completate si salvate in WMS in campurile Utilizator si Parola din aplicatia EDI creata mai sus.
   
10. Se intra iar in pagina de setari din Shopify si se selecteaza optiunea Notifications.
11. Se selecteaza optiunea "Webhooks"
12. Se apasa pe "Create webhook" si se selecteaza urmatoarele optiuni:
    • Event: Order creation, Order update, Order edit
    • Format: JSON
    • URL: WebHook: Adresa creare comanda - valoarea copiata mai sus din WMS
13. Se mai creaza un webhook pentru stergerea de comenzi din Shopify si se selecteaza urmatoarele optiuni:
    • Event: Order deletion, Order cancellation
    • Format: JSON
    • URL: WebHook: Adresa anulare comanda - valoarea copiata mai sus din WMS
      
14. Se ia valoarea "Adresa confirmare Shopify" copiata mai sus din WMS si se apeleaza in browser. Utilizatorul va fi redirectionat catre pagina de administrare Shopify in care ii va cere permisiunea ca sa instaleze aplicatia. Trebuie sa se apese pe butonul Install.
    
15. Trebuie sa se deschida o pagina goala cu un mesaj care confirma instalarea aplicatiei.
    Din acest moment se poate utiliza comunicarea cu Shopify.

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).

Setari auxiliare care se pot configura

In WMS, la nivel de aplicatie EDI externa, in cazul Shopify se pot seta urmatoarele setari aditionale:

• La nivel de import comenzi outbound:
  • Save beneficiary - bool - daca NU este bifata, nu se va mai crea o inregistrare in EDIPartners ca sa se creeze automat un beneficiar. Astfel comanda se va crea fara beneficiar existent in nomenclator.
    !!!! pentru ca sa functioneze, trebuie la tipul de comanda outbound sa se seteze proprietatea "Dezactiveaza salvarea beneficiarului comenzii".
  • COD by outstanding - bool - daca este bifata, nu se va mai prelua informatia despre metoda de plata din comanda ci doar se va verifica valoarea (numerica) din campul "total_outstanding". Daca valoarea este mai mare decat 0 se va considera ca, comanda este cu ramburs, se va seta aceasta valoarea ca si ramburs pe comanda, iar modalitatea de plata se va seta "CASH". Daca valoarea este 0 se va considera ca, comanda nu are ramburs si se va seta modalitatea de plata "CARD".
  • Locker ID - string - se va specifica campul din pachetul comenzii pe care il trimite Shopify catre WMS in care se stocheaza informatia despre codul sau idul lockerului. Daca nu se seteaza se ia implicit valoarea "LocationId".
    !!!! daca se utilizeaza livrarea in locker, acest camp trebuie obligatoriu de setat.
  • Locker name - string - se va specifica campul din pachetul comenzii pe care il trimite Shopify catre WMS in care se stocheaza informatia despre denumirea lockerului. Daca nu se seteaza se ia implicit valoarea "LocationName". Campul este optional si este folosit doar pentru afisarea denumirii lockerului in comanda.
  • Locker courier - string - se va specifica campul din pachetul comenzii pe care il trimite Shopify catre WMS in care se stocheaza informatia despre curierul lockerului. Daca in Shopify sunt configurate metode de livrare diferite pentru fiecare curier, atunci acest camp nu trebuie setat. Acesta se seteaza doar in momentul in care in Shopify se configureaza o singura metoda de livrare (Curier de exemplu) dar exista clientul are posibilitatea sa selecteze locker de la curieri diferiti.
    !!!! daca se seteaza, valoarea primita din Shopify va suprascrie metoda de livrare primita in comanda.

Export rezultat comenzi client

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".

Alte functionalitati

1. Modificare comanda in Shopify - de fiecare data cand se modifica o comanda in Shopify se trimite catre WMS un pachet de date cu informatiile despre comanda. 
   Daca comanda nu exista in WMS, se creaza.
   Daca insa comanda exista in WMS se fac anumite actualizari pe comanda:
   • comanda anulata in Shopify - daca comanda este anulata in Shopify se incearca anularea ei si in WMS. Daca nu se poate anula comanda (este pregatita deja), ea se marcheaza ca si anulata si nu va putea fi finalizata (va da eroare la incercarea de inchidere a comenzii sau in verificare).
   • Cod locker - daca pe comanda din Shopify este setat codul de locker, acesta se va seta si in comanda din WMS.
   • Status incasare - daca in Shopify comanda a fost marcata ca si incasata, se va marca si in WMS ca si incasata,
2. Fortare reimport comanda client din Shopify - daca se fac mai multe modificari in comanda din Shopify si se doreste sa se reimporte complet comanda in WMS, dupa ce se fac modificarile, trebuie sa se seteze, in Shopify, tag-ul "wms_reimport". Dupa ce se seteaza acest tag, pachetul de date se va trimite catre WMS iar in WMS se va incerca anularea comenzii si reimportul ei.
   Daca se reuseste anularea comenzii si reimportul ei, in Shopify se va sterge de pe comanda tag-ul "wms_reimport".
   Exista situatii in care nu se poate anula comanda in WMS (a fost deja pregatit ceva pe ea), in acest caz se va sterge de pe comanda tag-ul "wms_reimport" si se va adauga tag-ul "wms_error_reimport"