跳转到主要内容

订单入库货物拆包

先决条件

  1. 身份验证-提交您的用户凭据,客户端ID和客户端机密以进行OAuth2身份验证。有关如何调用OAuth API以验证和验证凭据的说明,请参阅API身份验证

  2. 检索您的入库货件订单号-向端点发送GET请求/colocations/v2/orders/{orderId},以检索已安排的入库货件的订单号。要安排新的入库货件,请向端点发送POST请求/colocations/v2/orders/shipments。要安排入库货件,用户必须具有Shipments权限。如果您已拥有入库货件订单编号,则可以跳过此步骤。

  3. 要获取Smart Hands详细信息,您必须具有Smart Hands订购权限。

  4. 获取Smart Hands类型-向端点发送GET请求/v1/orders/smarthands/types以获取所有Smart Hands订单类型。如果您已经知道Smart Hands订单类型,则可以跳过此步骤。

  5. 获取位置信息-向端点发送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"
}

响应表明订单已成功,并返回订单号。

这个页面对您有帮助吗?