Agency Flow · Documentație Services & Billing

Zece billing types, aceleași patru tabele

Un serviciu are exact un billing type; tipul e un strategy pattern — schema stochează parametrii, codul calculează, DB-ul păzește derivatele. Documentația de aici arată schema completă plus câte un flux narativ pas-cu-pas pentru fiecare tip: cine acționează, ce se inserează, ce se calculează și când îngheață fiecare cifră.

Account manager — setup Engine — automat Specialist / Echipa Finance — fee & facturare

Fundația

De aici se începe — tabelele și regulile pe care le folosesc toate fluxurile.

DB

Schema tabelelor

service · service_pricing_* · service_billing_period · service_cost_line

Harta celor 11 tabele, exemple de date per billing type și puntea spre cod (Doctrine CTI → strategie → snapshot).
A1

Fixed fee — fluxul de referință

invoice = fixed_amount

Cel mai simplu tip, povestit cap-coadă. Celelalte fluxuri sunt variațiuni pe scheletul lui — citește-l primul.
⚡

Ghid rapid — tot sistemul pe o pagină

decizie · tabel comparativ · stări · glosar · FAQ

Pentru prima zi: cum aleg billing type-ul, ce diferă între tipuri dintr-o privire și întrebările care apar garantat.
∑

Calculator de billing — interactiv

alegi tipul → miști cifrele → vezi breakdown-ul live

Strategy pattern-ul pe viu: factura, costul și bucket-urile de profit se rescriu în timp real. Ideal pentru prezentare.

LABOR Munca echipei e costul

Fără supplier. Factura vine din sumă fixă sau din ore; profitul = factură − cost intern (pontaje × cost/h angajat).

A2

Hourly — flat rate

invoice = billed_rate × Σ ore

O singură rată pe serviciu; orele se agregă din pontaje. Perioada se naște cost_entry și îngheață la închiderea lunii.
B

Hourly — tiered

≤cap @ base · peste @ over (marginal)

Două benzi de preț, aplicate marginal — banda a doua doar pe orele de peste cap, niciodată retroactiv.

SUPPLIER Furnizorul e costul

Fără muncă internă. Costul furnizorului trece prin (C/E) sau poartă un fee (D/F1/F2/F3); fiecare lună lasă o linie de cost — ancora facturilor de furnizor.

C

Fixed cost

invoice = supplier_cost · profit 0

Pass-through pur, sumă fixă: nimic de introdus lunar, profit legitim zero, dar linia de cost există pentru AP (Accounts Payable).
D

Fixed cost + fee

invoice = cost + fee · profit = fee

Ca C, plus un fee fix. Clientul vede o singură sumă combinată — niciodată split-ul cost/fee.
E

Variable cost

invoice = cost introdus lunar · profit 0

Pass-through cu cost variabil: specialistul introduce costul în fiecare lună, factura îl oglindește.
F1

Per deliverable + fee

invoice = Σ qty × (cost/u + fee/u)

Vedeta: linii per livrabil, fiecare cu supplierul ei, flux pe două roluri (specialist → finance) și lifecycle per linie.
F2

Cost/h + fee/h

invoice = (cost/h + fee/h) × ore

Ratele fixate la setup, orele furnizorului introduse lunar. Profit = fee/h × ore, marjă curată.
F3

% of cost (markup)

invoice = cost × (1 + fee_pct)

Procent fixat la setup peste un cost introdus lunar. Tot fee-ul e marjă curată — spre deosebire de Platform.

HIBRID Supplier și labor deodată

Singura excepție de la regula labor-XOR-supplier: financiar de platformă plus orele echipei care o administrează.

PL

Platform — % of spend

invoice = spend × (1 + client_pct) · rebate = platform_pct × spend

Rebate-ul platformei e profit direct (spread, nu cash); fee-ul clientului e labour-recovery și se netează cu orele echipei.

OVERLAY Buget la nivel de client

Nu e billing type: un overlay pe client care schimbă doar factura. Serviciile lui rulează normal, ca actuals.

G

Budget overlay

client_invoice = Client.budget · variance = budget − Σ actual

Factură fixă = bugetul, indiferent de servicii. Diferența buget − actual e variația de scop (under/over-serviced), ținută intern ca sold curent.
Cum se citește orice flux: pasul 1 e mereu setup-ul (2 rânduri: service + tabelul de pricing al tipului), pasul 2 e deschiderea lunii (rândul de perioadă), la mijloc stă diferența specifică tipului (ore / cost / linii / spend), iar finalul e identic: facturare din snapshot, înghețare, raportare prin SUM. Ce diferă între tipuri e doar cine completează ce, pe aceleași locuri.