> ## 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.

# Koble til Instabox (Legacy API)

> Koble til den utfasede transportøren Instabox (Legacy API) med Klient-ID, Klienthemmelighet og Customer number, og hvorfor nye oppsett bør bruke Instabox i stedet.

**Instabox (eldre API)** er den eldre måten å koble til Instabox på. Den er merket **Utfases** på fanen **Alle transportører**. Hold pekeren over merket for å lese: «Det frittstående Instabox-API-et er utgått. Bytt til Instabox-integrasjonen som drives av Instabee.»

Bruk den bare hvis du fortsatt har legitimasjon for det eldre Instabox-systemet (en klient-ID og en hemmelighet). For et nytt oppsett, bruk [Koble til Instabox](/docs/no/how-to/connect-instabox) i stedet. Feltene alle transportører har til felles, står på [Legitimasjon for transportører](/docs/no/how-to/carrier-credentials).

<Warning>
  Eksisterende tilkoblinger fortsetter å fungere: du kan fortsatt koble til denne transportøren og sende sendinger med den. Nye oppsett bør bruke **Instabox**.
</Warning>

<Info>
  Du velger ikke avsenderadresse i dette skjemaet. Legg til adressene dine under organisasjonsmenyen → **Administrer** → **Adresser**. Du velger avsenderadressen på hver sending eller i en [fraktregel](/docs/no/how-to/shipping-rule-fields).
</Info>

## Før du begynner

Du trenger tre opplysninger fra Instabox for det eldre systemet:

* din **Klient-ID**
* din **Klienthemmelighet**
* ditt **Kundenummer**, prefikset Instabox setter foran pakkenumrene dine (for eksempel `PA02`)

