Passer au contenu principal

Planifier les envois

Tous les envois doivent être planifiés à l'avance en créant une commande d'envoi entrant ou sortant. Le non-respect de cette consigne peut entraîner le rejet de l'envoi. Seul un utilisateur Equinix Customer Portal disposant de l’autorisation de commande d’envois peut planifier ces envois. Vous trouverez ici les types d'envois actuellement pris en charge par les API Equinix Customer Portal.

Conditions préalables​

  1. Pour obtenir les détails de l'envoi, l'utilisateur doit disposer Shipmentsdes autorisations de commande.

  2. Authentifier - envoyez vos identifiants utilisateur, votre identifiant client et votre secret client pour l'authentification OAuth2. Pour obtenir des instructions sur la façon d'appeler l'API OAuth pour valider et authentifier vos identifiants, reportez-vous à authentification API.

  3. Pour planifier un envoi, vous devez déterminer l'identifiant exact de la cage et le numéro de compte de l'envoi. Ces valeurs seront transmises pour les cageIdparamètres et accountNumberdans le corps de la demande.

  4. Obtenir des informations de localisation : envoyez une GET demande au /v1/orders/smarthands/locationspoint final pour récupérer les emplacements IBX disponibles auxquels vous avez accès. Vous pouvez ignorer cette étape si vous connaissez déjà les informations de localisation.

Programmation d'un envoi entrant​

Pour planifier un envoi entrant, envoyez une POST demande au /colocations/v2/orders/shipmentsterminal. Utilisez le "type": "INBOUND" paramètre pour indiquer qu'il s'agit d'un envoi entrant et fournissez le reste des détails de l'envoi dans le corps de la demande. Une demande d’envoi entrant nécessite au minimum d’inclure le type d’envoi, la date d’envoi, la cage associée, le transporteur et le nombre de cartons. Les autres informations nécessaires que vous devez transmettre à l'organisme de demande d'envoi entrant dépendent des éléments suivants :

  • Si votre envoi entrant provient d'une cage liée à plusieurs comptes.
  • Si le transporteur qui livre l'envoi provient de votre organisation, d'un transporteur répertorié ou non répertorié. Si votre transporteur n’est pas DHL, FedEx, UPS, votre transporteur n’est pas répertorié.

Exemple de requête cURL :

Un envoi entrant d'une cage associée à un compte unique qui sera livré par votre organisation.

Dans ce scénario, votre envoi entrant est livré dans votre cage liée à un seul compte par un membre de votre organisation. Les informations minimales requises pour ce scénario sont transmises dans cet exemple de demande.

curl -X
POST "https://api.equinix.com/colocations/v2/orders/shipments"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
    "type": "INBOUND",
    "requestedDateTime": "2020-11-02T10:45:41Z",
    "cageId": "AM1:01:000111",
    "details": {
    "carrier": "CUSTOMER_CARRIER",
    "numberOfBoxes": 2
    }
}'

Exemple de requête cURL :

Envoi entrant depuis une cage associée à plusieurs comptes qui sera livré par un transporteur non répertorié. Des demandes Smart Hands, des informations, des coordonnées et des pièces jointes supplémentaires sont également incluses.

note

Avant de créer une commande avec pièce jointe, appelez le Attachments File terminal.

Dans ce scénario, vous avez fourni les informations minimales requises pour faciliter un envoi entrant, et vous avez inclus des paramètres corporels supplémentaires qui prennent en charge les éléments suivants :

  • demande supplémentaire de Smart Hands pour livrer l'envoi à votre cage
  • description supplémentaire
  • pièces jointes à l'appui
  • votre propre identifiant de référence
  • informations sur le bon de commande
  • coordonnées des personnes chargées de la notification ou des contacts techniques

Tous les paramètres corporels disponibles et applicables sont transmis dans cet exemple de demande.

curl -X
POST "https://api.equinix.com/colocations/v2/orders/shipments"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
    "type": "INBOUND",
    "requestedDateTime": "2020-11-02T10:45:41Z",
    "cageId": "AM1:01:000111",
    "accountNumber": 901011,
    "details": {
        "carrier": "OTHER",
        "carrierName": "New Carrier",
        "numberOfBoxes": 2,
        "carrierTrackingNumbers": [
            "t1Z294AK92654678989",
            "t1Z086DK96424456780"
        ],
        "cageDelivery": true
    },
    "description": "Package is fragile and heavy. Handle with care. Additional description in attachment.",
    "attachments": [
        {
            "id": "85d9660a-f877-405a-b38e-8e61a4f77f44",
            "name": "OrderInstructions.docx"
        }
    ], 
    "customerReferenceId": "2020/16347",
        "purchaseOrder": {
        "type": "NEW",
        "number": "9654284",
        "amount": "10000",
        "startDate": "2020-10-01",
        "endDate": "2021-09-30",
        "attachmentId": "56d10de6-f2c0-4edd-ba29-b70736aa2093"
    },
    "contacts": [
    {
        "type": "NOTIFICATION",
        "registeredUsers": [
            "john_doe1",
            "jane_smith1"
        ]
    },
    {
        "type": "TECHNICAL",
        "firstName": "John",
        "lastName": "Doe",
        "availability": "WORK_HOURS",
        "timezone": "America/Los_Angeles",
        "details": [
            {
                "type": "EMAIL",
                "value": "johndoe@acme.com""
            },
            {
                "type": "PHONE",
                "value": "+1-987654321"
            },
            {
                "type": "MOBILE",
                "value": "+1-912345678"
            }
        ]
    }
  ]
}'

La commande est créée avec succès lorsqu'un code HTTP de 201 est renvoyé et que l'en-tête de réponse est renvoyé. Il n'y a pas d'organisme de réponse.

