Skip to main content

Swotzy integracija

Jei naudojate Swotzy savo siunčiamų paketų valdymui, galite jį prijungti prie Baltix. Kai klientas atsiskaitymo metu pasirenka atsiėmimo punktą, Baltix automatiškai atnaujins atitinkamą užsakymą Swotzy su teisingais vežėjo, paslaugos ir paketų parduotuvės duomenimis.

PICKUP ONLY režimas

Skirtukas External Provider matomas tik tada, kai jūsų programa veikia Pickup Only režimu. Jei nematote skirtuko, eikite į Settings > General ir perjunkite programos režimą.

Išankstinės sąlygos

1. Swotzy paskyra su API prieiga

Sukurkite paskyrą Swotzy.

2. Gauti Swotzy API raktą

  1. Eikite į kairįjį šoninį meniu.
  2. Spustelėkite skirtuką Integrations (1).
  3. Spustelėkite meniu elementą API (2).

  1. Sukurkite naują API raktą.

  1. Išsaugokite (3) Public key ir (4) Private key.
  2. Tada eikite į Prijungti Swotzy

3. Nustatyti produkto svorį ir matmenis Shopify

Būtina kiekvienam produktui

Kiekvienas produkto variantas jūsų Shopify parduotuvėje privalo turėti sukonfigūruotą svorį ir pakuotės matmenis (ilgį, plotį, aukštį). Baltix siunčia šiuos duomenis į Swotzy atnaujinant užsakymą — jei jų nėra, Swotzy gali atmesti siuntą arba naudoti neteisingas numatytąsias reikšmes.

Norėdami juos nustatyti:

  1. Eikite į Shopify admin > Products
  2. Atidarykite produktą ir slinkite iki skyriaus Shipping
  3. Užpildykite laukus Weight, Length, Width ir Height
  4. Pakartokite kiekvienam produkto variantui

4. Įjungti nustatymą „Display store order ID on label"

Svarbus Swotzy nustatymas

Savo Swotzy informaciniame skydelyje privalote įjungti "Display store order ID on label" integracijos nustatymuose. Baltix naudoja Shopify užsakymo numerį užsakymams Swotzy suderinti — be šio nustatymo suderinimas nepavyks ir atsiėmimo punkto duomenys nebus perkelti.

Kaip įjungti nustatymą

  1. Eikite į kairįjį šoninį meniu
  2. Spustelėkite skirtuką Integrations (1)
  3. Spustelėkite meniu elementą Stores (2)

Swotzy integration menu

  1. Spustelėkite mygtuką Manage prie savo Shopify svetainės (3)

Manage shopify website

  1. Tada įjunkite Display store order ID on label

Enable settings

  1. Nepamirškite išsaugoti spausdami mygtuką Save puslapio apačioje.

Save settings

Prijungti Swotzy

  1. Eikite į Baltix integracijų skirtuką Settings.

  1. Tada External Provider (5).
  2. Laukelyje (6) įveskite Public key iš (3).
  3. Laukelyje (7) įveskite Private key iš (4).

  1. Spustelėkite Test connection, kad patikrintumėte, ar prisijungimo duomenys galioja
  2. Spustelėkite Save

Išsaugojus, prie pavadinimo atsiranda žalias ženkliukas Connected.

Siuntimo kainos apribojimas

Dėl Shopify platformos apribojimo šiuo metu neįmanoma dinamiškai koreguoti siuntimo kainos pagal kliento pasirinktą vežėją. Atsiskaitymo metu rodoma siuntimo kaina yra ta, kurią sukonfigūravote savo Shopify siuntimo nustatymuose, nepaisant to, kurį vežėjo atsiėmimo punktą pasirinko klientas.

Peržiūrėkite Siuntimo metodo sąranką, kad sukonfigūruotumėte savo siuntimo kainas

Norėdami užbaigti sąranką, sekite šiuos vadovus:

Kaip tai veikia

Kai klientas pateikia užsakymą ir pasirenka atsiėmimo punktą:

  1. Baltix gauna Shopify webhook su užsakymo duomenimis
  2. Fono užduotis ieško atitinkamo užsakymo Swotzy (pagal užsakymo numerį arba kliento el. paštą)
  3. Užduotis atnaujina Swotzy užsakymą su:
    • Vežėju (Omniva, DPD, Latvijas Pasts ir kt.)
    • Paslaugos tipu (PARCELSHOP)
    • Pasirinktu paketų parduotuvės ID
    • Kliento telefono numeriu
    • Pakuotės matmenimis (iš produkto varianto duomenų, jei prieinami)

Jei Swotzy užsakymas nerandamas iš karto (sinchronizavimo vėlavimas), užduotis automatiškai kartojama iki 5 kartų su eksponentinio delsimo strategija.

Užsakymo sinchronizavimo būsena

Kiekvienas užsakymas Baltix seka Swotzy perkėlimo būseną:

  • PENDING — Užduotis yra eilėje arba vykdoma
  • SUCCESS — Atsiėmimo punktas sėkmingai perkeltas į Swotzy
  • FAILED — Visi bandymo kartojimai nepavyko (patikrinkite klaidos pranešimą užsakymo detalių puslapyje)

Iš užsakymo detalių puslapio galite rankiniu būdu pakartoti nepavykusį perkėlimą.

Atjungti Swotzy

  1. Eikite į Settings > External Provider
  2. Spustelėkite Delete

Tai pašalina išsaugotus prisijungimo duomenis. Jau perkelti į Swotzy užsakymai nebus paveikti.

Trikčių šalinimas

ProblemaSprendimas
„Connection failed" bandantDar kartą patikrinkite viešąjį ir privatųjį raktus. Įsitikinkite, kad nėra papildomų tarpų.
Užsakymas įstrigo PENDINGSusisiekite su palaikymo komanda
Užsakymas rodo FAILEDAtidarykite užsakymo detalę, kad pamatytumėte klaidą. Dažna priežastis: užsakymas dar nebuvo sukurtas Swotzy, kai Baltix bandė jį atnaujinti. Nesijaudinkite — Baltix kartoja iki tol, kol užsakymas bus redaguojamas
Swotzy užsakymas jau apdorotasJei užsakymas paliko „draft" būseną Swotzy prieš tai, kai Baltix galėjo jį atnaujinti, Baltix jį pažymi kaip SUCCESS (jokių veiksmų nereikia).