メインコンテンツへスキップ

​
国際出荷を作成する

このガイドでは、YunExpressを使用して日本からアメリカへの越境出荷を作成する手順を説明します。同じフローは、サポートされているすべての配送業者および配送ルートに適用できます。

​
始める前に

  • オンボーディングで取得したAPIトークンとshipperAccountIdがあること（認証を参照）
  • 配送業者のslugとプロダクトコードを把握していること（配送業者とプロダクトコードを参照）

​
1. 出荷データを準備する

国際出荷には以下が必要です：
  • 発送元住所 — 倉庫またはフルフィルメントセンター
  • 届け先住所 — お客様の配送先住所
  • 荷物の詳細 — 重量およびアイテムレベルの税関申告（英語の説明、数量、単価、単位重量）
税関申告（descriptionEn、unitPrice、unitWeight）は越境出荷に必須です。税関データが不足していたり不正確な場合、通関手続きに遅延が生じる可能性があります。

​
2. ラベルを作成する

curl -X POST https://api.flexforward.com/labels \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "idempotencyKey": "shipment-jp-us-001",
    "courier": "yunexpress",
    "service": {
      "shipperAccountId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "productCode": "YEXP01"
    },
    "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": "[email protected]"
        },
        "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"
            }
          ]
        }
      ]
    }
  }'

​
3. レスポンスを確認する

201 Created
{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "status": "created",
  "courier": "yunexpress",
  "courierOrderNumber": "YT2503010001",
  "courierTrackingNumber": "YT2503010001CN",
  "error": null
}
statusがcreatedであれば、ラベルの準備は完了です。idを保存してください。ラベルドキュメントの取得や出荷の追跡に使用します。 statusがfailedの場合は、errorオブジェクトで配送業者の却下理由を確認してください。詳しくはエラーハンドリングを参照してください。

​
4. 次のステップ

ラベルドキュメントを取得する

荷物に貼付するエアウェイビルPDFをダウンロードします。

出荷を追跡する

正規化された追跡データで出荷状況を監視します。

​
国際出荷のヒント

  • HSコード — HSコード（hsCode）を含めることで、通関手続きが迅速になります。各国の税関当局のサイトでコードを検索できます。
  • 現地語の説明 — descriptionLocalフィールドは、仕向国の言語でアイテムの説明を提供し、通関処理に役立ちます。
  • べき等性 — 常に意味のあるidempotencyKey（例：注文ID）を使用して、リトライを安全に行えるようにしてください。べき等性とリトライを参照してください。