# 安排发货 所有货物都必须通过创建入站或出站货物订单提前安排。否则可能导致货物被拒绝。只有拥有货物订购权限的Equinix Customer Portal用户才能安排这些货物。Equinix Customer Portal API目前支持的货物类型可在此处找到。 ## 先决条件[​](#先决条件 "直接链接至先决条件") 1. 用户必须具有订购权限,才能获取发货详情`Shipments`。 2. 验证-提交您的用户凭据,客户端ID和客户端机密以进行OAuth2验证。有关如何致电OAuth API以验证和验证您的凭据的说明,请参阅[API验证](https://docs.equinix.com/zh-Hans/equinix-api/api-authentication.md)。 3. 您需要确定货物的确切机笼ID和账号,以便安排货物。和`accountNumber`参数将在请求正文中传递这些值`cageId`。 4. 获取位置信息-向端点发送`GET`请求[`/v1/orders/smarthands/locations`](https://docs.equinix.com/zh-Hans/api-catalog/smarthandsv1/smarthands/getlocation.md),以检索您有权访问的可用IBX位置。如果您已知道网点信息,可以跳过此步骤。 ## 安排入境货件[​](#安排入境货件 "直接链接至安排入境货件") ![](https://docs.equinix.com/zh-Hans/assets/images/ScheduleInboundShipment-v2-d5af65c2680a6aea37f81b1b698a86fd.png) 要安排入站货物,请向端点发送`POST`请求[`/colocations/v2/orders/shipments`](https://docs.equinix.com/zh-Hans/api-catalog/shipmentsv2/shipments/schedule%20inbound%20or%20outbound%20shipment.md)。使用`"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 " -d '{     "type": "INBOUND",     "requestedDateTime": "2020-11-02T10:45:41Z",     "cageId": "AM1:01:000111",     "details": {     "carrier": "CUSTOMER_CARRIER",     "numberOfBoxes": 2     } }' ``` cURL 请求示例: 来自与多个账户相关联的机笼的入站货物,将由未列出的承运商交付。其他Smart Hands请求,信息,联系方式和附件也包括在内。 > **注意** > > 创建带有附件的订单之前,请致电[`Attachments File`](https://docs.equinix.com/zh-Hans/api-catalog/attachmentsv1/attachments/createattachment.md)端点。 在这种情况下,您已提供促进入站货物所需的最低限度的信息,并包括支持以下内容的附加正文参数: * Smart Hands要求额外将货物送至您的机笼 * 附加说明 * 支持附件 * 您自己的参考标识符 * 购买订单信息 * 通知或技术联系人的联系人信息 所有可用且适用的主体参数均在此示例请求中传递。 ``` curl -X POST "https://api.equinix.com/colocations/v2/orders/shipments" -H "content-type: application/json" -H "authorization: Bearer " -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}`](https://docs.equinix.com/zh-Hans/api-catalog/shipmentsv2/shipments/update%20inbound%20or%20outbound%20shipment.md)API参考部分中的以获取更多信息。 要为此订单添加备注,检索并回复此订单协商或取消此订单,请参阅API参考部分中的[订单](https://docs.equinix.com/zh-Hans/api-catalog/ordersv2/orders.md)以获取更多信息。 ## 安排出站货物[​](#安排出站货物 "直接链接至安排出站货物") ![](https://docs.equinix.com/zh-Hans/assets/images/ScheduleOutboundShipment-v2-b917e877e1720215570527401150a9f0.png) 要安排出站货物,请向端点发送`POST`请求[`/colocations/v2/orders/shipments`](https://docs.equinix.com/zh-Hans/api-catalog/shipmentsv2/shipments/schedule%20inbound%20or%20outbound%20shipment.md)。使用`"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 " -d '{     "type": "OUTBOUND",     "requestedDateTime": "2020-11-02T10:45:41Z",     "cageId": "AM1:01:000111",     "details": {     "carrier": "CUSTOMER_CARRIER"     ]     } }' ``` cURL 请求示例: 来自机笼的出站货物,包含多个订单,该订单将由未列出的承运商交付,且需要 Equinix打印货物标签。相关的发货标签详情以附件形式提供。其他Smart Hands 请求,信息,联系方式和附件也包括在内。 > **注意** > > 创建带有附件的订单之前,请致电[`Attachments File`](https://docs.equinix.com/zh-Hans/api-catalog/attachmentsv1/attachments/createattachment.md)端点。 在此场景中,您已提供处理出站发货请求所需的最低限度的信息,并包含了支持以下内容的附加正文参数: * 以美元以外的货币申报的货件价值 * Smart Hands要求从您的机笼中取出货物或为其投保 * 附加说明 * 支持附件 * 您自己的参考标识符 * 购买订单信息 * 通知或技术联系人的联系人信息 所有可用且适用的主体参数均在此示例请求中传递。 ``` curl -X POST "https://api.equinix.com/colocations/v2/orders/shipments" -H "content-type: application/json" -H "authorization: Bearer " -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}`](https://docs.equinix.com/zh-Hans/api-catalog/shipmentsv2/shipments/update%20inbound%20or%20outbound%20shipment.md)API参考部分中的以获取更多信息。 要为此订单添加备注,检索并回复此订单协商或取消此订单,请参阅API参考部分中的[订单](https://docs.equinix.com/zh-Hans/api-catalog/ordersv2/orders.md)以获取更多信息。