Entreprises (MultiServiceCompany)

Le module MultiServiceCompanyModule permet de gérer les entreprises (fournisseurs de services) au sein de votre application multi-services. Une application peut avoir plusieurs entreprises, et une peut être définie comme entreprise par défaut.

Accès : client.app.multiService.company

Méthodes

`create`

Crée une nouvelle entreprise.

Exemple


const response = await client.app.multiService.company.create({
  appId: "app_id",
  apiKey: "user_api_key",
  name: "Salon Belle Coiffure",
  description: "Le meilleur salon de la ville",
  email: "contact@bellecoiffure.com",
  telephone: "+2250707070707",
  address: "Abidjan, Cocody",
  logo: "https://example.com/logo.png",
  logoId: "logo_file_id",
  isDefault: true
});

Paramètres

Champ	Type	Requis	Description
`appId`	string	Oui	ID de l’application
`apiKey`	string	Oui	Clé API de l’utilisateur
`name`	string	Oui	Nom de l’entreprise (min 1 caractère)
`description`	string	Non	Description de l’entreprise
`email`	string	Non	Email de contact (format email valide)
`telephone`	string	Non	Numéro de téléphone
`address`	string	Non	Adresse physique
`logo`	string	Non	URL du logo
`logoId`	string	Non	ID du fichier logo (pour le suivi/suppression)
`isDefault`	boolean	Non	Définir comme entreprise par défaut (défaut: false)

Si isDefault: true, toutes les autres entreprises de l’application perdront leur statut par défaut.

Réponse


{
  "success": true,
  "data": {
    "id": "company_id",
    "appId": "app_id",
    "name": "Salon Belle Coiffure",
    "description": "Le meilleur salon de la ville",
    "email": "contact@bellecoiffure.com",
    "telephone": "+2250707070707",
    "address": "Abidjan, Cocody",
    "logo": "https://example.com/logo.png",
    "isDefault": true,
    "createdAt": "2024-01-15T10:00:00.000Z",
    "updatedAt": "2024-01-15T10:00:00.000Z"
  }
}

`list`

Liste toutes les entreprises de l’application.

Exemple


const response = await client.app.multiService.company.list({
  appId: "app_id",
  apiKey: "user_api_key"
});
 
// Trouver l'entreprise par défaut
const defaultCompany = response.data.find(c => c.isDefault);

Paramètres

Champ	Type	Requis	Description
`appId`	string	Oui	ID de l’application
`apiKey`	string	Oui	Clé API de l’utilisateur

Les entreprises sont triées par date de création décroissante.

Réponse


{
  "success": true,
  "data": [
    {
      "id": "company_id_1",
      "appId": "app_id",
      "name": "Salon Belle Coiffure",
      "description": "Le meilleur salon de la ville",
      "email": "contact@bellecoiffure.com",
      "telephone": "+2250707070707",
      "address": "Abidjan, Cocody",
      "logo": "https://example.com/logo.png",
      "isDefault": true,
      "createdAt": "2024-01-15T10:00:00.000Z",
      "updatedAt": "2024-01-15T10:00:00.000Z"
    },
    {
      "id": "company_id_2",
      "appId": "app_id",
      "name": "Salon Beauté Plus",
      "description": null,
      "email": null,
      "telephone": null,
      "address": null,
      "logo": null,
      "isDefault": false,
      "createdAt": "2024-01-10T08:00:00.000Z",
      "updatedAt": "2024-01-10T08:00:00.000Z"
    }
  ]
}

`get`

Récupère les détails d’une entreprise.

Exemple


const response = await client.app.multiService.company.get({
  appId: "app_id",
  apiKey: "user_api_key",
  id: "company_id"
});
 
if (response.success) {
  console.log(`Entreprise: ${response.data.name}`);
  console.log(`Email: ${response.data.email ?? 'Non renseigné'}`);
}

Paramètres

Champ	Type	Requis	Description
`appId`	string	Oui	ID de l’application
`apiKey`	string	Oui	Clé API de l’utilisateur
`id`	string	Oui	ID de l’entreprise

Réponse


