6. Créer un propriétaire

Reconstruit — doc utilisateur « Création propriétaire » + schéma createOwner / OwnerInput.

Pas dans la capture UI

Ce parcours n’apparaît pas dans graphql-calls.json. Les exemples ci-dessous sont dérivés du schéma officiel.

Modèle de données

Un Owner embarque un profile: ProfileInput! :

• type: personal_profile → personne physique
• type: moral_profile → personne morale (SCI, société…)

Champs obligatoires notables : isInvoicingEntity, profile.bankAccount, et pour l’identité profile.identity.housingAddress.

Personne physique

GraphQL

mutation createOwner($owner: OwnerInput!) {
  createOwner(owner: $owner) {
    id
    customReference
    isInvoicingEntity
    profile {
      type
      officialContact {
        firstName
        lastName
        email
      }
    }
  }
}

{
  "owner": {
    "isInvoicingEntity": true,
    "externalId": "OWNER-EXT-001",
    "customReference": "P-001",
    "profile": {
      "type": "personal_profile",
      "bankAccount": {
        "accountHolderName": "Alice Martin",
        "iban": "FR76XXXXXXXXXXXXXXXXXXXXXXX",
        "bic": "BNPAFRPP",
        "bankName": "Banque Exemple"
      },
      "officialContact": {
        "civility": "female",
        "firstName": "Alice",
        "lastName": "Martin",
        "email": "[email protected]",
        "mobilePhone": "+33600000000"
      },
      "identity": {
        "housingAddress": {
          "number": "10",
          "street": "Rue de Rivoli",
          "zip": "75001",
          "city": "Paris",
          "country": "FR"
        }
      }
    }
  }
}

Node.js

const { createOwner } = await ublo(
  `mutation createOwner($owner: OwnerInput!) {
    createOwner(owner: $owner) { id customReference }
  }`,
  { owner: { /* variables ci-dessus */ } },
);

curl

Bearer

curl -sS -X POST "$UBLO_GRAPHQL_URL" \
  -H "Authorization: Bearer $UBLO_API_TOKEN" \
  -H 'Content-Type: application/json' \
  -d @create-owner.json

Cookie session

curl -sS -X POST "$UBLO_GRAPHQL_URL" \
  -H 'Content-Type: application/json' \
  -b cookies.txt \
  -d @create-owner.json

Enums

Les valeurs de civility sont définies par l’enum CivilityType (female, male, undefined). Consultez les autres enums dans le schéma et validez-les par introspection sur votre tenant.

Personne morale

Même mutation, avec profile.type: "moral_profile" et profile.registration / contacts officiels selon ProfileInput. Côté métier (PDF), renseignez raison sociale, SIREN/SIRET, TVA, NAF, adresse de domiciliation et de facturation.

Lier le propriétaire au lot

Selon votre version de schéma, la propriété se pousse via updateUnit (unitOwnerships / domaine Unit ownership) ou mutations dédiées du sous-domaine Unit ownership. Vérifiez le schéma UnitInputV2 / createUnitOwnership sur votre environnement.

Suite

Créer un locataire