Resumen de la entidad
Acuerdo
Expón los metadatos de contratos para que presupuestos, compras y RR. HH. trabajen sobre la misma fuente de datos.
Endpoints
https://api.flowtly.eu/agreements
Listar acuerdos
Recupera colecciones Hydra con filtros sobre tipo, empleado o estado.
https://api.flowtly.eu/agreements/action-needed
Listar acuerdos con acciones pendientes
Recupera acuerdos marcados por aprobaciones o datos faltantes.
https://api.flowtly.eu/agreements
Crear acuerdo
Publica un nuevo acuerdo con metadatos del proveedor/cliente y parámetros de facturación.
https://api.flowtly.eu/agreements/{id}
Obtener acuerdo por ID
Consulta un acuerdo específico para revisar estado, valor y responsables.
https://api.flowtly.eu/agreements/{id}
Actualizar acuerdo
Actualiza estado, fechas o responsables de un acuerdo.
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.
Casos de uso
Campos del esquema
Agreement-agreement.read| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Identificador interno del contrato en Flowtly. |
employee |
string | null | IRI del empleado responsable. |
type |
string | Tipo de contrato: proveedor, cliente o empleo. |
variant |
string | Subtipo personalizado usado en automatizaciones. |
amount |
number | Importe registrado para el contrato (neto o bruto). |
minutesPerWeek |
integer | Minutos previstos por semana. |
jobSize |
integer | Tamaño de puesto utilizado en la planificación. |
amountType |
string | Indica si el importe es neto o bruto. |
billingType |
string | Frecuencia de facturación (mensual, por hora, etc.). |
positionName |
string | null | Etiqueta de puesto en texto libre. |
position |
string | null | IRI que apunta al registro estándar de puestos. |
dateFrom |
string | Fecha de inicio de la vigencia. |
dateTo |
string | null | Fecha fin (puede ser nula). |
currency |
string | Referencia de moneda usada en los importes. |
cost |
string | null | IRI del coste asociado. |
active |
boolean | Indica si Flowtly considera el contrato activo. |
hoursPerWeek |
integer | Horas previstas por semana. |
status |
string | Estado del workflow (draft, active…). |
Ejemplos
https://api.flowtly.eu/agreements
Registrar un acuerdo con proveedor
Crea un contrato de suscripción con proveedor y lo asocia al empleado responsable y a la referencia de moneda en 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"
}