DOCS

Retrieve tax id

/

Retrieve tax ID

Retrieve the tax ID needed to process low-value shipments.

GraphQL

If you are using the Landed Cost API you can request a taxId when creating a Landed Cost quote or after it has been created. This taxId will only be returned if the shipment that the quote is being generated for will require remittance based on the destination country and item value. This taxId can then be passed to the carrier when you are creating the label and commercial invoice.

Retrieve tax ID for remittance 

The mutations and queries referenced below will show how an applciable taxId will be returned in the response. In the event that a taxId does not apply to the shipment the taxId field will be empty.

Request
Response

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
mutation {
  landedCostCalculateWorkflow(
    input: { endUse: NOT_FOR_RESALE, method: DAP, tariffRate: ZONOS_PREFERRED }
  ) {
    id
    amountSubtotals {
      duties
    }

    duties {
      amount
      currency
    }
    taxes {
      amount
      currency
    }
    fees {
      amount
      description
      currency
    }
    remittance {
      amount
      description
      note
    }
    taxId {
      taxIdNumber
      countryCode
    }
  }
}
Request
Response

Query

1
2
3
4
5
6
7
query {
  landedCost(id: "landed_cost_f809d1a3-8551-46c2-9d20-b0cdb16b39b6") {
    taxId {
      taxIdNumber
    }
  }
}

Was this page helpful?