API til egen kanal

En egen kanal lader din egen webshop, dit ERP- eller dit lagersystem sende ordrer direkte ind i Zippendo, når der ikke findes en færdig forbindelse til det. Denne side gennemgår alle kontrollerne i oprettelsesvinduet og kanalindstillingerne og viser, hvordan en udvikler sender en ordre. Gennemgangen med klik finder du i Forbind ordrekanaler. Den fulde reference til indholdet finder du i Egne kanaler. Klik på Ordrekanaler i sidemenuen og derefter på fanen Katalog. Kortet Egen kanal siger Forbind din egen webshop eller dit ERP-system. Dets knap hedder Opret kanal.

Katalog over ordrekanaler med kortet Egen kanal og knappen Opret kanal — Kortet Egen kanal i kataloget

Opret kanalen

Klik på Opret kanal. Vinduet Opret egen kanal åbner: En ordrekanal til din egen webshop eller dit ERP-system.

Vinduet Opret egen kanal med Kanalnavn udfyldt som Min webshop, Opret kanal og Annuller — Opret egen kanal: skriv et Kanalnavn

Felt	Påkrævet	Det skal du skrive
Kanalnavn	Ja	Et navn, du genkender, f.eks. “Min webshop”. Opret kanal er inaktiv, indtil du har skrevet et.
Brand	Nej	Vises kun, når din organisation har brands. Ordrer fra denne kanal hører til dette brand.

Klik på Opret kanal (den viser Opretter…). Du ser Ordrekanal oprettet, og Zippendo åbner den nye kanals indstillinger. Hvis du ser Kunne ikke oprette ordrekanalen, så prøv igen. Annuller lukker vinduet.

Ordremodtagelse

Indstillingssiden har kanalens navn som overskrift og Din egen integration: send ordrer til modtagelses-URL’en, eller brug API’et og SDK’erne. Se dokumentation åbner referencen Egne kanaler.

Kortet Ordremodtagelse: Dit system sender signerede ordrer til modtagelses-URL’en nedenfor. Signer den rå body i hver forespørgsel med HMAC-SHA256 og signeringsnøglen.

Kontrol	Hvad den gør
Modtagelses-URL	Den adresse, dit system sender ordrer til, på formen `https://api.zippendo.com/webhooks/order-channels/<channel id>`. Kopier den fra din egen kanal. Kopier viser Kopieret til udklipsholderen. eller Kunne ikke kopiere til udklipsholderen.
Generer nøgle	Opretter signeringsnøglen. Viser Genererer… og derefter Signeringsnøgle genereret. eller Kunne ikke generere signeringsnøglen.
Erstat nøgle	Erstatter en eksisterende nøgle. Zippendo beder dig bekræfte: dit system afvises, indtil det signerer med den nye nøgle.
Tilbagekald	Slår nøglen fra. Alle ordrer, dit system sender, afvises, indtil du genererer en ny nøgle. Viser Signeringsnøgle tilbagekaldt. eller Kunne ikke tilbagekalde signeringsnøglen.
Aktiv signeringsnøgle oprettet	Efterfulgt af dato og klokkeslæt for, hvornår den nuværende nøgle blev oprettet.

Kanalen accepterer først ordrer, når der findes en signeringsnøgle. Der er ingen separat kontakt til at slå modtagelse til. Efter Generer nøgle eller Erstat nøgle vises nøglen én gang:

Ordremodtagelse med engangssigneringsnøglen, Kopier, Tilbagekald og Erstat nøgle — Kopier signeringsnøglen nu. Den vises kun én gang

Kopier nøglen nu. Den vises kun én gang. Hvis du erstatter den senere, holder den nuværende nøgle op med at virke med det samme. Nøglen begynder med zwhs_. Gem den i dit systems konfiguration.

Send en ordre

Send en POST til Modtagelses-URL med to headers:

Header	Værdi
`X-Zippendo-Topic`	`order.created`, `order.updated`, `order.cancelled` eller `ping`
`X-Zippendo-Signature`	HMAC-SHA256 af den rå anmodningsbody, hex-kodet, med signeringsnøglen som nøgle

order.created og order.updated opretter eller opdaterer begge ordren ud fra dens externalId. Bodyen i order.cancelled er { "externalId": "…" }. ping returnerer 200 { "received": true } uden at ændre noget.

import crypto from "node:crypto"

const body = JSON.stringify(order)
const signature = crypto.createHmac("sha256", process.env.ZIPPENDO_WEBHOOK_SECRET)
  .update(body)
  .digest("hex")

await fetch(webhookUrl, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Zippendo-Topic": "order.created",
    "X-Zippendo-Signature": signature
  },
  body
})

