メインコンテンツに移動

出荷スケジュール

すべての出荷は、出荷オーダーを作成して事前にスケジュールされている必要がある。これを怠ると、貨物が拒否される可能性がある。これらの配送をスケジュールできるのは、Equinix Customer Portalユーザー(シップメントオーダー権限を持つユーザー)だけである。Equinix Customer Portal APIで現在サポートされている配送の種類はこちら。

前提条件​

  1. 出荷の詳細を取得するには、ユーザーが注文権限を持っている必要がある。Shipments

  2. 認証- OAuth2認証のためにユーザー資格情報、クライアントID、およびクライアントシークレットを送信する。認証情報を検証および認証するためにOAuth APIを呼び出す方法については、API認証を参照。

  3. 出荷をスケジュールするには、出荷の正確なケージIDとアカウント番号を決定する必要がある。これらの値はリクエストボディ内のパラメータとaccountNumberパラメータに渡される。cageId

  4. 位置情報の取得-エンドポイントにリクエストを/v1/orders/smarthands/locations送信して、GETアクセス可能なIBXロケーションを取得する。位置情報がすでにわかっている場合は、この手順をスキップしてもよい。

インバウンド出荷のスケジューリング​

インバウンドシップメントをスケジュールするには、エンドポイントにリクエストを/colocations/v2/orders/shipments送信する。POSTパラメータを使用して、イン"type": "INBOUND"バウンドシップメントであることを指定し、リクエストの本文に残りのシップメントの詳細を入力する。入荷リクエストには、最低限、出荷タイプ、出荷日、関連するケージ、配送業者、および梱包箱の数が必要である。入荷リクエストボディに渡す必要があるその他の必要な情報は、次の内容に依存する。

  • インバウンド貨物が複数のアカウントにリンクされたケージからのものである場合。
  • 配送業者が配送業者の場合、配送業者または配送業者の場合。あなたのキャリアがDHL、FedEx、UPSでない場合、あなたのキャリアはリストされていない。

cURLリクエストの例：

1つのアカウントに関連するケージからのインバウンド貨物は、あなたの組織によって配信されます。

このシナリオでは、納品物は、組織の誰かが1つのアカウントにリンクされたケージにのみ配信される。このシナリオに必要な最小限の情報は、このサンプルリクエストに渡される。

curl -X  
POST "https://api.equinix.com/colocations/v2/orders/shipments"  
-H "content-type: application/json"  
-H "authorization: Bearer <token>"  
-d '{  
    "type": "INBOUND",  
    "requestedDateTime": "2020-11-02T10:45:41Z",  
    "cageId": "AM1:01:000111",  
    "details": {  
    "carrier": "CUSTOMER_CARRIER",  
    "numberOfBoxes": 2  
    }  
}'

cURLリクエストの例：

リストにない配送業者が配送する、複数のアカウントに関連付けられたケージからの配送。追加のSmart Handsリクエスト、情報、連絡先の詳細、添付ファイルも含まれる。

メモ

添付ファイル付きのオーダーを作成する前に、エンドポイントを呼び出す。Attachments File

このシナリオでは、インバウンド貨物を促進するために最低限必要な情報を提供し、以下をサポートする追加のボディパラメータが含まれています：

  • お客様のケージへの配送のためのSmart Handsの追加リクエスト
  • 追加説明
  • 添付ファイル
  • あなた自身の参照識別子
  • 発注情報
  • 通知または技術連絡担当者の連絡先

このサンプルリクエストでは、利用可能で適用可能なすべてのボディパラメータが渡されます。

curl -X  
POST "https://api.equinix.com/colocations/v2/orders/shipments"  
-H "content-type: application/json"  
-H "authorization: Bearer <token>"  
-d '{  
    "type": "INBOUND",  
    "requestedDateTime": "2020-11-02T10:45:41Z",  
    "cageId": "AM1:01:000111",  
    "accountNumber": 901011,  
    "details": {  
        "carrier": "OTHER",  
        "carrierName": "New Carrier",  
        "numberOfBoxes": 2,  
        "carrierTrackingNumbers": [  
            "t1Z294AK92654678989",  
            "t1Z086DK96424456780"  
        ],  
        "cageDelivery": true  
    },  
    "description": "Package is fragile and heavy. Handle with care. Additional description in attachment.",  
    "attachments": [  
        {  
            "id": "85d9660a-f877-405a-b38e-8e61a4f77f44",  
            "name": "OrderInstructions.docx"  
        }  
    ],   
    "customerReferenceId": "2020/16347",  
        "purchaseOrder": {  
        "type": "NEW",  
        "number": "9654284",  
        "amount": "10000",  
        "startDate": "2020-10-01",  
        "endDate": "2021-09-30",  
        "attachmentId": "56d10de6-f2c0-4edd-ba29-b70736aa2093"  
    },  
    "contacts": [  
    {  
        "type": "NOTIFICATION",  
        "registeredUsers": [  
            "john_doe1",  
            "jane_smith1"  
        ]  
    },  
    {  
        "type": "TECHNICAL",  
        "firstName": "John",  
        "lastName": "Doe",  
        "availability": "WORK_HOURS",  
        "timezone": "America/Los_Angeles",  
        "details": [  
            {  
                "type": "EMAIL",  
                "value": "johndoe@acme.com""  
            },  
            {  
                "type": "PHONE",  
                "value": "+1-987654321"  
            },  
            {  
                "type": "MOBILE",  
                "value": "+1-912345678"  
            }  
        ]  
    }  
  ]  
}'

HTTPコード201が返され、レスポンスヘッダーが返されると、オーダーが正常に作成される。レスポンスボディがない。

