Ana sayfaLojistik sağlayıcıları için Bir Bildirim Kimliğini Doğrulayın

Posta etiketleri | Bir Bildirim Kimliğini Doğrulayın

Bir Bildirim Kimliğinin durumunu alın ve gümrük belgelerini otomatik olarak doldurun

Posta etiketleri oluşturursanız, bir kullanıcı Bildirim Kimliği sağladığında tam gümrük bildirimi ayrıntılarını almak için Zonos'u çağırabilirsiniz. Bu, kullanıcıların gümrük belgelerini manuel olarak doldurma ihtiyacını ortadan kaldırır ve gümrüklerin ön ödendiği ve gümrük formlarının otomatik olarak doldurulduğu sorunsuz bir kargo deneyimi yaratır.

Gümrük bildirimlerini otomatik olarak doldur

Bildirim Kimliklerini kullanarak otomatik gümrük bildirimi popülasyonunu etkinleştirmek için aşağıdaki adımları izleyin.

1. Etiket oluşturma akışında Bildirim Kimliği alanını etkinleştirin

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

2. Bildirim Kimliği durumunu ve gümrük bildirimi ayrıntılarını sorgulayın

Bildirim Kimliğini kullanarak tam gümrük bildirimi verilerini almak için aşağıdaki sorguyu kullanın. Bu, mevcut olduğunda doğrulama durumunu, öğe ayrıntılarını, değerleri, HS kodlarını ve alıcı bilgilerini döndürür

1query DeclarationQuery($id: ID!) {

2 declaration(id: $id) {

3 id

4 status

5 paymentStatus

6 landedCost {

7 id

8 method

9 landedCostGuaranteeCode

10 amountSubtotals {

11 duties

12 taxes

13 fees

14 landedCostTotal

15 }

16 }

17 items {

18 id

19 sku

20 productId

21 amount

22 currencyCode

23 name

24 hsCode

25 description

26 hsCodeSource

27 countryOfOrigin

28 quantity

29 measurements {

30 type

31 value

32 unitOfMeasure

33 }

34 }

35 parties {

36 id

37 type

38 person {

39 firstName

40 lastName

41 email

42 phone

43 }

44 location {

45 id

46 line1

47 line2

48 countryCode

49 postalCode

50 }

51 }

52 }

53}

3. Yanıtı işleyin ve gümrük bildirimleri otomatik olarak doldurun

API yanıtı, doğrulama durumunu ve gümrük verilerini içerir. Bildirim Kimliğinin geçerli olup olmadığını belirlemek için status bilgilerini kullanın, ardından kullanılabilir gümrük verilerini otomatik olarak doldurun veya manuel giriş isteminde bulunun.

Örnek yanıtlar

Tam gümrük verileriyle geçerli Bildirim Kimliği:

{
  "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. Kargo oluşturun

Bildirim Kimliğinden otomatik olarak doldurulmuş veriler veya manuel olarak girilen bildirim bilgileri kullanarak etiket oluşturmayı işleyin.

5. Takip numarasını Bildirim Kimliğine bağlayın

Etiket oluşturulduktan sonra, takip numarasını Bildirim Kimliğiyle bağlamak için declarationShipmentCreate mutasyonunu kullanın ve uygun gümrük ödeme doğrulaması ile kargo takibini sağlayın.

1mutation DeclarationShipmentCreate($input: DeclarationShipmentCreateInput!) {

2 declarationShipmentCreate(input: $input)

3}

Bildirim Kimliğine bağlı bir kargo oluşturabilirsiniz; bu, bir trackingNumbers dizisi ve kargo için kullanılan declarationID iletilerek yapılabilir.

Bildirim Kimliğiyle bir kargo oluşturabilirsiniz; bunu kartonlar ve kartonlar içindeki öğelere ilişkin ayrıntıları ileterek yapabilirsiniz; bu ayrıntıları, ilgili karton için trackingNumber ile birlikte shipmentCarton içinde iletebilirsiniz.

GraphQL API ReferenceTypes, inputs, and operations used in this guide

INPUTS

DeclarationShipmentCreateInput

MUTATIONS

declarationShipmentCreate

Demo rezervasyonu yap