daichodo-validate 0.1.0__tar.gz

daichodo_validate-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.py[cod]
+.venv/
+.gen/
+dist/
+build/
+*.egg-info/
+.pytest_cache/

daichodo_validate-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daichodo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

daichodo_validate-0.1.0/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: daichodo-validate
+Version: 0.1.0
+Summary: Validate Japanese corporate numbers (法人番号) and qualified invoice registration numbers (登録番号). Zero dependencies, no network.
+Project-URL: Homepage, https://daichodo.com
+Project-URL: Source, https://github.com/daichodo/daichodo-python
+Project-URL: Issues, https://github.com/daichodo/daichodo-python/issues
+Author-email: Daichodo <dev@daichodo.com>
+License: MIT
+License-File: LICENSE
+Keywords: corporate-number,invoice,japan,validation,インボイス,法人番号,適格請求書
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Japanese
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Financial :: Accounting
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# daichodo-validate
+
+法人番号と適格請求書発行事業者の登録番号を検証します。依存関係なし、通信なし、APIキー不要。
+
+Validate Japanese corporate numbers (法人番号) and qualified invoice
+registration numbers (登録番号). Zero dependencies, no network, no API key.
+
+```bash
+pip install daichodo-validate
+```
+
+```python
+from daichodo_validate import validate_registration_number
+
+validate_registration_number("T1010001153225")
+# ValidationResult(valid=True, corporate_number='1010001153225')
+```
+
+## 日本語
+
+検査用数字の計算式は国税庁が公表している仕様に基づくため、サービスへの接続は不要です。
+
+判定できるのは**形式として正しいか**であり、**実際に登録されているか**ではありません。
+登録の有無や有効期間を確認するには [daichodo.com](https://daichodo.com) の API を
+ご利用ください。
+
+### 個人事業主の登録番号に検査用数字はありません
+
+個人事業主の登録番号は法人番号から導出されないため、形式以外に検証できる要素が
+ありません。
+
+```python
+validate_registration_number("T1234567890123")
+# ValidationResult(valid=True, reason='not derived from a 法人番号',
+#                  corporate_number=None)
+```
+
+これらは**有効**です。登録簿の約半数は個人事業主であるため、無効として扱うと確認対象の
+半分を誤って弾くことになります。
+
+## English
+
+The check-digit rules come from the National Tax Agency's published
+specification, so this needs no service behind it.
+
+It tells you whether a number is **well-formed** — not whether it is
+**registered**. For registration status and validity dates you need the API at
+[daichodo.com](https://daichodo.com).
+
+### Sole traders have no check digit
+
+Registration numbers for sole traders are not derived from a 法人番号, so there
+is nothing to verify beyond the format. They are **valid**. Roughly half the
+register is sole traders, so treating them as invalid would reject half of
+everything you look at.
+
+## ライセンス / Licence
+
+MIT.
+
+---
+
+出典：国税庁法人番号公表サイト（国税庁）（https://www.houjin-bangou.nta.go.jp/）を加工して作成

daichodo_validate-0.1.0/README.md

@@ -0,0 +1,63 @@
+# daichodo-validate
+
+法人番号と適格請求書発行事業者の登録番号を検証します。依存関係なし、通信なし、APIキー不要。
+
+Validate Japanese corporate numbers (法人番号) and qualified invoice
+registration numbers (登録番号). Zero dependencies, no network, no API key.
+
+```bash
+pip install daichodo-validate
+```
+
+```python
+from daichodo_validate import validate_registration_number
+
+validate_registration_number("T1010001153225")
+# ValidationResult(valid=True, corporate_number='1010001153225')
+```
+
+## 日本語
+
+検査用数字の計算式は国税庁が公表している仕様に基づくため、サービスへの接続は不要です。
+
+判定できるのは**形式として正しいか**であり、**実際に登録されているか**ではありません。
+登録の有無や有効期間を確認するには [daichodo.com](https://daichodo.com) の API を
+ご利用ください。
+
+### 個人事業主の登録番号に検査用数字はありません
+
+個人事業主の登録番号は法人番号から導出されないため、形式以外に検証できる要素が
+ありません。
+
+```python
+validate_registration_number("T1234567890123")
+# ValidationResult(valid=True, reason='not derived from a 法人番号',
+#                  corporate_number=None)
+```
+
+これらは**有効**です。登録簿の約半数は個人事業主であるため、無効として扱うと確認対象の
+半分を誤って弾くことになります。
+
+## English
+
+The check-digit rules come from the National Tax Agency's published
+specification, so this needs no service behind it.
+
+It tells you whether a number is **well-formed** — not whether it is
+**registered**. For registration status and validity dates you need the API at
+[daichodo.com](https://daichodo.com).
+
+### Sole traders have no check digit
+
+Registration numbers for sole traders are not derived from a 法人番号, so there
+is nothing to verify beyond the format. They are **valid**. Roughly half the
+register is sole traders, so treating them as invalid would reject half of
+everything you look at.
+
+## ライセンス / Licence
+
+MIT.
+
+---
+
+出典：国税庁法人番号公表サイト（国税庁）（https://www.houjin-bangou.nta.go.jp/）を加工して作成

daichodo_validate-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[project]
+name = "daichodo-validate"
+version = "0.1.0"
+description = "Validate Japanese corporate numbers (法人番号) and qualified invoice registration numbers (登録番号). Zero dependencies, no network."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.9"
+authors = [{ name = "Daichodo", email = "dev@daichodo.com" }]
+keywords = ["法人番号", "適格請求書", "インボイス", "japan", "corporate-number", "invoice", "validation"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Natural Language :: Japanese",
+    "Programming Language :: Python :: 3",
+    "Topic :: Office/Business :: Financial :: Accounting",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://daichodo.com"
+Source = "https://github.com/daichodo/daichodo-python"
+Issues = "https://github.com/daichodo/daichodo-python/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/daichodo_validate"]

daichodo_validate-0.1.0/src/daichodo_validate/__init__.py

@@ -0,0 +1,125 @@
+"""Validate Japanese corporate numbers (法人番号) and qualified invoice
+registration numbers (登録番号).
+
+Zero dependencies, no network, no API key. The check-digit rules come from the
+National Tax Agency's published specification, so this needs no service behind
+it — which is why it is given away.
+
+It tells you whether a number is **well-formed**, not whether it is
+**registered**. For that you need a lookup: https://daichodo.com
+
+This is a copy of the implementation the Daichodo API runs, not a
+reimplementation. Both assert against the same `check-digit-vectors.json`, so
+the two cannot drift apart without a test failing on one side or the other.
+"""
+from __future__ import annotations
+
+import re
+from dataclasses import dataclass
+
+CORPORATE_NUMBER = re.compile(r"^\d{13}$")
+REGISTRATION_NUMBER = re.compile(r"^T\d{13}$")
+
+
+@dataclass(frozen=True)
+class ValidationResult:
+    value: str
+    valid: bool
+    reason: str | None = None
+    corporate_number: str | None = None
+
+    def as_dict(self) -> dict:
+        return {
+            "value": self.value,
+            "valid": self.valid,
+            "reason": self.reason,
+            "corporate_number": self.corporate_number,
+        }
+
+
+def check_digit(base: str) -> int:
+    """Compute the 法人番号 check digit for a 12-digit base.
+
+    Per the NTA specification:
+
+        検査用数字 = 9 - (Σ(n=1..12) Pn × Qn) mod 9
+
+    where `Pn` is the nth digit counting from the RIGHT of the 12-digit body,
+    and `Qn` is 1 for odd n and 2 for even n.
+
+    The right-to-left ordering is the part that is easy to get backwards, and a
+    reversed implementation still produces a plausible digit for roughly one
+    number in nine — so it passes casual testing and fails in production.
+    """
+    if len(base) != 12 or not base.isdigit():
+        raise ValueError("check digit is computed over exactly 12 digits")
+
+    total = sum(
+        int(digit) * (2 if (index + 1) % 2 == 0 else 1)
+        for index, digit in enumerate(reversed(base))
+    )
+    return 9 - (total % 9)
+
+
+def validate_corporate_number(value: str) -> ValidationResult:
+    """Validate a 13-digit 法人番号, including its check digit."""
+    cleaned = _clean(value)
+
+    if not CORPORATE_NUMBER.match(cleaned):
+        return ValidationResult(value, False, "must be exactly 13 digits")
+
+    expected = check_digit(cleaned[1:])
+    if int(cleaned[0]) != expected:
+        return ValidationResult(
+            value, False, f"check digit is {cleaned[0]}, expected {expected}"
+        )
+
+    return ValidationResult(value, True, corporate_number=cleaned)
+
+
+def validate_registration_number(value: str) -> ValidationResult:
+    """Validate a 適格請求書発行事業者 登録番号 (`T` + 13 digits).
+
+    For corporations the 13 digits are the 法人番号, so the check digit applies.
+    Individuals are assigned a number that is not derived from a 法人番号 and
+    carries no verifiable check digit — format is all that can be asserted, and
+    claiming otherwise would reject roughly half the register.
+    """
+    cleaned = _clean(value).upper()
+
+    if not REGISTRATION_NUMBER.match(cleaned):
+        return ValidationResult(value, False, "must be 'T' followed by 13 digits")
+
+    body = cleaned[1:]
+    expected = check_digit(body[1:])
+    if int(body[0]) == expected:
+        return ValidationResult(value, True, corporate_number=body)
+
+    # Format-valid but not a corporate number. Sole traders live here, so this
+    # is not an error — only an absence of a corporate number to join on.
+    return ValidationResult(value, True, reason="not derived from a 法人番号")
+
+
+def _clean(value: str) -> str:
+    """Strip the separators people paste from invoices and spreadsheets."""
+    return re.sub(r"[\s\-‐－ー―]", "", value.strip())
+
+
+__all__ = [
+    "ValidationResult",
+    "check_digit",
+    "validate_corporate_number",
+    "validate_registration_number",
+    "is_valid",
+]
+
+
+def is_valid(value: str) -> bool:
+    """True if the value is a well-formed number of either kind."""
+    cleaned = _clean(value).upper()
+    checker = (
+        validate_registration_number
+        if cleaned.startswith("T")
+        else validate_corporate_number
+    )
+    return checker(value).valid