[Index de la documentation](https://prescriptio.fr/docs/llms.txt)

# Préparer une tournée terrain

L'outil tournees de Prescriptio prépare une journée de prospection sur le terrain : rendez-vous, prospects à voir autour, ordre de passage, trajet et message de chaque arrêt ; l'envoi se fait depuis votre messagerie.

### Squelette d'appel, généré depuis le schéma

**MCP (JSON-RPC)**

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "action": "lister"
    },
    "name": "tournees"
  }
}
```

**HTTP (curl)**

```bash
curl -sS https://prescriptio.fr/api/mcp \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"action":"lister"},"name":"tournees"}}'
```

### Forme de la réponse, générée depuis le schéma

```json
{
  "action": "<texte>",
  "download_url": "<texte>",
  "fields": {},
  "files": [
    {}
  ],
  "ok": false,
  "page": 0,
  "pages_total": 0,
  "quota": {},
  "texte": "<texte>"
}
```

## Paramètres

| Nom | Type | Requis | Description |
|---|---|---|---|
| `action` | `lister` · `lire` · `creer` · `modifier` · `supprimer` · `ajouter_etape` · `retirer_etape` · `regler_etape` · `proposer` · `optimiser` · `preparer` · `marquer` · `client` · `feuille_de_route` | oui | lister (défaut) ; lire { tournee_id } ; creer { nom, jour, depart, rayon_km } ; modifier { tournee_id, nom?, jour?, depart?, rayon_km?, statut? } ; supprimer { tournee_id } ; ajouter_etape { tournee_id, fiche_id \ |
| `action_message` | `rendez_vous` · `depot_documents` · `presentation` | — | preparer : ce que le message propose. |
| `adresse` | texte | — | Adresse d'un arret sans fiche (un rendez-vous), geocodee par la BAN. |
| `client` | booléen | — | client : true (défaut) pose le statut client sur la fiche de l'arret, false le remet en prospect. |
| `corps` | texte | — | preparer : corps du message. Vide = compose depuis les reglages de prospection. |
| `depart` | texte | — | Ville ou adresse de depart, résolue par la BAN (creer, modifier). |
| `duree_min` | entier | — | Durée de l'arret en minutes (défaut 30). (min 5, max 480) |
| `email` | texte | — | Le destinataire du message de l'arret : écrit ici, JAMAIS relu par l'outil. |
| `etape_id` | texte | — | Identifiant de l'arret (rendu par lire). Pour preparer : "toutes" = tous les arrets sans action. |
| `fiche_id` | texte | — | Une fiche de la base de l'utilisateur (base_suivis, ou proposer). |
| `heure` | texte | — | HH:MM, l'heure fixee d'un rendez-vous. Vide = quand le trajet le veut. |
| `jour` | texte | — | Le jour, AAAA-MM-JJ. Vide = a fixer. |
| `naf` | texte | — | proposer : codes NAF (5 caracteres) séparés par des virgules. Défaut : les activites les plus presentes dans la base. |
| `nature` | `rendez_vous` · `prospect` | — | rendez_vous = point fixe a heure fixe ; prospect = insere ou le trajet le veut (défaut). |
| `nom` | texte | — | Nom de la tournee (creer, modifier) ou de l'arret (ajouter_etape). |
| `note` | texte | — | — |
| `objet` | texte | — | preparer : objet du message. Vide = compose depuis les reglages de prospection. |
| `rayon_km` | entier | — | Rayon des propositions autour des arrets (défaut 20). (min 1, max 50) |
| `siren` | texte | — | Une entreprise de l'annuaire : elle entre dans la base ET dans la tournee. |
| `siret` | texte | — | Etablissement precis, facultatif avec siren. |
| `statut` | texte | — | modifier : brouillon \ |
| `texte` | texte | — | feuille_de_route : la feuille de route du jour, ecrite par l'assistant après avoir prepare la tournee (l'ordre, les heures d'arrivee, ce qui manque), en texte simple, paragraphes séparés par une ligne vide. Elle s'affiche sur la tournee, en carte de l'agent IA. Vide = l'effacer. (max. caractères 6000) |
| `tournee_id` | texte | — | Identifiant de la tournee (rendu par lister / creer). |

## Quand l'utiliser

Dans l'ordre : creer { nom, jour, depart } ; ajouter_etape pour les rendez-vous (nom + adresse + heure) ; proposer { tournee_id } pour voir les prospects de la base et de l'annuaire dans le rayon ; ajouter_etape { fiche_id } ou { siren } ; optimiser (ordre et trajet) ; preparer { etape_id | "toutes", action_message } pour écrire les messages. ⚠ Prescriptio n'ENVOIE rien : le message part de la messagerie de l'utilisateur (ou de son assistant, depuis SA boite) ; marquer { statut: "envoyee" } enregistre qu'il est parti. client { etape_id } pose le statut client sur la fiche. Une fois la tournee preparee, feuille_de_route { tournee_id, texte } y garde la feuille de route du jour (l'ordre, les heures d'arrivee, ce qui manque). Aucune coordonnee n'est rendue : le destinataire (email) s'écrit, ne se relit pas.

**Prompt prêt à coller : Le prompt qui le déclenche**

```text
Prépare ma tournée de jeudi autour de Grenoble : mes rendez-vous fixes, les prospects à voir autour, et l'ordre de passage.
```

Outil : `tournees` · Portée : `mcp:write`, écrit dans votre espace · Coût : 1 appel, aucune unité de dossier · Limite : agit dans votre espace seulement, jamais dans la donnée publique

## En bref

| | |
|---|---|
| Effets | lecture et écriture dans l'espace du compte |
| Portée OAuth | `mcp:write` |
| Conditions d’accès | Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas. |
| Données lues | l'espace du compte authentifié (ses alertes, ses dossiers, sa base) |
| Distribution | MCP historique |
| En REST | aucune opération : il s'appelle par le connecteur MCP |

## Réponse

Le résultat arrive dans `content[0].text` (le JSON sérialisé) et dans `structuredContent` (le même objet). L'exemple donne les **types**, jamais des valeurs réelles. Un champ absent ou `null` n'est ni un zéro ni une estimation : la source ne l'a pas renseigné.

## Erreurs et quotas

Cet outil ne consomme aucune unité de dossier : chercher est gratuit, c'est la lecture d'un dossier (`marches_dce`, `mairies_deliberations` et leurs téléchargements) qui est décomptée.

Les compteurs d’appels et de dossiers sont communs. Chaque action peut aussi être soumise à des droits et plafonds métier : [Codes d'erreur](https://prescriptio.fr/docs/reference/erreurs) et [Authentification et quotas](https://prescriptio.fr/docs/reference/authentification#les-quotas).

## Les skills qui s'en servent

- [prescriptio-preparer-terrain](https://prescriptio.fr/skills/prescriptio-preparer-terrain) : Le skill du plugin qui route cet outil

## Les pages qui s'en servent

Calculé depuis la documentation : chaque page qui cite `tournees`.

- [Prospection](https://prescriptio.fr/docs/prospection) : Documentation, Les modules
- [Préparer une tournée terrain autour de vos rendez-vous](https://prescriptio.fr/docs/guides/tournee-terrain) : Guides, Prospecter
- [Prompts de la prospection](https://prescriptio.fr/docs/prompts/prospection) : IA, Prompts par métier
- [Préparer une tournée](https://prescriptio.fr/skills/prescriptio-preparer-terrain) : IA, Les skills du plugin
- [Comment préparer une tournée de visites chez les applicateurs d'un secteur ?](https://prescriptio.fr/docs/connaissances/tournee-terrain) : Base de connaissances, Agir auprès du bon interlocuteur

## Voir aussi

- [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module