Vue d’ensemble
Contrat
Exposez les métadonnées contractuelles afin que budgets, achats et RH partagent la même source d’information.
Endpoints
https://api.flowtly.eu/agreements
Lister les contrats
Récupère les collections Hydra filtrées par type, collaborateur ou statut.
https://api.flowtly.eu/agreements/action-needed
Lister les contrats à actionner
Récupère les contrats signalés pour approbation ou données manquantes.
https://api.flowtly.eu/agreements
Créer un contrat
Crée un contrat avec données fournisseur/client, cadence de facturation et montant.
https://api.flowtly.eu/agreements/{id}
Obtenir un contrat par ID
Lit un contrat précis pour vérifier son statut, sa valeur et les responsables.
https://api.flowtly.eu/agreements/{id}
Mettre à jour un contrat
Ajuste le statut, les dates ou les responsables d’un contrat.
https://api.flowtly.eu/agreements/without-file
Retrieves the collection of Agreement resources.
Retrieves the collection of Agreement resources.
https://api.flowtly.eu/agreements/without-file/active
Retrieves the collection of Agreement resources.
Retrieves the collection of Agreement resources.
Cas d’usage
Champs du schéma
Agreement-agreement.read| Champ | Type | Description |
|---|---|---|
id |
integer | Identifiant interne du contrat dans Flowtly. |
employee |
string | null | IRI du collaborateur responsable. |
type |
string | Type de contrat (fournisseur, client, emploi). |
variant |
string | Sous-type personnalisé utilisé dans vos automatisations. |
amount |
number | Montant enregistré (net ou brut). |
minutesPerWeek |
integer | Minutes prévues par semaine. |
jobSize |
integer | Taille de poste utilisée pour les prévisions. |
amountType |
string | Indique si la somme est nette ou brute. |
billingType |
string | Fréquence de facturation (mensuelle, horaire…). |
positionName |
string | null | Libellé libre du poste. |
position |
string | null | IRI pointant vers le référentiel de postes. |
dateFrom |
string | Date de début de validité. |
dateTo |
string | null | Date de fin (facultative). |
currency |
string | Référence de devise utilisée pour les montants. |
cost |
string | null | IRI du coût associé. |
active |
boolean | Indique si Flowtly considère le contrat actif. |
hoursPerWeek |
integer | Heures prévues par semaine. |
status |
string | Statut du workflow (draft, active…). |
Exemples
https://api.flowtly.eu/agreements
Enregistrer un contrat fournisseur
Crée un contrat fournisseur récurrent et le relie au collaborateur responsable ainsi qu’à la référence de devise dans Flowtly.
{
"employee": "/api/employees/emp_439",
"type": "vendor",
"variant": "software",
"amount": 18500,
"currency": "/api/currencies/EUR",
"dateFrom": "2024-07-01T00:00:00+00:00",
"dateTo": "2024-12-31T00:00:00+00:00",
"amountType": "netto",
"billingType": "per-month",
"positionName": "Implementation partner",
"hoursPerWeek": 12
}{
"@id": "/api/agreements/agr_Y29H",
"@type": "Agreement",
"id": 5021,
"employee": "/api/employees/emp_439",
"type": "vendor",
"variant": "software",
"amount": 18500,
"currency": "/api/currencies/EUR",
"dateFrom": "2024-07-01T00:00:00+00:00",
"dateTo": "2024-12-31T00:00:00+00:00",
"amountType": "netto",
"billingType": "per-month",
"positionName": "Implementation partner",
"hoursPerWeek": 12,
"active": true,
"status": "draft"
}