DOCS

Gümrük manifestosu hazırla

Ana sayfaLojistik sağlayıcıları için Taşıyıcılar ve Yeniden Satıcılar Gümrük manifestosu hazırla

ABD gönderileri için gümrük manifestosu hazırla.

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

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

İsteği hazırla 

Bir manifest oluşturmak, gönderi verilerinizi uygun yapıya düzenlemeyi gerektirir. API, önce manifestoyu oluşturduğunuz ve ardından bireysel gönderi ayrıntılarını içeren manifest satırlarını eklediğiniz hiyerarşik bir yaklaşım kullanır.

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

Ana giriş türleri

Manifest API'si, gönderi verilerini düzenlemek için çeşitli giriş türleri kullanır:

  • ManifestInput: Havaalanları, waybill türü ve uçuş ayrıntılarını içeren üst düzey gönderi bilgileri
  • ManifestLineInput: Bir manifesto ile ilişkili bireysel gönderi ayrıntıları
  • ManifestLineItemInput: Gümrük sınıflandırması için ürün bilgileri
  • CreatePartyInput: Menşe ve hedef için taraf ve konum ayrıntıları

GraphQL API referansında tam alan tanımlarını ve seçenekleri görüntüleyin.

API aracılığıyla manifest oluştur 

Gönderi verilerinizi düzenledikten sonra, manifestoyu oluşturmak için GraphQL mutasyonunu gönderin.

Adım 1: Manifest başlığı oluştur

1mutation ManifestCreate($input: ManifestInput!) {
2 manifestCreate(input: $input) {
3 id
4 amount
5 arrivalDate
6 awbNumber
7 awbPrefix
8 carrierCode
9 createdAt
10 createdBy
11 destinationCode
12 operatorDestination
13 operatorOrigin
14 originCode
15 postalOperatorCode
16 serviceNumber
17 source
18 transportationMode
19 updatedAt
20 updatedBy
21 weight
22 weightUnit
23 statusTransitions {
24 createdAt
25 createdBy
26 note
27 source
28 }
29 lines(first: 5) {
30 totalCount
31 edges {
32 cursor
33 node {
34 id
35 trackingNumber
36 endUse
37 currencyCode
38 createdAt
39 createdBy
40 updatedAt
41 updatedBy
42 landedCost {
43 id
44 }
45 }
46 }
47 }
48 }
49}

RESPONSE

json

{
  "data": {
    "manifestCreate": {
      "id": "manifest_abc123def456",
      "amount": "0",
      "arrivalDate": "2026-03-15T14:30:00.000Z",
      "awbNumber": "1234",
      "awbPrefix": "001",
      "carrierCode": "AA",
      "createdAt": "2026-01-06T12:00:00.000Z",
      "createdBy": "organization_xyz789",
      "destinationCode": "JFK",
      "operatorDestination": "US",
      "originCode": "LHR",
      "postalOperatorCode": "J1CGBA",
      "serviceNumber": "1234",
      "source": "API",
      "transportationMode": "AIR",
      "updatedAt": "2026-01-06T12:00:00.000Z",
      "updatedBy": "organization_xyz789",
      "weight": "0",
      "weightUnit": "KILOGRAM",
      "statusTransitions": [],
      "lines": {
        "totalCount": 0,
        "edges": []
      }
    }
  }
}

Adım 2: Manifest satırları ekle

manifestCreate mutasyonundan döndürülen ID'yi kullanarak, artık bireysel gönderimleri manifesto ile ilişkilendirebilirsiniz.

1mutation ManifestLineCreate($manifestId: ID!, $input: ManifestLineInput!) {
2 manifestLineCreate(manifestId: $manifestId, input: $input) {
3 id
4 manifestId
5 trackingNumber
6 endUse
7 currencyCode
8 referenceNumber
9 arrivalDate
10 createdAt
11 createdBy
12 updatedAt
13 updatedBy
14 landedCost {
15 id
16 }
17 }
18}

RESPONSE

json

{
  "data": {
    "manifestLineCreate": {
      "id": "manifest_line_def456ghi789",
      "manifestId": "manifest_abc123def456",
      "trackingNumber": "LX123456789GB",
      "endUse": "NOT_FOR_RESALE",
      "currencyCode": "USD",
      "referenceNumber": "ORDER-2026-001",
      "arrivalDate": "2026-03-15T14:30:00.000Z",
      "createdAt": "2026-01-06T12:05:00.000Z",
      "createdBy": "organization_xyz789",
      "updatedAt": "2026-01-06T12:05:00.000Z",
      "updatedBy": "organization_xyz789",
      "landedCost": null
    }
  }
}

