Entrada de pedidos Desembalaje

Requisitos previos

1. Autenticar - Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para la autenticación OAuth2. Consulte API Authentication para obtener instrucciones sobre cómo llamar a la API OAuth para validar y autenticar sus credenciales.

2. Recuperar el número de pedido de un envío entrante: envíe una solicitud GET al punto final /colocations/v2/orders/{orderId} para recuperar el número de pedido de un envío entrante ya programado. Para programar un nuevo envío entrante, envíe una solicitud POST al punto final /colocations/v2/orders/shipments. Para programar un envío entrante, el usuario debe tener permiso de Envíos. Puede omitir este paso si ya dispone del número de pedido del envío entrante.

3. Para obtener los detalles de Smart Hands, debe disponer del permiso de pedido Smart Hands.

4. Obtener tipos de Smart Hands - Envíe una solicitud GET al punto final /v1/orders/smarthands/types para obtener todos los tipos de pedidos de Smart Hands. Puede omitir este paso si ya conoce el tipo de pedido de Smart Hands.

5. Obtener información de ubicación - Envíe una solicitud GET al punto final /v1/orders/smarthands/locations para recuperar las ubicaciones IBX disponibles a las que tiene acceso. Puede omitir este paso si ya conoce la información de ubicación.

Orden de entrada Desembalaje y eliminación de envases

Para solicitar el desembalaje y la eliminación del embalaje de un envío entrante, envíe una solicitud POST al punto final /smarthands/shipmentUnpack. Especifique los detalles de su paquete y las instrucciones en el cuerpo de la solicitud. Utilice el objeto opcional attachments para incluir detalles adicionales para un técnico.

nota

Antes de crear un pedido con archivo adjunto, llame al punto final Attachments File.

Ejemplo de solicitud 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"  
    }  
  ]  
}'

Para obtener una lista completa de los parámetros del cuerpo y sus descripciones, consulte la Referencia de la API.

Respuesta de muestra:

{  
  "OrderNumber": "1-457809872838"  
}

La respuesta indica que el pedido se ha realizado correctamente y devuelve el número de pedido.