DOCS

Create a landed cost graphql

/

Create a landed cost

Learn how to create a landed cost from a shipment rating.

GraphQL

In scenarios where you are using Zonos to calculate shipment ratings but have another means of calculating taxes to support your business, you can use the createLandedCost mutation. This mutation will allow you to create a landed cost that is required for order creation, without Zonos calculating duties, taxes, and fees.

API examples 

When using landedCostCreate, you are required to pass the currencyCode and endUse. You will also be required to pass the rootId and shipmentRatingId that were obtained from the original shipment rating workflow. You can optionally provide a list or lists of duties, fees, and taxes. When providing these details, you are required to send the amount and formula that was used to determine the value used in the amount field.

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
48
49
50
51
52
53
54
55
56
57
58
59
60
mutation {
  landedCostCreate(
    input: {
      currencyCode: USD
      endUse: NOT_FOR_RESALE
      shipmentRating: "shipment_rating_822af8c6-9d3f-49e5-bc7a-1a96691c322b"
      tariffRate: ZONOS_PREFERRED
      taxes: [
        {
          amount: "3.375"
          formula: "6.75% of the item cost"
          item: "item_268b5769-4ffd-47d5-a1c7-0177a9a281d1"
          description: "Sales Tax"
        }
        {
          amount: "4.6575"
          formula: "6.75% of the item cost"
          item: "item_1735c05f-cc4a-48bc-8a4f-de8346572288"
          description: "Sales Tax"
        }
        {
          amount: "2.47725"
          formula: "6.75% of the shipping cost"
          description: "Sales Tax"
        }
      ]
      rootId: "zonos_internal_federated_request_2610cbc2-991e-4acc-b78c-106ed1b06792"
    }
  ) {
    id
    landedCostGuaranteeCode
    taxes {
      amount
      formula
      item {
        id
        sku
        amount
      }
    }
    amountSubtotals {
      items
      taxes
      shipping
    }
    shipmentRating {
      shipmentRatingCartons {
        carton {
          items {
            item {
              sku
              amount
              id
            }
          }
        }
      }
    }
  }
}

Response

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
{
  "data": {
    "landedCostCreate": {
      "id": "landed_cost_c2ccd403-81e0-4ea9-8958-bc5cc5f10b81",
      "landedCostGuaranteeCode": "NOT_APPLICABLE",
      "taxes": [
        {
          "amount": 3.375,
          "formula": "6.75% of the item cost",
          "item": {
            "id": "item_268b5769-4ffd-47d5-a1c7-0177a9a281d1",
            "sku": "1",
            "amount": 50.0
          }
        },
        {
          "amount": 4.6575,
          "formula": "6.75% of the item cost",
          "item": {
            "id": "item_1735c05f-cc4a-48bc-8a4f-de8346572288",
            "sku": "2",
            "amount": 69.0
          }
        },
        {
          "amount": 2.47725,
          "formula": "6.75% of the shipping cost",
          "item": null
        }
      ],
      "amountSubtotals": {
        "items": 119.0,
        "taxes": 10.51,
        "shipping": 36.7
      },
      "shipmentRating": {
        "shipmentRatingCartons": [
          {
            "carton": {
              "items": [
                {
                  "item": {
                    "sku": "1",
                    "amount": 50.0,
                    "id": "item_268b5769-4ffd-47d5-a1c7-0177a9a281d1"
                  }
                },
                {
                  "item": {
                    "sku": "2",
                    "amount": 69.0,
                    "id": "item_1735c05f-cc4a-48bc-8a4f-de8346572288"
                  }
                }
              ]
            }
          }
        ]
      }
    }
  }
}

Was this page helpful?