Môže byť suma záporné číslo: samostatné obchodné pravidlá a pravidlá typu
Všetky polia sumy napíšte ako `minimum: 0`, čo na prvý pohľad vyzerá veľmi prísne, ale zablokuje normálny záznam o vrátení platby. Či bola suma extrahovaná do čísla a či sú v tomto biznise povolené záporné čísla, sú dve otázky. Najprv by ste mali potvrdiť význam dokumentu a potom napísať pravidlá rozsahu.
Ak robíte štruktúrovanú extrakciu objednávok, účtov alebo finančných dokumentov, pole sumy je často najnáchylnejšie na chyby. Mnoho ľudí zapíše všetky sumy ako minimum: 0, čo sa zdá byť veľmi prísne, ale bežné záznamy o vrátení peňazí budú kvôli tomu zamietnuté.
Či bola suma extrahovaná do čísla a či sú v tomto biznise povolené záporné čísla, sú dve rôzne otázky. Najprv potvrďte, čo predstavuje záporné znamienko v dokumente, a potom určte pravidlá rozsahu, aby ste sa uistili, že typ je správny bez náhodného poškodenia primeraných údajov.
Tento článok používa syntetické vzorky na demonštráciu spôsobu spracovania. Kód bol skontrolovaný pomocou príkladov v izolovanom prostredí; to nie je zárukou všetkých skutočných súborov alebo výkonu produktu. Pred spracovaním dôležitých dokumentov si uschovajte originály a skontrolujte ich podľa hraníc a akceptačných položiek v texte.
Môže byť suma záporná? Záver jednou vetou
Či môže byť suma záporná, závisí od dohody podniku, nie od samotného typu poľa. Najprv definujte význam záporného znamienka a potom nechajte obmedzenia určiť typ.
| vaša situácia | Odporúčané postupy | dôvod |
|---|---|---|
| Náhrady v zmluve sú vyjadrené ako záporné sumy | Pole poplatkov je obmedzené na nezáporné hodnoty a záporné hodnoty sú povolené na vrátenie peňazí. | Symboly sú obchodné sémantiky a nemôžu byť univerzálne |
| Systém používa „kladná suma plus typ vrátenia" | Suma je jednotne kladná a pole typu sa používa na rozlíšenie refundácií | Obidve metódy možno nastaviť, ale pre to isté rozhranie možno vybrať iba jednu. |
| Vyžaduje sa striktne kladná suma | Namiestominimum: 0 použite exclusiveMinimum | minimum obsahuje hranice a prejde nulovými hodnotami |
| Negatívne znaky v zdrojoch môžu chýbať alebo sú nesprávne umiestnené | Uložte pôvodný fragment textu a skontrolujte ho ručne. Neberte priamo absolútnu hodnotu. | Automatická korekcia môže maskovať skutočné chyby |
Najprv definujte, čo predstavuje záporné znamienko
Súhrnná dohoda v tomto článku stanovuje, že bežné poplatky nie sú záporné a náhrady sú vyjadrené ako záporné sumy. Skutočné systémy môžu tiež používať účtovnú metódu „kladná suma plus typ refundácie". Obidve metódy možno zaviesť, ale nemôžete sa spoliehať na to, že čitatelia budú hádať v rovnakom rozhraní.
Hranica nulového bodu je tu vzorový protokol a nie je jednotným štandardom vo finančnom odvetví.
Nechajte typ určiť obmedzenia
minimum schémy JSON obsahuje hranice, exclusiveMinimum hranice neobsahuje. Ak je obchodná požiadavka striktne kladná, minimum: 0 nemožno použiť.
Najprv vypíšte scenáre, kde sú povolené nulové hodnoty, potom vyberte kľúčové slová, aby ste predišli nesprávnej klasifikácii voľných projektov, odpisov alebo odhadov ako chýb.
from jsonschema import Draft202012Validator
schema = {
"type": "object", "required": ["kind", "amount"],
"additionalProperties": False,
"properties": {"kind": {"enum": ["charge", "refund"]},
"amount": {"type": "number"}},
"allOf": [
{"if": {"properties": {"kind": {"const": "charge"}}},
"then": {"properties": {"amount": {"minimum": 0}}}},
{"if": {"properties": {"kind": {"const": "refund"}}},
"then": {"properties": {"amount": {"exclusiveMaximum": 0}}}}
]
}
v = Draft202012Validator(schema)
valid = lambda x: not list(v.iter_errors(x))
assert valid({"kind": "charge", "amount": 0})
assert valid({"kind": "refund", "amount": -12.5})
assert not valid({"kind": "refund", "amount": 12.5})
assert not valid({"kind": "charge", "amount": True})
assert not valid({"amount": 12.5})
Príklad závisí od jsonschema, skontrolovaného podľa Draft 2020-12. Nevykonáva prevod mien ani neoveruje vzťah medzi podpoložkami a celkovými hodnotami.
Výpočty mien vyžadujú jasnú presnosť a stratégie zaokrúhľovania; nemôžete ľubovoľne pridávať čísla s pohyblivou desatinnou čiarkou len preto, že hodnoty prechádzajú validáciou schémy.
Hlásenie chýb vyžaduje uvedenie obchodného kontextu
Keď overenie zlyhá, informácie o chybe by mali ľuďom pomôcť určiť príčinu, nie len označiť "nelegálne".
| Pozorovanie | Takto to bolo riešené | Overenie je stále potrebné |
|---|---|---|
| Vrátenie peňazí je pozitívne | Odmietnuť | Stratil sa symbol alebo zdroj používa iný protokol? |
| Náboje sú nulové | Akceptovať štruktúru | Je to bezplatný projekt? |
| Suma je šnúrka | Typ odmietnutia | Tisíce miest, typov mien a desatinných pravidiel |
| Typ chýba | Odmietnuť | Nehádajte typ dokumentu podľa symbolu sumy |
Nezakrývajte chyby automatickými absolútnymi hodnotami
OCR môže vynechať krátke horizontálne čiary, posúvať záporné znamienko počas prekladu alebo používať opačnú symbolickú konvenciu v podniku, čo všetko môže byť rovnaká výnimka.
Ak je abs() zavolaný priamo, dôležité diagnostické signály budú eliminované. Bezpečnejším prístupom je uložiť pôvodný textový fragment, číslo strany a predparsovací reťazec, a potom sa rozhodnúť, či ho znovu rozbaliť alebo manuálne skontrolovať.
Skontrolujte množstvo a typ spoločne pri doručení
Pri používaní OmniDoc (Produktový portál) na spracovanie dokumentov obsahujúcich sumy môžete tento pravidlový list použiť ako súčasť akceptácie po preklade: nielen skontrolujte, či čísla chýbajú, ale aj či sa zmenili vrátenia, kredity a ďalšie kontexty.
Nástroje môžu pomôcť dokončiť preklad, ale dohoda o výške by mala byť stále jasne definovaná obchodnou stranou.
📊 Porovnanie jadra
| Metóda | Význam mínusového znamienka | Vhodné pre danú scénu | Dôležité poznámky |
|---|---|---|---|
| Vrátenie peňazí je za záporné sumy | Negatívne znamenie znamená vrátenie peňazí | Dohoda stanovuje, že smery sa rozlišujú symbolmi | Pole náboja musí byť obmedzené na nezáporné, zatiaľ čo pole vrátenia povoľuje záporné hodnoty |
| Pozitívna suma plus typ vrátenia peňazí | Mínus znak nenesie obchodný význam | Systém rozlišuje refundácie podľa poľa typu | Sumy musia byť jednotne kladné a typy musia byť kontrolované súčasne |
minimum: 0 | Obsahuje nulové hodnoty | Povolené nulové sumy | Umožňuje nulové hodnoty a nie je vhodný pre striktne pozitívne scenáre |
exclusiveMinimum: 0 | Neobsahuje nulové hodnoty | Prísne požiadavky sú pozitívne sumy | Prosím, potvrďte, že bezplatné položky alebo vrátenia nebudú omylom odmietnuté |
🎯 Ktorý prístup ti vyhovuje?
Ak vaša zmluva používa zápornú sumu na vyjadrenie vrátenia peňazí
- Nastavte nezáporné obmedzenia pre polia poplatku, povolte záporné hodnoty pre polia na vrátenie peňazí a špecifikujte dohodu v dokumentácii.
Ak váš systém používa "pozitívnu sumu plus typ vrátenia"
- Pole množstva je zjednotené ako kladné a pole typu je zaškrtnuté, aby sa predišlo posudzovaniu povahy dokumentov len podľa čísel.
Ak podnik vyžaduje striktne kladnú sumu
- Použite
exclusiveMinimuma najprv potvrďte, či budú voľné projekty, offsety a odhady nesprávne zamietnuté.
Ak môže chýbať záporné znamienko zdrojového súboru
- Uchovávajte originálne textové fragmenty, čísla strán a predparzovacie reťazce, manuálne si ich skontrolujte pred vstupom do databázy a priamo neberte absolútne hodnoty.
❓ Často kladené otázky (FAQ)
1. Aký je rozdiel medzi minimum a exclusiveMinimum?
minimum obsahuje okrajové hodnoty, exclusiveMinimum nie. Ak sú obchodné požiadavky striktne kladné, minimum: 0 nie je možné použiť.
2. Je suma vždy správna cez overenie schémy?
Nie nevyhnutne. Príklad nevykonáva konverziu mien, ani neoveruje vzťah medzi podpoložkami a celkmi; Výpočet meny tiež vyžaduje jasnú presnosť a stratégie zaokrúhľovania.
3. Prečo sa suma nedá priamo sčítať pomocou čísel s pohyblivou desatinnou čiarkou?
Výpočty mien vyžadujú jasnú presnosť a stratégie zaokrúhľovania; nemôžete ľubovoľne pridávať čísla s pohyblivou desatinnou čiarkou len preto, že hodnoty prešli schema.
4. Ak narazíte na abnormálne záporné znamienko, môžete priamo vziať absolútnu hodnotu?
Neodporúča sa. Vynechanie OCR, preklad pohybujúcich sa záporných znamienok alebo obchodné symbolové konvencie môžu všetky spôsobiť anomálie; priame odoberanie absolútnych hodnôt eliminuje diagnostické stopy.
📝 Zhrnutie
Kľúčom k poľu množstva je najprv potvrdiť, čo znamená záporné znamienko, a potom nechať typ určiť obmedzenie. Oddelenie obchodných pravidiel od typových pravidiel zabezpečuje, že omylom neodmietnete vrátenie peňazí ani neprehliadnete skutočné chyby.
Zdroje: Numerické obmedzenia schémy JSON


