API Harmoniq

Zone geografice /geo-areas

Arborele de țări, regiuni și zone din care fac parte unitățile; de el depinde și aria managerilor de zonă. Numele sunt unice între zonele cu același părinte. Ștergerea e refuzată cât timp unități sau subzone o folosesc.

Drepturi: geo_areas:read, geo_areas:write

Adrese

• GET /api/v1/geo-areas Listă
• GET /api/v1/geo-areas/{id} O înregistrare
• POST /api/v1/geo-areas Creare
• PATCH /api/v1/geo-areas/{id} Modificare
• DELETE /api/v1/geo-areas/{id} Ștergere

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/geo-areas

{
    "name": "Nord-Vest",
    "level_label": "regiune",
    "parent_id": 1,
    "sort": 0
}

{
    "data": {
        "id": 3,
        "name": "Nord-Vest",
        "level_label": "regiune",
        "parent_id": 1,
        "sort": 0,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Unități /work-units

Unitățile companiei: magazine, farmacii, birouri, hoteluri. Ștergerea e refuzată cât timp oameni, documente sau rezultate se mai referă la ea.

Drepturi: work_units:read, work_units:write

Adrese

• GET /api/v1/work-units Listă
• GET /api/v1/work-units/{id} O înregistrare
• POST /api/v1/work-units Creare
• PATCH /api/v1/work-units/{id} Modificare
• DELETE /api/v1/work-units/{id} Ștergere

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/work-units

{
    "name": "Farmacia Verde Centru",
    "code": "CJ01",
    "geo_area_id": 3,
    "address": "Str. Memorandumului 10",
    "opened_on": "2016-03-01",
    "is_active": true,
    "custom_fields": {
        "12": "XL"
    }
}

{
    "data": {
        "id": 12,
        "name": "Farmacia Verde Centru",
        "code": "CJ01",
        "geo_area_id": 3,
        "address": "Str. Memorandumului 10",
        "city": "Cluj-Napoca",
        "county": "Cluj",
        "phone": null,
        "email": null,
        "opened_on": "2016-03-01",
        "closed_on": "2026-05-01",
        "is_active": true,
        "custom_fields": {
            "12": "XL"
        },
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Departamente /departments

Funcții la nivelul companiei (Vânzări, Logistică…), care pot fi imbricate. Ștergerea e refuzată cât timp încadrări sau subdepartamente îl folosesc.

Drepturi: departments:read, departments:write

Adrese

• GET /api/v1/departments Listă
• GET /api/v1/departments/{id} O înregistrare
• POST /api/v1/departments Creare
• PATCH /api/v1/departments/{id} Modificare
• DELETE /api/v1/departments/{id} Ștergere

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/departments

{
    "name": "Farmacie",
    "code": "FARM",
    "is_active": true,
    "custom_fields": {
        "12": "XL"
    }
}

{
    "data": {
        "id": 4,
        "name": "Farmacie",
        "code": "FARM",
        "parent_id": 1,
        "is_active": true,
        "custom_fields": {
            "12": "XL"
        },
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Funcții /positions

Funcțiile din companie și nivelul lor (un număr mai mare înseamnă o funcție mai înaltă). Ștergerea e refuzată cât timp cineva o ocupă.

Drepturi: positions:read, positions:write

Adrese

• GET /api/v1/positions Listă
• GET /api/v1/positions/{id} O înregistrare
• POST /api/v1/positions Creare
• PATCH /api/v1/positions/{id} Modificare
• DELETE /api/v1/positions/{id} Ștergere

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/positions

{
    "name": "Farmacist",
    "code": "FA",
    "level": 2,
    "is_active": true,
    "custom_fields": {
        "12": "XL"
    }
}

{
    "data": {
        "id": 7,
        "name": "Farmacist",
        "code": "FA",
        "level": 2,
        "description": null,
        "is_active": true,
        "custom_fields": {
            "12": "XL"
        },
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Echipe /teams

Grupuri de oameni din unități diferite (un proiect, un grup de lucru). Membrii se adaugă și se scot unul câte unul, cu acțiunile de mai jos.

Drepturi: teams:read, teams:write

Adrese

• GET /api/v1/teams Listă
• GET /api/v1/teams/{id} O înregistrare
• POST /api/v1/teams Creare
• PATCH /api/v1/teams/{id} Modificare
• DELETE /api/v1/teams/{id} Ștergere
• POST /api/v1/teams/{id}/add-member Adaugă un angajat în echipă (nu se schimbă nimic dacă face deja parte din ea). Corp: {"employee_id": 345}.
• POST /api/v1/teams/{id}/remove-member Scoate un angajat din echipă. Corp: {"employee_id": 345}.

Câmpuri

Filtre

/api/v1/teams/{id}/add-member: employee_id (integer) — Angajatul de adăugat (un id din /employees).

/api/v1/teams/{id}/remove-member: employee_id (integer) — Angajatul de scos (un id din /employees).

POST https://compania-mea.harmoniq.ro/api/v1/teams

{
    "name": "Proiect inventar",
    "is_active": true,
    "custom_fields": {
        "12": "XL"
    }
}

{
    "data": {
        "id": 2,
        "name": "Proiect inventar",
        "description": null,
        "is_active": true,
        "member_ids": [
            345,
            346
        ],
        "custom_fields": {
            "12": "XL"
        },
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Câmpuri proprii /custom-fields

Câmpurile adăugate de companie propriilor înregistrări, doar citire: ce înseamnă fiecare id din custom_fields al unei înregistrări, tipul și variantele lui. Câmpurile sensibile ale angajaților apar doar pentru o cheie cu dreptul sensitive. Câmpurile se definesc în aplicație.

Drepturi: custom_fields:read

Adrese

• GET /api/v1/custom-fields Listă
• GET /api/v1/custom-fields/{id} O înregistrare

Câmpuri

Filtre

{
    "data": {
        "id": 12,
        "entity": "employee",
        "label": "Mărime uniformă",
        "type": "select",
        "options": [
            {
                "id": "m",
                "label": "M"
            }
        ],
        "is_required": false,
        "visibility": "reach",
        "is_active": true,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Angajați /employees

Oamenii companiei. Crearea unui angajat creează și prima încadrare; mutările ulterioare se fac prin /placements. CNP-ul nu se citește și nu se scrie niciodată prin API. Conturile de acces se creează în aplicație.

Drepturi: employees:read, employees:write

Adrese

• GET /api/v1/employees Listă
• GET /api/v1/employees/{id} O înregistrare
• POST /api/v1/employees Creare
• PATCH /api/v1/employees/{id} Modificare
• DELETE /api/v1/employees/{id} Ștergere

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/employees

{
    "employee_number": "FV0012",
    "first_name": "Ana",
    "last_name": "Popescu",
    "email": "ana.popescu@example.com",
    "hire_date": "2024-02-01",
    "status": "active",
    "work_unit_id": 12,
    "custom_fields": {
        "12": "XL"
    }
}

{
    "data": {
        "id": 345,
        "employee_number": "FV0012",
        "first_name": "Ana",
        "last_name": "Popescu",
        "email": "ana.popescu@example.com",
        "phone": null,
        "birth_date": "2026-05-01",
        "hire_date": "2024-02-01",
        "termination_date": "2026-05-01",
        "status": "active",
        "work_unit_id": 12,
        "department_id": 1,
        "position_id": 1,
        "has_login": true,
        "custom_fields": {
            "12": "XL"
        },
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Încadrări /placements

Unde lucrează fiecare persoană: unitate, departament și funcție, de când până când. O încadrare principală nouă o preia pe cea dinainte, care rămâne încadrare secundară curentă până când este încheiată.

Drepturi: placements:read, placements:write

Adrese

• GET /api/v1/placements Listă
• GET /api/v1/placements/{id} O înregistrare
• POST /api/v1/placements Creare
• DELETE /api/v1/placements/{id} Ștergere
• POST /api/v1/placements/{id}/end Încheie încadrarea la valid_to (nu înainte de începutul ei).
• POST /api/v1/placements/{id}/make-primary O face încadrarea principală; cea principală dinainte devine secundară.

Câmpuri

Filtre

/api/v1/placements/{id}/end: valid_to (date) — Ultima zi a încadrării (Y-m-d).

POST https://compania-mea.harmoniq.ro/api/v1/placements

{
    "employee_id": 345,
    "work_unit_id": 12,
    "is_primary": true,
    "valid_from": "2026-03-01"
}

{
    "data": {
        "id": 901,
        "employee_id": 345,
        "work_unit_id": 12,
        "department_id": 1,
        "position_id": 1,
        "is_primary": true,
        "valid_from": "2026-03-01",
        "valid_to": "2026-05-01",
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Tipuri de concediu /leave-types

Tipurile de concediu folosite de companie, așa cum sunt configurate în aplicație. Doar citire.

Drepturi: leave_types:read

Adrese

• GET /api/v1/leave-types Listă
• GET /api/v1/leave-types/{id} O înregistrare

Câmpuri

Filtre

{
    "data": {
        "id": 1,
        "code": "CO",
        "name": "Concediu de odihnă",
        "uses_balance": true,
        "default_entitlement": 21,
        "is_paid": true,
        "requires_attachment": true,
        "requires_reference": true,
        "requires_replacement": true,
        "is_active": true,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Cereri de concediu /leave-requests

Cererile de concediu, după aceleași reguli ca în aplicație: se numără zilele lucrătoare, se verifică soldul și suprapunerile și pornește fluxul de aprobare al companiei. Aprobarea și respingerea urmează fluxul cererii: cel care a creat cheia trebuie să fie aprobator la pasul curent.

Drepturi: leave_requests:read, leave_requests:write

Adrese

• GET /api/v1/leave-requests Listă
• GET /api/v1/leave-requests/{id} O înregistrare
• POST /api/v1/leave-requests Creare
• POST /api/v1/leave-requests/{id}/approve Aprobă pasul curent (comentariu opțional).
• POST /api/v1/leave-requests/{id}/reject Respinge cererea; comentariul (motivul) este obligatoriu.
• POST /api/v1/leave-requests/{id}/cancel Anulează o cerere în așteptare sau aprobată.

Câmpuri

Filtre

/api/v1/leave-requests/{id}/approve: comment (text) — Comentariu opțional pentru persoană.

/api/v1/leave-requests/{id}/reject: comment (text) — Motivul, arătat persoanei (obligatoriu).

POST https://compania-mea.harmoniq.ro/api/v1/leave-requests

{
    "employee_id": 345,
    "leave_type_id": 1,
    "starts_on": "2026-07-06",
    "ends_on": "2026-07-10"
}

{
    "data": {
        "id": 77,
        "employee_id": 345,
        "leave_type_id": 1,
        "starts_on": "2026-07-06",
        "ends_on": "2026-07-10",
        "days": 5,
        "status": "pending",
        "replacement_employee_id": 1,
        "reference": null,
        "note": null,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Solduri de concediu /leave-balances

Soldul anual al fiecărei persoane, pentru fiecare tip de concediu care se scade dintr-un sold. Listarea unui an îl deschide pentru toți oamenii activi, pro rata și cu zilele reportate, ca în aplicație; zilele folosite, în așteptare și disponibile se calculează. Zilele anului, ajustarea și zilele reportate se pot modifica — niciodată pentru persoana care a creat cheia.

Drepturi: leave_balances:read, leave_balances:write

Adrese

• GET /api/v1/leave-balances Listă
• GET /api/v1/leave-balances/{id} O înregistrare
• PATCH /api/v1/leave-balances/{id} Modificare

Câmpuri

Filtre

{
    "data": {
        "id": 55,
        "employee_id": 345,
        "leave_type_id": 1,
        "year": 2026,
        "entitlement": 21,
        "adjustment": 0,
        "carried_over": 3,
        "carried_over_expires_on": "2026-03-31",
        "carried_usable": 3,
        "earlier": 0,
        "earlier_expires_on": "2026-05-01",
        "used": 5,
        "pending": 2,
        "available": 17,
        "note": null,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Evenimente în calendar /calendar-events

Calendarul companiei. Participanții (sau unitatea) sunt anunțați despre un eveniment nou, o oră nouă sau un loc nou. Un eveniment nou se poate repeta: fiecare apariție devine un eveniment separat din aceeași serie și se modifică, se anulează sau se șterge separat.

Drepturi: calendar_events:read, calendar_events:write

Adrese

• GET /api/v1/calendar-events Listă
• GET /api/v1/calendar-events/{id} O înregistrare
• POST /api/v1/calendar-events Creare
• PATCH /api/v1/calendar-events/{id} Modificare
• DELETE /api/v1/calendar-events/{id} Ștergere
• POST /api/v1/calendar-events/{id}/cancel Anulează această apariție; participanții sunt anunțați.

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/calendar-events

{
    "title": "Inventar trimestrial",
    "description": "<p>Toată echipa.</p>",
    "starts_at": "2026-07-06T15:00:00Z",
    "ends_at": "2026-07-06T17:00:00Z",
    "visibility": "everyone",
    "participants": [
        345,
        346
    ]
}

{
    "data": {
        "id": 410,
        "event_type_id": 1,
        "title": "Inventar trimestrial",
        "description": "<p>Toată echipa.</p>",
        "location": null,
        "starts_at": "2026-07-06T15:00:00Z",
        "ends_at": "2026-07-06T17:00:00Z",
        "all_day": true,
        "visibility": "everyone",
        "work_unit_id": 1,
        "participants": [
            345,
            346
        ],
        "rsvp": true,
        "recurrence": "weekly",
        "recurrence_until": "2026-05-01",
        "series_id": 1,
        "cancelled_at": "2026-05-01T08:00:00Z",
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Indicatori KPI /kpi-metrics

Ce măsoară compania: cheia fiecărui indicator, unitatea de măsură, pentru cine se măsoară (nivelul) și cât de des (perioada). Doar citire; indicatorii se definesc în aplicație. Prin API se pot trimite valori doar pentru indicatorii cu sursa „api”.

Drepturi: kpi_metrics:read

Adrese

• GET /api/v1/kpi-metrics Listă
• GET /api/v1/kpi-metrics/{id} O înregistrare

Câmpuri

Filtre

{
    "data": {
        "id": 7,
        "key": "sales.actual",
        "label": "Sales",
        "description": null,
        "unit": "currency",
        "value_type": "decimal",
        "grain": "employee",
        "period": "month",
        "aggregation": "sum",
        "source_type": "api",
        "is_higher_better": true,
        "is_active": true,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Valori KPI /metric-values

Valoarea unui indicator pentru un subiect într-o perioadă. Crearea o scrie (sau înlocuiește valoarea existentă pentru acel subiect și acea perioadă); acceptă valori doar indicatorii cu sursa „api”. O valoare lipsă (null) înseamnă „fără date”, niciodată zero. Pentru multe valori după referințe de business (marcă, codul unității) folosiți POST /metrics/{key}/values.

Drepturi: metric_values:read, metric_values:write

Adrese

• GET /api/v1/metric-values Listă
• GET /api/v1/metric-values/{id} O înregistrare
• POST /api/v1/metric-values Creare

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/metric-values

{
    "metric": "sales.api",
    "subject_id": 345,
    "period": "2026-09",
    "value": "1234.5"
}

{
    "data": {
        "id": 5120,
        "metric": "sales.api",
        "subject_type": "employee",
        "subject_id": 345,
        "period": "2026-09",
        "period_start": "2026-09-01",
        "period_end": "2026-09-30",
        "value": "1234.5",
        "source": "api",
        "recorded_at": "2026-05-01T08:00:00Z"
    }
}

Fișe de performanță /kpi-scorecards

Fișele de performanță cu toate versiunile lor (ciornă, publicată, arhivată): părțile din care e făcut scorul, ponderile lor și nivelurile în care cade un scor. Doar citire; fișele se construiesc în aplicație, iar o versiune publicată nu se mai schimbă.

Drepturi: kpi_scorecards:read

Adrese

• GET /api/v1/kpi-scorecards Listă
• GET /api/v1/kpi-scorecards/{id} O înregistrare

Câmpuri

Filtre

{
    "data": {
        "id": 4,
        "family": "9b2e0c1e-0f0a-4b47-9f3a-2c1d7e8a1b20",
        "version": 2,
        "name": "Pharmacist performance",
        "description": null,
        "grain": "employee",
        "period": "month",
        "status": "published",
        "effective_from": "2026-05-01",
        "effective_to": "2026-05-01",
        "published_at": "2026-05-01T08:00:00Z",
        "components": [
            {
                "key": "sales",
                "label": "Sales achievement",
                "weight": "0.55"
            }
        ],
        "levels": [
            {
                "name": "Good",
                "min_score": "85",
                "color": "#2B6CB0"
            }
        ],
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Rezultate KPI /kpi-results

Scorurile pe fișele de performanță: rezultatul curent al fiecărui subiect și al fiecărei perioade, nivelul atins și valoarea și punctele fiecărei părți. Un total sau o parte fără date este null, niciodată zero. Doar citire; rezultatele apar la închiderea unei perioade.

Drepturi: kpi_results:read

Adrese

• GET /api/v1/kpi-results Listă
• GET /api/v1/kpi-results/{id} O înregistrare

Câmpuri

Filtre

{
    "data": {
        "id": 9811,
        "scorecard_id": 4,
        "scorecard": "Pharmacist performance",
        "subject_type": "employee",
        "subject_id": 345,
        "subject": "Ana Popescu",
        "period": "2026-09-01",
        "total": "92.40",
        "level": "Good",
        "level_color": "#2B6CB0",
        "bonus": null,
        "parts": [
            {
                "key": "sales",
                "label": "Sales achievement",
                "value": "104.2",
                "points": "57.31"
            }
        ],
        "created_at": "2026-05-01T08:00:00Z"
    }
}

Obiective /objectives

Obiective după o regulă (de exemplu „produse focus”): perioada, parametrii și țintele pe unități. Regula și perioada nu se mai schimbă după creare. Acțiunea record păstrează ce au realizat oamenii sau unitățile; punctajul se calculează la închiderea perioadei. Un obiectiv deja punctat nu poate fi șters.

Drepturi: objectives:read, objectives:write

Adrese

• GET /api/v1/objectives Listă
• GET /api/v1/objectives/{id} O înregistrare
• POST /api/v1/objectives Creare
• PATCH /api/v1/objectives/{id} Modificare
• DELETE /api/v1/objectives/{id} Ștergere
• POST /api/v1/objectives/{id}/record Păstrează ce au realizat subiecții: măsurile lor înlocuiesc ce era înregistrat; măsurile goale șterg înregistrarea (din nou fără date).

Câmpuri

Filtre

/api/v1/objectives/{id}/record: achievements (array) — O listă de {subject_id, measures: {numele măsurii: număr}}; subiecți la nivelul regulii, din unitățile cu ținte.

POST https://compania-mea.harmoniq.ro/api/v1/objectives

{
    "rule_id": 2,
    "name": "Vitamin C 1000",
    "period": "2026-09",
    "params": {
        "bonus": "2"
    },
    "targets": [
        {
            "work_unit_id": 12,
            "target": "30"
        }
    ],
    "external_ref": "CAMP-2026-09"
}

{
    "data": {
        "id": 31,
        "rule_id": 2,
        "rule": "Focus products",
        "name": "Vitamin C 1000",
        "description": null,
        "period": "2026-09",
        "period_start": "2026-09-01",
        "period_end": "2026-09-30",
        "params": {
            "bonus": "2"
        },
        "targets": [
            {
                "work_unit_id": 12,
                "target": "30"
            }
        ],
        "external_ref": "CAMP-2026-09",
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Evaluări /reviews

Evaluările date pe grile: cui, de cine, pentru ce perioadă, punctele și rezultatul și răspunsul la fiecare criteriu. Doar citire; evaluările se dau în aplicație. Ciornele sunt lucrul evaluatorului și nu apar niciodată.

Drepturi: reviews:read

Adrese

• GET /api/v1/reviews Listă
• GET /api/v1/reviews/{id} O înregistrare

Câmpuri

Filtre

{
    "data": {
        "id": 812,
        "form_id": 3,
        "form": "Monthly evaluation",
        "employee_id": 345,
        "evaluator_id": 12,
        "period_start": "2026-09-01",
        "period_end": "2026-09-30",
        "status": "submitted",
        "total_points": "8.00",
        "max_points": "10.00",
        "result": "80",
        "comment": null,
        "submitted_at": "2026-05-01T08:00:00Z",
        "cancelled_at": "2026-05-01T08:00:00Z",
        "answers": [
            {
                "criterion_key": "attitude",
                "selected": [
                    "teamwork"
                ],
                "value": null,
                "points": "2.00",
                "comment": null
            }
        ],
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Cursuri /courses

Catalogul de cursuri. Titlul și descrierea se scriu în limba companiei (celelalte limbi se traduc în aplicație); capitolele și coperțile se scriu în aplicație. Un curs se poate șterge doar cât timp nu a fost alocat nimănui — altfel arhivați-l.

Drepturi: courses:read, courses:write

Adrese

• GET /api/v1/courses Listă
• GET /api/v1/courses/{id} O înregistrare
• POST /api/v1/courses Creare
• PATCH /api/v1/courses/{id} Modificare
• DELETE /api/v1/courses/{id} Ștergere

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/courses

{
    "title": "Siguranța la incendiu",
    "status": "published",
    "estimated_minutes": 20,
    "validity_months": 12,
    "issues_certificate": true,
    "recertifies": false,
    "points": 10
}

{
    "data": {
        "id": 7,
        "title": "Siguranța la incendiu",
        "description": null,
        "category_id": 1,
        "category": "Obligatorii",
        "author": null,
        "status": "published",
        "estimated_minutes": 20,
        "validity_months": 12,
        "issues_certificate": true,
        "recertifies": false,
        "points": 10,
        "chapters_count": 4,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Alocări de instruire /learning-assignments

Un curs publicat (sau un test de sine stătător) dat unor oameni: tuturor, unei unități, unei zone, unui departament, unei funcții sau unor angajați anume. Oamenii sunt înscriși imediat. Se șterge doar cât timp nimeni nu a început.

Drepturi: learning_assignments:read, learning_assignments:write

Adrese

• GET /api/v1/learning-assignments Listă
• GET /api/v1/learning-assignments/{id} O înregistrare
• POST /api/v1/learning-assignments Creare
• DELETE /api/v1/learning-assignments/{id} Ștergere

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/learning-assignments

{
    "course_id": 7,
    "available_from": "2026-05-01",
    "due_on": "2026-05-31",
    "enrolls_newcomers": true,
    "targets": [
        {
            "type": "work_unit",
            "id": 12
        }
    ]
}

{
    "data": {
        "id": 31,
        "course_id": 7,
        "test_id": 1,
        "available_from": "2026-05-01",
        "due_on": "2026-05-31",
        "enrolls_newcomers": true,
        "targets": [
            {
                "type": "work_unit",
                "id": 12
            }
        ],
        "enrollments_count": 14,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Înscrieri /enrollments

Cine este înscris la ce curs sau test și cât a parcurs. Acțiuni: un termen mai târziu, încă o încercare, scutirea cuiva care nu a început.

Drepturi: enrollments:read, enrollments:write

Adrese

• GET /api/v1/enrollments Listă
• GET /api/v1/enrollments/{id} O înregistrare
• POST /api/v1/enrollments/{id}/extend Stabilește un termen mai târziu.
• POST /api/v1/enrollments/{id}/grant-attempt Permite încă o încercare la test (nu după promovare).
• POST /api/v1/enrollments/{id}/excuse Scutește persoana (doar înainte să înceapă).

Câmpuri

Filtre

/api/v1/enrollments/{id}/extend: due_on (date) — Noul termen, nu înainte de deschiderea înscrierii.

{
    "data": {
        "id": 501,
        "assignment_id": 31,
        "employee_id": 345,
        "course_id": 7,
        "test_id": 1,
        "available_from": "2026-05-01",
        "due_on": "2026-05-31",
        "status": "completed",
        "started_at": "2026-05-01T08:00:00Z",
        "completed_at": "2026-05-01T08:00:00Z",
        "score": 90,
        "passed": true,
        "extra_attempts": 0,
        "is_overdue": false,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Certificate /certificates

Certificatele obținute la terminarea unui curs, cu codul pe care oricine îl poate verifica pe pagina certificatului.

Drepturi: certificates:read

Adrese

• GET /api/v1/certificates Listă
• GET /api/v1/certificates/{id} O înregistrare

Câmpuri

Filtre

{
    "data": {
        "id": 88,
        "enrollment_id": 501,
        "employee_id": 345,
        "course_id": 7,
        "number": "FV-2026-0042",
        "verification_code": "K7Q2M9XA",
        "issued_on": "2026-05-12",
        "expires_on": "2027-05-12",
        "is_valid": true,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Audituri /audits

Auditurile unităților, cu constatările lor, punct cu punct. Doar citire: un audit se face în aplicație.

Drepturi: audits:read

Adrese

• GET /api/v1/audits Listă
• GET /api/v1/audits/{id} O înregistrare

Câmpuri

Filtre

{
    "data": {
        "id": 19,
        "work_unit_id": 12,
        "template_name": "Verificare lunară farmacie",
        "auditor_id": 1,
        "status": "completed",
        "conducted_at": "2026-05-01T08:00:00Z",
        "completed_at": "2026-05-01T08:00:00Z",
        "score": 88.89,
        "pass_score": 80,
        "passed": true,
        "critical_findings": 0,
        "is_self_check": true,
        "note": null,
        "findings": [
            {
                "section": "Frigider",
                "item": "Termometrul este calibrat",
                "weight": 2,
                "critical": true,
                "result": "not_ok",
                "comment": "Ultima calibrare în martie."
            }
        ],
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Acțiuni corective /audit-action-plans

Acțiunile corective stabilite după audituri. Avansează ca pe pagina auditului: marcate ca rezolvate cu o notă, verificate, redeschise cu un motiv sau anulate.

Drepturi: audit_action_plans:read, audit_action_plans:write

Adrese

• GET /api/v1/audit-action-plans Listă
• GET /api/v1/audit-action-plans/{id} O înregistrare
• POST /api/v1/audit-action-plans/{id}/mark-done Marchează o acțiune deschisă ca rezolvată.
• POST /api/v1/audit-action-plans/{id}/verify Acceptă o acțiune rezolvată.
• POST /api/v1/audit-action-plans/{id}/reopen Trimite înapoi o acțiune rezolvată, cu motivul.
• POST /api/v1/audit-action-plans/{id}/cancel Anulează o acțiune deschisă sau rezolvată.

Câmpuri

Filtre

/api/v1/audit-action-plans/{id}/mark-done: note (text) — Ce s-a făcut.

/api/v1/audit-action-plans/{id}/reopen: reason (text) — De ce nu este acceptată.

{
    "data": {
        "id": 4,
        "audit_id": 19,
        "result_id": 1,
        "description": "Calibrați termometrul frigiderului și păstrați certificatul.",
        "responsible_id": 1,
        "due_on": "2026-05-20",
        "status": "open",
        "is_overdue": true,
        "done_note": null,
        "done_at": "2026-05-01T08:00:00Z",
        "verified_by": 1,
        "verified_at": "2026-05-01T08:00:00Z",
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Tipuri SSM /ssm-types

Tipurile de instruiri și controale de sănătate și securitate în muncă pe care compania le înregistrează, cu valabilitatea fiecăruia.

Drepturi: ssm_types:read

Adrese

• GET /api/v1/ssm-types Listă
• GET /api/v1/ssm-types/{id} O înregistrare

Câmpuri

Filtre

{
    "data": {
        "id": 2,
        "name": "Instruire periodică",
        "validity_months": 6,
        "is_required": true,
        "is_active": true,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Înregistrări SSM /ssm-records

Cine a avut ce instruire sau control SSM, când și până când este valabil (calculat din tip). O înregistrare pe apel.

Drepturi: ssm_records:read, ssm_records:write

Adrese

• GET /api/v1/ssm-records Listă
• GET /api/v1/ssm-records/{id} O înregistrare
• POST /api/v1/ssm-records Creare
• DELETE /api/v1/ssm-records/{id} Ștergere

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/ssm-records

{
    "employee_id": 345,
    "type_id": 2,
    "done_on": "2026-04-15"
}

{
    "data": {
        "id": 120,
        "employee_id": 345,
        "type_id": 2,
        "done_on": "2026-04-15",
        "valid_until": "2026-10-15",
        "state": "valid",
        "trainer": null,
        "note": null,
        "recorded_by": 1,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Categorii de documente /document-categories

Categoriile în care se îndosariază documentele, pentru toată compania sau pentru unități.

Drepturi: document_categories:read

Adrese

• GET /api/v1/document-categories Listă
• GET /api/v1/document-categories/{id} O înregistrare

Câmpuri

Filtre

{
    "data": {
        "id": 4,
        "name": "Autorizații",
        "scope": "company",
        "sort": 1,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Documente /documents

Autorizații, contracte și regulamente, cu data expirării. API-ul citește datele documentului și numele, mărimea și tipul fișierului curent; fișierul se descarcă din aplicație. Un fișier se trimite ca {"name", "content_base64"} (aceleași tipuri ca în aplicație — PDF, Office, imagini, ZIP — cel mult 50 MB); un fișier trimis la un document existent adaugă o versiune nouă. Ștergerea mută documentul în coș, de unde se poate restaura din aplicație.

Drepturi: documents:read, documents:write

Adrese

• GET /api/v1/documents Listă
• GET /api/v1/documents/{id} O înregistrare
• POST /api/v1/documents Creare
• PATCH /api/v1/documents/{id} Modificare
• DELETE /api/v1/documents/{id} Ștergere

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/documents

{
    "title": "Autorizație sanitară de funcționare",
    "category_id": 4,
    "work_unit_id": 12,
    "is_internal": false,
    "expires_on": "2026-12-31",
    "repeat_months": 12,
    "alert_days": [
        30,
        7
    ],
    "file": {
        "name": "document.pdf",
        "content_base64": "JVBERi0xLjQK…"
    }
}

{
    "data": {
        "id": 31,
        "title": "Autorizație sanitară de funcționare",
        "description": null,
        "category_id": 4,
        "work_unit_id": 12,
        "is_internal": false,
        "expires_on": "2026-12-31",
        "expiry_state": "valid",
        "repeat_months": 12,
        "alert_days": [
            30,
            7
        ],
        "versions": 2,
        "file_name": "autorizatie.pdf",
        "file_size": 184220,
        "file_mime": "application/pdf",
        "version_note": null,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Categorii de solicitări /service-categories

Despre ce sunt solicitările de servicii (mentenanță, IT…) și dacă au nevoie întâi de aprobare.

Drepturi: service_categories:read

Adrese

• GET /api/v1/service-categories Listă
• GET /api/v1/service-categories/{id} O înregistrare

Câmpuri

Filtre

{
    "data": {
        "id": 2,
        "name": "Mentenanță și reparații",
        "is_active": true,
        "needs_approval": false,
        "sort": 1,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Solicitări /service-requests

Cereri de a repara sau de a asigura ceva într-o unitate, cu istoricul lor. Se depun pentru persoana din requested_by (care trebuie să poată face solicitări pentru acea unitate) sau pentru cel care a creat cheia; se aplică fluxul de aprobare al categoriei. Se mută cu acțiunea move, cum poate face pe ecran cel care a creat cheia.

Drepturi: service_requests:read, service_requests:write

Adrese

• GET /api/v1/service-requests Listă
• GET /api/v1/service-requests/{id} O înregistrare
• POST /api/v1/service-requests Creare
• POST /api/v1/service-requests/{id}/move Mută solicitarea în altă stare (in_progress, resolved, unresolved, open, cancelled), cum poate cel care a creat cheia. Nerezolvată și redeschiderea cer un comentariu.

Câmpuri

Filtre

/api/v1/service-requests/{id}/move: status (awaiting_approval | open | in_progress | resolved | unresolved | rejected | cancelled) — Starea nouă.; comment (text) — De ce (obligatoriu pentru nerezolvată și la redeschidere).

POST https://compania-mea.harmoniq.ro/api/v1/service-requests

{
    "category_id": 2,
    "work_unit_id": 12,
    "title": "Frigiderul de vaccinuri nu mai răcește",
    "description": "text",
    "requested_by": 17
}

{
    "data": {
        "id": 88,
        "category_id": 2,
        "work_unit_id": 12,
        "title": "Frigiderul de vaccinuri nu mai răcește",
        "description": "text",
        "requested_by": 17,
        "employee_id": 345,
        "status": "open",
        "assigned_to": 1,
        "closed_at": "2026-05-01T08:00:00Z",
        "history": [
            {
                "status_from": "open",
                "status_to": "in_progress",
                "comment": "Vine tehnicianul mâine.",
                "user_id": 9,
                "at": "2026-05-04T08:00:00Z"
            }
        ],
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Materiale /materials

Ce pot cere unitățile, cu stocul de acum, acolo unde se urmărește.

Drepturi: materials:read

Adrese

• GET /api/v1/materials Listă
• GET /api/v1/materials/{id} O înregistrare

Câmpuri

Filtre

{
    "data": {
        "id": 7,
        "name": "Mănuși nitril",
        "description": null,
        "unit": "cutie",
        "track_stock": true,
        "stock": 35,
        "is_active": true,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Cereri de materiale /material-requests

Cereri de materiale, cu pozițiile lor. Se depun pentru persoana din requested_by (sau pentru cel care a creat cheia), pentru materiale active și o unitate pentru care poate cere; apoi se preiau, se finalizează (stocul scade) sau se anulează, cum poate pe ecran cel care a creat cheia.

Drepturi: material_requests:read, material_requests:write

Adrese

• GET /api/v1/material-requests Listă
• GET /api/v1/material-requests/{id} O înregistrare
• POST /api/v1/material-requests Creare
• POST /api/v1/material-requests/{id}/take Preia o cerere nouă.
• POST /api/v1/material-requests/{id}/complete O finalizează: stocul materialelor urmărite scade.
• POST /api/v1/material-requests/{id}/cancel Anulează o cerere încă nefinalizată.

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/material-requests

{
    "work_unit_id": 12,
    "requested_by": 17,
    "items": [
        {
            "material_id": 7,
            "quantity": 5
        }
    ]
}

{
    "data": {
        "id": 51,
        "work_unit_id": 12,
        "requested_by": 17,
        "status": "new",
        "handled_by": 1,
        "note": null,
        "items": [
            {
                "material_id": 7,
                "quantity": 5
            }
        ],
        "completed_at": "2026-05-01T08:00:00Z",
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Chestionare /surveys

Chestionarele publicate și închise, cu întrebările lor, și rezultatele doar ca totaluri: câți au ales fiecare răspuns, media unei scale și câți au răspuns la o întrebare liberă — niciodată ce au scris. Rezultatele unui chestionar anonim rămân ascunse cât timp răspunsurile sunt sigilate și cât are mai puțin de 5 răspunsuri.

Drepturi: surveys:read

Adrese

• GET /api/v1/surveys Listă
• GET /api/v1/surveys/{id} O înregistrare

Câmpuri

Filtre

{
    "data": {
        "id": 5,
        "title": "Climatul de lucru",
        "description": null,
        "is_anonymous": true,
        "is_mandatory": false,
        "status": "closed",
        "opens_at": "2026-05-01T08:00:00Z",
        "closes_at": "2026-05-01T08:00:00Z",
        "published_at": "2026-05-01T08:00:00Z",
        "questions": [
            {
                "id": 11,
                "type": "single",
                "text": "Ați recomanda compania?",
                "is_required": true,
                "options": [
                    {
                        "id": 31,
                        "label": "Da"
                    }
                ]
            }
        ],
        "results": {
            "hidden": false,
            "responses": 14,
            "questions": [
                {
                    "question_id": 11,
                    "answered": 14,
                    "counts": {
                        "31": 11
                    },
                    "average": null
                }
            ]
        },
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Răspunsuri la chestionare /survey-responses

Răspunsurile la chestionarele nominale, câte un răspuns pe persoană cu ce a ales. Răspunsurile unui chestionar anonim nu se dau niciodată unul câte unul — doar totalurile, în /surveys.

Drepturi: survey_responses:read

Adrese

• GET /api/v1/survey-responses Listă
• GET /api/v1/survey-responses/{id} O înregistrare

Câmpuri

Filtre

{
    "data": {
        "id": "9b2f4c1e-6f0a-4e7c-9a51-3c2d1e0f7a88",
        "survey_id": 5,
        "employee_id": 345,
        "submitted_at": "2026-05-01T08:00:00Z",
        "answers": [
            {
                "question_id": 11,
                "option_id": 31,
                "value": null,
                "text": null
            }
        ]
    }
}

Postări /posts

Postările Social pentru toată compania (nu dintr-un grup), publicate. Le creează cel care a creat cheia: o postare sau, dacă poate face anunțuri, o știre, un anunț, o promoție sau un concurs; textul este simplu, cu un rând liber între paragrafe.

Drepturi: posts:read, posts:write

Adrese

• GET /api/v1/posts Listă
• GET /api/v1/posts/{id} O înregistrare
• POST /api/v1/posts Creare

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/posts

{
    "type": "announcement",
    "title": "Program de sărbători",
    "body": "Între 24 și 26 decembrie programul este 9–14.",
    "comments_enabled": true
}

{
    "data": {
        "id": 120,
        "type": "announcement",
        "title": "Program de sărbători",
        "body": "Între 24 și 26 decembrie programul este 9–14.",
        "author": "Maria Matei",
        "comments_enabled": true,
        "comments_count": 3,
        "published_at": "2026-05-01T08:00:00Z",
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Articole din baza de cunoștințe /knowledge-articles

Articolele publicate din baza de cunoștințe (proceduri, instrucțiuni), cu textul simplu, în limba cerută (Accept-Language) sau în limba companiei.

Drepturi: knowledge_articles:read

Adrese

• GET /api/v1/knowledge-articles Listă
• GET /api/v1/knowledge-articles/{id} O înregistrare

Câmpuri

Filtre

{
    "data": {
        "id": 9,
        "category_id": 2,
        "category": "Operațiuni",
        "title": "Recepția mărfii",
        "summary": null,
        "body": null,
        "is_featured": true,
        "published_at": "2026-05-01T08:00:00Z",
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Clienți /crm-contacts

Oamenii pe care compania îi deservește — clienți și potențiali clienți. O adresă de email este unică în companie (a doua este refuzată). Acordul de marketing nu se scrie odată cu înregistrarea: se schimbă doar prin acțiunea consent, care îi păstrează istoricul (dat sau retras, cum, când, de cine). Acțiunea erase șterge datele persoanei la cererea ei și nu poate fi anulată: numele, emailul, telefonul, notele și ce s-a scris despre ea dispar, cifrele (cumpărări, valori ale oportunităților, note) rămân, iar înregistrarea nu mai poate fi modificată.

Drepturi: crm_contacts:read, crm_contacts:write

Adrese

• GET /api/v1/crm-contacts Listă
• GET /api/v1/crm-contacts/{id} O înregistrare
• POST /api/v1/crm-contacts Creare
• PATCH /api/v1/crm-contacts/{id} Modificare
• DELETE /api/v1/crm-contacts/{id} Ștergere
• POST /api/v1/crm-contacts/{id}/consent Înregistrează că persoana și-a dat sau și-a retras acordul de marketing, și cum.
• POST /api/v1/crm-contacts/{id}/erase Șterge datele persoanei la cererea ei (GDPR). Ireversibil.

Câmpuri

Filtre

/api/v1/crm-contacts/{id}/consent: granted (boolean) — true: dat; false: retras.; channel (form | verbal | email | import | api | other) — Cum: form, verbal, email, import, api sau other (api, dacă lipsește).; note (string) — O notă (de exemplu unde se păstrează formularul).

POST https://compania-mea.harmoniq.ro/api/v1/crm-contacts

{
    "first_name": "Ioana",
    "last_name": "Pop",
    "email": "ioana.pop@example.com",
    "phone": "0722 111 222",
    "account_id": 31,
    "city": "Cluj-Napoca",
    "country": "RO",
    "locale": "ro",
    "status": "customer",
    "source": "walk_in",
    "work_unit_id": 12,
    "owner_id": 17,
    "tags": [
        "loyalty"
    ]
}

{
    "data": {
        "id": 120,
        "first_name": "Ioana",
        "last_name": "Pop",
        "email": "ioana.pop@example.com",
        "phone": "0722 111 222",
        "account_id": 31,
        "job_title": null,
        "city": "Cluj-Napoca",
        "country": "RO",
        "locale": "ro",
        "status": "customer",
        "source": "walk_in",
        "work_unit_id": 12,
        "owner_id": 17,
        "tags": [
            "loyalty"
        ],
        "notes": null,
        "marketing_consent": true,
        "consent_updated_at": "2026-05-01T08:00:00Z",
        "last_activity_at": "2026-05-01T08:00:00Z",
        "erased_at": "2026-05-01T08:00:00Z",
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Organizații client /crm-accounts

Companiile și instituțiile cărora le vinde firma. Numele este unic în companie. Ștergerea uneia îi păstrează contactele și oportunitățile, fără legătură.

Drepturi: crm_accounts:read, crm_accounts:write

Adrese

• GET /api/v1/crm-accounts Listă
• GET /api/v1/crm-accounts/{id} O înregistrare
• POST /api/v1/crm-accounts Creare
• PATCH /api/v1/crm-accounts/{id} Modificare
• DELETE /api/v1/crm-accounts/{id} Ștergere

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/crm-accounts

{
    "name": "Hotel Sigma SRL",
    "registration_number": "J12/345/2019",
    "vat_number": "RO12345678",
    "industry": "Hospitality",
    "email": "office@sigma.example",
    "phone": "0264 000 111",
    "city": "Cluj-Napoca",
    "country": "RO",
    "work_unit_id": 12,
    "owner_id": 17,
    "tags": [
        "corporate",
        "events"
    ]
}

{
    "data": {
        "id": 31,
        "name": "Hotel Sigma SRL",
        "registration_number": "J12/345/2019",
        "vat_number": "RO12345678",
        "industry": "Hospitality",
        "email": "office@sigma.example",
        "phone": "0264 000 111",
        "website": null,
        "address": null,
        "city": "Cluj-Napoca",
        "country": "RO",
        "work_unit_id": 12,
        "owner_id": 17,
        "tags": [
            "corporate",
            "events"
        ],
        "notes": null,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Fluxuri de vânzare /crm-pipelines

Fluxurile prin care trec oportunitățile, cu etapele lor (configurate în aplicație). Fiecare companie are unul implicit. O etapă este în lucru (cu șansa ca o oportunitate de acolo să fie câștigată) sau închide oportunitatea ca fiind câștigată ori pierdută.

Drepturi: crm_pipelines:read

Adrese

• GET /api/v1/crm-pipelines Listă
• GET /api/v1/crm-pipelines/{id} O înregistrare

Câmpuri

{
    "data": {
        "id": 1,
        "name": "Sales",
        "is_default": true,
        "sort": 1,
        "stages": [
            {
                "id": 3,
                "name": "Proposal sent",
                "kind": "open",
                "probability": 60,
                "sort": 20
            },
            {
                "id": 5,
                "name": "Won",
                "kind": "won",
                "probability": 100,
                "sort": 40
            }
        ],
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Oportunități /crm-deals

Vânzări, rezervări sau contracte în lucru într-un flux de vânzare. Fluxul și etapa se aleg la creare (prima etapă în lucru a fluxului implicit, dacă lipsesc); apoi o oportunitate își schimbă etapa doar prin move, win, lose și reopen. Starea urmează mereu etapa, iar closed_at se completează când este câștigată sau pierdută. O oportunitate câștigată face din contactul ei un client.

Drepturi: crm_deals:read, crm_deals:write

Adrese

• GET /api/v1/crm-deals Listă
• GET /api/v1/crm-deals/{id} O înregistrare
• POST /api/v1/crm-deals Creare
• PATCH /api/v1/crm-deals/{id} Modificare
• DELETE /api/v1/crm-deals/{id} Ștergere
• POST /api/v1/crm-deals/{id}/move Mută oportunitatea în altă etapă (a fluxului ei sau a altuia — oportunitatea se mută odată cu ea).
• POST /api/v1/crm-deals/{id}/win Marchează oportunitatea câștigată (etapa câștigată a fluxului).
• POST /api/v1/crm-deals/{id}/lose Marchează oportunitatea pierdută (etapa pierdută a fluxului), cu motivul.
• POST /api/v1/crm-deals/{id}/reopen Readuce o oportunitate încheiată în ultima etapă în lucru a fluxului.

Câmpuri

Filtre

/api/v1/crm-deals/{id}/move: stage_id (integer) — Etapa în care se mută.

/api/v1/crm-deals/{id}/lose: lost_reason (string) — De ce a fost pierdută.

POST https://compania-mea.harmoniq.ro/api/v1/crm-deals

{
    "title": "Corporate rates 2027",
    "pipeline_id": 1,
    "stage_id": 3,
    "contact_id": 120,
    "account_id": 31,
    "value": 12500.5,
    "currency": "RON",
    "expected_close_on": "2026-12-15",
    "source": "referral",
    "work_unit_id": 12,
    "owner_id": 17
}

{
    "data": {
        "id": 77,
        "title": "Corporate rates 2027",
        "pipeline_id": 1,
        "stage_id": 3,
        "status": "open",
        "contact_id": 120,
        "account_id": 31,
        "value": 12500.5,
        "currency": "RON",
        "expected_close_on": "2026-12-15",
        "closed_at": "2026-05-01T08:00:00Z",
        "lost_reason": null,
        "source": "referral",
        "work_unit_id": 12,
        "owner_id": 17,
        "notes": null,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Activități cu clienții /crm-activities

Ce s-a făcut sau urmează să se facă cu clienții: apel, întâlnire, vizită, email, notă, sarcină și cumpărare. O sarcină așteaptă până este finalizată; orice altceva este făcut când se înregistrează (la done_at, dacă se trimite). O cumpărare are nevoie de sumă și face din contactul ei un client. O activitate a unei oportunități preia clientul, organizația și unitatea oportunității, dacă nu sunt trimise.

Drepturi: crm_activities:read, crm_activities:write

Adrese

• GET /api/v1/crm-activities Listă
• GET /api/v1/crm-activities/{id} O înregistrare
• POST /api/v1/crm-activities Creare
• PATCH /api/v1/crm-activities/{id} Modificare
• DELETE /api/v1/crm-activities/{id} Ștergere
• POST /api/v1/crm-activities/{id}/complete Marchează o sarcină ca făcută (acum).
• POST /api/v1/crm-activities/{id}/reopen O marchează din nou ca nefăcută (nu și pentru cumpărări).

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/crm-activities

{
    "type": "purchase",
    "subject": "Receipt 1243",
    "contact_id": 120,
    "amount": 240,
    "due_at": "2026-11-03T09:00:00Z",
    "done_at": "2026-11-02T15:20:00Z",
    "work_unit_id": 12,
    "owner_id": 17
}

{
    "data": {
        "id": 530,
        "type": "purchase",
        "subject": "Receipt 1243",
        "body": null,
        "contact_id": 120,
        "account_id": 1,
        "deal_id": 1,
        "amount": 240,
        "due_at": "2026-11-03T09:00:00Z",
        "done_at": "2026-11-02T15:20:00Z",
        "work_unit_id": 12,
        "owner_id": 17,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Păreri ale clienților /crm-feedback

Ce au spus clienții: păreri (o notă de la 0 la 10 — cât de probabil ar recomanda firma — și/sau un comentariu) și reclamații. O părere are nevoie de o notă sau de un comentariu. O reclamație rămâne deschisă până este rezolvată, cu ce s-a făcut; poate fi redeschisă. Tipul se stabilește la creare.

Drepturi: crm_feedback:read, crm_feedback:write

Adrese

• GET /api/v1/crm-feedback Listă
• GET /api/v1/crm-feedback/{id} O înregistrare
• POST /api/v1/crm-feedback Creare
• PATCH /api/v1/crm-feedback/{id} Modificare
• DELETE /api/v1/crm-feedback/{id} Ștergere
• POST /api/v1/crm-feedback/{id}/resolve Rezolvă o reclamație, spunând ce s-a făcut.
• POST /api/v1/crm-feedback/{id}/reopen Redeschide o reclamație rezolvată.

Câmpuri

Filtre

/api/v1/crm-feedback/{id}/resolve: resolution (text) — Ce s-a făcut.

POST https://compania-mea.harmoniq.ro/api/v1/crm-feedback

{
    "kind": "feedback",
    "contact_id": 120,
    "score": 9,
    "comment": "Quick and friendly service.",
    "channel": "in_person",
    "received_on": "2026-11-02",
    "work_unit_id": 12,
    "owner_id": 17
}

{
    "data": {
        "id": 64,
        "kind": "feedback",
        "contact_id": 120,
        "account_id": 1,
        "score": 9,
        "comment": "Quick and friendly service.",
        "channel": "in_person",
        "received_on": "2026-11-02",
        "status": "resolved",
        "resolved_at": "2026-05-01T08:00:00Z",
        "resolution": null,
        "work_unit_id": 12,
        "owner_id": 17,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Parteneri /merch-partners

Producătorii și brandurile ale căror campanii intră în spațiile de expunere și pe rafturile companiei: o singură listă pentru ambele module. Numele este unic în companie. Scrierea cere dreptul „Gestionează partenerii” pentru cel care a creat cheia.

Drepturi: merch_partners:read, merch_partners:write

Adrese

• GET /api/v1/merch-partners Listă
• GET /api/v1/merch-partners/{id} O înregistrare
• POST /api/v1/merch-partners Creare
• PATCH /api/v1/merch-partners/{id} Modificare

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/merch-partners

{
    "name": "Dermalab",
    "code": "DLB",
    "contact_name": "Ana Ionescu",
    "contact_email": "ana@dermalab.example",
    "contact_phone": "0722 000 111",
    "crm_account_id": 31,
    "is_active": true
}

{
    "data": {
        "id": 3,
        "name": "Dermalab",
        "code": "DLB",
        "contact_name": "Ana Ionescu",
        "contact_email": "ana@dermalab.example",
        "contact_phone": "0722 000 111",
        "notes": null,
        "crm_account_id": 31,
        "is_active": true,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Tipuri de zone /space-zone-types

Spații și expunere: tipurile de zone pe care compania le are în mai multe locații (o ramă click, un suport pe counter, un totem), cu dimensiunile și capacitatea lor obișnuite. Prețul lunar îl scrie doar cine vede sumele.

Drepturi: space_zone_types:read, space_zone_types:write

Adrese

• GET /api/v1/space-zone-types Listă
• GET /api/v1/space-zone-types/{id} O înregistrare
• POST /api/v1/space-zone-types Creare
• PATCH /api/v1/space-zone-types/{id} Modificare

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/space-zone-types

{
    "name": "Ramă click A2",
    "width_cm": 50,
    "height_cm": 70,
    "faces": 2,
    "capacity": 2,
    "capacity_label": "afișe A2",
    "is_display": true,
    "monthly_price": 150,
    "is_active": true,
    "sort": 10
}

{
    "data": {
        "id": 2,
        "name": "Ramă click A2",
        "description": null,
        "width_cm": 50,
        "height_cm": 70,
        "depth_cm": 12.5,
        "faces": 2,
        "capacity": 2,
        "capacity_label": "afișe A2",
        "is_display": true,
        "monthly_price": 150,
        "is_active": true,
        "sort": 10,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Zone din locații /space-zones

Spații și expunere: zonele fiecărei locații (unde sunt, cât de mari, cât încape pe fiecare față), doar în locațiile pe care cel care a creat cheia le amenajează. O zonă rămâne în locația ei. O zonă nouă de un anumit tip preia dimensiunile tipului pentru ce lipsește. Mai puține fețe sau mai puțin loc decât au nevoie campaniile ei în desfășurare sunt refuzate; o zonă cu campanii nu se poate șterge.

Drepturi: space_zones:read, space_zones:write

Adrese

• GET /api/v1/space-zones Listă
• GET /api/v1/space-zones/{id} O înregistrare
• POST /api/v1/space-zones Creare
• PATCH /api/v1/space-zones/{id} Modificare
• DELETE /api/v1/space-zones/{id} Ștergere

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/space-zones

{
    "work_unit_id": 12,
    "zone_type_id": 2,
    "name": "Ramă click intrare",
    "width_cm": 50,
    "height_cm": 70,
    "faces": 2,
    "capacity": 2,
    "capacity_label": "afișe A2",
    "is_display": true,
    "monthly_price": 150,
    "status": "active",
    "sort": 100
}

{
    "data": {
        "id": 41,
        "work_unit_id": 12,
        "zone_type_id": 2,
        "name": "Ramă click intrare",
        "description": null,
        "width_cm": 50,
        "height_cm": 70,
        "depth_cm": 12.5,
        "area_m2": 12.5,
        "faces": 2,
        "capacity": 2,
        "capacity_label": "afișe A2",
        "is_display": true,
        "monthly_price": 150,
        "status": "active",
        "pin_x": 42.5,
        "pin_y": 88,
        "sort": 100,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Mobilier și tarife /shelf-fixture-types

Spațiu la raft: tipurile de mobilier (gondolă, capăt de raft, frigider) cu tariful — pe față de produs sau pe metru de raft, pe lună. Tarifele le scrie doar cine are dreptul la prețurile de la raft.

Drepturi: shelf_fixture_types:read, shelf_fixture_types:write

Adrese

• GET /api/v1/shelf-fixture-types Listă
• GET /api/v1/shelf-fixture-types/{id} O înregistrare
• POST /api/v1/shelf-fixture-types Creare
• PATCH /api/v1/shelf-fixture-types/{id} Modificare

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/shelf-fixture-types

{
    "name": "Gondolă",
    "face_price": 25,
    "is_active": true,
    "sort": 10
}

{
    "data": {
        "id": 1,
        "name": "Gondolă",
        "face_price": 25,
        "meter_price": 12.5,
        "is_active": true,
        "sort": 10,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Planograme /shelf-planograms

Spațiu la raft: planogramele descrise o dată — mobilierul, dimensiunile, rafturile de sus în jos, cu ce încape pe fiecare (fețe sau centimetri) și coeficientul lui de preț. Trimiterea câmpului shelves înlocuiește lista de rafturi; un raft pe care sunt campanii nu poate fi scos. Numele este unic.

Drepturi: shelf_planograms:read, shelf_planograms:write

Adrese

• GET /api/v1/shelf-planograms Listă
• GET /api/v1/shelf-planograms/{id} O înregistrare
• POST /api/v1/shelf-planograms Creare
• PATCH /api/v1/shelf-planograms/{id} Modificare

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/shelf-planograms

{
    "name": "Capăt de raft vitamine",
    "code": "CR-VIT",
    "fixture_type_id": 2,
    "category": "Suplimente",
    "width_cm": 100,
    "height_cm": 180,
    "capacity_unit": "faces",
    "is_active": true,
    "shelves": [
        {
            "position": 1,
            "label": null,
            "capacity": 8,
            "price_factor": 1.2
        },
        {
            "position": 2,
            "label": "La nivelul ochilor",
            "capacity": 8,
            "price_factor": 1.5
        }
    ]
}

{
    "data": {
        "id": 4,
        "name": "Capăt de raft vitamine",
        "code": "CR-VIT",
        "fixture_type_id": 2,
        "category": "Suplimente",
        "width_cm": 100,
        "height_cm": 180,
        "depth_cm": 12.5,
        "capacity_unit": "faces",
        "instructions": null,
        "is_active": true,
        "shelves": [
            {
                "position": 1,
                "label": null,
                "capacity": 8,
                "price_factor": 1.2
            },
            {
                "position": 2,
                "label": "La nivelul ochilor",
                "capacity": 8,
                "price_factor": 1.5
            }
        ],
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Planograme amplasate /shelf-placements

Spațiu la raft: o planogramă amplasată într-o locație, cu eticheta, nota și costurile ei, doar în locațiile pe care cel care a creat cheia le amenajează. Ștergerea o scoate din locație: rămâne pentru istoricul campaniilor ei sau dispare dacă nu a avut niciuna; niciodată cât timp rulează o campanie pe ea. Costurile le scrie doar cine vede prețurile.

Drepturi: shelf_placements:read, shelf_placements:write

Adrese

• GET /api/v1/shelf-placements Listă
• GET /api/v1/shelf-placements/{id} O înregistrare
• POST /api/v1/shelf-placements Creare
• PATCH /api/v1/shelf-placements/{id} Modificare
• DELETE /api/v1/shelf-placements/{id} Ștergere

Câmpuri

Filtre

POST https://compania-mea.harmoniq.ro/api/v1/shelf-placements

{
    "planogram_id": 4,
    "work_unit_id": 12,
    "label": "lângă casă",
    "installed_on": "2026-02-18",
    "monthly_cost": 25
}

{
    "data": {
        "id": 88,
        "planogram_id": 4,
        "work_unit_id": 12,
        "label": "lângă casă",
        "status": "active",
        "installed_on": "2026-02-18",
        "removed_on": "2026-05-01",
        "local_note": null,
        "setup_cost": 12.5,
        "monthly_cost": 25,
        "created_at": "2026-05-01T08:00:00Z",
        "updated_at": "2026-05-01T08:00:00Z"
    }
}

Campanii /merch-campaigns

Campaniile ambelor module (module: spaces — zone de expunere; shelf — rafturi din planograme), scrise ca cel care a creat cheia. O campanie începe ca ciornă: locațiile (units) și regulile care numesc locurile din ele (rules) devin locurile ei. Acțiunea launch verifică locul și o trimite fiecărei locații, iar cancel o oprește. O campanie lansată își păstrează datele și locurile; se mai schimbă doar textul, partenerul, sumele și cererea de fotografii. Valoarea și costul le scrie doar cine vede sumele.

Drepturi: merch_campaigns:read, merch_campaigns:write

Adrese

• GET /api/v1/merch-campaigns Listă
• GET /api/v1/merch-campaigns/{id} O înregistrare
• POST /api/v1/merch-campaigns Creare
• PATCH /api/v1/merch-campaigns/{id} Modificare
• DELETE /api/v1/merch-campaigns/{id} Ștergere
• POST /api/v1/merch-campaigns/{id}/launch Lansează ciorna: verifică locul și o trimite fiecărei locații.
• POST /api/v1/merch-campaigns/{id}/cancel Anulează o campanie lansată: nu mai pornește unde nu a fost pusă, iar unde este pusă trebuie scoasă.

Câmpuri

Filtre