OmniDocМожет ли сумма быть отрицательным числом: отдельные бизнес-правила и правила типов
Запишите все поля суммы как `minimum: 0`, что на первый взгляд выглядит очень строго, но заблокирует обычную запись о возврате. Была ли сумма извлечена в число и разрешены ли в этом бизнесе отрицательные числа — это два вопроса. Сначала вам следует подтвердить смысл документа, а затем написать правила его применения.
— При сообщении об ошибке исходный фрагмент текста, номер страницы и строку перед анализом следует сохранить, а abs() не следует использовать напрямую, чтобы скрыть подсказки об отсутствующих символах.
- В примере проверяется только тип и символ, но не выполняется конвертация валюты или проверка общей суммы товара. Валютные расчеты требуют четкой точности и стратегии округления.
Если вы выполняете структурированное извлечение заказов, счетов или финансовых документов, поле суммы часто является наиболее подверженным ошибкам местом. Многие люди будут записывать все суммы как minimum: 0, что кажется очень строгим, но из-за этого обычные записи о возврате будут отклонены.
Была ли сумма извлечена в число и разрешены ли в этом бизнесе отрицательные числа — это два разных вопроса. Сначала подтвердите, что представляет собой отрицательный знак в документе, а затем определите правила диапазона, чтобы гарантировать правильность типа без случайного повреждения разумных данных.
В этой статье для демонстрации метода обработки используются синтетические образцы. Код проверен на примерах в изолированной среде; это не является гарантией всех реальных файлов или производительности продукта. Перед обработкой важных документов, пожалуйста, сохраните оригиналы и просмотрите их по границам и пунктам приема в тексте.
Может ли сумма быть отрицательной? Вывод в одно предложение
Может ли сумма быть отрицательной, зависит от соглашения компании, а не от самого типа поля. Сначала определите значение отрицательного знака, а затем позвольте типу определять ограничения.
| твоя ситуация | Рекомендуемые практики | причина |
|---|---|---|
| Возврат средств в договоре выражается в виде отрицательных сумм. | Поле начисления ограничено неотрицательными значениями, а для возвратов разрешены отрицательные значения. | Символы представляют собой бизнес-семантику и не могут быть универсальными. |
| Система использует «положительную сумму плюс тип возврата». | Сумма всегда положительна, а поле типа используется для различения возвратов. | Оба метода могут быть установлены, но для одного и того же интерфейса можно выбрать только один. |
| Требуется строго положительная сумма | Используйте exclusiveMinimum вместо minimum: 0. | minimum содержит границы и будет передавать нулевые значения. |
| Отрицательные знаки в источниках могут отсутствовать или быть неуместными. | Сохраните исходный фрагмент текста и просмотрите его вручную. Не принимайте непосредственно абсолютное значение. | Автокоррекция может маскировать реальные ошибки |
Сначала определите, что представляет собой отрицательный знак
Соглашение о синтезе в этой статье предусматривает, что обычные сборы неотрицательны, а возмещения выражаются в виде отрицательных сумм. Реальные системы также могут использовать метод учета «положительная сумма плюс тип возмещения». Оба метода могут быть установлены, но вы не можете рассчитывать на то, что читатели догадаются в одном и том же интерфейсе.
Граница нулевой точки здесь представляет собой образец протокола и не является единым стандартом в финансовой отрасли.
Пусть тип определяет ограничения
minimum схемы JSON содержит границы, а exclusiveMinimum не содержит границ. Если бизнес-требование строго положительное, minimum: 0 использовать нельзя.
Перечислите сценарии, которые допускают нулевые значения, прежде чем выбирать ключевые слова, чтобы избежать ошибочной интерпретации бесплатных позиций, списаний или оценок как ошибок.
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})Пример зависит от jsonschema и проверен согласно проекту 2020-12. Он не выполняет конвертацию валюты и не проверяет взаимосвязь между позициями и итогами.
Валютные расчеты требуют четкой точности и стратегии округления. Просто потому, что значения проходят проверку схемы, вы не можете использовать числа с плавающей запятой для накопления по своему желанию.
Сообщая об ошибке, необходимо указать бизнес-контекст
Если проверка не удалась, сообщение об ошибке должно помочь людям определить причину, а не просто указать «незаконно».
| Наблюдение | Вот как это было организовано | Проверка всё ещё необходима |
|---|---|---|
| Возврат положительный | Отказ | Потерян ли символ или источник использует другой протокол? |
| Нулевый заряд | Принять структуру | Является ли это бесплатной программой |
| Сумма — это строка | Виды отказов | Тысячи точек, валют и десятичных правил |
| Отсутствующий тип | Отказ | Не угадывайте тип документа по символу суммы |
Не используй автоматическое извлечение абсолютного значения, чтобы скрыть ошибки
OCR может показывать тот же тип исключения, если отсутствует короткая горизонтальная линия, при переводе перемещается минус или бизнес использует противоположные символические условности.
Если abs() вызывается напрямую, важные диагностические подсказки исключаются. Более безопасным способом является сохранение исходного текстового клипа, номер страницы и строки предварительного разбора, а затем решить, извлекать ли их заново или проверять вручную.
Проверьте сумму и введите вместе при доставке
При использовании OmniDoc (запись продукта) для обработки документов с суммами вы можете использовать эту таблицу правил для принятия после обработки: не только проверить, нет ли номеров, но и проверить, изменился ли контекст возвратов, кредитов и других вопросов.
Инструменты могут помочь завершить переводы, но соглашение о сумме всё равно должно быть уточнено бизнес-стороной.
📊 Сравнение ядра
| Метод | Значение знака минус | Подходит для сцены | Важные моменты |
|---|---|---|---|
| Возврат осуществляется с отрицательной суммой | Отрицательный знак означает возврат средств | Соглашение предусматривает, что направления различаются символами | Поле заряда должно быть ограничено неотрицательным, а поле возврата может быть отрицательным |
| Положительная сумма плюс тип возврата | Отрицательный знак не несёт делового значения | Система различает возвраты по типу поля | Сумма равномерно положительная, и тип должен проверяться одновременно |
minimum: 0 | Содержит ноль значений | Допустимые значения при нулевой стоимости | Он допускает нулевые значения и не подходит для строго положительных сценариев |
exclusiveMinimum: 0 | Нулевые значения не включены | Строгие требования устанавливаются на положительные значения | Убедитесь, что бесплатные товары или отмены не будут ошибочно отклонены |
🎯 Какой способ тебе подходит?
Если в вашем соглашении используется отрицательная сумма для обозначения возврата
- Установить неотрицательное ограничение для поля заряда, разрешить отрицательные значения для поля возврата и указать соглашение в документации.
Если в вашей системе используется «Положительная сумма плюс тип возврата»
- Количества полей унифицированы в положительные, а типовые поля проверяются, чтобы не оценивать характер документа только по числам.
Если бизнес требует, чтобы сумма была строго положительной
- Используйте
exclusiveMinimumи сначала убедитесь, будут ли бесплатные проекты, офсеты и оценки ошибочно отклонены.
Если отрицательный знак в исходном файле может отсутствовать
- Сохранять исходный фрагмент, номер страницы и строку предварительного разбора, вручную проверять перед входом в базу данных и не выбирать напрямую абсолютные значения.
❓ Часто задаваемые вопросы (FAQ)
1. В чём разница между minimum и exclusiveMinimum?
minimum содержит граничные значения, а exclusiveMinimum — нет. Если требования бизнеса строгие и положительные, использование minimum: 0 нельзя.
2. Всегда ли сумма верна только потому, что проходит проверку по схеме?
Не обязательно. Пример не выполняет конвертацию валют и не проверяет связь между подстатьями и итогами; Расчеты валюты также требуют четкой точности и стратегий округления.
3. Почему сумма нельзя напрямую добавить с помощью чисел с плавающей запятой?
Расчеты валют требуют чёткой точности и стратегий округления; нельзя произвольно добавлять числа с плавающей запятой только потому, что значения проходят проверку схемы.
4. Если вы сталкиваетесь с аномальными отрицательными признаками, можете ли вы напрямую взять абсолютное значение?
Не рекомендуется. Пропуски OCR, переносные отрицательные знаки или другие бизнес-символы могут вызывать аномалии; прямое взятие абсолютных значений устраняет диагностические подсказки.
📝 Краткое содержание
Ключевой элемент поля числа — сначала подтвердить, что означает отрицательный знак, а затем дать типу определить ограничение. Отдельте бизнес-правила от правил типа, чтобы избежать ошибочных отказов при возврате и не упустить реальные ошибки.
Опыт сейчас: загрузите документ, чтобы начать перевод, сохраняя оригинальное форматирование
Источники: Числовые ограничения схемы JSON
