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

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

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.

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.