Les API Comptes-Rendus d'Activité et Réception de Service
Les API Comptes-Rendus d'Activité et Réceptions de service font partie des API LittleBig Connection et vous aident dans la phase de contrôle du cycle de vie de vos missions. Voyons dans cet article quand et comment vous pouvez les utiliser, et quelles sont les informations qu'elles contiennent.
Dans cet article
- Présentation des API Comptes-Rendus d'Activité et Réceptions de service
- Utiliser l'API Comptes-Rendus d'Activité (CRA)
- Utiliser l'API Réceptions de service
.
Présentation des API Comptes-Rendus
Ces API vous permettent de contrôler en un seul endroit les heures prestées déclarées par vos consultants afin d'assurer la réussite de vos missions. En effet, vos consultants pourront saisir le temps presté, les heures supplémentaires et les frais sur votre portail prestataires, et ce sera ensuite automatiquement synchronisé avec la plateforme LittleBig grâce à l'API Comptes-Rendus d'Activité (CRA). Et une fois le CRA validé, vous pourrez utiliser l'API Réceptions de service comme étape finale de vérification avant de déclencher la facturation.
Vous pouvez activer l'une et/ou l'autre des API, et les utiliser aux moments suivants :
Pour plus d'informations sur le processus de validation des CRA, veuillez lire cet article.
Important
Veuillez noter que pour bénéficier de l'une ou l'autre de ces API, elles doivent être activées à l'avance.
.
Utiliser l'API Comptes-Rendus d'Activité (CRA)
.
Soumission du CRA par le Consultant
Le CRA est créé au sein de la plateforme LittleBig Connection, il devient alors possible de le remplir. Les informations qu'il contient peuvent être mises à jour directement depuis le compte LittleBig Connection du consultant, ou bien depuis votre portail prestataires. Selon le cas, le statut initial du CRA, que vous pouvez suivre sur la plateforme, sera différent :
| Si le CRA doit être rempli sur LittleBig Connection | Si le CRA doit être rempli sur votre portail prestataires | |
| Statut sur la plateforme LB | En attente | En attente de transmission |
| Statut sur l'API |
Statut : notValidated Détail : pendingConsultantValidation |
Statut : notValidated Détail : pendingTransmission |
Pour que le consultant puisse soumettre son CRA via votre portail, vos outils internes doivent d'abord être en mesure de récupérer les CRA en attente, puis de les importer dans votre portail afin que le consultant puisse le visualiser et valider les données.
Pour récupérer ces CRA en attente, vous pouvez utiliser l'opération API SearchActivityReports et filtrer les CRA qui n'ont pas encore été validés, sur un mois et/ou une année spécifique. Consultez la page Documentation API pour plus de détails sur les critères de recherche.
La réponse que vous recevrez contiendra les informations suivantes du CRA :
|
|
Lors de cette étape, seuls les CRA dont le statut est En attente de transmission doivent être pris en compte.
.
Approbation du CRA par le Commercial
Une fois que le consultant a soumis son CRA, vous pouvez utiliser l'opération API UpdateActivityReport pour renvoyer les informations à la plateforme LittleBig.
Une fois cette synchronisation effectuée, le Commercial peut approuver ou rejeter manuellement le CRA sur la plateforme LittleBig, et le statut du CRA sera mis à jour en conséquence :
| Si le CRA est approuvé par le Commercial | Si le CRA est rejeté par le Commercial | |
| Statut sur la plateforme LB | Validé par le Commercial | Refusé par le Commercial |
| Statut sur l'API |
Status : notValidated Détail : validatedBySeller |
Status : notValidated Détail : refusedBySeller |
| Prochaines actions | Le Responsable opérationnel peut valider ou refuser le CRA | Le Consultant doit corriger et soumettre à nouveau le CRA. |
.
Validation du CRA par le Responsable opérationnel
Après l'approbation du CRA par le Commercial, le Responsable opérationnel peut l'approuver ou le refuser, et le statut sera mis à jour en conséquence :
| Si le CRA est validé par le Responsable opérationnel | Si le CRA est refusé par le Responsable opérationnel | |
| Statut sur la plateforme LB | Validé par le Responsable opérationnel | Refusé par le Responsable opérationnel |
| Statut sur l'API |
Statut : notValidated Détail : validatedByManager |
Statut : notValidated Détail : refusedByManager |
| Prochaines actions | Les Réceptions de service peuvent être utilisées | Le Consultant doit corriger et soumettre à nouveau le CRA |
.
Utiliser l'API Réceptions de service
Après la validation du CRA par le Responsable opérationnel, vous pouvez utiliser l'opération API UpdateServiceReception pour vérifier que les informations de la plateforme LB et de vos outils internes coïncident pour confirmer ou rejeter le CRA.
| Si le CRA est validé par votre outil interne | Si le CRA est refusé par votre outil interne | |
| Statut sur la plateforme LB | Validé dans le SI |
Refusé dans le SI. En attente Responsable opérationnel |
| Statut sur l'API |
Statut : Validated Détail : validatedByExternalSi |
Statut : Rejected Détail : refusedByExternalSi |
| Prochaines actions | Aucune. Le CRA du mois est validé et le processus de facturation démarre | Le Responsable opérationnel vérifie le CRA et peut renvoyer une Réception de service ou refusé le CRA pour que le Consultant le corrige |