Proč verzovat ceníky?
Ceny se mění. Zákazník však musí dostat fakturu odpovídající cenám platným v době využití služby — ne těm aktuálním. BillingEngine to řeší automaticky pomocí verzí ceníku.
Jak verze fungují
Každý ceník (price_list) může mít libovolný počet verzí (price_list_versions). Každá verze má:
| Pole | Popis |
|---|---|
valid_from | Datum začátku platnosti |
valid_to | Datum konce platnosti (nebo null = neomezeno) |
status | draft / active / archived |
Engine vždy vybere verzi, jejíž interval valid_from–valid_to pokrývá datum záznamu.
Vytvoření nové verze přes API
POST /api/v1/price-lists/{id}/versions
Authorization: Bearer <token>
{
"valid_from": "2026-04-01",
"valid_to": null,
"status": "active"
}
Poté přidejte položky:
POST /api/v1/price-lists/{id}/versions/{versionId}/items
{
"service_type": "SMS",
"unit_price": 0.85,
"currency": "CZK"
}
Přechod na novou verzi
Při zvýšení cen od 1. dubna stačí:
- Vytvořte novou verzi s
valid_from: "2026-04-01" - Uzavřete starou verzi nastavením
valid_to: "2026-03-31"(nebo ji archivujte) - Záznamy z března zůstanou oceněny starými sazbami, dubnové záznamy automaticky použijí nové
Žádný zásah do historických dat není potřeba.
Tip: draft verze
Novou verzi lze nejprve vytvořit ve stavu draft a otestovat ji na vzorových datech. Aktivuje se teprve po nasazení — ideální workflow před každým zdražením.