Adım 3: Birden fazla manifest satırı ekle (toplu)

Verimlilik için, manifestLinesCreate mutasyonunu kullanarak tek bir istekte birden fazla manifest satırı ekleyebilirsiniz. Her satır, gönderimin menşe ve hedefini tanımlamak için kendi parties dizisini gerektirir.

1mutation ManifestLinesCreate($manifestId: ID!, $input: [ManifestLineInput!]!) {
2 manifestLinesCreate(manifestId: $manifestId, input: $input) {
3 id
4 manifestId
5 trackingNumber
6 endUse
7 currencyCode
8 createdAt
9 }
10}

RESPONSE

json

{
  "data": {
    "manifestLinesCreate": [
      {
        "id": "manifest_line_aaa111bbb222",
        "manifestId": "manifest_abc123def456",
        "trackingNumber": "LX123456789GB",
        "endUse": "NOT_FOR_RESALE",
        "currencyCode": "USD",
        "createdAt": "2026-01-06T12:10:00.000Z"
      },
      {
        "id": "manifest_line_ccc333ddd444",
        "manifestId": "manifest_abc123def456",
        "trackingNumber": "LX987654321GB",
        "endUse": "GIFT",
        "currencyCode": "USD",
        "createdAt": "2026-01-06T12:10:00.000Z"
      }
    ]
  }
}

Adım 4: Manifestoyu güncelle

Uçuş ayrıntıları değiştiği durumunda, aşağıdaki mutasyonu kullanarak manifest ayrıntılarını güncelleyebilirsiniz. source alanı gereklidir ve güncelleştirme için veri kaynağını gösterir.

1mutation ManifestUpdate($id: ID!, $input: ManifestUpdateInput!) {
2 manifestUpdate(id: $id, input: $input) {
3 id
4 amount
5 arrivalDate
6 awbNumber
7 awbPrefix
8 carrierCode
9 createdAt
10 createdBy
11 destinationCode
12 operatorDestination
13 operatorOrigin
14 originCode
15 postalOperatorCode
16 serviceNumber
17 source
18 transportationMode
19 updatedAt
20 updatedBy
21 weight
22 weightUnit
23 statusTransitions {
24 createdAt
25 createdBy
26 note
27 source
28 }
29 }
30}

RESPONSE

json

{
  "data": {
    "manifestUpdate": {
      "id": "manifest_abc123def456",
      "amount": "150.50",
      "arrivalDate": "2026-03-16T10:00:00.000Z",
      "awbNumber": "5678",
      "awbPrefix": "001",
      "carrierCode": "BA",
      "createdAt": "2026-01-06T12:00:00.000Z",
      "createdBy": "organization_xyz789",
      "destinationCode": "JFK",
      "operatorDestination": "US",
      "originCode": "LHR",
      "postalOperatorCode": "J1CGBA",
      "serviceNumber": "5678",
      "source": "RESDIT",
      "transportationMode": "AIR",
      "updatedAt": "2026-01-06T14:30:00.000Z",
      "updatedBy": "organization_xyz789",
      "weight": "25.5",
      "weightUnit": "KILOGRAM",
      "statusTransitions": [
        {
          "createdAt": "2026-01-06T14:30:00.000Z",
          "createdBy": "organization_xyz789",
          "note": "Flight rescheduled due to weather",
          "source": "RESDIT"
        }
      ]
    }
  }
}

Veri kaynağı değerleri

ManifestUpdateInput içindeki source alanı aşağıdaki değerleri kabul eder:

Değer↕Açıklama↕
CARDITTaşıyıcı veri alışverişi
PRECONGönderim öncesi tavsiyesi
PREDESSevkiyat öncesi tavsiyesi
RESDITSevkiyata yanıt
Demo rezervasyonu yap

Bu sayfa faydalı mıydı?

Destek alın·Hukuki belgeler·© 2026 Zonos
Bu sayfada:
  • ABD gönderileri için gümrük manifestosu hazırla.
  • İsteği hazırla
  • API aracılığıyla manifest oluştur