Retour aux guides

Prise de rendez-vous

La planification des interventions terrain est gérée différemment selon les OI. Netwo unifie l'accès aux créneaux disponibles et la réservation, quel que soit le protocole sous-jacent.

Attention : Les créneaux disponibles dépendent de l'OI et peuvent changer rapidement. Réservez dès que possible après consultation.

Consulter les créneaux disponibles

Récupérez la liste des créneaux disponibles pour planifier une intervention sur une commande.

GET/v1/orders/{orderId}/slots

Retourne les créneaux d'intervention disponibles pour la commande.

Paramètres

NomTypeRequisDescription
fromstring
optionnel
Date de début (format ISO, défaut : aujourd'hui)
tostring
optionnel
Date de fin (format ISO, défaut : from + 14 jours)
timeOfDaystring
optionnel
MORNING / AFTERNOON / ALL (défaut : ALL)
bash
curl https://api.netwo.io/v1/orders/ORD-2024-00142/slots?from=2024-03-25&to=2024-04-08&timeOfDay=ALL \
  -H "Authorization: Bearer YOUR_API_KEY"

Réserver un créneau

Confirmez un créneau en fournissant les informations de contact pour le technicien.

POST/v1/orders/{orderId}/appointment

Réserve un créneau d'intervention pour la commande.

Paramètres

NomTypeRequisDescription
slotIdstring
requis
Identifiant du créneau choisi
contactNamestring
requis
Nom du contact sur place
contactPhonestring
requis
Téléphone du contact
instructionsstring
optionnel
Consignes d'accès pour le technicien
bash
curl -X POST https://api.netwo.io/v1/orders/ORD-2024-00142/appointment \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slotId": "SLT-20240325-AM",
    "contactName": "Jean Dupont",
    "contactPhone": "+33612345678",
    "instructions": "Digicode 4521, 3eme etage gauche"
  }'

Modifier un rendez-vous

Déplacez un rendez-vous existant vers un nouveau créneau.

PUT/v1/orders/{orderId}/appointment

Modifie le rendez-vous en cours pour la commande.

Paramètres

NomTypeRequisDescription
slotIdstring
requis
Identifiant du nouveau créneau
reasonstring
requis
Motif de la modification
bash
curl -X PUT https://api.netwo.io/v1/orders/ORD-2024-00142/appointment \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slotId": "SLT-20240326-AM",
    "reason": "Client indisponible le 25 mars"
  }'

Annuler un rendez-vous

Annulez un rendez-vous planifié en fournissant un motif.

DELETE/v1/orders/{orderId}/appointment

Annule le rendez-vous en cours pour la commande.

Paramètres

NomTypeRequisDescription
reasonstring
requis
Motif de l'annulation
bash
curl -X DELETE https://api.netwo.io/v1/orders/ORD-2024-00142/appointment \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "Commande annulee par le client"
  }'

Format de réponse

Créneaux disponibles

Réponse retournée par l'endpoint de consultation des créneaux.

json
{
  "orderId": "ORD-2024-00142",
  "slots": [
    {
      "slotId": "SLT-20240325-AM",
      "date": "2024-03-25",
      "timeOfDay": "MORNING",
      "startTime": "08:00",
      "endTime": "12:00",
      "available": true
    },
    {
      "slotId": "SLT-20240325-PM",
      "date": "2024-03-25",
      "timeOfDay": "AFTERNOON",
      "startTime": "13:00",
      "endTime": "17:00",
      "available": true
    },
    {
      "slotId": "SLT-20240326-AM",
      "date": "2024-03-26",
      "timeOfDay": "MORNING",
      "startTime": "08:00",
      "endTime": "12:00",
      "available": false
    }
  ]
}

Confirmation de rendez-vous

Réponse retournée lors de la réservation ou modification d'un rendez-vous.

json
{
  "orderId": "ORD-2024-00142",
  "appointmentId": "APT-2024-00089",
  "slot": {
    "slotId": "SLT-20240325-AM",
    "date": "2024-03-25",
    "startTime": "08:00",
    "endTime": "12:00"
  },
  "contact": {
    "name": "Jean Dupont",
    "phone": "+33612345678"
  },
  "instructions": "Digicode 4521, 3eme etage gauche",
  "status": "CONFIRMED",
  "createdAt": "2024-03-19T11:00:00Z"
}
Guide précédent : Suivi de commandeGuide suivant : Support