DOCS

Beregne landed cost - GraphQL

Landed Cost•
HjemFor logistikudbydere Landed Cost Beregne landed cost - GraphQL

Beregne en landed cost

Beregne afgifter, skatter og gebyrer med GraphQL.

GraphQL

Zonos beregner den samlede landed cost for internationale forsendelser—inklusive afgifter, skatter og eventuelle yderligere gebyrer opkrævet af told, mæglere eller transportører. I de fleste tilfælde garanterer vi disse beregninger ved at betale den endelige regning selv og opkræve dig præcis det, vi har beregnet. I nogle tilfælde kan du bruge vores landed cost uden garanti, hvilket betyder, at du påtager dig ansvaret for enhver forskel mellem vores beregning og de faktiske omkostninger.

Forbered anmodningen 

Beregning af en landed cost API kræver flere input, som vi har organiseret i arbejdsgange. Når du er færdig, vil du være i stand til at lave en enkelt anmodning for at returnere en landed cost baseret på forsendelsesdestinationen, varerne i indkøbskurven og forsendelsesoplysningerne.

Hver arbejdsgang har sine egne krævede input. GraphQL giver dig mulighed for at sende mere data end nødvendigt, men kun visse felter er nødvendige for at returnere en landed cost. Disse er tydeligt markeret i vores API reference for at se alle mulige felter.

Bemærk, at nogle felter betinget er nødvendige, hvis du ønsker, at din beregning skal være garanteret.

Nedenfor har vi skitseret alle felter, der kræves for at beregne en garanteret landed cost. Sørg for, at disse oplysninger er inkluderet, før du laver din anmodning.

Krævede input til garanterede beregninger

partyCreateWorkflowInput

partyCreateWorkflowInput identificerer de involverede parter og deres placeringer. Se det fulde skema i vores GraphQL API reference. Krævede felter er:

  • location
    • administrativeAreaCode: Koden for staten eller provinsen, i to bogstaver. Kun påkrævet for CA og BR.
    • countryCode: Den to-bogstavs ISO kode for landet.
    • line1: Den første linje af adressen.
    • postalCode: Postnummeret eller zip-koden for adressen.
  • person
    • email: E-mailadressen til personen.
    • firstName: Fornavnet på personen.
    • lastName: Efternavnet på personen.
    • phone: Telefonnummeret til personen.
  • type
    • DESTINATION: location & person oplysningerne for forsendelsesdestinationen.
    • ORIGIN: location oplysningerne for forsendelsesoprindelsen. person tilknyttet forsendelsesoprindelsen er ikke påkrævet.
itemCreateWorkflowInput

itemCreateWorkflowInput lister varerne i indkøbskurven. Der er mange valgfrie felter (se alle muligheder i vores API reference), men felterne nedenfor er påkrævede.

  • amount: Prisen på varen.
  • currencyCode: Valutakoden for varebeløbet.
  • quantity: Mængden af varen.
  • Et af følgende (hvad end der er indstillet som din vare nøgle præference. Din vare nøgle forbinder oplysninger gemt i Kataloget til varen i indkøbskurven og bruges under oprettelse af etiketter.)
    • productId: Vare ID'et.
    • sku: Vare SKU'en.

measurements (WEIGHT, LENGTH, WIDTH, HEIGHT) er kun påkrævet, hvis du ønsker at kartonisere dine varer, når du får en forsendelsesvurdering.

cartonsCreateWorkflowInput

cartonsCreateWorkflowInput kræver kun selve inputtet. Se det fulde skema i vores GraphQL API reference for at se alle værdier, der kan sendes. Det er vigtigt at angive dimensionerne og vægten af kartonen, hvis Zonos beregner forsendelsesomkostningerne.

shipmentRatingCreateWorkflowInput

Denne arbejdsgang bruges, når du allerede kender forsendelsestjenesten og omkostningerne; hvis du ønsker, at Zonos skal beregne disse omkostninger for de tjenester, du har aktiveret, skal du udskifte denne arbejdsgang og bruge shipmentRatingCalculateWorkflow i stedet.

shipmentRatingCreateWorkflowInput kommunikerer forsendelsesomkostningen. Se det fulde skema i vores GraphQL API reference. Krævede felter er:

  • amount: Forsendelsesomkostningen.
  • currencyCode: Valutakoden for forsendelsesomkostningen.
  • serviceLevelCode: Koden, der angiver det forsendelsestjenesteniveau, der anvendes i forsendelsesvurderingen.
landedCostWorkflowInput

