---
title: "Concepts clés"
description: "Organisation, objet, entité, statuts de date et statut d’activité, le vocabulaire de Millcheck."
canonical_url: "https://docs.millcheck.fr/decouvrir/concepts"
---
# Concepts clés

> Organisation, objet, entité, statuts de date et statut d’activité, le vocabulaire de Millcheck.

## Le modèle de données

```text
Organisation ──┬── Objet SIT ──┬── Entité ──── Dates
               │               └── Entité ──── Dates
               └── Objet SIT ──── Entité ──── Dates
```

<field-group>
<field name="Organisation" type="structure">

La structure cliente (office de tourisme, ADT…). Elle possède une clé d’API, des domaines autorisés et des options souscrites.

</field>

<field name="Objet SIT" type="hébergement / établissement">

Un objet touristique issu de votre SIT, identifié par son **identifiant SIT**. C’est l’unité exposée par l’API et les widgets.

</field>

<field name="Entité" type="unité locative">

Une source de disponibilités rattachée à un objet : une chambre, un type de logement, un emplacement… Chaque entité est alimentée par saisie manuelle, flux iCal ou place de marché.

</field>

<field name="Date" type="jour">

L’état de disponibilité d’une entité pour un jour donné.

</field>
</field-group>

## Statuts d’une date

<table>
<thead>
  <tr>
    <th>
      Valeur
    </th>
    
    <th>
      Statut
    </th>
    
    <th>
      Couleur par défaut du widget
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        1
      </code>
    </td>
    
    <td>
      Disponible
    </td>
    
    <td>
      <badge color="success" variant="subtle">
        #3e9041
      </badge>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        2
      </code>
    </td>
    
    <td>
      Complet
    </td>
    
    <td>
      <badge color="error" variant="subtle">
        #db1919
      </badge>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        3
      </code>
    </td>
    
    <td>
      Fermé
    </td>
    
    <td>
      <badge color="neutral" variant="subtle">
        #252525
      </badge>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        4
      </code>
    </td>
    
    <td>
      Quelques places disponibles
    </td>
    
    <td>
      <badge color="warning" variant="subtle">
        #ff7b00
      </badge>
    </td>
  </tr>
</tbody>
</table>

Pour l’API, une entité est **disponible** un jour donné si son statut vaut `1` ou `4`. Un objet est disponible si **au moins une** de ses entités l’est.

<note>

Pour les meublés / gîtes (`MEUBLE_GITE`), le statut « quelques places disponibles » est affiché comme « disponible » dans le widget : la notion de places partielles n’a pas de sens pour une location entière.

</note>

## Statut d’activité d’un objet

Une entité est considérée **active** lorsque ses disponibilités ont été mises à jour au cours des **14 derniers jours**. Le statut de l’objet en découle :

<table>
<thead>
  <tr>
    <th>
      Statut
    </th>
    
    <th>
      Règle
    </th>
    
    <th>
      Exposé par l’API
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        active
      </code>
    </td>
    
    <td>
      Toutes les entités sont actives, ou l’objet est connecté à une place de marché
    </td>
    
    <td>
      Oui
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        partially
      </code>
    </td>
    
    <td>
      Une partie des entités est active
    </td>
    
    <td>
      Oui
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        inactive
      </code>
    </td>
    
    <td>
      Aucune entité active
    </td>
    
    <td>
      Non
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        not_configured
      </code>
    </td>
    
    <td>
      Objet pas encore configuré
    </td>
    
    <td>
      Non
    </td>
  </tr>
</tbody>
</table>

<caution>

Un objet inactif disparaît des réponses de l’API et son widget ne s’affiche plus. Pensez à **désactiver le calendrier sur la fiche SIT** correspondante.

</caution>

## Relances

Pour les prestataires en saisie manuelle, Millcheck envoie des **e-mails de relance** les invitant à mettre à jour leurs disponibilités. Sans réponse aux relances, l’objet finit par devenir inactif.


## Sitemap

See the full [sitemap](https://docs.millcheck.fr/sitemap.md) for all pages.