安排发货

所有发货必须提前安排，方法是创建入库或出站货物订购。否则，发货可能会被拒收。只有拥有发货订单权限的Equinix Customer Portal用户才能安排这些发货。您可以在此处查看Equinix Customer PortalAPI 当前支持的发货类型。

先决条件

要获取发货详情，用户必须拥有“发货”订单权限。
身份验证 - 请提交您的用户凭据、客户端 ID 和客户端密钥以进行 OAuth2 身份验证。有关如何调用 OAuth API 来验证和确认您的凭据的说明，请参阅API 身份验证。
要安排发货，您需要确定发货的准确笼号 ID 和账号。这些值将作为请求正文中的 cageId 和 accountNumber 参数传递。
获取位置信息 - 向 /v1/orders/smarthands/locations 端点发送 GET 请求，以检索您有权访问的可用 IBX 位置。如果您已经知道位置信息，则可以跳过此步骤。

安排入境货件

要安排入库发货，请向 /colocations/v2/orders/shipments 发送 POST 请求%20inbound%20或%20outbound%20shipment) 端点。使用 "type": "INBOUND" 参数指定这是一个入库发货请求，并在请求正文中提供其余发货详情。入库发货请求至少需要包含发货类型、发货日期、关联的货笼、承运商和箱数。您需要在入库发货请求正文中传递的其他必要信息取决于以下因素：

如果您的入站货物来自与多个账户关联的机笼。
如果承运商来自您的组织，则可能是列出的承运商或未列出的承运商。如果您的承运商不是 DHL、FedEx 或 UPS，则您的承运商为未列出的承运商。

cURL 请求示例：

您的组织将运送来自与单个帐户关联的机笼的入站货物。

在此场景中，您的入站货物将由您组织中的人员递送至仅与一个账户关联的机笼。此场景所需的最低限度信息已在此示例请求中传递。

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，并返回响应头，表示订购创建成功，无响应体。

如果您想更新此订单，请参阅 /v2/orders/shipments/{orderId}。%20inbound%20或%20outbound%有关更多信息，请参阅 API 参考部分中的 20shipment）。

如果您想为该订单添加备注、检索和回复该订单的协商，或取消该订单，请参阅 API 参考部分中的订单以获取更多信息。

安排出站货物

要安排出库发货，请向 /colocations/v2/orders/shipments 发送 POST 请求%20inbound%20或%20outbound%20shipment) 端点。使用 "type": "OUTBOUND" 参数指定这是一个出库发货请求，并在请求正文中提供其余发货详情。出库发货请求至少需要包含发货类型、发货日期、关联的货笼和承运商。您需要在出库发货请求中传递的其他必要信息。请求体取决于以下因素：

如果您的出站运输来自与多个账户关联的机笼。
如果配送货件的承运商来自您的组织，则可能是列出的承运商或未列出的承运商。如果您的承运商不是 DHL、FedEx 或 UPS，则您的承运商为未列出的承运商。
如果您需要 Equinix 打印运输标签。

cURL 请求示例：

从与单个帐户关联的机笼中出站运输将由您组织的人员运送。

在此场景中，您的出站运输将由您组织中的人员递送至仅与一个账户关联的机笼。此场景所需的最低限度信息已在此示例请求中传递。

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 将打印货运标签。相关的货运标签详细信息以附件形式提供。其他智能搬运服务请求、信息、联系方式和附件也包含在内。

注意

在创建带有附件的订单之前，请调用 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，并返回响应头，表示订购创建成功，无响应体。

如果您想更新此订单，请参阅 /v2/orders/shipments/{orderId}。%20inbound%20或%20outbound%有关更多信息，请参阅 API 参考部分中的 20shipment）。

先决条件​

安排入境货件​

安排出站货物​

先决条件

安排入境货件

安排出站货物