landedCostWorkflowInput dikterer præferencerne for beregningen af landed cost. Se det fulde skema i vores GraphQL API reference. Krævede felter er:

  • calculationMethod: Angiver din præference for, hvordan du planlægger at sende: DDP (forudbetalte afgifter og skatter) eller DAP (enten afgifter og skatter betales ved levering, eller hvis en remitteringsordning gælder, betales de via et skatte-ID).
    • Hvis du bruger vores landed cost garanti, skal denne værdi altid være DDP_PREFERRED, som vil give et DDP tilbud, når det er muligt, og et DAP tilbud, hvis et DDP ikke er tilladt. At bruge DAP i stedet kan resultere i, at landed costs ikke længere er garanteret, da dette typisk resulterer i afgifter og skatter betalt ved levering.
  • endUse: Angiver, om varerne sælges til en anden virksomhed (FOR_RESALE) eller til slutbrug med en forbruger (NOT_FOR_RESALE).
  • tariffRate: Angiver den metode, som Zonos skal bruge til at beregne toldsatserne for dette tilbud, i tilfælde af at der er et udvalg af toldsatser, der kan anvendes. *Når du bruger vores landed cost garanti, skal dette altid være ZONOS_PREFERRED.

Tilføj beregnede forsendelsesomkostninger: Hvis du ønsker, at Zonos skal beregne forsendelsesomkostningerne for dig, skal du erstatte shipmentRatingCreateWorkflow med shipmentRatingCalculateWorkflow. Tilføj cartonizeWorkflow, hvis du ønsker, at Zonos skal sortere dine varer i kartoner, før du finder forsendelsesomkostningerne (bruges til dimensional vægt).

HS-kode og forsendelsesmuligheder

GraphQL giver dig fleksibiliteten til at tilpasse forespørgslen efter dine præferencer. Der er et par muligheder for, hvordan du inkluderer HS-koder og forsendelsesomkostninger i forespørgslen.

HS-koder

HS-koder påvirker toldsatser og er derfor nødvendige. Du kan enten angive HS-koden for hver vare eller lade Classify generere dem.

Angiv HS-koder for hver vare

Zonos anbefaler stærkt at bruge produktspecifikke HS-koder, da det fører til en mere præcis landed cost-beregning. Hvis du kender dine HS-koder, skal du angive hsCode for hver item under itemCreateWorkflow.

Hvis du angiver en HS-kode, vil Zonos validere den med det samme, når du får en landed cost-beregning. Hvis den angivne HS-kode er ugyldig (dvs. den ikke eksisterer), vil Zonos re-classify din vare med det samme og bruge den nye, gyldige HS-kode i stedet for den angivne.

Hvis du har brug for hjælp til at generere HS-koder for dine produkter, kan du lære om Zonos Classify og hvordan du anmoder om en klassifikation.

Generer HS-koder med Classify

Hvis du ikke angiver Zonos en hsCode, vil vi først tjekke Zonos Katalog for at se, om du har en HS-kode gemt for din vare. Hvis ikke, vil vi kalde Classify for at generere en klassifikation til at understøtte din landed cost-beregning baseret på følgende itemCreateWorkflow produktdetaljefelter: description, category, og material. Hvis dine produktdetaljefelter ikke er detaljerede nok til at generere en klassifikation baseret på Classify's tillidsscore, vil den standard HS-kode der er tildelt din butik blive brugt.

Forsendelsesomkostninger

Både forsendelsesserviceniveauet og dets omkostninger påvirker told, skatter og gebyrer og er derfor nødvendige. Zonos kan beregne forsendelse, eller du kan angive dette til os.

Beregn forsendelse

For at få Zonos til at beregne forsendelsesomkostninger, brug shipmentRatingCalculateWorkflow. Forsendelsesmulighederne, der returneres i den beregnede forsendelsesrespons, vil korrelere med de serviceLevels, du har tildelt forsendelsesprofiler i Dashboard.

Fejlfinding: Hvis du forventer et serviceLevel i responsen, men det ikke vises, skal du sikre dig, at serviceLevel er aktiveret og understøttes af den method, du har valgt.