Pour mettre à jour cette commande, reportez-vous à /v2/orders/shipments/{orderId} la section référence API pour plus d'informations.

Si vous souhaitez ajouter des notes à cette commande, récupérer et répondre aux négociations pour cette commande, ou annuler cette commande, consultez commandes dans la section référence API pour plus d'informations.

Planifier un envoi sortant​

Pour planifier un envoi sortant, envoyez une POST demande au /colocations/v2/orders/shipmentsterminal. Utilisez le "type": "OUTBOUND" paramètre pour indiquer qu'il s'agit d'un envoi sortant et fournissez les détails du reste de l'envoi dans le corps de la demande. Une demande d’envoi sortant nécessite au minimum d’inclure le type d’envoi, la date d’envoi, la cage associée et le transporteur. Les autres informations nécessaires que vous devez transmettre à l' organisme de demande d'envoi sortant dépendent des éléments suivants :

  • Si votre envoi provient d'une cage liée à plusieurs comptes.
  • Si le transporteur qui livre l'envoi provient de votre organisation, d'un transporteur répertorié ou non répertorié. Si votre transporteur n’est pas DHL, FedEx, UPS, votre transporteur n’est pas répertorié.
  • Si vous souhaitez qu'une étiquette d'expédition soit imprimée par Equinix.

Exemple de requête cURL :

Un envoi sortant d'une cage associée à un compte unique qui sera livré par une personne de votre organisation.

Dans ce scénario, votre envoi sortant est livré dans votre cage liée à un seul compte par un membre de votre organisation. Les informations minimales requises pour ce scénario sont transmises dans cet exemple de demande.

curl -X
POST "https://api.equinix.com/colocations/v2/orders/shipments"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
    "type": "OUTBOUND",
    "requestedDateTime": "2020-11-02T10:45:41Z",
    "cageId": "AM1:01:000111",
    "details": {
    "carrier": "CUSTOMER_CARRIER"
    ]
    }
}'

Exemple de requête cURL :

Envoi sortant provenant d'une cage associé à plusieurs comptages qui sera livré par un transporteur non répertorié et qui nécessite l' impression de l'étiquette d'expédition par Equinix. Les détails de l'étiquette d'expédition pertinente sont fournis en pièce jointe. Des demandes Smart Hands, des informations, des coordonnées et des pièces jointes supplémentaires sont également incluses.

note

Avant de créer une commande avec pièce jointe, appelez le Attachments File terminal.

Dans ce scénario, vous avez fourni les informations minimales requises pour faciliter une demande de transport sortant, et vous avez inclus des paramètres supplémentaires dans le corps du message qui permettent de répondre aux questions suivantes :

  • la valeur déclarée de l'envoi dans une devise autre que le dollar américain
  • demandes supplémentaires de Smart Hands pour récupérer votre envoi dans votre cage ou pour l'assurer
  • description supplémentaire
  • pièces jointes à l'appui
  • votre propre identifiant de référence
  • informations sur le bon de commande
  • coordonnées des personnes chargées de la notification ou des contacts techniques

Tous les paramètres corporels disponibles et applicables sont transmis dans cet exemple de demande.

curl -X
POST "https://api.equinix.com/colocations/v2/orders/shipments"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
    "type": "OUTBOUND",
    "requestedDateTime": "2020-11-02T10:45:41Z",
    "cageId": "AM1:01:000111",
    "accountNumber": 901011,
    "details": {
    "carrier": "OTHER",
    "carrierName": "New Carrier",
    "numberOfBoxes": 2,
    "declaredValue": 1000,
    "declaredValueCurrency": "EUR",
    "carrierTrackingNumbers": [
        "t1Z294AK92654678989",
        "t1Z086DK96424456780"
    ],
        "shipmentLabelRequired": true,
        "shipmentAttachmentId": "f49891fc-d9a5-4b4b-bc65-150b1c5e6dff",
        "requirePickup": true,
        "insureShipment": true
    },
    "description": "Package is fragile and heavy. Handle with care. Additional description in attachment.",
    "attachments": [
    {
        "id": "85d9660a-f877-405a-b38e-8e61a4f77f44",
        "name": "OrderInstructions.docx"
    }
    ],
    "customerReferenceId": "2020/16347",
    "purchaseOrder": {
        "type": "NEW",
        "number": "9654284",
        "amount": "10000",
        "startDate": "2020-10-01",
        "endDate": "2021-09-30",
        "attachmentId": "56d10de6-f2c0-4edd-ba29-b70736aa2093"
    },
    "contacts": [
    {
        "type": "NOTIFICATION",
        "registeredUsers": [
            "john_doe1",
            "jane_smith1"
        ]
    },
    {
        "type": "TECHNICAL",
        "firstName": "John",
        "lastName": "Doe",
        "availability": "WORK_HOURS",
        "timezone": "America/Los_Angeles",
        "details": [
            {
                "type": "EMAIL",
                "value": "johndoe@acme.com"
            },
            {
                "type": "PHONE",
                "value": "+1-987654321"
            },
            {
                "type": "MOBILE",
                "value": "+1-912345678"
            }
        ]
    }
  ]
}'

La commande est créée avec succès lorsqu'un code HTTP de 201 est renvoyé et que l'en-tête de réponse est renvoyé. Il n'y a pas d'organisme de réponse.

Pour mettre à jour cette commande, reportez-vous à /v2/orders/shipments/{orderId} la section référence API pour plus d'informations.

Si vous souhaitez ajouter des notes à cette commande, récupérer et répondre aux négociations pour cette commande, ou annuler cette commande, consultez commandes dans la section référence API pour plus d'informations.

Cette page vous a-t-elle été utile ?