Czy kwota może być liczbą ujemną: oddzielne reguły biznesowe i reguły typu

Jeśli przeprowadzasz uporządkowaną ekstrakcję zamówień, rachunków lub dokumentów finansowych, pole kwoty jest często miejscem najbardziej podatnym na błędy. Wiele osób zapisze wszystkie kwoty jako minimum: 0, co wydaje się bardzo rygorystyczne, ale normalne zapisy dotyczące zwrotów zostaną z tego powodu odrzucone.

To, czy kwota została wyodrębniona w postaci liczby i czy w tej branży dozwolone są liczby ujemne, to dwie różne kwestie. Najpierw sprawdź, co oznacza znak minus w dokumencie, a następnie określ reguły zakresu, aby mieć pewność, że typ jest poprawny, bez przypadkowego uszkodzenia rozsądnych danych.

W tym artykule wykorzystano próbki syntetyczne w celu zademonstrowania metody przetwarzania. Kod został sprawdzony na przykładach w izolowanym środowisku; nie stanowi to gwarancji wszystkich rzeczywistych plików ani wydajności produktu. Przed przystąpieniem do przetwarzania ważnych dokumentów prosimy o zachowanie oryginałów i zapoznanie się z nimi zgodnie z granicami i pozycjami akceptacji w tekście.

Czy kwota może być ujemna? Wniosek w jednym zdaniu

To, czy kwota może być ujemna, zależy od zgody firmy, a nie od samego typu pola. Najpierw zdefiniuj znaczenie znaku ujemnego, a następnie pozwól, aby typ określił ograniczenia.

Najpierw zdefiniuj, co reprezentuje znak ujemny

Porozumienie podsumowujące zawarte w tym artykule stanowi, że zwykłe opłaty nie są ujemne, a zwroty wyrażane są w kwotach ujemnych. Prawdziwe systemy mogą również stosować metodę księgowania „kwota dodatnia plus rodzaj zwrotu". Można zastosować obie metody, ale nie można polegać na tym, że czytelnicy zgadną w tym samym interfejsie.

Granica punktu zerowego jest tutaj przykładowym protokołem i nie stanowi ujednoliconego standardu w branży finansowej.

Niech typ określa ograniczenia

minimum schematu JSON zawiera granice, exclusiveMinimum nie zawiera granic. Jeśli wymaganie biznesowe jest ściśle pozytywne, nie można zastosować minimum: 0.

Przed wybraniem słów kluczowych wypisz scenariusze, które dopuszczają wartości zerowe, aby uniknąć błędnej interpretacji bezpłatnych pozycji, odpisów lub szacunków jako błędów.

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})

Przykład zależy od jsonschema i jest zweryfikowany zgodnie z Draft 2020-12. Nie dokonuje przeliczenia walut ani nie weryfikuje związku pomiędzy pozycjami a sumami.

Obliczenia walut wymagają jasnej precyzji i strategii zaokrąglania. Tylko dlatego, że wartości przechodzą weryfikację schematu, nie można używać liczb zmiennoprzecinkowych do dowolnej akumulacji.

Zgłaszając błąd, należy wskazać kontekst biznesowy

Jeśli weryfikacja zakończy się niepowodzeniem, komunikat o błędzie powinien pomóc użytkownikom w ustaleniu przyczyny, a nie tylko wskazywać, że jest to „nielegalne".

Nie używaj automatycznych wartości bezwzględnych, aby ukryć błędy

Brakujące myślniki w OCR, przesuwające się znaki ujemne podczas tłumaczenia lub firma stosująca konwencje przeciwnych znaków mogą objawiać się tą samą anomalią.

Bezpośrednie wywołanieabs() wyeliminowałoby ważne wskazówki diagnostyczne. Bezpieczniejszym podejściem jest zapisanie oryginalnych fragmentów tekstu, numerów stron i ciągów znaków przed analizą, a następnie podjęcie decyzji o ponownym wyodrębnieniu lub ręcznym przejrzeniu.

Podczas dostawy sprawdź kwotę i typ

Używając OmniDoc (portal produktowy) do przetwarzania dokumentów zawierających kwoty, możesz użyć tej tabeli reguł w ramach akceptacji po tłumaczeniu: nie tylko sprawdź, czy numery zostały utracone, ale także czy zmienił się kontekst zwrotów, uznań itp.

Narzędzia mogą pomóc w ukończeniu tłumaczenia, ale umowa dotycząca kwoty powinna być nadal jasna dla strony biznesowej.

📊 Porównanie rdzeni

🎯 Która metoda jest dla Ciebie odpowiednia?

Jeśli w Twojej umowie jest mowa o kwocie ujemnej jako wskazaniu zwrotu środków

• Ustaw nieujemne ograniczenia dla pola opłaty, zezwól na wartości ujemne dla pola zwrotu i zapisz umowę w dokumencie.

Jeśli Twój system używa „kwota dodatnia plus typ zwrotu"

• Pole kwoty powinno być jednolicie dodatnie, a pole typu powinno być jednocześnie weryfikowane, aby nie oceniać charakteru dokumentu na podstawie samych liczb.

Jeśli kwota zapotrzebowania biznesowego jest ściśle dodatnia

• UżyjexclusiveMinimum i sprawdź najpierw, czy bezpłatne produkty, rabaty i szacunki nie zostaną omyłkowo odrzucone.

Jeśli znak ujemny pliku źródłowego może zostać utracony

• Zachowaj oryginalne fragmenty tekstu, numery stron i wstępnie przeanalizowane ciągi znaków i ręcznie je przeglądaj przed wprowadzeniem ich do bazy danych. Nie bierz bezpośrednio wartości bezwzględnej.

❓ Często zadawane pytania (FAQ)

1. Jaka jest różnica pomiędzy minimum i exclusiveMinimum?

minimum zawiera wartości graniczne, exclusiveMinimum nie zawiera wartości granicznych. Jeśli wymaganie biznesowe jest ściśle pozytywne, nie można zastosować minimum: 0.

2. Jeśli przejdzie weryfikację schematu, czy kwota będzie prawidłowa?

niepewny. Przykład nie przeprowadza przeliczania walut ani nie weryfikuje związku pomiędzy pozycjami i sumami; obliczenia walutowe wymagają również jasnej strategii precyzji i zaokrąglania.

3. Dlaczego nie można bezpośrednio zgromadzić kwoty za pomocą liczb zmiennoprzecinkowych?

Obliczenia walut wymagają jasnej precyzji i strategii zaokrąglania. Liczb zmiennoprzecinkowych nie można używać do losowego kumulowania tylko dlatego, że wartości przeszły weryfikację schematu.

4. Czy w przypadku wystąpienia wyjątku ze znakiem ujemnym możesz bezpośrednio przyjąć wartość bezwzględną?

Niezalecane. Brakujące słowa w OCR, przenoszenie znaków ujemnych w tłumaczeniu lub inna konwencja symboli biznesowych mogą powodować nieprawidłowości. Bezpośrednie przyjęcie wartości bezwzględnej wyeliminuje wskazówki diagnostyczne.

📝 Podsumowanie

Kluczem do pola kwoty jest najpierw potwierdzenie, co reprezentuje znak ujemny, a następnie umożliwienie typowi określenia ograniczeń. Oddzielając reguły biznesowe i reguły typu, nie możesz przez pomyłkę odrzucić zwrotu środków ani przeoczyć rzeczywistych błędów.

Wypróbuj teraz: prześlij dokument, aby rozpocząć tłumaczenie, zachowując oryginalny układ

Źródła: Ograniczenia numeryczne schematu JSON