Demander une intervention

IntentPlatform offre la possibilité de réaliser des demandes d'intervention via API.

Fonctionnement

API à utiliser:  Operations v2 

La création d'une demande d'intervention sur intentPlatform se matérialise par la création d'une intervention avec un status:open et event:requested

Vous êtes libre de fixer la référence de la demande. Le prestataire en charge de la demande utilisera votre référence pour transmettre le déroulé de son traitement.

Le champ description vous permet de détailler votre demande. Il est important de transmettre le maximum d'information afin de faciliter la qualification par le prestataire.

Le champ workType vous permet d'indiquer à votre prestataire si vous lui demandez
  • un dépannage (corrective)
  • un diagnostic (diagnosis)

Le champ serviceCode vous permet d'indiquer la prestation que vous demandez à votre prestataire. Il permet d'amener une information de qualification supplémentaire à votre prestataire. Si vous n'avez connaissance précisément de la prestation demandée, vous pouvez indiquer un serviceCode générique, par exemple autres, a qualifier ou demande . Le prestataire aura la charge de requalifier cette information lors de la clôture de l'intervention.

Le champ assetReference vous permet d'indiquer la référence de l'asset (bâti ou équipement) où vous souhaitez que l'intervention soit réalisée.
Pour une demande d'intervention liée à un ascenseur, il est attendu d'indiquer la référence de l'ascenseur et non la référence de l'immeuble.

Le champ contacts vous permet d'indiquer le ou les contacts associés à la demande. Les contacts sont à transmettre au format vCard.

Vous avez également la possibilité de rajouter des tags complémentaires qui ne seraient pas gérés par défaut par intentPlatform. Vous pouvez les ajouter dans la rubrique tags lors du POST de la demande d'intervention.

Transmission des données

Création d'une demande d'intervention

POST  https://apisandbox.hubintent.com/api/operations/v2/interventions/logs 
{
 "reference": "INTER-0506",
 "description": "Plus de chauffage dans le logement 2. Le locataire indique une température de 16°C",
 "contractReference": "contract1",
 "status": "open",
 "event": "requested",
 "eventDate": "2024-03-06T10:45:23",
 "logDate": "2024-03-06T10:45:26",
 "serviceCode": "P902",
 "location": {
 "assetReference": "LOGEMENT_002"
 },
 "workType": "corrective",
 "contacts": [
"BEGIN:VCARD\n\nVERSION:3\r\nFN;CHARSET=UTF-8:Pierre DUPONT\r\nN;CHARSET=UTF-8:DUPONT;Pierre\r\nTEL;TYPE=WORK,VOICE:0734220902\r\nTEL;TYPE=HOME,VOICE:0685874445\r\nADR;TYPE=WORK:165 Avenue de Bretagne;59000;LILLE;France\r\nROLE;CHARSET=UTF-8:Locataire\r\nEMAIL;CHARSET=UTF-8;TYPE=WORK,INTERNET:p.dupont@internet.fr\r\nEND:VCARD"
 ],
 "criticalLevel": 3,
 "equipmentWorkingOrder": "not_operational",
 "tags": {
    "NouveauTagPerso":"string",
    "TagDeMonChoix":"string"
  }
}

Publication d’un document

POST  https://apisandbox.hubintent.com/api/documents/v1/documents 

curl -X POST " https://apisandbox.hubintent.com/api/documents/v1/documents " -H "accept: application/json" -H "Content-Type: multipart/form-data" -F "file=@quitus1.pdf;type=application/pdf" -F "title=Ma demande d'intervention" -F "elementType=intervention" -F "elementReference=INTER-0506" -F "description=Détail de ma demande d'intervention" -F "intent_contractReference=contract1"

Plus d’informations :  ⁠⁠Document sur une opération⁠