> ## Documentation Index
> Fetch the complete documentation index at: https://docs.consile.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Webshipper

> Ordrer, forsendelser og tracking, fragtomkostninger, fragtpriser, pakkeshops og returneringer fra Webshipper, plus booking af forsendelser og rettelser af ordrer med forhåndsvisning før hver ændring, direkte fra din AI.

*[Read this page in English](https://docs.consile.ai/en/connectors/webshipper.md)*

Webshipper-connectoren giver din AI adgang til fragten fra jeres webshop i
Webshipper: ordrer med status og fejlbesked, forsendelser med tracking,
fragtomkostninger pr. transportør, fragtpriser, pakkeshops, transportører,
ordrekanaler og returneringer. Den kan også booke en forsendelse for en ordre,
rette en ordre, før den sendes, og oprette en manuel ordre, altid bag en
forhåndsvisning, som du skal bekræfte. Du forbinder med jeres kontonavn og et
API-token, som du selv opretter i Webshipper, og din AI ser aldrig selve tokenet.

> [!NOTE]
>
> **Læs + guardrailet skriv.** 12 værktøjer læser kun. De 3 skriveværktøjer ændrer
> intet i Webshipper uden en eksplicit bekræftelse (`confirm: true`). Uden den får
> du kun en forhåndsvisning. At booke en forsendelse køber porto hos
> transportøren, og transportøren eller shoppen kan give modtageren besked. En
> administrator kan sætte den enkelte bruger til **Kun læsning**. Se
> [Handlinger & guardrails](https://docs.consile.ai/essentials/handlinger-og-guardrails.md).

> [card] Adgang
>
> Læs + guardrailet skriv. Kun læsning kan vælges pr. bruger

> [card] Godkendelse
>
> Kontonavn og API-token fra Webshipper

> [card] Drift
>
> Hostet i EU · Frankfurt

* **Pris:** 299 kr/md ekskl. moms (39 EUR). Ingen binding, opsig når som helst.
  Prisen dækker 1 bruger og 1 Webshipper-konto. Hver ekstra bruger og hver ekstra
  konto koster 149,50 kr/md ekskl. moms. Se [Priser](https://docs.consile.ai/portal/priser.md). Webshipper er
  også med i [Consile Studio-medlemskabet](https://docs.consile.ai/portal/medlemskab.md) og
  [den gratis udgave](https://docs.consile.ai/portal/gratis-udgave.md).
* **Én konto pr. forbindelse:** et API-token hører til én Webshipper-konto (fx
  `minbutik.webshipper.io`). Har I flere konti, fx én pr. brand eller land,
  forbinder I én aftale pr. konto. Hver ekstra aftale får sin egen adresse, fx
  `https://mcp.consile.ai/webshipper-2/mcp`. Se
  [Flere aftaler](https://docs.consile.ai/connect/forbind-webshipper.md#flere-aftaler).
* **Endpoint:** `https://mcp.consile.ai/webshipper/mcp` (din egen, navngivne
  connector i din AI).

## Forudsætninger

**1. Abonnement**

En administrator køber connectoren i [portalen](https://app.consile.ai). Se
[Tilkøb en connector](https://docs.consile.ai/portal/tilkoeb-connector.md).

**2. Din AI forbundet**

Se [Forbind Claude](https://docs.consile.ai/connect/forbind-claude.md) eller
[Forbind ChatGPT](https://docs.consile.ai/connect/forbind-chatgpt.md).

**3. Webshipper Pro eller Advanced**

API-adgang følger med Webshipper Pro og Advanced. Andre planer har ikke
API-adgang, og så kan connectoren ikke forbindes.

**4. Webshipper forbundet**

Opret et API-token i Webshipper under **Indstillinger → Adgang & tokens**, og
indsæt det i portalen sammen med kontonavnet. Se
[Forbind Webshipper](https://docs.consile.ai/connect/forbind-webshipper.md).

**5. Adgang til hver bruger**

Den, der køber Webshipper, får automatisk den inkluderede adgang. Skal flere
kolleger bruge Webshipper i deres AI, giver en administrator dem adgang på
personens side under **Team** og vælger samtidig deres adgangsniveau (se
[Adgangsniveau pr. bruger](#adgangsniveau-pr-bruger)). Hver ekstra bruger koster
149,50 kr/md ekskl. moms. Har I
[Consile Studio-medlemskabet](https://docs.consile.ai/portal/medlemskab.md), giver en administrator i
stedet én medlemskabslicens pr. person, og den dækker også Webshipper. Se
[Team](https://docs.consile.ai/portal/team.md).

> [!NOTE]
>
> **Var I kunde før 2026-11-17?** Har jeres organisation et medlemskab eller en
> gratis udgave fra før Webshipper kom til, står Webshippers værktøjer slået fra,
> til en administrator slår dem til under [Værktøjer](https://docs.consile.ai/portal/vaerktoejer.md). Nye
> kunder får både læse- og skriveværktøjerne slået til fra start.

## Hvad kan den? (tools)

Du behøver ikke kende tool-navnene. Du spørger i naturligt sprog, og din AI vælger
og kalder selv det rigtige værktøj. Hvert værktøj hedder `webshipper__<tool>` (fx
`webshipper__search_orders`); i tabellerne herunder står navnene uden præfiks.

Connectoren stiller i alt 15 værktøjer til rådighed: 12 read-only og 3
guardrailede skriveværktøjer. En bruger på **Kun læsning** får kun de 12.

### Læsning (12 read-only)

**Ordrer**

| Tool | Hvad den gør |
| - | - |
| `search_orders` | Ordrer filtreret på status (fx fejlede ordrer), shoppens ordrenummer, fritekst, dato, ordrekanal, land eller tag, med modtager og Webshippers fejlbesked |
| `get_order` | Én ordre med ordrelinjer, leverings-, faktura- og afsenderadresse, pakkeshop, fragtmetode og shoppens oprindelige fragtvalg |

**Forsendelser & tracking**

| Tool | Hvad den gør |
| - | - |
| `search_shipments` | Forsendelser for en ordre eller på trackingnummer, reference, dato eller land, med transportør, trackinglink, seneste status og pris |
| `get_shipment` | Én forsendelse med transportørens trackinghændelser, pakker med vægt og mål, adresser, tillægsydelser og kost- og salgspris |

**Fragtpriser & omkostninger**

| Tool | Hvad den gør |
| - | - |
| `summarize_shipping_costs` | Antal forsendelser, kostpris og salgspris pr. transportør og valuta for en periode på op til 92 dage |
| `quote_shipping_rates` | Hvilke af en ordrekanals fragtmetoder der passer til en pakke, og hvad de koster kunden i checkout |
| `quote_carrier_services` | Én transportørs tjenester for de givne pakker med transportørens kostpris og forventet leveringsdag; intet bookes |
| `list_shipping_rates` | Fragtmetoderne pr. ordrekanal med transportør, servicekode, krav om pakkeshop og om de er skjulte eller til retur |

**Pakkeshops, opsætning & returneringer**

| Tool | Hvad den gør |
| - | - |
| `find_drop_points` | Op til 20 af de nærmeste pakkeshops og pakkebokse for en adresse med id, adresse, koordinater og åbningstider |
| `list_carriers` | Transportøraftalerne på kontoen med navn, testtilstand og tjenester; aftalens adgangsoplysninger vises aldrig |
| `list_order_channels` | Webshops og systemer, ordrerne kommer fra, med synkroniseringsstatus og om forsendelser og fulfilment sker automatisk; shoppens adgangsoplysninger vises aldrig |
| `search_returns` | Returordrer fra returportalen med status, returnerede linjer, antal og kundens årsag |

### Skrivning (3 guardrailede værktøjer)

Disse 3 værktøjer er de eneste, der ændrer noget i Webshipper. Et kald uden
`confirm: true` ændrer aldrig noget, men viser præcis, hvilken ændring der ville
blive sendt. Normalt viser din AI dig forhåndsvisningen og kalder først igen med
`confirm: true`, når du har sagt ja. Kolonnen **Ekstra spærre** viser de
værktøjer, hvor bekræftelsen også skal passe til forhåndsvisningen (se
[Sådan virker guardrailen](#sådan-virker-guardrailen)).

| Tool | Hvad den gør | Ekstra spærre |
| - | - | - |
| `create_shipment` | Booker én ordre hos transportøren med ordrens egen eller en valgt fragtmetode. Det køber porto, og transportøren eller shoppen kan give modtageren besked på sms eller e-mail. Kan ikke annulleres sikkert bagefter | Ja, kan ikke fortrydes |
| `update_order` | Retter felter i leveringsadressen, skifter fragtmetode eller sætter ordren på hold og frigiver den igen, før den sendes | Ja |
| `create_order` | Opretter en manuel ordre i en ordrekanal, fx en erstatningsvare eller en B2B-pakke, med op til 100 linjer. Der bookes ingen forsendelse | |

> [card] [Bygger du selv ovenpå? Se API-referencen](https://docs.consile.ai/developers/tools/webshipper.md)
>
> Fuld reference med alle 15 værktøjer, argumenter, paginering, guardrail-felter og
> fejl.

## Sådan virker guardrailen

1. **Alle 3 skriveværktøjer er dry-run som standard.** Et kald uden
   `confirm: true` ændrer aldrig noget i Webshipper. Du får en forhåndsvisning af
   præcis den ændring, der ville blive sendt. Ved booking og rettelser viser den
   også ordren, som den ser ud nu.
2. **Ændringen udføres kun med `confirm: true`.** Der er ingen undtagelser.
3. **Booking og rettelser skal passe til forhåndsvisningen.** `create_shipment` og
   `update_order` kræver også en kontrolværdi fra forhåndsvisningen. Er ordren
   ændret i Webshipper mellem forhåndsvisning og bekræftelse, afvises kaldet, og
   intet ændres. Det tager altid to kald.
4. **Kun ordrer, der kan sendes.** En ordre, der allerede er sendt, delvist sendt,
   annulleret eller låst i Webshipper, kan hverken bookes eller rettes. En ordre på
   hold skal frigives med `update_order`, før den kan bookes. Det forhindrer, at en
   ordre, der allerede er sendt, bookes igen.
5. **Intet slettes eller annulleres.** Connectoren kan ikke slette eller annullere
   ordrer og forsendelser, printe labels eller bestille afhentning. Det gør du selv
   i Webshipper.
6. **Ukendt udfald siges højt.** Får en skrivning intet svar fra Webshipper,
   fortæller fejlen din AI, at udfaldet er ukendt, og beder den tjekke i
   Webshipper, før den prøver igen.

> [!WARNING]
>
> **En booking koster porto.** Når `create_shipment` er bekræftet, er forsendelsen
> købt hos transportøren, og modtageren kan have fået besked. At slette
> forsendelsen i Webshipper bagefter annullerer den ikke altid hos transportøren.
> Læs forhåndsvisningen, før du siger ja.

> [!TIP]
>
> Læs hele bekræftelsesmodellen, der gælder på tværs af alle skrive-connectors,
> under [Handlinger & guardrails](https://docs.consile.ai/essentials/handlinger-og-guardrails.md). Vil I have
> en administrators ja før bestemte skrivninger, så brug
> [Godkendelser](https://docs.consile.ai/portal/godkendelser.md). En regel på et skriveværktøj gælder både
> forhåndsvisningen og bekræftelsen.

## Adgangsniveau pr. bruger

En administrator vælger adgangsniveau for hver bruger i portalen under
[Team](https://docs.consile.ai/portal/team.md): klik på brugerens navn, og vælg for Webshipper mellem
**Ingen**, **Kun læsning (12)**, **Fuld adgang (15)** og **Tilpasset**, hvor du
vælger præcis de værktøjer, brugeren får (se
[Tilpasset adgang](https://docs.consile.ai/portal/team.md#tilpasset-adgang)). Tallene tæller de værktøjer,
organisationen har slået til.

| Niveau | Værktøjer | Hvad din AI kan |
| - | - | - |
| **Kun læsning** | 12 | Læse ordrer, forsendelser, tracking, fragtomkostninger, fragtpriser, pakkeshops, opsætning og returneringer. Ingen skriveværktøjer. |
| **Fuld adgang** (standard) | 15 | Alt ovenfor plus de 3 guardrailede skriveværktøjer. |

* Begge niveauer koster det samme.
* Står en bruger på **Kun læsning**, blokerer Consile alle skriveoperationer på
  serveren for den bruger: skriveværktøjerne vises ikke i brugerens AI, og et kald
  af dem afvises, uden at noget ændres.
* Forbindelsen til Webshipper er virksomhedens, så kolleger med **Fuld adgang** kan
  fortsat skrive.

## Prøv at spørge

> [accordion] Fejlede ordrer
>
> > *"Hvilke ordrer fejlede i Webshipper i dag, og hvorfor?"*
>
> > *"Vis de ordrer, der står på hold, og hvor længe de har ventet."*

> [accordion] Tracking
>
> > *"Hvor er pakken til ordre 1001, og hvornår blev den sidst scannet?"*
>
> > *"Find forsendelsen med trackingnummer 00370712345678901234, og vis hændelserne."*

> [accordion] Fragtomkostninger
>
> > *"Hvad brugte vi på fragt pr. transportør i oktober, og hvad betalte kunderne?"*
>
> > *"Hvilke pakkeshops ligger tættest på Vestergade 10, 8000 Aarhus C?"*

> [accordion] Book & ret (guardrailet)
>
> > *"Ret leveringsadressen på ordre 1001 til Nørregade 5, 1165 København K."* (du får en forhåndsvisning og skal bekræfte)
>
> > *"Book forsendelsen for ordre 1001 med ordrens egen fragtmetode. Vis mig den først."*

> [!TIP]
>
> Shoppens eget ordrenummer er ikke det samme som Webshippers id for ordren. Nævn
> gerne ordrenummeret i spørgsmålet. Din AI finder selv Webshippers id med
> `search_orders`.

## Begrænsninger

* **Skrivning er guardrailet, ikke fri.** De 3 skriveværktøjer virker kun bag
  bekræftelsesspærren ovenfor. Guardrailen består af sikre standardindstillinger i
  connectoren og er ikke en absolut garanti.
* **En booking kan ikke trækkes tilbage.** Porto er købt, når en forsendelse er
  booket. Skal den annulleres, gør du det i Webshipper eller hos transportøren.
* **Ikke med i denne version.** Labels og andre dokumenter som filer, print,
  afhentning, returneringer som skrivning, noter, sletning og annullering samt
  opsætning af transportører, fragtregler og webhooks.
* **Adgangsoplysninger vises aldrig.** Shoppens adgangstokens, transportøraftalernes
  adgangsoplysninger, dokumenter som labels og pakkesedler og billeder fra
  returneringer sendes aldrig til din AI.
* **Persondata.** Ordrer og forsendelser indeholder adresser på jeres kunder.
  Lister viser navn, firma, postnummer, by og land. En enkelt ordre eller
  forsendelse viser også telefon og e-mail, som kundeservice har brug for.
* **Tokenets rettigheder.** Mangler tokenet adgang til et område i Webshipper, fx
  forsendelser, fejler de værktøjer, der bruger området, med en forklarende besked.
  De øvrige værktøjer virker.
* **Én side ad gangen.** Søgninger giver 30 resultater pr. side. Din AI beder selv
  om næste side, når der kan være flere. En opgørelse af fragtomkostninger læser
  højst 1.500 forsendelser; er perioden større, beder din AI om en kortere periode.
* **Webshippers grænse for kald.** Webshipper tillader omkring 2 kald i sekundet pr.
  API-token, og grænsen deles af alle brugere af samme forbindelse. Rammer din AI
  den, får den besked om at vente lidt.
* **Ingen gemte data.** Alt hentes og skrives live, når du spørger. Consile gemmer
  ingen ordre- eller forsendelsesdata.

Virker noget ikke som forventet? Se [Fejlfinding](https://docs.consile.ai/troubleshooting.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.