7. Créer une fiche locataire (profil)

Reconstruit — cas d’usage officiel Créer une fiche locataire + PDF « Création propriétaire et locataire ».

Deux mutations distinctes :

Type	Mutation	Input
Personne physique	createPersonalProfile	PersonalProfileInput
Personne morale	createMoralProfile	MoralProfileInput

Documents

À ce jour, l’upload de documents n’est pas supporté via l’API GraphQL : à faire dans l’interface admin.

Personne physique

GraphQL

mutation createPersonalProfile($personalProfile: PersonalProfileInput!) {
  createPersonalProfile(personalProfile: $personalProfile) {
    id
    reference
    contact {
      civility
      firstName
      lastName
      email
      mobilePhone
    }
    maritalStatus
    nationality
  }
}

{
  "personalProfile": {
    "externalId": "TENANT-EXT-001",
    "customReference": "L-001",
    "maritalStatus": "single",
    "nationality": "french",
    "contact": {
      "civility": "mr",
      "firstName": "Jean",
      "lastName": "Dupont",
      "email": "[email protected]",
      "mobilePhone": "+33611111111"
    }
  }
}

Node.js

const { createPersonalProfile } = await ublo(
  `mutation createPersonalProfile($personalProfile: PersonalProfileInput!) {
    createPersonalProfile(personalProfile: $personalProfile) {
      id
      reference
      contact { firstName lastName email }
    }
  }`,
  {
    personalProfile: {
      externalId: 'TENANT-EXT-001',
      contact: {
        civility: 'mr',
        firstName: 'Jean',
        lastName: 'Dupont',
        email: '[email protected]',
        mobilePhone: '+33611111111',
      },
    },
  },
);

console.log(createPersonalProfile.id);

curl

Bearer

curl -sS -X POST "$UBLO_GRAPHQL_URL" \
  -H "Authorization: Bearer $UBLO_API_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "mutation ($personalProfile: PersonalProfileInput!) { createPersonalProfile(personalProfile: $personalProfile) { id reference } }",
    "variables": {
      "personalProfile": {
        "externalId": "TENANT-EXT-001",
        "contact": {
          "civility": "mr",
          "firstName": "Jean",
          "lastName": "Dupont",
          "email": "[email protected]",
          "mobilePhone": "+33611111111"
        }
      }
    }
  }'

Cookie session

curl -sS -X POST "$UBLO_GRAPHQL_URL" \
  -H 'Content-Type: application/json' \
  -b cookies.txt \
  -d '{
    "query": "mutation ($personalProfile: PersonalProfileInput!) { createPersonalProfile(personalProfile: $personalProfile) { id reference } }",
    "variables": {
      "personalProfile": {
        "externalId": "TENANT-EXT-001",
        "contact": {
          "civility": "mr",
          "firstName": "Jean",
          "lastName": "Dupont",
          "email": "[email protected]",
          "mobilePhone": "+33611111111"
        }
      }
    }
  }'

Enums utiles : ContactInput, MaritalStatusType, NationalityType.

Personne morale

mutation createMoralProfile($moralProfile: MoralProfileInput!) {
  createMoralProfile(moralProfile: $moralProfile) {
    id
    name
    reference
    siren
    siret
    address { street zip city country }
  }
}

{
  "moralProfile": {
    "name": "SCI Exemple",
    "externalId": "TENANT-SCI-001",
    "siren": "123456789",
    "siret": "12345678900012",
    "nafOrApe": "6820A",
    "tva": "FR12123456789",
    "address": {
      "street": "Avenue de la République",
      "zip": "75011",
      "city": "Paris",
      "country": "FR"
    }
  }
}

name est obligatoire (String!).

Suite

Le profil devient rattachable à un dossier (personalProfileId / moralProfileId) → Créer un dossier de location.