# Solicitar ubicación del paquete ![](https://docs.equinix.com/es/assets/images/OrderPackagesLocation-c374f37bd1d54fdb6bf93753729d00fe.png) ## Requisitos previos[​](#requisitos-previos "Enlace directo a Requisitos previos") 1. Autenticar: Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para la autenticación OAuth2. Consulte [Autenticación de API](https://docs.equinix.com/es/equinix-api/api-authentication.md) para obtener instrucciones sobre cómo llamar al API de OAuth para validar y autenticar sus credenciales. 2. Recuperar su número de pedido de envío de entrada: Envíe una `GET` solicitud al [`/colocations/v2/orders/{orderId}`](https://docs.equinix.com/es/api-catalog/ordersv2/orders/get%20order%20details.md) punto final para recuperar un número de pedido para un envío de entrada que ya se haya programado. Para programar un nuevo envío de entrada, envíe una `POST` solicitud al [`/colocations/v2/orders/shipments`](https://docs.equinix.com/es/api-catalog/shipmentsv2/shipments/schedule%20inbound%20or%20outbound%20shipment.md) punto final. Para programar un envío de entrada, el usuario debe tener `Shipments` permiso. Puede omitir este paso si ya tiene el número de pedido de envío de entrada. 3. Para obtener los detalles de Smart Hands, debe tener `Smart Hands`permiso de pedido. 4. Obtener tipos de Smart Hands - Enviar una `GET` solicitud al [`/v1/orders/smarthands/types`](https://docs.equinix.com/es/api-catalog/smarthandsv1/smarthands/smarthandtypes.md) punto final para obtener todos los tipos de pedido 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 `GET` solicitud al [`/v1/orders/smarthands/locations`](https://docs.equinix.com/es/api-catalog/smarthandsv1/smarthands/getlocation.md) punto final para recuperar las ubicaciones de IBX disponibles a las que tenga acceso. Puede omitir este paso si ya conoce la información de ubicación. ## Obtenga la ubicación de un paquete[​](#obtenga-la-ubicación-de-un-paquete "Enlace directo a Obtenga la ubicación de un paquete") Para solicitar la ubicación de sus paquetes en el IBX, envíe una `POST` solicitud al [`/v1/orders/smarthands/locatePackage`](https://docs.equinix.com/es/api-catalog/smarthandsv1/smarthands/handlesmarthandlocatepackageorder.md) punto final. Especifique los detalles de sus paquetes y necesidades en el `serviceDetails` objeto del 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, llama al [`Attachments File`](https://docs.equinix.com/es/api-catalog/attachmentsv1/attachments/createattachment.md) punto final. ``` curl -X POST "https://api.equinix.com/v1/orders/smarthands/locatePackage" -H "content-type: application/json" -H "authorization: Bearer " -d '{     "ibxLocation": {     "ibx": "AM1",     "cages": [       {         "cage": "AM1:0J:00JD11",         "cabinets": [             "AM1:0J:00JD11:0001"         ],         "accountNumber": "126854"       }     ]   },   "serviceDetails": {     "shipmentOrderNumber": "1-1234567890",     "trackingNumber": "All tracking numbers in this shipment order.",     "possibleLocation": "Last known location was the loading bay.",     "packageDescription": "Multiple DHL boxes.",     "scopeOfWork": "Locate and group all boxes together in a fixed location for easy identification and later collection.",     "needSupportFromASubmarineCableStationEngineer": true   },   "attachments": [     {         "id": "fcb2k8763-2947-456e-8d68-f280753d60ba",         "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 y descripciones del cuerpo, consulte [la referencia de API](https://docs.equinix.com/es/api-catalog/smarthandsv1/smarthands/handlesmarthandlocatepackageorder.md) . Respuesta de muestra: ``` {   "OrderNumber": "1-457809872838" } ``` La respuesta indica que el pedido se ha realizado correctamente y devuelve el número de pedido.