{
  "success": true,
  "data": {
    "id": "company_id",
    "appId": "app_id",
    "name": "Salon Belle Coiffure",
    "description": "Le meilleur salon de la ville",
    "email": "contact@bellecoiffure.com",
    "telephone": "+2250707070707",
    "address": "Abidjan, Cocody",
    "logo": "https://example.com/logo.png",
    "isDefault": true,
    "createdAt": "2024-01-15T10:00:00.000Z",
    "updatedAt": "2024-01-15T10:00:00.000Z"
  }
}

Erreur possible :


{
  "success": false,
  "error": "company-not-found"
}

`update`

Met à jour les informations d’une entreprise.

Exemple


// Mise à jour partielle
const response = await client.app.multiService.company.update({
  appId: "app_id",
  apiKey: "user_api_key",
  id: "company_id",
  name: "Salon Belle Coiffure & Esthétique",
  address: "Abidjan, Riviera 2"
});
 
// Définir comme entreprise par défaut
const response2 = await client.app.multiService.company.update({
  appId: "app_id",
  apiKey: "user_api_key",
  id: "company_id",
  isDefault: true
});
 
// Mettre à jour le logo
const response3 = await client.app.multiService.company.update({
  appId: "app_id",
  apiKey: "user_api_key",
  id: "company_id",
  logo: "https://example.com/new-logo.png",
  logoId: "new_logo_file_id"
});

Paramètres

Champ	Type	Requis	Description
`appId`	string	Oui	ID de l’application
`apiKey`	string	Oui	Clé API de l’utilisateur
`id`	string	Oui	ID de l’entreprise
`name`	string	Non	Nouveau nom
`description`	string	Non	Nouvelle description
`email`	string	Non	Nouvel email
`telephone`	string	Non	Nouveau téléphone
`address`	string	Non	Nouvelle adresse
`logo`	string	Non	Nouvelle URL du logo
`logoId`	string	Non	Nouvel ID du fichier logo
`isDefault`	boolean	Non	Définir comme entreprise par défaut

Si isDefault: true, toutes les autres entreprises de l’application perdront leur statut par défaut.

Réponse


{
  "success": true,
  "data": {
    "id": "company_id",
    "appId": "app_id",
    "name": "Salon Belle Coiffure & Esthétique",
    "description": "Le meilleur salon de la ville",
    "email": "contact@bellecoiffure.com",
    "telephone": "+2250707070707",
    "address": "Abidjan, Riviera 2",
    "logo": "https://example.com/logo.png",
    "isDefault": true,
    "createdAt": "2024-01-15T10:00:00.000Z",
    "updatedAt": "2024-01-20T14:30:00.000Z"
  }
}

`delete`

Supprime une entreprise.

Exemple


const response = await client.app.multiService.company.delete({
  appId: "app_id",
  apiKey: "user_api_key",
  id: "company_id"
});
 
if (response.success) {
  console.log("Entreprise supprimée avec succès");
}

Paramètres

Champ	Type	Requis	Description
`appId`	string	Oui	ID de l’application
`apiKey`	string	Oui	Clé API de l’utilisateur
`id`	string	Oui	ID de l’entreprise

La suppression d’une entreprise entraîne la suppression en cascade de :

Tous les rendez-vous de cette entreprise
Toutes les options de champs des services
Tous les champs des services
Tous les services de cette entreprise
Tous les agents de cette entreprise

Réponse


{
  "success": true,
  "data": true
}

Erreur possible :


{
  "success": false,
  "error": "company-not-found"
}

Entreprise par défaut

L’entreprise par défaut est utilisée automatiquement lorsqu’aucun companyId n’est spécifié lors de la création d’agents ou de services.


// Créer un service sans spécifier companyId
// → Utilise automatiquement l'entreprise par défaut
const service = await client.app.multiService.service.create({
  appId: "app_id",
  apiKey: "user_api_key",
  name: "Coupe Homme",
  basePrice: 1500
  // companyId omis → entreprise par défaut
});

Si aucune entreprise par défaut n’existe et qu’aucune entreprise n’est présente, une entreprise par défaut sera créée automatiquement avec le nom de l’application.

Gestion des erreurs

Code erreur	Description
`company-not-found`	L’entreprise n’existe pas ou n’appartient pas à l’application
`not-authorized`	La clé API n’a pas les droits nécessaires
`app-not-found`	L’application n’existe pas