DOCS

Bir Beyan Kimliğini Doğrula

Ana sayfaLojistik sağlayıcıları için Bir Beyan Kimliğini Doğrula

Gönderi etiketleri | Bir Beyan Kimliğini Doğrula

Bir Beyan Kimliğinin durumunu al ve gümrük belgelerini otomatik doldur

Posta etiketleri oluşturuyorsanız, bir kullanıcı bir Beyan Kimliği sağladığında gümrük beyanı detaylarını almak için Zonos'u çağırabilirsiniz. Bu, kullanıcıların gümrük belgelerini manuel olarak doldurmalarını ortadan kaldırarak, vergilerin önceden ödendiği ve gümrük formlarının otomatik olarak doldurulduğu kesintisiz bir gönderim deneyimi yaratır.

Gümrük beyanlarını otomatik doldurma 

Platformunuzdan Beyan Kimliklerini kullanarak otomatik gümrük beyanı doldurmayı etkinleştirmek için aşağıdaki adımları izleyin.

1. Etiket oluşturma akışında Beyan Kimliği alanını etkinleştir

Posta etiketi oluşturma arayüzünüze bir Beyan Kimliği alanı ekleyin. Kullanıcılar geçerli bir Beyan Kimliği girdiğinde, platformunuz gümrük beyanını otomatik olarak doldurabilir ve manuel veri girişi ihtiyacını ortadan kaldırır.

2. Beyan Kimliği durumunu ve gümrük beyanı detaylarını sorgula

Beyan Kimliğini kullanarak tam gümrük beyanı verilerini almak için aşağıdaki sorguyu kullanın. Bu, mevcut olduğunda doğrulama durumu ile birlikte öğe detaylarını, değerleri, HS kodlarını ve alıcı bilgilerini döndürür.

Sorgu

GraphQL

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
query DeclarationQuery($id: ID!) {
  declaration(id: $id) {
    id
    status
    paymentStatus
    landedCost {
      id
      method
      landedCostGuaranteeCode
      amountSubtotals {
        duties
        taxes
        fees
        landedCostTotal
      }
    }
    items {
      id
      sku
      productId
      amount
      currencyCode
      name
      hsCode
      description
      hsCodeSource
      countryOfOrigin
      quantity
      measurements {
        type
        value
        unitOfMeasure
      }
    }
    parties {
      id
      type
      person {
        firstName
        lastName
        email
        phone
      }
      location {
        id
        line1
        line2
        countryCode
        postalCode
      }
    }
  }
}

Değişkenler

GraphQL

1
2
  "id": "0mm1993s0mdcn"
}

3. Yanıtı işleme ve gümrük beyanını otomatik doldurma

API yanıtı, doğrulama durumu ve gümrük verilerini içerir. status bilgisini kullanarak Beyan ID'sinin geçerli olup olmadığını belirleyin, ardından mevcut gümrük verilerini otomatik doldurun veya manuel giriş için talep edin.

Örnek yanıtlar

Tam gümrük verileri ile geçerli Beyan ID'si:

Yanıt

JSON

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
{
  "data": {
    "declaration": {
      "id": "0mm1993s0mdcn",
      "status": "OPEN",
      "paymentStatus": "OPEN",
      "landedCost": {
        "id": "landed_cost_eabb13ab-df23-45df-9ce8-96dd29d396d1",
        "method": "DAP",
        "landedCostGuaranteeCode": "NOT_APPLICABLE",
        "amountSubtotals": {
          "duties": 0.0,
          "taxes": 0.0,
          "fees": 2.62,
          "landedCostTotal": 2.62
        }
      },
      "items": [
        {
          "id": "item_0mm199388v57g",
          "sku": "item_1",
          "productId": "item_1",
          "amount": 70.0,
          "currencyCode": "USD",
          "name": "Item 1",
          "hsCode": "9504.90.4000",
          "description": "This is the description for Item 1",
          "hsCodeSource": "TARIFF_COMPLETED",
          "countryOfOrigin": "CN",
          "quantity": 2,
          "measurements": [
            {
              "type": "WEIGHT",
              "value": 1,
              "unitOfMeasure": "POUND"
            }
          ]
        }
      ],
      "parties": [
        {
          "id": "party_0kesb32rw5hfa",
          "type": "DESTINATION",
          "person": {
            "firstName": "test",
            "lastName": "origin",
            "email": null,
            "phone": "1234567890"
          },
          "location": {
            "id": "location_c7882546-652e-49cb-81a4-98962a54c49f",
            "line1": "123 Test Street",
            "line2": "",
            "countryCode": "US",
            "postalCode": "84790"
          }
        },
        {
          "id": "party_0mjfz59bgg175",
          "type": "ORIGIN",
          "person": {
            "firstName": "test",
            "lastName": "destination",
            "email": null,
            "phone": "1234567890"
          },
          "location": {
            "id": "location_0mdzb9vk8bp7c",
            "line1": "998 Ridgehaven",
            "line2": null,
            "countryCode": "CA",
            "postalCode": "N0N 0N0"
          }
        }
      ]
    }
  }
}

4. Gönderimi oluşturun

Etiket oluşturma işlemini, bir Beyan Kimliği'nden otomatik doldurulmuş verileri kullanarak veya manuel olarak girilen beyan bilgileriyle gerçekleştirin.

5. Takip numarasını Beyan Kimliği ile bağlayın

Etiket oluşturulduktan sonra, takip numarasını Beyan Kimliği ile bağlamak için declarationShipmentCreate mutasyonunu kullanın, böylece doğru gümrük vergisi ödeme doğrulaması ve gönderim takibi sağlanır.

Gönderimi oluştur

GraphQL

1
2
3
mutation DeclarationShipmentCreate($input: DeclarationShipmentCreateInput!) {
  declarationShipmentCreate(input: $input)
}

Bir Gönderimi, gönderim için kullanılan declarationID ve bir dizi trackingNumbers geçirerek oluşturabilirsiniz.

Karton detayları olmadan değişkenler

GraphQL

1
2
3
4
5
6
{
  "input": {
    "declarationId": "0mm32wfyrn5es",
    "trackingNumbers": ["test_tracking_1", "test_tracking_2"]
  }
}

Bir gönderim oluşturmak için gönderim için kullanılan declarationID'yi geçirebilirsiniz. Kartonlar ve kartonlar içindeki öğeler hakkında detaylarınız varsa, bunları shipmentCarton içinde ve o karton için trackingNumber ile birlikte geçirebilirsiniz.

Karton detayları ile değişkenler

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
  "input": {
    "declarationId": "0mm32wfyrn5es",
    "shipmentCartons": [
      {
        "dimensionalUnit": "INCH",
        "length": 8,
        "width": 4,
        "height": 2,
        "trackingNumber": "1234567890",
        "weight": 5,
        "weightUnit": "POUND",
        "items": [
          {
            "itemReference": "item_1",
            "quantity": 3,
            "hsCode": "1234.56.7890"
          }
        ]
      }
    ]
  }
}

Bu sayfa faydalı mıydı?

Demo rezervasyonu yap

Sorular?

Destek alın
© 2025 Zonoszonos.com
Bu sayfada:
  • Gönderi etiketleri | Bir Beyan Kimliğini Doğrula
  • Gümrük beyanlarını otomatik doldurma