Bulk actions on visits (asynchronous)

post

https://api.mapflow.co/api/v1/visits/bulk_action/

Lance une tâche asynchrone pour effectuer des actions en lot sur plusieurs visites.

DEUX MODES DE SÉLECTION :

Par liste d'IDs explicites (visit_ids) :
- Fournir une liste d'UUIDs de visites
- Maximum : 5000 visites
Par filtres de recherche (filters) :
- Applique l'action sur TOUTES les visites correspondant aux filtres
- Support de la recherche globale via le paramètre "search"
- Support de tous les filtres (visit_date, visit_type, priority, etc.)
- Maximum : 10000 visites (sécurité)

Actions supportées : change_priority, change_type, change_date, change_reference, change_duration, change_opening_hours, add_tags, remove_tags, add_to_route, remove_from_route, add_product, remove_product.

Exemples :

Mode IDs :

{
    "action": "add_tags",
    "visit_ids": ["uuid1", "uuid2", "uuid3"],
    "tag_ids": ["tag-uuid"]
}

Mode filtres (recherche) :

{
    "action": "add_tags",
    "filters": {
        "search": "Virginie"
    },
    "tag_ids": ["tag-uuid"]
}

Mode filtres (date) :

{
    "action": "change_priority",
    "filters": {
        "visit_date": "2025-12-16",
        "visit_type": "delivery"
    },
    "new_priority": 5
}

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Serializer pour les actions en lot sur les visites

Supporte deux modes de sélection :

Par liste d'IDs explicites (visit_ids)
Par filtres de recherche (filters) - applique l'action sur tous les résultats

Exemples :

Mode IDs : {"action": "add_tags", "visit_ids": ["uuid1", "uuid2"], "tag_ids": ["tag-uuid"]}
Mode filtres : {"action": "add_tags", "filters": {"search": "Virginie"}, "tag_ids": ["tag-uuid"]}

visit_ids

array of uuids

length between 1 and 5000

Liste des IDs de visites (max 5000). Optionnel si 'filters' est fourni.

visit_ids

filters

string

Filtres de recherche pour sélectionner les visites (ex: {'search': 'Virginie', 'visit_date': '2024-12-16'}). Applique l'action sur tous les résultats correspondants. Optionnel si 'visit_ids' est fourni.

action

string

enum

required

change_priority - Changer la priorité
change_type - Changer le type de visite
change_date - Changer la date
change_reference - Changer la référence
change_duration - Changer la durée
change_opening_hours - Changer les horaires d'ouverture
add_tags - Ajouter des tags
remove_tags - Retirer des tags
add_to_route - Ajouter à une route
remove_from_route - Retirer d'une route
add_product - Ajouter des produits
remove_product - Retirer des produits

new_priority

integer

1 to 5

Nouvelle priorité (requis si action=change_priority)

new_visit_type

string

enum

Nouveau type de visite (requis si action=change_type)

delivery - Livraison
pickup - Enlèvement
service - Intervention
delivery_pickup - Livraison + Enlèvement

Allowed:

new_visit_date

date

Nouvelle date de visite (requis si action=change_date)

new_reference

string

length between 1 and 50

Nouvelle référence (requis si action=change_reference)

duration

integer

≥ 0

Nouvelle durée en minutes (requis si action=change_duration)

opening_hour_1

string | null

Heure d'ouverture 1 (requis si action=change_opening_hours)

closing_hour_1

string | null

Heure de fermeture 1 (requis si action=change_opening_hours)

opening_hour_2

string | null

Heure d'ouverture 2 (optionnel pour action=change_opening_hours)

closing_hour_2

string | null

Heure de fermeture 2 (optionnel pour action=change_opening_hours)

tag_ids

array of uuids

Liste des IDs de tags (requis si action=add_tags ou remove_tags)

tag_ids

route_ids

array of uuids

Liste des IDs de routes (requis si action=add_to_route ou remove_from_route)

route_ids

products

array of objects

Liste des produits avec quantités (requis si action=add_product ou remove_product)

products

Headers

content-type

string

enum

Defaults to application/json

Generated from available request content types

Allowed:

Responses

202Asynchronous task launched successfully

400Invalid data or too many visits selected

403Insufficient permissions