Releases: InstaSoft-hu/keypro-cli
Release list
v0.1.14
Full Changelog: v0.1.13...v0.1.14
v0.1.13
v0.1.12
v0.1.11
A licenc jellege olvasható a termék-végpontokon
A GET /products és a GET /products/{key} válasza új mezőt visz:
licenseNature (used | new | subscription). Azt mondja meg, mit veszel
jogilag: használt, határozatlan idejű licencet a másodlagos forgalomból
(used), korábban nem aktivált licencet a gyártó hivatalos láncából (new),
vagy határozott idejű, a jogosulthoz kötött előfizetést (subscription). A
mező mindig ki van töltve, sosem null.
Ott van a termék-soron és minden változat-soron is (a lista variants[]
elemein, a részletező bővebb variants[] elemein, és include_variants=true
mellett az önálló változat-találatokon). A jelleg a változat SAJÁT értéke, egy
családon belül is eltérhet, és a változaté a mérvadó: a csoport-sor nem
rendelhető.
Külön dolog a fulfillmentType-tól, ami azt mondja meg, mit kapsz (kulcs,
matrica, kártya, előfizetés): egy digital termék lehet használt is, új is.
Parancssorból: a keypro products get <cikkszám vagy azonosító> új "Licenc
jellege" sorban mutatja, a --json a nyers értéket viszi tovább.
Nem törő. Új mező, a meglévők változatlanok.
A licenc-dokumentum is viszi a jelleget, és ez dönti el, melyik irat készül
A GET /license-documents sorai, a GET /license-documents/{id} és a
POST /license-documents válasza is viszi a licenseNature mezőt. A
dokumentumon ez a kiállítás pillanatképe: egy későbbi katalógus-javítás nem
írja át egy már kiadott irat fajtáját.
Ebből következik a válasz pdf objektumának KULCSHALMAZA is, tehát az
dokumentumonként különbözhet:
licenseNature |
A pdf kulcsai (és a ?kind= értékek) |
|---|---|
used |
atruhazas, megsemmisites |
new |
licencigazolas |
subscription |
elofizetes-igazolas |
A fajtát nem a hívó választja: a kiállított tételek terméke dönti el. Ami a
pdf mezőben nincs meghirdetve, arra a GET /license-documents/{id}/pdf
not_found (404) hibát ad - ugyanazt, mint ismeretlen fajtára.
Nem törő. A pdf kulcsai eddig is a dokumentumhoz tartozó iratokat
hirdették, és használt licencre változatlanul atruhazas + megsemmisites.
Aki eddig is a pdf mezőből vette a letöltési címet, annak nincs teendője.
Aki a két régi kulcsnevet égette be, az kezelje a másik két fajtát is - egy
előfizetésre kiállított dokumentumon nincs atruhazas.
Két új végfelhasználói irat
A GET /license-documents/{id}/pdf kind paramétere két új értéket vett fel:
licencigazolas- Licencigazolás, új (new) licencre,elofizetes-igazolas- Előfizetés-igazolás, előfizetésre (subscription).
A használt licenc iratai változatlanok: atruhazas (átruházási igazolás) és
megsemmisites (megsemmisítési nyilatkozat).
Egy dokumentumon továbbra is csak AZONOS jellegű tételek lehetnek: vegyes
kérésre a POST /license-documents item_not_allowed (400) hibát ad, és a
hibaüzenet megnevezi a terméket meg a jellegét.
Parancssorból: a keypro licdok pdf <id> --kind <fajta> mind a négy fajtát
elfogadja.
Nem törő. Új felvett értékek; a régi kettő ugyanazt jelenti, mint eddig.
Új készlet-állapot: on_demand ("Max 24 óra")
A stock.status felvette az on_demand értéket, tehát a lehetséges értékek:
always | unknown | unlimited | in_stock | low | out | on_demand.
Az on_demand azt jelenti, hogy a terméket rendelésre szerezzük be, és
nincs belőle szabad licenc: az available ezért 0, a label pedig
Max 24 óra. Az out ugyanígy 0 szabad licencet jelent, de olyan terméken,
amit készleten tartunk - ott a beszerzési idő nyitott. Egyik sem blokkolja a
rendelést.
Nem törő a szó szoros értelmében: egyetlen meglévő érték jelentése sem
változott.
Figyelmet igényel. Ez a kiadás egyetlen ilyen pontja. Ha a stock.status
hat régi értékére KIMERÍTŐ elágazást írtál (switch alapértelmezett ág nélkül,
szigorú felsorolás-típus, "minden más = hiba" szabály), akkor a hetedik érték
nálad hibát vagy üres állapotot okoz. Vedd fel az on_demand ágat, vagy adj az
elágazásnak biztonságos alapértelmezést.
A cikkszám egyedi, az ambiguous_sku hiba nem fordulhat elő
A cikkszám (sku) a katalógusban egyedi, kis- és nagybetűre nézve is:
OFFICE2024 és office2024 nem élhet meg egymás mellett. Adatbázis-szintű
részleges egyedi index őrzi, tehát egy cikkszám legfeljebb egy terméksort -
egyszerű terméket vagy változatot - azonosít. A POST /orders/preview és a
POST /orders items[].sku mezője ezért egyértelmű, és az ambiguous_sku
(400) hiba nem fordulhat elő.
A hibakód a szerződés része marad, védekezésből: a kliensednek nem kell
kivennie a kezeléséből, de számítania sem kell rá.
Változatlan, hogy a sku hiányozhat (null): a katalógus több mint
felének nincs cikkszáma, azokat productId-vel kell rendelni.
Nem törő. Egy hibaág szűnt meg, új nem keletkezett.
Új fizetési mód: internal
A paymentMethod (a POST /orders/preview, a POST /orders és a fizetési mód
módosítása) felvette az internal értéket: belső elszámolás, fizetés nélkül,
és semmilyen bizonylat nem készül róla - számla, díjbekérő és szállítólevél
sem.
Fiók-szintű engedélyhez kötött: kizárólag a cégen belüli partner-fiókból
választható. Minden más fiók payment_method_not_allowed (403) hibát kap, már
az előnézeten. Ez a hibakód is új.
Parancssorból: keypro order preview --payment internal. A CLI szándékosan
átengedi az értéket, hogy a beszélő hibaüzenet a szervertől jöjjön.
Nem törő. Új felvett érték és egy új hibakód egy új úton; a meglévő
fizetési módok viselkedése változatlan.
A teljes valtozasnaplo: CHANGELOG.md