Skip to main content
Mukautetun kanavan avulla oma verkkokauppasi, ERP- tai varastojärjestelmäsi voi lähettää tilauksia suoraan Zippendoon, kun sille ei ole valmista yhteyttä. Tällä sivulla käydään läpi luontiikkunan ja kanavan asetusten kaikki kentät sekä se, miten kehittäjä lähettää tilauksen. Vaiheittainen ohje on Yhdistä myyntikanavat. Täydellinen payload-kuvaus on sivulla Mukautetut kanavat. Valitse sivupalkista Myyntikanavat ja sitten Katalogi-välilehti. Mukautettu kanava -kortissa lukee Yhdistä oma verkkokauppasi tai ERP-järjestelmäsi. Kortin painike on Luo kanava.
Myyntikanavien katalogi, jossa Mukautettu kanava -kortti ja Luo kanava -painikeMyyntikanavien katalogi, jossa Mukautettu kanava -kortti ja Luo kanava -painike

Mukautettu kanava -kortti katalogissa

Luo kanava

Valitse Luo kanava. Luo mukautettu kanava -ikkuna avautuu: Myyntikanava omalle verkkokaupallesi tai ERP-järjestelmällesi.
Luo mukautettu kanava -ikkuna, jossa Kanavan nimeksi on täytetty Verkkokauppani, sekä Luo kanava ja PeruutaLuo mukautettu kanava -ikkuna, jossa Kanavan nimeksi on täytetty Verkkokauppani, sekä Luo kanava ja Peruuta

Luo mukautettu kanava: anna Kanavan nimi

Valitse Luo kanava (painikkeessa lukee Luodaan…). Näet viestin Myyntikanava luotu, ja Zippendo avaa uuden kanavan asetukset. Jos näet viestin Myyntikanavan luominen epäonnistui, yritä uudelleen. Peruuta sulkee ikkunan.

Tilausten vastaanotto

Asetussivun otsikkona on kanavan nimi ja teksti Oma integraatiosi: lähetä tilaukset vastaanotto-URL-osoitteeseen tai käytä API:a ja SDK:ita. Avaa ohjeet avaa Mukautetut kanavat -kuvauksen.
Tilausten vastaanotto -kortti, jossa Vastaanotto-URL, Kopioi ja Luo salaisuusTilausten vastaanotto -kortti, jossa Vastaanotto-URL, Kopioi ja Luo salaisuus

Tilausten vastaanotto: Vastaanotto-URL ja Luo salaisuus

Tilausten vastaanotto -kortti: Järjestelmäsi lähettää allekirjoitetut tilaukset alla olevaan vastaanotto-URL-osoitteeseen. Allekirjoita jokaisen pyynnön raaka runko HMAC-SHA256:lla allekirjoitussalaisuuden avulla. Kanava hyväksyy tilauksia vasta, kun allekirjoitussalaisuus on olemassa. Vastaanotolle ei ole erillistä kytkintä. Kun olet valinnut Luo salaisuus tai Vaihda salaisuus, salaisuus näytetään vain kerran:
Tilausten vastaanotto -kortti, jossa kertaluonteinen allekirjoitussalaisuus, Kopioi, Mitätöi ja Vaihda salaisuusTilausten vastaanotto -kortti, jossa kertaluonteinen allekirjoitussalaisuus, Kopioi, Mitätöi ja Vaihda salaisuus

Kopioi allekirjoitussalaisuus nyt. Se näytetään vain kerran

Kopioi salaisuus nyt. Se näytetään vain kerran. Jos vaihdat sen myöhemmin, nykyinen salaisuus lakkaa toimimasta heti. Salaisuus alkaa merkeillä zwhs_. Tallenna se järjestelmäsi asetuksiin.

Lähetä tilaus

