---
title: "Notifie le destinataire d'un stop par SMS — ETA + tracking (R318.3)."
method: POST
path: "/api/v1/livraison/stops/{stop_id}/sms-notify"
tags: ["Livraison & Routing (V2)"]
---

# Notifie le destinataire d'un stop par SMS — ETA + tracking (R318.3).

`POST /api/v1/livraison/stops/{stop_id}/sms-notify`

## Request

- Base URL: `https://erp.eyeot.fr/api/v1`
- URL: `https://erp.eyeot.fr/api/v1/api/v1/livraison/stops/{stop_id}/sms-notify`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Notifie le destinataire d'un stop par SMS — ETA + tracking (R318.3).

    Body :
        {
          "eta_minutes": 30,        # optionnel, default = depuis stop.eta_predicted
          "phone": "+33612345678"   # optionnel, fallback stop.recipient_phone
        }

    Cas d'erreur :
        - 404 stop introuvable
        - 400 numéro destinataire invalide (E.164)
        - 422 Twilio non configuré pour l'org
        - 503 Twilio API échec

**Permissions requises** : `livraison:write`

## Response `200`

Succès — payload `{data, meta}` (cf. API-GUIDE §3.1)

## Other responses

- `201`: Ressource créée. ID dans `data.id`.
- `400`: Validation Marshmallow échouée. `errors` détaille chaque champ invalide.
- `401`: JWT manquant, expiré ou révoqué.
- `402`: L'organisation n'a pas d'abonnement actif (paywall). Rediriger vers /activate.
- `403`: Permissions `module:action` insuffisantes pour cette route.
- `404`: Ressource introuvable (ou cross-tenant — équivalent à hidden).
- `409`: État incohérent (email dupliqué, ressource déjà dans cet état, etc.).
- `422`: Validation Marshmallow échouée. `errors` détaille chaque champ invalide.
- `429`: Trop de requêtes. Honorer le header `Retry-After` (secondes).

---

[API](https://skmtc.dev/eyeot/apis/eyeot-erp-api.md) · [All operations](https://skmtc.dev/eyeot/apis/eyeot-erp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/eyeot/apis/eyeot-erp-api/revisions/42ab95222a89?raw)