> ## Documentation Index > Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # API til egen kanal > Opret en egen ordrekanal, kopier modtagelses-URL'en og signeringsnøglen, indstil Drift-kontakterne, og send en signeret ordre fra din egen webshop eller dit ERP-system. 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](/docs/da/tutorials/connect-order-channels). Den fulde reference til indholdet finder du i [Egne kanaler](/docs/da/order-channels/custom-channels). 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 Katalog over ordrekanaler med kortet Egen kanal og knappen Opret kanal ## 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 Vinduet Opret egen kanal med Kanalnavn udfyldt som Min webshop, Opret kanal og Annuller | 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](/docs/da/order-channels/custom-channels). Kortet Ordremodtagelse med Modtagelses-URL, Kopier og Generer nøgle Kortet Ordremodtagelse med Modtagelses-URL, Kopier og Generer nøgle 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/`. 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 Ordremodtagelse med engangssigneringsnøglen, Kopier, Tilbagekald og Erstat nøgle **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. ```javascript theme={null} 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](/docs/da/order-channels/custom-channels). | 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](/docs/da/how-to/create-an-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](/docs/da/how-to/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 Ordreliste med en ordre, der kom ind gennem en egen kanal ## Drift Kortet Drift med Kanal aktiveret slået til, Send forsendelser automatisk, Standard afsenderadresse, Seneste ordre modtaget og Gem ændringer Kortet Drift med Kanal aktiveret slået til, Send forsendelser automatisk, Standard afsenderadresse, Seneste ordre modtaget og Gem ændringer | 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 Siden Ordrekanaler med en egen kanal markeret Deaktiveret Overskydende Shopify- eller WooCommerce-kanaler, markeret **Ingen aktiv forbindelse** og **Afbrudt**, er noget andet. Se [Indstillinger for ordrekanaler](/docs/da/how-to/order-channel-settings). ## Slet Under **Farezone** finder du **Slet kanal**: **Slet kanalen. Din integration kan ikke længere sende ordrer til den.** Farezone med Slet kanal og knappen Slet Farezone med Slet kanal og knappen Slet 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 Opret kanalen fra kataloget, og åbn derefter Ordrer. Fuldt indhold, annullering, ping og REST-eksempler. Siden Ordrekanaler, brands og overskydende kanaler. Et token til POST /orgs/\{orgId}/orders i stedet for signerede push. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.