POST /clients/merge

Fusionne deux fiches clients en une seule.

Fonctionnement:

  • Le client source est fusionné dans le client target
  • Toutes les factures, devis et documents du client source sont transférés au client cible
  • Le client source est supprimé après la fusion

Transfert des données:

  • Factures et devis
  • Historique des paiements
  • Notes et commentaires
  • Interlocuteurs

Attention:

  • Cette opération est irréversible
  • Les informations du client source qui diffèrent ne sont pas copiées (seuls les documents sont transférés)

Événement déclenché: MERGE_CLIENT

application/json

Body Required

  • source string Required

    ID du client à fusionner (sera supprimé)

  • target string Required

    ID du client cible (recevra les documents)

Responses

  • 200 application/json

    Clients fusionnés avec succès

    Hide response attributes Show response attributes object
    • client object
      Hide client attributes Show client attributes object
      • _id string

        Unique identifier for the client

      • name string

        Name of the client (required)

      • email string(email)

        Email of the client

      • phone string

        Phone number

      • phoneFormat string

        Formatted phone number for search

      • mobile string

        Mobile phone number

      • mobileFormat string

        Formatted mobile number for search

      • fax string

        Fax number

      • address string

        Street address

      • address_complement string

        Address complement

      • address_end string

        Additional address information

      • zip_code string

        Zip code

      • city string

        City

      • country string

        Country

        Default value is France.

      • company string

        Reference to the company

      • category string

        Client category

      • client_code string

        Client code for accounting

      • analytical_code string

        Analytical code

      • siren string

        SIREN number

      • nic string

        NIC code

      • tva_number string

        VAT number

      • website string

        Website URL

      • description string

        Client description

      • notes string

        Notes about the client

      • avatar object

        Client avatar image

      • client_contact string

        Reference to main contact interlocutor

      • mainInterlocutor string

        Reference to main interlocutor

      • positionsAssigned array[string]

        List of assigned positions

      • positionCreator string

        Position that created this client

      • positionLastUpdator string

        Position that last updated this client

      • tags array[string]

        List of tag references

      • state string

        Client state

        Values are active or inactive. Default value is active.

      • stats object
        Hide stats attributes Show stats attributes object
        • nbInvoices integer

          Default value is 0.

        • nbNotes integer

          Default value is 0.

        • nbReminders integer

          Default value is 0.

        • nbFiles integer

          Default value is 0.

        • nbPurchases integer

          Default value is 0.

        • nbQuotes integer

          Default value is 0.

        • nbDeliveryReceipts integer

          Default value is 0.

      • extraData object

        Custom extra data

      • createdAt string(date-time)
      • updatedAt string(date-time)
    • documentsTransferred integer

      Nombre de documents transférés

  • 400

    Requête invalide - IDs manquants ou identiques

  • 404

    Client source ou cible non trouvé

POST /clients/merge
curl \
 --request POST 'https://wuro.pro/api/v3.2/clients/merge' \
 --header "X-APP-ID: $API_KEY" \
 --header "X-APP-SECRET: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"source":"string","target":"string"}'
Request examples
{
  "source": "string",
  "target": "string"
}
Response examples (200)
{
  "client": {
    "_id": "string",
    "name": "string",
    "email": "hello@example.com",
    "phone": "string",
    "phoneFormat": "string",
    "mobile": "string",
    "mobileFormat": "string",
    "fax": "string",
    "address": "string",
    "address_complement": "string",
    "address_end": "string",
    "zip_code": "string",
    "city": "string",
    "country": "France",
    "company": "string",
    "category": "string",
    "client_code": "string",
    "analytical_code": "string",
    "siren": "string",
    "nic": "string",
    "tva_number": "string",
    "website": "string",
    "description": "string",
    "notes": "string",
    "avatar": {},
    "client_contact": "string",
    "mainInterlocutor": "string",
    "positionsAssigned": [
      "string"
    ],
    "positionCreator": "string",
    "positionLastUpdator": "string",
    "tags": [
      "string"
    ],
    "state": "active",
    "stats": {
      "nbInvoices": 0,
      "nbNotes": 0,
      "nbReminders": 0,
      "nbFiles": 0,
      "nbPurchases": 0,
      "nbQuotes": 0,
      "nbDeliveryReceipts": 0
    },
    "extraData": {},
    "createdAt": "2025-05-04T09:42:00Z",
    "updatedAt": "2025-05-04T09:42:00Z"
  },
  "documentsTransferred": 42
}