Liaison de votre logiciel à une société

Cas d'une société déjà existante dans Mobilic

Vous pouvez communiquer votre client_id à un gestionnaire de cette société. Il pourra alors le rentrer dans sa console gestionnaire dans Mobilic :

Cas d'une société non existante dans Mobilic

Vous pouvez créer une société dans Mobilic et y être automatiquement lié, en faisant un appel API au endpoint /protected :

mutation {
    company{
    softwareRegistration(
        clientId: 156432124,
        usualName: "Nom de la société",
        siren: "110068012",
        siret: "12234567005",
        nbWorkers: 10
      ){
        id
        name
    }
  }
}

Le paramètre nbWorkers est obligatoire et correspond au nombre de salariés de l'entreprise. Cette information est nécessaire pour permettre le calcul du certificat Mobilic. La valeur doit être un entier strictement supérieur à 0.

Contraintes métier importantes

Restriction SIREN/SIRET

⚠️ Contrainte métier : Une entreprise ne peut pas être enregistrée à la fois de façon globale (représentant tous ses établissements) ET par établissements spécifiques (avec des SIRETs distincts).

Explication

Dans Mobilic, une entreprise peut être enregistrée selon deux modes :

1. Mode global : L'entreprise représente l'ensemble de ses établissements (aucun SIRET spécifique)

2. Mode établissements : L'entreprise est enregistrée pour des établissements spécifiques (avec SIRETs)

Ces deux modes sont mutuellement exclusifs pour un même SIREN.

Cas d'erreur :

La mutation softwareRegistration échouera si :

• Une entreprise existe déjà en mode global pour le SIREN donné

• ET vous tentez de créer un établissement spécifique avec un SIRET

Exemple complet

1. Création initiale en mode global (réussit) :

mutation {
    company {
        softwareRegistration(
            clientId: 156432124,
            usualName: "Société Globale",
            siren: "110068012",
            nbWorkers: 10
            # ← Pas de SIRET = mode global
        ) {
            id
            name
        }
    }
}

1. Tentative de création d'établissement spécifique (échoue) :

mutation {
      company {
          softwareRegistration(
              clientId: 156432124,
              usualName: "Établissement spécifique",
              siren: "110068012",
              siret: "11006801200123",  # ← SIRET spécifique
              nbWorkers: 10
          ) {
              id
              name
          }
      }
  }

Réponse d'erreur :

{
    "errors": [{
      "message": "Company already registered globally for this SIREN (representing all establishments). Cannot create 
  SIRET-specific establishments.",
      "locations": [{"line": 4, "column": 15}],
      "path": ["company", "softwareRegistration"],
      "extensions": {
        "code": "SIREN_ALREADY_SIGNED_UP"
      }
    }],
    "data": {
      "company": {
        "softwareRegistration": null
      }
   

Solutions recommandées

Choisir une approche cohérente dès le départ :

Option 1 : Approche globale

• Créez l'entreprise sans SIRET pour représenter tous les établissements

• Idéal pour les entreprises avec gestion centralisée

Option 2 : Approche par établissements

• Créez directement chaque établissement avec son SIRET spécifique

• Idéal pour les entreprises avec gestion décentralisée par établissement

⚠️ Important : Une fois le mode choisi pour un SIREN, il ne peut plus être modifié. Planifiez votre stratégie d'enregistrement en fonction de vos besoins métier.