DOCS

Platform forsendelsesintegration

Landed Cost•
HjemFor logistikudbydere Landed Cost Platform forsendelsesintegration

Opret forsendelser fra din platform

Giv kunderne mulighed for at oprette Zonos forsendelser og etiketter fra din platform.

Denne guide er designet til udviklere af forsendelsesplatforme, der ønsker at integrere Zonos forsendelsesoprettelsesfunktioner i deres platform for deres kunder. Hvis du allerede bruger Zonos API'en og kun har brug for at oprette forsendelser for eksisterende ordrer, så se vores forsendelsesoprettelsesguide.

Hvis du er en forsendelsesplatform, der understøtter Zonos kunder, der sender internationalt, bør integration med Zonos for forsendelsesoprettelse være en topprioritet. Dette vil give dig mulighed for at tilbyde den mest problemfrie oplevelse for dine handlende og deres kunder ved at udnytte din platforms eksisterende funktioner, mens Zonos håndterer oprettelsen af forsendelsen, etiketten og den understøttende tolddokumentation.

Fordele ved at bruge Zonos til at oprette forsendelser inkluderer:

  • Tredjeparts fakturering af afgifter og skatter - Vi vil sikre, at dit eller din handelsmands transportørkonto bruges til forsendelsesomkostninger, mens regningerne for afgift og skat sendes til Zonos.
  • Fleksibilitet - I stedet for at udføre udviklingsarbejde for at sikre, at du kan generere overholdende etiketter med din platform, skal du integrere med vores API og lade os håndtere den konstant skiftende grænseoverskridende overholdelse.
  • Præcise tolddokumenter - Når du bruger Zonos til at generere etiketter, sikrer vi, at de rigtige oplysninger sendes til transportøren for at sikre, at pakken hurtigt klarerer tolden.

Denne guide vil føre dig gennem trinene til at implementere en komplet end-to-end integration, der vil give dig mulighed for at kalde Zonos for forsendelser fra din platform.

Aktiver etiketudskrivning 

Følg trinene nedenfor for at give dine kunder mulighed for at hente Zonos etiketter fra din platform.

1

Tillad API-legitimationsoplysninger

Zonos API'en er tilgængelig via en credentialToken. Din platform skal give kunderne mulighed for at indtaste deres credentialToken fra Zonos Dashboard ind i din platform. Herfra vil du kunne foretage anmodninger til Zonos på deres vegne.

2

Opret en forsendelse

For at hente en label er det nødvendigt at oprette en shipment, som label vil være knyttet til. Zonos håndterer denne proces med et workflow, der opretter shipments og labels i den samme anmodning. Når du udfører denne mutation, behøver du ikke at angive et serviceLevel, da vi vil bruge det serviceLevel, der er brugt fra den landedCost, der er knyttet til ordren. For orderId kan du bruge Zonos ordre-ID'et eller accountOrderNumber, som sandsynligvis allerede vil være i dit system.

Når en forsendelse og etiketter er oprettet med succes, vil vi returnere etiketter som en labelImage, som er et BASE64_ENCODED_IMAGE, eller som en url, hvor etiketten kan hentes fra.

Brug dette workflow, når du opretter en forsendelse for en eksisterende ordre og ikke har brug for at ændre vare- eller partydetaljer. Det understøtter valgfrie sporingsnumre, opfyldelsescentre, valg af service niveau og forsikring af erklæret værdi.

Mutation

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {
  shipmentCreateWorkflow(input: $input) {
    id
    status
    trackingDetails {
      number
    }
    serviceLevel {
      id
      name
      carrier {
        id
        name
      }
    }
    shipmentCartons {
      id
      carton {
        id
        width
        length
        height
        weight
        items {
          item {
            id
            amount
            description
          }
        }
      }
      label {
        url
        trackingNumber
        id
        documentFiling
      }
    }
  }
}

Basisvariabler

1
2
3
4
5
6
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789abc"
  }
}

Med Opfyldelsescenter

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789def",
    "fulfillmentCenter": "fulfillment_center_12345"
  }
}

Med brugerdefineret sporing

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": false,
    "orderId": "order_12345678-1234-1234-1234-123456789ghi",
    "trackingNumbers": ["tracking_example_1", "tracking_example_2"]
  }
}

Med serviceniveau

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789jkl",
    "serviceLevel": "dhl.express_example"
  }
}

Med erklæret værdi forsikring

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789mno",
    "isDeclaredValue": true
  }
}

Erklæret værdi

Sæt "isDeclaredValue": true for at aktivere dækning af erklæret værdi for alle varer i din forsendelse. Zonos kræver automatisk den fulde værdi af alle varer, der er indsendt i ordren; handlende kan ikke ændre dette beløb. Dette sætter den maksimale ansvarlighed, som transportøren vil acceptere i tilfælde af tab, skade eller tyveri under transport. Denne funktion understøttes kun for UPS, FedEx og DHL forsendelser. Zonos håndterer automatisk den transportør-specifikke implementering, når du aktiverer erklæret værdi, herunder de relevante parametre i vores API-opkald til disse transportører, så du ikke behøver at håndtere forskellige transportørkrav.

UPS begrænsninger: UPS dækker kun værdier mellem 100-50.000 USD og behandler erklæret værdi på kartonniveau. For forsendelser med flere kartoner skal handlende opdele forsendelsen for at angive dækning pr. karton. UPS genererer også en ekstra forsikringsformular, der skal printes sammen med etiketterne.

FedEx og DHL: Behandler erklæret værdi på forsendelsesniveau uden yderligere restriktioner.

3

Annuller en forsendelse

I tilfælde af at en kunde ønsker at annullere en forsendelse, kan du bruge følgende mutation, der vil annullere alle etiketter, der er knyttet til forsendelsen.

Anmodning

1
2
3
4
5
6
7
8
9
10
11
12
mutation {
  shipmentStatusUpdate(
    input: {
      shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223"
      status: VOIDED
      note: "Voiding shipment"
    }
  ) {
    id
    status
  }
}

Var denne side nyttig?

Book en demo

Spørgsmål?

Få support
© 2025 Zonoszonos.com
På denne side:
  • Opret forsendelser fra din platform
  • Aktiver etiketudskrivning
  • Tillad API-legitimationsoplysninger
  • Opret en forsendelse
  • Annuller en forsendelse