DOCS

Platformens forsendelsesintegration

Landed Cost•
HjemFor logistikudbydere Landed Cost Platformens forsendelsesintegration

Opret forsendelser fra din platform

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

Denne vejledning er designet til udviklere af forsendelsesplatforme, der ønsker at integrere Zonos oprettelse af forsendelser-muligheder i deres platform til deres kunder. Hvis du allerede bruger Zonos API'en og blot har brug for at oprette forsendelser til eksisterende ordrer, se vores Guide til oprettelse af forsendelse.

Hvis du er en forsendelsesplatform, der understøtter Zonos kunder, der opererer internationalt, bør integration med Zonos for oprettelse af forsendelser være en af de øverste overvejelser. Dette vil give dig mulighed for at tilbyde den mest problemfri oplevelse for dine sælgere og deres kunder ved at udnytte din platforms eksisterende funktioner, samtidig med at Zonos står for oprettelsen af forsendelsen, etiketten og den nødvendige tolddokumentation.

Fordele ved at bruge Zonos til at oprette forsendelser inkluderer:

  • Tredjepartsfakturering af told og afgifter - Vi sikrer, at du eller din forhandlers transportørkonto bruges til forsendelsesomkostningerne, mens regningerne for told og afgifter går til Zonos.
  • Fleksibilitet - I stedet for at udføre udviklingsarbejde for at sikre, at du kan generere overensstemmende etiketter med din platform, integrer med vores API og overlade den stadigt skiftende grænseoverskridende overholdelse til os.
  • Nøjagtig tolddokumentation - Når du bruger Zonos til at generere etiketter, sikrer vi, at de korrekte oplysninger videregives til transportøren, så pakken hurtigt kan klare tolden.

Denne vejledning vil guide dig gennem trinnene til at implementere en komplet end-to-end integration, der gør det muligt at kalde Zonos til 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

Den Zonos API er tilgængelig via et credentialToken. Din platform skal give kunderne mulighed for at indtaste deres credentialToken fra Zonos Kontrolpanel i din platform. Fra dette vil du kunne foretage anmodninger til Zonos på deres vegne.

2

Opret en forsendelse

For at hente en label skal du oprette en forsendelse, hvortil label vil være tilknyttet. Zonos kontrollerer denne proces med en arbejdsgang, der opretter shipments og labels i samme anmodning. Når du udfører denne mutation, behøver du ikke at angive en serviceLevel, da vi vil bruge den serviceLevel, der bruges fra landedCost, som er knyttet til order. For orderId kan du bruge Zonos-ordre-ID eller accountOrderNumber, som sandsynligvis allerede findes i dit system.

Når en forsendelse og etiketter oprettes med succes, returnerer vi etiketterne som en labelImage, som er en BASE64_ENCODED_IMAGE, eller som en url, hvor etiketten kan hentes fra.

Brug denne arbejdsgang, når du opretter en forsendelse til en eksisterende ordre og ikke behøver at ændre vare- eller partoplysninger. Den understøtter valgfrie sporingsnumre, opfyldelsescentre, valg af service niveau og forsikring for deklareret 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