订单入库货物拆包

先决条件
-
验证-提交您的用户凭据,客户端ID和客户端机密以进行OAuth2验证。有关如何致电OAuth API以验证和验证您的凭据的说明,请参阅API验证。
-
检索您的入站货物订单编号-向端点发送
GET请求/colocations/v2/orders/{orderId},要求检索已排程的入站货物的订单号。要安排新的入站货物,请向端点发送POST请求/colocations/v2/orders/shipments。要安排入站货物,用户必须具有Shipments权限。如果您已拥有入站货物订单编号,则可跳过此步骤。 -
您必须具有订购权限,才能获取Smart Hands详细信息
Smart Hands。 -
获取Smart Hands类型-向端点发送
GET获取所有Smart Hands订单类型的请求/v1/orders/smarthands/types。如果您已经知道Smart Hands订单类型,可以跳过此步骤。 -
获取位置信息-向端点发送
GET请求/v1/orders/smarthands/locations,以检索您有权访问的可用IBX位置。如果您已知道网点信息,可以跳过此步骤。
订单入库货物拆包及包装处置
请求入站货物拆包和包装处置,请向端点发送POST请求/smarthands/shipmentUnpack。在请求正文中指定包裹详情和说明。使用可选attachments对象包括技术人员的其他详细信息。
注意
创建带有附件的订单之前,请致电Attachments File端点。
cURL 请求示例:
curl -X
POST "https://api.equinix.com/v1/orders/smarthands/shipmentUnpack"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
"ibxLocation": {
"ibx": "AM1",
"cages": [
{
"cage": "AM1:0J:00JD11",
"cabinets": [
"AM1:0J:00JD11:0001"
],
"accountNumber": "126854"
}
]
},
"serviceDetails": {
"inboundShipmentOrderNumber": "1-190403752735",
"discardShipmentMaterial": false,
"copyOfPackingSlipNeeded": false,
"scopeOfWork": "Flatten the boxes and keep them by the side of the cage.",
"needSupportFromASubmarineCableStationEngineer": true
},
"attachments": [
{
"id": "26f40e6e-dd6e-48fa-a797-62c0d3157388",
"name": "AdditionalShipmentWorkDetails.docx"
}
],
"schedule": {
"scheduleType": "SCHEDULED_MAINTENANCE",
"requestedStartDate": "2019-08-30T22:00:49.776Z",
"requestedCompletionDate": "2019-08-31T22:00:49.776Z"
},
"customerReferenceNumber": "EQX-PO2019-08-001",
"purchaseOrder": {
"purchaseOrderType": "EXEMPTED",
"attachment": {
"id": "abc1fd2e-345f-67g4-hi89-01jk234l5m6n",
"name": "PurchaseOrderExemptionForm123.docx"
}
},
"contacts": [
{
"contactType": "ORDERING",
"userName": "johndoe"
},
{
"contactType": "TECHNICAL",
"name": "Jane Smith",
"email": "janesmith@corporation.com",
"workPhoneCountryCode": "+44",
"workPhone": "0148211111",
"workPhonePrefToCall": "MY_BUSINESS_HOURS",
"workPhoneTimeZone": "Europe/London",
"mobilePhoneCountryCode": "+44",
"mobilePhone": "0123456789",
"mobilePhonePrefToCall": "MY_BUSINESS_HOURS",
"mobilePhoneTimeZone": "Europe/London"
},
{
"contactType": "NOTIFICATION",
"userName": "johndoe"
},
{
"contactType": "NOTIFICATION",
"userName": "janesmith"
}
]
}'
有关主体参数和描述的完整列表,请参阅API参考手册。
示例回答:
{
"OrderNumber": "1-457809872838"
}
响应表明订单已成功,并返回订单号。