POST /clients/csv

Importe une liste de clients à partir d'un fichier CSV.

Format du fichier CSV:

  • Le fichier doit être encodé en UTF-8
  • La première ligne doit contenir les en-têtes des colonnes
  • Séparateur de colonnes : point-virgule (;) ou virgule (,)

Colonnes supportées:

  • name : Nom du client (obligatoire)
  • email : Adresse email
  • phone : Numéro de téléphone
  • address : Adresse postale
  • city : Ville
  • zip_code : Code postal
  • country : Pays
  • code : Code client
  • siren : Numéro SIREN
  • tva_intracom : Numéro de TVA intracommunautaire

Comportement:

  • Les clients existants (basé sur l'email ou le code) sont mis à jour
  • Les nouveaux clients sont créés
  • Un rapport d'import est retourné

Télécharger un modèle:

  • GET /files/clients.csv pour obtenir un fichier modèle
multipart/form-data

Body Required

  • file string(binary)

    Fichier CSV à importer

Responses

  • 200 application/json

    Clients importés avec succès

    Hide response attributes Show response attributes object
    • created integer

      Nombre de clients créés

    • updated integer

      Nombre de clients mis à jour

    • errors array[object]

      Liste des erreurs rencontrées

      Hide errors attributes Show errors attributes object
      • line integer

        Numéro de ligne en erreur

      • message string

        Message d'erreur

  • 400

    Requête invalide - Fichier CSV invalide ou manquant

POST /clients/csv
curl \
 --request POST 'https://wuro.pro/api/v3.2/clients/csv' \
 --header "X-APP-ID: $API_KEY" \
 --header "X-APP-SECRET: $API_KEY" \
 --header "Content-Type: multipart/form-data" \
 --form "file=@file"
Response examples (200)
{
  "created": 42,
  "updated": 42,
  "errors": [
    {
      "line": 42,
      "message": "string"
    }
  ]
}