Tilføj cartonizeWorkflow (som ikke har nogen input), hvis du ønsker, at Zonos skal sortere dine varer i kartoner, før du finder forsendelsesomkostningen (bruges til dimensionel vægt.

Angiv forsendelsesomkostninger

Hvis du kender serviceLevel og amount for en forsendelse, kan du angive disse i shipmentRatingCreateWorkflow-delen af forespørgslen. Vi vil bruge disse værdier til at beregne eventuelle tilknyttede transportørgebyrer og returnere dem i responsen.

Anmod om en landed cost via API 

Når du har de nødvendige inputdata, send GraphQL-mutation til API-endepunktet ved hjælp af dit valgte klientbibliotek eller værktøj. Her er nogle eksempler på, hvordan du kan strukturere mutationen.

Brug denne forespørgsel, når du får Zonos til at beregne forsendelsesomkostningen som en del af Landed Cost-forespørgslen. Vi vil derefter beregne told og skatter på forsendelse, hvis de vurderes af destinationslandet.

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
41
42
43
44
45
46
47
mutation CalculateLandedCostWithShipping(
  $parties: [PartyCreateWorkflowInput!]!
  $items: [ItemCreateWorkflowInput!]!
  $landedCostConfig: LandedCostWorkflowInput!
) {
  partyCreateWorkflow(input: $parties) {
    type
    id
    organization
  }

  itemCreateWorkflow(input: $items) {
    id
    amount
  }

  cartonizeWorkflow {
    id
    type
    items {
      item {
        id
      }
    }
  }

  shipmentRatingCalculateWorkflow {
    id
    amount
  }

  landedCostCalculateWorkflow(input: $landedCostConfig) {
    id
    duties {
      amount
      currency
    }
    taxes {
      amount
      currency
    }
    fees {
      amount
      currency
    }
  }
}

Variabler

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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
{
  "parties": [
    {
      "location": {
        "administrativeArea": "Utah",
        "administrativeAreaCode": "UT",
        "countryCode": "US",
        "line1": "345 N 2450 E",
        "line2": "#151",
        "locality": "St George",
        "postalCode": "84790"
      },
      "type": "ORIGIN"
    },
    {
      "location": {
        "administrativeArea": "BC",
        "administrativeAreaCode": "BC",
        "countryCode": "CA",
        "line1": "27 Sussex Dr.",
        "locality": "Victoria",
        "postalCode": "V8T 2V9"
      },
      "person": {
        "email": "test@gmail.com",
        "firstName": "firstName",
        "lastName": "lastName",
        "phone": "5022303021",
        "companyName": "goProTest",
        "metadata": { "key": "key", "value": "value" }
      },
      "type": "DESTINATION"
    },
    {
      "type": "PAYOR",
      "location": {
        "administrativeArea": "ON",
        "administrativeAreaCode": "ON",
        "countryCode": "CA",
        "latitude": 1.2,
        "line1": "asdf",
        "line2": "asdf",
        "locality": "locality",
        "longitude": 3423.2,
        "postalCode": "M4C 1A1"
      },
      "person": {
        "email": "test@gmail.com",
        "firstName": "firstName",
        "lastName": "lastName",
        "phone": "5022303021",
        "companyName": "goProTest",
        "metadata": { "key": "key", "value": "value" }
      }
    }
  ],
  "items": [
    {
      "amount": 69,
      "currencyCode": "USD",
      "countryOfOrigin": "US",
      "quantity": 1,
      "productId": "productId",
      "hsCode": "1006.30",
      "description": "description",
      "measurements": [
        { "type": "WIDTH", "value": 2, "unitOfMeasure": "CENTIMETER" },
        { "type": "WEIGHT", "value": 2, "unitOfMeasure": "POUND" }
      ]
    },
    {
      "amount": 62,
      "currencyCode": "CAD",
      "countryOfOrigin": "US",
      "hsCode": "1006.30",
      "quantity": 1,
      "productId": "productId2",
      "description": "description2",
      "measurements": [
        { "type": "WIDTH", "value": 2, "unitOfMeasure": "CENTIMETER" },
        { "type": "WEIGHT", "value": 2, "unitOfMeasure": "POUND" }
      ]
    }
  ],
  "landedCostConfig": {
    "endUse": "FOR_RESALE",
    "method": "DAP",
    "tariffRate": "ZONOS_PREFERRED"
  }
}

Svar

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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
{
  "data": {
    "partyCreateWorkflow": [
      {
        "type": "ORIGIN",
        "id": "party_749959ae-b9ff-4de4-b4ac-59cc990c53ba",
        "organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
      },
      {
        "type": "DESTINATION",
        "id": "party_cd7ff245-76b6-464f-a7bf-151ebe1f8833",
        "organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
      },
      {
        "type": "PAYOR",
        "id": "party_00e63a9e-9735-44d9-b129-3b3e76c5df25",
        "organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
      }
    ],
    "itemCreateWorkflow": [
      {
        "id": "item_eb27f071-de8b-4578-9db9-ae69aaf9be3e",
        "amount": 69
      },
      {
        "id": "item_fffa8ba8-cc8d-4e13-bed6-55044a71c115",
        "amount": 62
      }
    ],
    "cartonizeWorkflow": [
      {
        "id": "carton_b34b29c1-ce27-464b-b91b-df8e4a696312",
        "type": "PACKAGE",
        "items": [
          {
            "item": {
              "id": "item_eb27f071-de8b-4578-9db9-ae69aaf9be3e"
            }
          },
          {
            "item": {
              "id": "item_fffa8ba8-cc8d-4e13-bed6-55044a71c115"
            }
          }
        ]
      }
    ],
    "shipmentRatingCalculateWorkflow": [
      {
        "id": "shipment_rating_96787309-9510-43cc-b4fa-c341ff80f4cc",
        "amount": 173.2
      },
      {
        "id": "shipment_rating_b0ccb109-7794-4c7c-b5cc-e2cfbbc5c8ac",
        "amount": 190.1
      }
    ],
    "landedCostCalculateWorkflow": [
      {
        "id": "landed_cost_74d3ce11-bff2-4326-9e6f-368e03ac88b4",
        "duties": [
          {
            "amount": 0.0,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          }
        ],
        "taxes": [
          {
            "amount": 3.45,
            "currency": "USD"
          },
          {
            "amount": 3.1,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          }
        ],
        "fees": [
          {
            "amount": 0.13,
            "currency": "USD"
          },
          {
            "amount": 1.44,
            "currency": "USD"
          }
        ]
      },
      {
        "id": "landed_cost_7bbfd354-028c-457f-8c8e-c81bb8fa09a0",
        "duties": [
          {
            "amount": 0.0,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          }
        ],
        "taxes": [
          {
            "amount": 3.45,
            "currency": "USD"
          },
          {
            "amount": 3.1,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          }
        ],
        "fees": [
          {
            "amount": 0.13,
            "currency": "USD"
          },
          {
            "amount": 1.44,
            "currency": "USD"
          }
        ]
      }
    ]
  }
}

Anmod om en landed cost i Dashboard 

Du kan også beregne landed costs direkte i Zonos Dashboard uden at bruge API'en. Dette er nyttigt til at teste beregninger, træne dit team eller få hurtige tilbud til kundehenvendelser.

Dashboard bruger de samme API-endepunkter, der er beskrevet ovenfor, så resultaterne vil matche det, du ville få fra direkte API-opkald. Dette gør det til en fremragende måde at validere din API-integration eller udforske, hvordan forskellige input påvirker beregningerne.

Brug af Dashboard-beregneren

Med landed cost-beregneren i Dashboard kan du få tilbud med beregnede forsendelsesomkostninger, oprette tilbud med kendte forsendelsesomkostninger eller behandle flere tilbud i bulk.

Brug denne proces, når du kender forsendelsestjenesteniveauet og omkostningerne for din forsendelse.

  1. Gå til Dashboard → Orders → Quotes
  2. Klik på Nyt tilbud
  3. Valgfrit — Ændr placeringen af din afsendelsesadresse
  4. Vælg et Destination land fra dropdown-menuen
  5. Indtast forsendelsesbeløbet
    • Serviceniveauet er valgfrit; at tilføje det giver os mulighed for at beregne gældende transportørgebyrer
  6. Tilføj vareoplysninger for forsendelsen
    • Når du indtaster en beskrivelse, klassificerer vi automatisk classify produktet og genererer en HS-kode
    • Du kan overskrive den genererede HS-kode, hvis det er nødvendigt
    • For flere varer, klik på Gem og tilføj en anden. Ellers klik på Gem
  7. Valgfrit — Klik på Flere muligheder for at ændre:
    • Salgstype til Til videresalg
    • Leveringsmetode til Levering uden betalte afgifter
  8. Klik på Få tilbud
    • For at foretage ændringer, klik på Rediger formular og ændre eventuelle detaljer
    • Klik på Få tilbud igen for at opdatere

Et landed cost tilbud vises til højre, inklusive produkt-, forsendelses- og importomkostninger. Udvid tilbuddet for at se detaljerede opdelinger af varer, forsendelse, afgifter, skatter og gebyrer. Alle tilbud gemmes på tilbudssiden til fremtidig reference.

Rediger eksisterende tilbud: Klik på Tilbud igen i øverste højre hjørne for at ændre et eksisterende tilbud i stedet for at starte forfra.

Fordele ved at bruge Dashboard

  • Ingen kodning kræves — Generer tilbud gennem en brugervenlig grænseflade
  • Teamtræning — Hjælp ikke-tekniske teammedlemmer med at forstå landed cost komponenter
  • API-validering — Bekræft, at din API-integration giver forventede resultater
  • Kundesupport — Generer hurtigt tilbud til kundehenvendelser
  • Bulkbehandling — Håndter flere beregninger effektivt (kommer snart)

Dashboard-tilbud inkluderer de samme detaljerede opdelinger, der er tilgængelige gennem API'en, hvilket gør det til et fremragende supplement til din automatiserede integration.

Var denne side nyttig?

Book en demo

Spørgsmål?

Få support
© 2025 Zonoszonos.com
På denne side:
  • Beregne en landed cost
  • Forbered anmodningen
  • Anmod om en landed cost via API
  • Anmod om en landed cost i Dashboard