Desempacotamento da remessa de entrada do pedido

Pré-requisitos

1. Autenticar - Envie suas credenciais de usuário, ID do Cliente e Segredo do Cliente para autenticação OAuth2. Consulte Autenticação de API para obter instruções sobre como chamar a API OAuth para validar e autenticar suas credenciais.

2. Recupere o número do seu pedido de remessa de entrada - envie uma solicitação GET para [/colocations/v2/orders/{orderId}](/api-catalog/ordersv2/#tag/Orders/operation/GET%20Order%Para obter o número do pedido de uma remessa de entrada que já foi agendada, envie uma solicitação POST para o endpoint /colocations/v2/orders/shipments. Para agendar uma nova remessa de entrada, envie uma solicitação POST para o endpoint /api-catalog/shipmentsv2/#tag/Shipments/operation/Schedule.%20inbound%20 ou%20outbound%endpoint 20shipment). Para agendar uma remessa de entrada, o usuário deve ter a permissão Remessas. Você pode pular esta etapa se já tiver o número do pedido de remessa de entrada.

3. Para obter detalhes sobre o Smart Hands, você precisa ter permissão para fazer pedidos do tipo "Smart Hands".

4. Obtenha os tipos de pedidos Smart Hands - Envie uma solicitação GET para o endpoint /v1/orders/smarthands/types para obter todos os tipos de pedidos Smart Hands. Você pode pular esta etapa se já souber o tipo de pedido Smart Hands.

5. Obter informações de localização - Envie uma solicitação GET para o endpoint /v1/orders/smarthands/locations para recuperar os locais IBX disponíveis aos quais você tem acesso. Você pode pular esta etapa se já souber as informações de localização.

Pedido e descarte de Remessa de Entrada

Para solicitar a desembalagem e o descarte da embalagem de uma remessa recebida, envie uma solicitação POST para o endpoint /smarthands/shipmentUnpack. Especifique os detalhes da sua embalagem e as instruções no corpo da solicitação. Utilize o objeto opcional attachments para incluir detalhes adicionais para um técnico.

observação

Antes de criar um pedido com anexo, chame o endpoint Arquivo de anexos.

Exemplo de solicitação 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 obter uma lista completa dos parâmetros e descrições do corpo, consulte a Referência da API.

Exemplo de resposta:

{  
  "OrderNumber": "1-457809872838"  
}

A resposta indica que o pedido foi bem-sucedido e retorna o número do pedido.