Disse er ikke de samme som den ene **API-nøkkel** som brukes på [Koble til Instabox](/docs/no/how-to/connect-instabox). **Les mer** på kortet åpner [instabee.com](https://instabee.com).

## Koble til Instabox (Legacy API)

<Steps>
  <Step title="Åpne Alle transportører">
    Klikk **Transportører** i sidemenyen, og åpne deretter fanen **Alle transportører**.
  </Step>

  <Step title="Finn riktig kort">
    Finn kortet **Instabox (eldre API)** med det gule merket **Utfases**. Det er et annet kort enn **Instabox**. Klikk **Koble til**.
  </Step>

  <Step title="Fyll ut skjemaet">
    Vinduet **Koble til transportør** åpnes. Skriv inn et **Navn på transportør**, deretter **Klient-ID**, **Klienthemmelighet** og **Kundenummer**. **Testmodus** ligger under **Valgfrie felt**.
  </Step>

  <Step title="Koble til transportøren">
    Klikk **Koble til**. Du ser «Transportøren er koblet til», og transportøren vises på fanen **Mine transportører**.
  </Step>
</Steps>

<Frame caption="Kortet Instabox (Legacy API) med merket Utfases">
  <img src="https://mintcdn.com/zippendo/7selBID7y4T6jvlB/images/no/how-to/connect-instabox-legacy/01-all-carriers-card-light.png?fit=max&auto=format&n=7selBID7y4T6jvlB&q=85&s=ea86b4a06dcb17936eea48bd6e7b8477" alt="Fanen Alle transportører med kortet Instabox Legacy API merket Utfases, med knappene Koble til og Les mer" className="block dark:hidden" width="2880" height="1800" data-path="images/no/how-to/connect-instabox-legacy/01-all-carriers-card-light.png" />

  <img src="https://mintcdn.com/zippendo/7selBID7y4T6jvlB/images/no/how-to/connect-instabox-legacy/01-all-carriers-card-dark.png?fit=max&auto=format&n=7selBID7y4T6jvlB&q=85&s=834effdae924c66e667ef5e946c76401" alt="Fanen Alle transportører med kortet Instabox Legacy API merket Utfases, med knappene Koble til og Les mer" className="hidden dark:block" width="2880" height="1800" data-path="images/no/how-to/connect-instabox-legacy/01-all-carriers-card-dark.png" />
</Frame>

<Frame caption="Skriv inn Klient-ID, Klienthemmelighet og Customer number">
  <img src="https://mintcdn.com/zippendo/7selBID7y4T6jvlB/images/no/how-to/connect-instabox-legacy/02-connect-modal-light.png?fit=max&auto=format&n=7selBID7y4T6jvlB&q=85&s=e9771e94990b66490226d61b4c34f7aa" alt="Vinduet Koble til transportør for Instabox Legacy API med Klient-ID, Klienthemmelighet og Customer number" className="block dark:hidden" width="2880" height="2800" data-path="images/no/how-to/connect-instabox-legacy/02-connect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/7selBID7y4T6jvlB/images/no/how-to/connect-instabox-legacy/02-connect-modal-dark.png?fit=max&auto=format&n=7selBID7y4T6jvlB&q=85&s=9c83a0d4e818582657744834da765910" alt="Vinduet Koble til transportør for Instabox Legacy API med Klient-ID, Klienthemmelighet og Customer number" className="hidden dark:block" width="2880" height="2800" data-path="images/no/how-to/connect-instabox-legacy/02-connect-modal-dark.png" />
</Frame>

<Frame caption="Testmodus ligger under Valgfrie felt">
  <img src="https://mintcdn.com/zippendo/7selBID7y4T6jvlB/images/no/how-to/connect-instabox-legacy/03-optional-fields-light.png?fit=max&auto=format&n=7selBID7y4T6jvlB&q=85&s=d6d319f03ea283af304415c55b66d7d9" alt="Skjemaet for Instabox Legacy API rullet ned til Valgfrie felt med avkrysningsboksen Testmodus" className="block dark:hidden" width="2880" height="2800" data-path="images/no/how-to/connect-instabox-legacy/03-optional-fields-light.png" />

  <img src="https://mintcdn.com/zippendo/7selBID7y4T6jvlB/images/no/how-to/connect-instabox-legacy/03-optional-fields-dark.png?fit=max&auto=format&n=7selBID7y4T6jvlB&q=85&s=f9413fcbfae3a513e8c8435e54abc90d" alt="Skjemaet for Instabox Legacy API rullet ned til Valgfrie felt med avkrysningsboksen Testmodus" className="hidden dark:block" width="2880" height="2800" data-path="images/no/how-to/connect-instabox-legacy/03-optional-fields-dark.png" />
</Frame>

## Feltene i skjemaet

| Felt | Påkrevd | Hva du skriver inn |
| - | - | - |
| **Navn på transportør** | Ja | Navnet du ser under **Mine transportører** og når du velger transportør på en sending. Det starter som **Instabox (eldre API)**. |
| **Merkevare** | Nei | Vises bare hvis organisasjonen din har [merkevarer](/docs/no/how-to/create-a-brand). Skjemaet sier: «Bare denne merkevaren kan bruke denne transportøren.» La det stå tomt for å la alle merkevarer bruke den. |
| **Klient-ID** | Ja | Klient-ID-en din fra Instabox. Skjemaet sier: «OAuth-klient-ID-en din hos Instabox». |
| **Klienthemmelighet** | Ja | Hemmeligheten som hører til klient-ID-en din. Den skjules mens du skriver. Skjemaet sier: «OAuth-klienthemmeligheten din hos Instabox». |
| **Kundenummer** | Ja | Skjemaet sier: «Your Instabox customer number - used as the parcel id prefix (e.g. PA02)». |
| **Testmodus** | Nei | En avkrysningsboks, av som standard. Skjemaet sier: «Bruk testmiljøet til Instabox». |

**Koble til** gjør ingenting før **Navn på transportør**, **Klient-ID**, **Klienthemmelighet** og **Kundenummer** alle har en verdi.

### Test eller live

For denne eldre tilkoblingen avgjør Instabox mellom testsystemet og ekte sendinger ut fra legitimasjonen du skriver inn, ikke ut fra avkrysningsboksen **Testmodus**. Testlegitimasjon fra Instabox oppretter testsendinger. Live-legitimasjon oppretter ekte sendinger, selv med **Testmodus** på. For å prøve ting ut, be Instabox om testlegitimasjon og slå på **Testmodus** mens du bruker den. Se [Testmodus](/docs/no/how-to/sandbox-mode).

## Etter at du har koblet til

Transportøren vises under **Mine transportører** med et **Tilkoblet**-merke. Når du velger den på en sending, viser den også merket **Utfases**. Du velger fraktproduktet på hver sending eller i en fraktregel, ikke i dette skjemaet. Se [Fraktprodukter og tilleggstjenester](/docs/no/how-to/carrier-products-and-services).

| Fraktprodukt | Sendingstype | Leverer til et hentested? |
| - | - | - |
| **Levering til pakkeautomat** | Utgående | Ja, en pakkeautomat fra Instabox |
| **Hjemlevering** | Utgående | Nei |
| **Retur via pakkeautomat** | Inngående (retur) | Nei. Kunden din leverer pakken i en hvilken som helst pakkeautomat fra Instabox. Slå på tilleggstjenesten **Retur uten fraktetikett** hvis kunden ikke skal skrive ut en fraktetikett. |

Fraktproduktene brukes vanligvis innenfor og mellom Sverige, Norge, Danmark, Finland og Nederland, fra 0,1 til 20 kg. Du kan velge andre land i en fraktregel. Instabox godtar eller avviser forsendelsen når du sender den.

* **Levering til pakkeautomat** trenger et hentested (her en pakkeautomat) før du kan sende. Se [Velg et hentested](/docs/no/how-to/pick-a-service-point).
* Instabox sender sporingsoppdateringer til Zippendo av seg selv. Det er ingenting å sette opp. Se [Sporings-webhooks fra transportører](/docs/no/how-to/tracking-webhooks).
* Instabox oppretter ikke tolldokumenter. Hvis fraktregelen har **Lag proformafaktura** eller **Lag handelsfaktura** slått på, oppretter Zippendo dokumentet. Se [Toll og dokumenter](/docs/no/how-to/customs-and-documents).
* Denne transportøren er ikke tilgjengelig under **Hentinger**.

## Endre eller fjern tilkoblingen

For å endre den åpner du **Transportører** → **Mine transportører** og klikker **Rediger transportør** på kortet. Siden **Rediger transportør** har to deler:

* **Generelt**: **Navn på transportør**, og **Merkevare** hvis organisasjonen din har merkevarer.
* **Transportørinnstillinger**: **Klient-ID**, **Klienthemmelighet**, **Kundenummer** og **Testmodus**.

Klikk **Lagre**. Du ser «Transportøren er oppdatert».

For å fjerne den klikker du **Slett** på den samme siden, skriver navnet på transportøren med store bokstaver og klikker **Slett**. Fraktregler som bruker denne transportøren, slettes sammen med den. Sendinger du allerede har sendt, beholder fraktetikettene og sporingsnumrene sine.

Når du går over til den nye tilkoblingen, koble først til **Instabox**, oppdater fraktreglene dine til å bruke den, og slett deretter denne gamle tilkoblingen.

## Vanlige problemer

| Hva du ser | Hva du gjør |
| - | - |
| «Kunne ikke koble til transportøren. Prøv igjen.» | Sjekk at alle påkrevde felt er fylt ut, og prøv igjen. |
| «Du har nådd grensen i planen din. Oppgrader planen eller fjern noe du ikke bruker lenger.» | Grensen for transportører i planen din er nådd. Se [Fakturering og forbruk](/docs/no/how-to/billing-and-usage). |
| «Transportøren avviste innloggingsopplysningene dine. Oppdater legitimasjonen for transportøren under Transportører.» når du sender | Sjekk **Klient-ID** og **Klienthemmelighet** under **Rediger transportør**. En gjeldende **API-nøkkel** fra Instabox fungerer ikke her. Bruk [Koble til Instabox](/docs/no/how-to/connect-instabox) for den nøkkelen. |
| «Dette fraktproduktet leverer til et hentested. Velg et hentested før du sender.» | Velg en pakkeautomat for **Levering til pakkeautomat**. Se [Velg et hentested](/docs/no/how-to/pick-a-service-point). |
| «Transportøren avviste dette. Se årsaken fra transportøren, rett opp opplysningene og prøv igjen.» med årsaken «Instabox … is not available for …» når du sender | Instabox tilbyr ikke dette fraktproduktet for det landet og postnummeret. Sjekk adressen, eller velg et annet fraktprodukt. |

## Relatert

* [Koble til Instabox](/docs/no/how-to/connect-instabox)
* [Koble til en transportør eller integrasjon](/docs/no/how-to/connect-index)
* [Legitimasjon for transportører](/docs/no/how-to/carrier-credentials)
* [Testmodus](/docs/no/how-to/sandbox-mode)
* [Be om en transportørintegrasjon](/docs/no/how-to/request-carrier-integration)
* [Transportører](/docs/no/tutorials/carriers)


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