リクエストの準備
マニフェストを作成するには、発送データを適切な構造に整理する必要があります。APIは階層的アプローチを使用しており、最初にマニフェストを作成し、次に容器を追加し、最後に各容器に発送の詳細を含むマニフェストラインを入力します。
各コンポーネントには、税関の遵守と正確な文書を確保するために必要な特定の必須フィールドがあります。以下に、必須のデータ構造と必要な入力を概説します。
主要な入力タイプ
マニフェストAPIは、発送データを整理するためにいくつかの入力タイプを使用します：
ManifestInput: 空港、運送状の種類、フライトの詳細を含む高レベルの発送情報ManifestLineInput: 容器内の個々の発送詳細ManifestLineItemInput: 税関分類のための製品情報CreatePartyInput: 発送元および宛先のパーティーと場所の詳細
完全なフィールド定義とオプションは、私たちのGraphQL API リファレンスでご覧ください。
APIを介してマニフェストを作成する
発送データを整理したら、GraphQLミューテーションを送信してマニフェストを作成します。
ステップ1: マニフェストヘッダーを作成する
ミューテーション
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
}
}
ステップ 2: マニフェスト行を追加する
manifestCreate ミューテーションから返された ID を使用して、個々の出荷をマニフェストにリンクできます。
ミューテーション
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
}
}
ステップ 3: マニフェストの更新
フライトの詳細が変更された場合、次のミューテーションを使用してマニフェストの詳細を更新できます。
ミューテーション
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
}
}
}
米国向けの税関マニフェストを準備します。
Zonosに対して、郵便貨物の発送データを提供します。Zonosは、米国への郵便貨物に必要なすべての情報を含む包括的な税関マニフェストを準備します。