Påkrævede felter i indholdet: externalId, orderNumber og orderLines (mindst én linje med name og quantity). Valgfrie: customerName, customerEmail, shippingAddress, subtotalAmount, totalAmount, currency, notes, shippingMethodTitle og serviceCode. Den fulde felttabel: Egne kanaler.

Status	Betydning
`200`	Accepteret og behandlet
`400`	Manglende eller ukendt topic, indhold der ikke bestod valideringen, eller Kanal aktiveret er slået fra
`401`	Signaturtjekket mislykkedes: forkert nøgle, manglende header eller ingen nøgle genereret endnu
`404`	Ukendt kanal
`429`	For mange ordrer på én gang. Prøv igen efter forsinkelsen i `Retry-After`
`5xx`	Behandlingen mislykkedes. Prøv igen: det er sikkert at sende den samme ordre igen

Foretrækker du anmodning og svar? Opret ordrer med POST /orgs/{orgId}/orders med orderChannelId og et API-token. En anden ordre med samme externalId på samme kanal returnerer 409 ORDER_EXISTS. For at få trackingnumre og statusændringer tilbage skal du abonnere på din organisations webhooks (shipment.dispatched, tracking.updated). En egen kanal har ikke sit eget trackingkald og ingen skærm til kortlægning af leveringsmetoder. En ordre, du sender, vises under Ordrer. Dens status kan være Fejl, når Zippendo har importeret ordren, men ikke kunne oprette en forsendelse, der er klar til at blive sendt, f.eks. fordi ingen forsendelsesregel passede, eller adressen er ufuldstændig. Ordren hører stadig til kanalen.

Ordreliste med en ordre, der kom ind gennem en egen kanal — En ordre sendt af dit system på siden Ordrer

Drift

Indstilling	Gemmes	Hvad den gør
Kanal aktiveret	Med det samme	Slår kanalen til eller fra. Når den er slået fra, afviser Zippendo alle ordrer, der sendes til denne kanal.
Send forsendelser automatisk	Med Gem ændringer	Sender forsendelsen til transportøren automatisk, når en indkommende ordre passer til en forsendelsesregel. Slået fra som standard.
Brand	Med det samme	Ordrer fra denne kanal hører til dette brand. Listen vises kun, når din organisation har brands.
Standard afsenderadresse	Med Gem ændringer	Afsenderen til forsendelser, når ingen forsendelsesregel passer til ordren. Når der endnu ikke er gemt nogen, står der Ingen adresser endnu på listen.
Seneste ordre modtaget	Skrivebeskyttet	Hvornår kanalen senest modtog en ordre, eller Aldrig.

Gem ændringer (Gemmer…) gemmer Send forsendelser automatisk og Standard afsenderadresse. Du ser Ordrekanal opdateret eller Kunne ikke opdatere ordrekanalen.

Slå en kanal fra

Slå Kanal aktiveret fra. På fanen Forbundet står der så Deaktiveret i kanalens række på kortet Egen kanal. Egne kanaler bliver altid på fanen Forbundet og bliver aldrig til overskydende kanaler.

Siden Ordrekanaler med en egen kanal markeret Deaktiveret — En egen kanal, der er slået fra

Overskydende Shopify- eller WooCommerce-kanaler, markeret Ingen aktiv forbindelse og Afbrudt, er noget andet. Se Indstillinger for ordrekanaler.

Slet

Under Farezone finder du Slet kanal: Slet kanalen. Din integration kan ikke længere sende ordrer til den.

Klik på Slet og bekræft: Slet denne kanal? Dens modtagelses-URL stopper med at acceptere ordrer med det samme. Du ser Ordrekanal slettet eller Kunne ikke slette ordrekanalen.

Relateret

Forbind ordrekanaler

Opret kanalen fra kataloget, og åbn derefter Ordrer.

Reference til egne kanaler

Fuldt indhold, annullering, ping og REST-eksempler.

Indstillinger for ordrekanaler

Siden Ordrekanaler, brands og overskydende kanaler.

Opret et API-token

Et token til POST /orgs/{orgId}/orders i stedet for signerede push.

Overblik

Forsendelser

Ordrer og ordrekanaler

Transportører

Tilslut en transportør

Tilslut en integration

Udskrivning

Automatisering

Konto

Søgning og dashboard

API og events

API til egen kanal

Opret kanalen

Ordremodtagelse

Send en ordre

Drift

Slå en kanal fra

Slet

Relateret

Forbind ordrekanaler

Reference til egne kanaler

Indstillinger for ordrekanaler

Opret et API-token

​Opret kanalen

​Ordremodtagelse

​Send en ordre

​Drift

​Slå en kanal fra

​Slet

​Relateret

Forbind ordrekanaler

Reference til egne kanaler

Indstillinger for ordrekanaler

Opret et API-token

Opret kanalen

Ordremodtagelse

Send en ordre

Drift

Slå en kanal fra

Slet

Relateret