Coduri de manoperă
Cartea de tarife fixe (flat-rate book) a atelierului: operațiuni standard cu ore prestabilite, folosite la întocmirea devizelor și la atribuirea manoperei pe comenzi.
Endpoint-uri
| Metodă | Cale | Descriere |
|---|---|---|
| GET | /api/v1/service/labor-codes | Listă paginată; filtre category, is_active, search. |
| GET | /api/v1/service/labor-codes/{id} | Citește un cod de manoperă. |
| POST | /api/v1/service/labor-codes | Creează un cod de manoperă. |
| PUT | /api/v1/service/labor-codes/{id} | Actualizează un cod de manoperă. |
Filtre la listare
| Parametru | Tip | Note |
|---|---|---|
category | string | Filtru exact pe categorie. |
is_active | boolean | |
search | string | Caută în code și description. |
per_page | integer | Implicit 100. |
Schema unui cod de manoperă
La POST, code, description și default_hours sunt obligatorii. La PUT, toate sunt opționale.
| Câmp | Tip | Note |
|---|---|---|
code | string ≤ 32 | Cod unic per tenant. Obligatoriu la POST. |
description | string ≤ 255 | Obligatoriu la POST. |
default_hours | numeric ≥ 0 | Ore standard (flat-rate). Obligatoriu la POST. |
category | string ≤ 64 | ex. engine, chassis, electrical, tyres, routine_service. |
default_rate_cents | integer ≥ 0 | Tarif orar (bani). Lasă gol pentru a moșteni tariful implicit al atelierului. |
applies_to_kinds | array | Filtru pe tipuri de vehicul (ex. ["motorcycle","atv"]). |
make_filter | string ≤ 64 | Sugestie specifică unei mărci. |
metadata | array / object | JSON liber (sub-operațiuni, indicații etc.). |
is_active | boolean |
Exemplu — creare
bash
curl -X POST https://tenant.notsowms.ro/api/v1/service/labor-codes \
-H "Authorization: Bearer tenant.7c4a8d09ca3762af61e59520943dc26494f8941b" \
-H "Content-Type: application/json" \
-d '{
"code": "REV-10K-MOTO",
"description": "Revizie 10.000 km motocicletă",
"default_hours": 1.5,
"category": "routine_service",
"default_rate_cents": 18000,
"applies_to_kinds": ["motorcycle"]
}'Răspuns 201:
json
{
"data": {
"id": 88,
"code": "REV-10K-MOTO",
"description": "Revizie 10.000 km motocicletă",
"default_hours": "1.50",
"category": "routine_service",
"default_rate_cents": 18000,
"applies_to_kinds": ["motorcycle"],
"is_active": true,
"created_at": "2026-05-25T09:40:00.000000Z",
"updated_at": "2026-05-25T09:40:00.000000Z"
}
}Un code deja folosit returnează 422 (constrângere de unicitate per tenant).