Lähetä POST Vastaanotto-URL-osoitteeseen kahdella otsikolla: order.created ja order.updated luovat tai päivittävät tilauksen externalId:n perusteella. order.cancelled-rungon muoto on { "externalId": "…" }. ping palauttaa 200 { "received": true } muuttamatta mitään.
Pakolliset payload-kentät: externalId, orderNumber ja orderLines (vähintään yksi rivi, jossa name ja quantity). Valinnaiset: customerName, customerEmail, shippingAddress, subtotalAmount, totalAmount, currency, notes, shippingMethodTitle ja serviceCode. Täydellinen kenttätaulukko: Mukautetut kanavat. Haluatko mieluummin pyyntö-vastaus-mallin? Luo tilauksia kutsulla POST /orgs/{orgId}/orders, jossa annat orderChannelId:n, ja API-tokenilla. Toinen tilaus samalla externalId:llä samalla kanavalla palauttaa 409 ORDER_EXISTS. Saadaksesi seurantakoodit ja tilamuutokset takaisin tilaa organisaatiosi webhookit (shipment.dispatched, tracking.updated). Mukautetulla kanavalla ei ole omaa seurantakutsua eikä toimitustapojen yhdistämisnäkymää. Lähettämäsi tilaus näkyy kohdassa Tilaukset. Sen tila voi olla Virhe, kun Zippendo tuotti tilauksen mutta ei pystynyt luomaan lähetysvalmista lähetystä, esimerkiksi koska mikään toimitussääntö ei täsmännyt tai osoite on puutteellinen. Tilaus kuuluu silti kanavalle.
Tilausluettelo, jossa mukautetun kanavan kautta saapunut tilausTilausluettelo, jossa mukautetun kanavan kautta saapunut tilaus

Järjestelmäsi lähettämä tilaus Tilaukset-sivulla

Toiminta

Toiminta-kortti, jossa Kanava käytössä on päällä, sekä Lähetä lähetykset automaattisesti, Lähettäjän oletusosoite, Viimeisin vastaanotettu tilaus ja Tallenna muutoksetToiminta-kortti, jossa Kanava käytössä on päällä, sekä Lähetä lähetykset automaattisesti, Lähettäjän oletusosoite, Viimeisin vastaanotettu tilaus ja Tallenna muutokset

Toiminta: Kanava käytössä, Lähetä lähetykset automaattisesti ja Lähettäjän oletusosoite

Tallenna muutokset (Tallennetaan…) tallentaa Lähetä lähetykset automaattisesti ja Lähettäjän oletusosoite -asetukset. Näet viestin Myyntikanava päivitetty tai Myyntikanavan päivittäminen epäonnistui.

Kytke kanava pois päältä

Kytke Kanava käytössä pois päältä. Yhdistetty-välilehdellä kanavan rivillä Mukautettu kanava -kortissa lukee silloin Poistettu käytöstä. Mukautetut kanavat pysyvät aina Yhdistetty-välilehdellä, eivätkä koskaan muutu jäännöskanaviksi.
Myyntikanavat-sivu, jossa mukautettu kanava on merkitty tilaan Poistettu käytöstäMyyntikanavat-sivu, jossa mukautettu kanava on merkitty tilaan Poistettu käytöstä

Pois päältä kytketty mukautettu kanava

Shopify- tai WooCommerce-jäännöskanavat, joissa lukee Ei aktiivista yhteyttä ja Yhteys katkaistu, ovat eri asia. Katso Myyntikanavan asetukset.

Poista

Kohdassa Vaaravyöhyke on Poista kanava: Poista tämä mukautettu kanava. Integraatiosi ei enää voi lähettää siihen tilauksia.
Vaaravyöhyke, jossa Poista kanava ja Poista-painikeVaaravyöhyke, jossa Poista kanava ja Poista-painike

Poista kanava Vaaravyöhykkeessä

Valitse Poista ja vahvista: Poistetaanko tämä mukautettu kanava? Sen vastaanotto-URL lakkaa hyväksymästä tilauksia heti. Näet viestin Myyntikanava poistettu tai Myyntikanavan poistaminen epäonnistui.

Aiheeseen liittyvää

Yhdistä myyntikanavat

Luo kanava katalogista ja avaa sitten Tilaukset.

Mukautettujen kanavien kuvaus

Täydellinen payload, peruutus, ping ja REST-esimerkit.

Myyntikanavan asetukset

Myyntikanavat-sivu, brändit ja jäännöskanavat.

Luo API-token

Token kutsua POST /orgs/{orgId}/orders varten allekirjoitettujen kutsujen sijaan.