DOCS

Integrering av frakt på plattformen

Landed Cost•
HemFör logistikleverantörer Landed Cost Integrering av frakt på plattformen

Skapa frakter från din plattform

Ge kunderna möjlighet att skapa Zonos frakter och etiketter från din plattform.

Denna guide är utformad för utvecklare av fraktplattformar som vill integrera Zonos frakt skapande funktioner i sin plattform för sina kunder. Om du redan använder Zonos API och bara behöver skapa frakter för befintliga beställningar, se vår guide för frakt skapande.

Om du är en fraktplattform som stöder Zonos kunder som skickar internationellt, bör integration med Zonos för frakt skapande vara en hög prioritet. Detta kommer att göra det möjligt för dig att erbjuda den mest sömlösa upplevelsen för dina handlare och deras kunder genom att utnyttja din plattforms befintliga funktioner samtidigt som Zonos hanterar skapandet av frakten, etiketten och stödjande tulldokumentation.

Fördelar med att använda Zonos för att skapa frakter inkluderar:

  • Tredjeparts fakturering av avgifter och skatter - Vi kommer att säkerställa att ditt eller din handlares fraktkonto används för fraktkostnader medan räkningarna för avgifter och skatter kommer till Zonos.
  • Flexibilitet - Istället för att utföra utvecklingsarbete för att säkerställa att du kan generera överensstämmande etiketter med din plattform, integrera med vårt API och låt oss hantera den ständigt föränderliga gränsöverskridande efterlevnaden.
  • Korrekt tulldokumentation - När du använder Zonos för att generera etiketter, säkerställer vi att rätt detaljer överförs till transportören för att säkerställa att paketet snabbt klarar tullen.

Denna guide kommer att leda dig genom stegen för att implementera en komplett end-to-end integration som gör att du kan anropa Zonos för frakter från din plattform.

Aktivera etikettutskrift 

Följ stegen nedan för att låta dina kunder hämta Zonos etiketter från din plattform.

1

Tillåt API-uppgifter

Den Zonos API är tillgänglig med en credentialToken. Din plattform måste ge kunderna möjlighet att ange sin credentialToken från Zonos Dashboard i din plattform. Härifrån kommer du att kunna göra förfrågningar till Zonos på deras vägnar.

2

Skapa en frakt

För att hämta en etikett måste du skapa en frakt som etiketten kommer att kopplas till. Zonos hanterar denna process med ett arbetsflöde som skapar frakter och etiketter i samma begäran. När du utför denna mutation behöver du inte skicka en serviceLevel eftersom vi kommer att använda den serviceLevel som används från den landedCost som är kopplad till beställningen. För orderId kan du använda Zonos beställnings-ID eller accountOrderNumber som sannolikt redan finns i ditt system.

När en frakt och etiketter har skapats framgångsrikt kommer vi att returnera etiketter som en labelImage som är en BASE64_ENCODED_IMAGE, eller som en url där etiketten kan hämtas.

Använd detta arbetsflöde när du skapar en frakt för en befintlig beställning och inte behöver ändra artikel- eller partydetaljer. Det stöder valfria spårningsnummer, uppfyllande centra, val av service nivå och försäkring för deklarerat värde.

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
      }
    }
  }
}

Grundläggande variabler

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

Med uppfyllningscenter

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

Med anpassad spårning

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 servicenivå

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

Med deklarerad värdeförsäkring

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

Deklarerat värde

Ställ in "isDeclaredValue": true för att aktivera täckning för deklarerat värde för alla artiklar i din försändelse. Zonos gör automatiskt anspråk på det fulla värdet av alla artiklar som skickas in i beställningen; handlare kan inte ändra detta belopp. Detta sätter det maximala ansvar som transportören kommer att acceptera vid förlust, skada eller stöld under transport. Denna funktion stöds endast för UPS, FedEx och DHL-försändelser. Zonos hanterar automatiskt transportörspecifik implementering när du aktiverar deklarerat värde, inklusive de lämpliga parametrarna i våra API-anrop till dessa transportörer, så du behöver inte hantera olika transportörers krav.

UPS begränsningar: UPS täcker endast värden mellan 100-50,000 USD och behandlar deklarerat värde på kartonnivå. För fler-kartong försändelser måste handlare dela upp försändelsen för att ange täckning per kartong. UPS genererar också ett ytterligare försäkringsformulär som måste skrivas ut med etiketterna.

FedEx och DHL: Behandlar deklarerat värde på försändelsenivå utan ytterligare begränsningar.

3

Ogiltigförklara en försändelse

Om en kund vill ogiltigförklara en försändelse, kan du använda följande mutation som kommer att ogiltigförklara alla etiketter kopplade till försändelsen.

Begäran

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 den här sidan till hjälp?

Boka en demo

Frågor?

Få support
© 2025 Zonoszonos.com
På den här sidan:
  • Skapa frakter från din plattform
  • Aktivera etikettutskrift
  • Tillåt API-uppgifter
  • Skapa en frakt
  • Ogiltigförklara en försändelse