この順序を更新する場合は、「APIリファレンス」セクションのを参照して/v2/orders/shipments/{orderId}詳細を確認する。

この注文にメモを追加する場合、この注文のネゴシエーションを取得して返信する場合、またはこの注文をキャンセルする場合は、「APIリファレンス」セクションの注文を参照してください。

出荷のスケジュール​

アウトバウンドシップメントをスケジュールするには、エンドポイントにリクエストを/colocations/v2/orders/shipments送信する。POSTパラメータを使用して、"type": "OUTBOUND"それがアウトバウンドシップメントであることを指定し、リクエストの本文に残りのシップメントの詳細を入力する。出荷リクエストには、出荷タイプ、出荷日、関連するケージ、配送業者を含める必要がある。出荷 リクエストボディに渡す必要があるその他の必要な情報は、次の内容に依存する。

  • 複数のアカウントにリンクされたケージからの出荷の場合。
  • 配送業者が配送業者の場合、配送業者または配送業者の場合。あなたのキャリアがDHL、FedEx、UPSでない場合、あなたのキャリアはリストされていない。
  • エクイニクスによる配送ラベルの印刷が必要な場合。

cURLリクエストの例：

1つのアカウントに関連付けられたケージから、お客様の組織の誰かが配送する出荷。

このシナリオでは、アウトバウンド貨物は、組織の誰かによって1つのアカウントにリンクされたケージに配送される。このシナリオに必要な最小限の情報は、このサンプルリクエストに渡される。

curl -X  
POST "https://api.equinix.com/colocations/v2/orders/shipments"  
-H "content-type: application/json"  
-H "authorization: Bearer <token>"  
-d '{  
    "type": "OUTBOUND",  
    "requestedDateTime": "2020-11-02T10:45:41Z",  
    "cageId": "AM1:01:000111",  
    "details": {  
    "carrier": "CUSTOMER_CARRIER"  
    ]  
    }  
}'

cURLリクエストの例：

リストにない配送業者によって配送される複数のカウントに関連付けられたケージからのアウトバウンド貨物で、 Equinixが配送ラベルを印刷する必要があるもの。関連する配送ラベルの詳細は、添付ファイルとして提供される。追加のSmart Hands リクエスト、情報、連絡先の詳細、添付ファイルも含まれる。

メモ

添付ファイル付きのオーダーを作成する前に、エンドポイントを呼び出す。Attachments File

このシナリオでは、発送依頼を円滑に進めるために最低限必要な情報をプロバイダに提供し、以下をサポートする追加のボディパラメータを含めました：

  • 米ドル以外の通貨で申告された出荷額
  • Smart Handsのケージからのお荷物の引き取り、またはお荷物の保険に関する追加のご依頼
  • 追加説明
  • 添付ファイル
  • あなた自身の参照識別子
  • 発注情報
  • 通知または技術連絡担当者の連絡先

このサンプルリクエストでは、利用可能で適用可能なすべてのボディパラメータが渡されます。

curl -X  
POST "https://api.equinix.com/colocations/v2/orders/shipments"  
-H "content-type: application/json"  
-H "authorization: Bearer <token>"  
-d '{  
    "type": "OUTBOUND",  
    "requestedDateTime": "2020-11-02T10:45:41Z",  
    "cageId": "AM1:01:000111",  
    "accountNumber": 901011,  
    "details": {  
    "carrier": "OTHER",  
    "carrierName": "New Carrier",  
    "numberOfBoxes": 2,  
    "declaredValue": 1000,  
    "declaredValueCurrency": "EUR",  
    "carrierTrackingNumbers": [  
        "t1Z294AK92654678989",  
        "t1Z086DK96424456780"  
    ],  
        "shipmentLabelRequired": true,  
        "shipmentAttachmentId": "f49891fc-d9a5-4b4b-bc65-150b1c5e6dff",  
        "requirePickup": true,  
        "insureShipment": true  
    },  
    "description": "Package is fragile and heavy. Handle with care. Additional description in attachment.",  
    "attachments": [  
    {  
        "id": "85d9660a-f877-405a-b38e-8e61a4f77f44",  
        "name": "OrderInstructions.docx"  
    }  
    ],  
    "customerReferenceId": "2020/16347",  
    "purchaseOrder": {  
        "type": "NEW",  
        "number": "9654284",  
        "amount": "10000",  
        "startDate": "2020-10-01",  
        "endDate": "2021-09-30",  
        "attachmentId": "56d10de6-f2c0-4edd-ba29-b70736aa2093"  
    },  
    "contacts": [  
    {  
        "type": "NOTIFICATION",  
        "registeredUsers": [  
            "john_doe1",  
            "jane_smith1"  
        ]  
    },  
    {  
        "type": "TECHNICAL",  
        "firstName": "John",  
        "lastName": "Doe",  
        "availability": "WORK_HOURS",  
        "timezone": "America/Los_Angeles",  
        "details": [  
            {  
                "type": "EMAIL",  
                "value": "johndoe@acme.com"  
            },  
            {  
                "type": "PHONE",  
                "value": "+1-987654321"  
            },  
            {  
                "type": "MOBILE",  
                "value": "+1-912345678"  
            }  
        ]  
    }  
  ]  
}'

HTTPコード201が返され、レスポンスヘッダーが返されると、オーダーが正常に作成される。レスポンスボディがない。

この順序を更新する場合は、「APIリファレンス」セクションのを参照して/v2/orders/shipments/{orderId}詳細を確認する。

この注文にメモを追加する場合、この注文のネゴシエーションを取得して返信する場合、またはこの注文をキャンセルする場合は、「APIリファレンス」セクションの注文を参照してください。

このページは役に立ちましたか？