> ## Documentation Index
> Fetch the complete documentation index at: https://openapidocs.flexforwardship.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 国際出荷を作成する
> 越境配送ラベルを作成するためのエンドツーエンドガイド
# 国際出荷を作成する
このガイドでは、YunExpressを使用して日本からアメリカへの越境出荷を作成する手順を説明します。同じフローは、サポートされているすべての配送業者および配送ルートに適用できます。
## 始める前に
* オンボーディングで取得したAPIトークンがあること（[認証](/ja/authentication#アクセスの仕組み)を参照）
* 配送業者のslugとプロダクトコードを把握していること（[配送業者とプロダクトコード](/ja/core-concepts#配送業者とプロダクトコード)を参照）
## 1. 出荷データを準備する
国際出荷には以下が必要です：
* **発送元住所** — 倉庫またはフルフィルメントセンター
* **届け先住所** — お客様の配送先住所
* **荷物の詳細** — 重量およびアイテムレベルの税関申告（英語の説明、数量、単価、単位重量）
税関申告（`descriptionEn`、`unitPrice`、`unitWeight`）は越境出荷に必須です。税関データが不足していたり不正確な場合、通関手続きに遅延が生じる可能性があります。
## 2. ラベルを作成する
`unique-key-per-request` は毎回のリクエストで固有の値に置き換えてください。同じ `idempotencyKey` を再利用すると、新しいラベルの作成ではなく冪等リプレイが発生します。
```bash cURL theme={null}
curl -X POST https://api.flexforward.com/labels \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"idempotencyKey": "unique-key-per-request",
"courier": "yunexpress",
"service": {
"productCode": "HKMUZXR"
},
"shipment": {
"shipFrom": {
"contact": {
"firstName": "Warehouse",
"lastName": "Staff",
"phone": "+81-90-1234-5678"
},
"address": {
"countryCode": "JP",
"city": "Tokyo",
"postalCode": "100-0001",
"streetLines": ["1-1 Marunouchi"]
}
},
"shipTo": {
"contact": {
"firstName": "Jane",
"lastName": "Smith",
"phone": "+1-555-0100",
"email": "jane.smith@example.com"
},
"address": {
"countryCode": "US",
"city": "Los Angeles",
"state": "CA",
"postalCode": "90001",
"streetLines": ["456 Oak Avenue", "Apt 12"]
}
},
"parcels": [
{
"weight": 0.8,
"items": [
{
"descriptionEn": "Cotton T-Shirt",
"descriptionLocal": "コットンTシャツ",
"quantity": 2,
"unitPrice": { "amount": 29.99, "currency": "USD" },
"unitWeight": 0.3,
"hsCode": "6109.10"
},
{
"descriptionEn": "Phone Case",
"descriptionLocal": "スマホケース",
"quantity": 1,
"unitPrice": { "amount": 12.00, "currency": "USD" },
"unitWeight": 0.2,
"hsCode": "3926.90"
}
]
}
]
}
}'
```
```javascript Node.js theme={null}
const response = await fetch('https://api.flexforward.com/labels', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
idempotencyKey: 'unique-key-per-request',
courier: 'yunexpress',
service: {
productCode: 'HKMUZXR'
},
shipment: {
shipFrom: {
contact: { firstName: 'Warehouse', lastName: 'Staff', phone: '+81-90-1234-5678' },
address: { countryCode: 'JP', city: 'Tokyo', postalCode: '100-0001', streetLines: ['1-1 Marunouchi'] }
},
shipTo: {
contact: { firstName: 'Jane', lastName: 'Smith', phone: '+1-555-0100', email: 'jane.smith@example.com' },
address: { countryCode: 'US', city: 'Los Angeles', state: 'CA', postalCode: '90001', streetLines: ['456 Oak Avenue', 'Apt 12'] }
},
parcels: [{
weight: 0.8,
items: [
{ descriptionEn: 'Cotton T-Shirt', descriptionLocal: 'コットンTシャツ', quantity: 2, unitPrice: { amount: 29.99, currency: 'USD' }, unitWeight: 0.3, hsCode: '6109.10' },
{ descriptionEn: 'Phone Case', descriptionLocal: 'スマホケース', quantity: 1, unitPrice: { amount: 12.00, currency: 'USD' }, unitWeight: 0.2, hsCode: '3926.90' }
]
}]
}
})
});
const label = await response.json();
```
```python Python theme={null}
import requests
response = requests.post(
'https://api.flexforward.com/labels',
headers={'Authorization': 'Bearer YOUR_API_TOKEN'},
json={
'idempotencyKey': 'unique-key-per-request',
'courier': 'yunexpress',
'service': {
'productCode': 'HKMUZXR'
},
'shipment': {
'shipFrom': {
'contact': {'firstName': 'Warehouse', 'lastName': 'Staff', 'phone': '+81-90-1234-5678'},
'address': {'countryCode': 'JP', 'city': 'Tokyo', 'postalCode': '100-0001', 'streetLines': ['1-1 Marunouchi']}
},
'shipTo': {
'contact': {'firstName': 'Jane', 'lastName': 'Smith', 'phone': '+1-555-0100', 'email': 'jane.smith@example.com'},
'address': {'countryCode': 'US', 'city': 'Los Angeles', 'state': 'CA', 'postalCode': '90001', 'streetLines': ['456 Oak Avenue', 'Apt 12']}
},
'parcels': [{
'weight': 0.8,
'items': [
{'descriptionEn': 'Cotton T-Shirt', 'descriptionLocal': 'コットンTシャツ', 'quantity': 2, 'unitPrice': {'amount': 29.99, 'currency': 'USD'}, 'unitWeight': 0.3, 'hsCode': '6109.10'},
{'descriptionEn': 'Phone Case', 'descriptionLocal': 'スマホケース', 'quantity': 1, 'unitPrice': {'amount': 12.00, 'currency': 'USD'}, 'unitWeight': 0.2, 'hsCode': '3926.90'}
]
}]
}
}
)
label = response.json()
```
## 3. レスポンスを確認する
```json 201 Created theme={null}
{
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"status": "created",
"courier": "yunexpress",
"courierOrderNumber": "YT2503010001",
"courierTrackingNumber": "YT2503010001CN",
"error": null
}
```
`status`が`created`であれば、ラベルの準備は完了です。`id`を保存してください。ラベルドキュメントの取得や出荷の追跡に使用します。
`status`が`failed`の場合は、`error`オブジェクトで配送業者の却下理由を確認してください。詳しくは[エラーハンドリング](/ja/error-handling#配送業者の下流エラー502)を参照してください。
## 4. 次のステップ
荷物に貼付するエアウェイビルPDFをダウンロードします。
正規化された追跡データで出荷状況を監視します。
## 国際出荷のヒント
* **HSコード** — HSコード（`hsCode`）を含めることで、通関手続きが迅速になります。各国の税関当局のサイトでコードを検索できます。
* **現地語の説明** — `descriptionLocal`フィールドは、仕向国の言語でアイテムの説明を提供し、通関処理に役立ちます。
* **べき等性** — 常に意味のある`idempotencyKey`（例：注文ID）を使用して、リトライを安全に行えるようにしてください。[べき等性とリトライ](/ja/idempotency-and-retries)を参照してください。