DOCS

Gümrük manifestosu hazırlayın

ABD gönderimleri için bir gümrük manifestosu hazırlayın.

Zonos'a gelen posta gönderim verilerini sağlayın.

Zonos ABD'ye yapılan posta gönderimleri için gerekli tüm bilgileri içeren kapsamlı gümrük manifestoları hazırlayacaktır.

Talebi hazırlayın 

Bir manifestonun oluşturulması, gönderim verilerinizi uygun bir yapıya organize etmeyi gerektirir. API, önce manifestoyu oluşturduğunuz, ardından kapları eklediğiniz ve son olarak her bir kabı gönderim detaylarını içeren manifest satırlarıyla doldurduğunuz hiyerarşik bir yaklaşım kullanır.

Her bileşenin gümrük uyumluluğunu ve doğru belgeleri sağlamak için belirli gerekli alanları vardır. Aşağıda, temel veri yapısını ve gerekli girdileri özetledik.

Anahtar girdi türleri

Manifest API, gönderim verilerini organize etmek için birkaç girdi türü kullanır:

  • ManifestInput: Havaalanları, waybill türü ve uçuş detayları gibi yüksek düzeyde gönderim bilgileri
  • ManifestLineInput: Bir kap içindeki bireysel gönderim detayları
  • ManifestLineItemInput: Gümrük sınıflandırması için ürün bilgileri
  • CreatePartyInput: Menşei ve varış yeri için taraf ve konum detayları

Tam alan tanımlarını ve seçeneklerini GraphQL API referansımızda görüntüleyin.

API aracılığıyla bir manifest oluşturun 

Gönderim verilerinizi organize ettikten sonra, manifestoyu oluşturmak için GraphQL mutasyonunu gönderin.

Adım 1: Manifesto başlığını oluşturun

MUTASYON

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
mutation ManifestCreate {
  manifestCreate(
    input: {
      arrivalDate: "2025-09-11T16:16:49.262Z"
      postalOperatorCode: J1CMDA
      carrierCode: "AA"
      destinationCode: "JFK"
      serviceNumber: "11"
    }
  ) {
    amount
    createdAt
    createdBy
    id
    postalOperatorCode
    transportationMode
    updatedAt
    updatedBy
    weight
    weightUnit
    lines(first: 5) {
      totalCount
      edges {
        cursor
        node {
          createdAt
          createdBy
          id
          updatedAt
          updatedBy
          landedCost {
            id
          }
        }
      }
    }
    arrivalDate
    awbPrefix
    carrierCode
    destinationCode
    originCode
    operatorDestination
    statusTransitions {
      note
      source
      createdAt
      createdBy
    }
    operatorOrigin
    serviceNumber
    source
  }
}

Adım 2: Manifest satırlarını ekleyin

manifestCreate mutasyonundan dönen kimliği kullanarak, artık bireysel gönderimleri manifestoya bağlayabilirsiniz.

MUTASYON

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
mutation ManifestLineCreate {
  manifestLineCreate(
    manifestId: "A-AA137-J1CGBA-(2025-09-12)"
    input: {
      endUse: NOT_FOR_RESALE
      trackingNumber: "1Z08134599"
      referenceNumber: "test"
      items: { amount: "453", quantity: 2, countryOfOrigin: CN }
      parties: [
        { type: ORIGIN, location: { countryCode: GB } }
        { type: DESTINATION, location: { countryCode: US } }
      ]
      currencyCode: USD
    }
  ) {
    createdAt
    createdBy
    endUse
    id
    manifestId
    trackingNumber
    updatedAt
    updatedBy
  }
}

Adım 3: Manifestoyu Güncelle

Uçuş detaylarının değişmesi durumunda, aşağıdaki mutasyonu kullanarak manifest detaylarını güncelleyebilirsiniz.

MUTASYON

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
mutation ManifestUpdate {
  manifestUpdate(
    id: "manifest_0my2erm8c14z3"
    input: {
      source: RESDIT
      carrierCode: "JFK"
      arrivalDate: "2025-09-12T16:16:49.262Z"
      serviceNumber: "79824513"
      note: "Update from RESDIT"
    }
  ) {
    amount
    arrivalDate
    awbNumber
    awbPrefix
    carrierCode
    createdAt
    createdBy
    destinationCode
    id
    operatorDestination
    operatorOrigin
    originCode
    postalOperatorCode
    serviceNumber
    source
    transportationMode
    updatedAt
    updatedBy
    weight
    statusTransitions {
      note
      source
      createdAt
    }
  }
}

Bu sayfa faydalı mıydı?