Metadata-Version: 2.1
Name: daichodo
Version: 0.1.1
Summary: A client library for accessing Daichodo
Requires-Python: >=3.11
Requires-Dist: httpx<0.29.0,>=0.23.1
Requires-Dist: attrs>=22.2.0
Description-Content-Type: text/markdown

# daichodo

Daichodo API の Python クライアント。適格請求書発行事業者（インボイス）登録番号と
法人番号を照会します。

Python client for the [Daichodo](https://daichodo.com) API — Japanese qualified
invoice issuer (適格請求書発行事業者) and corporate number (法人番号) lookup,
validation, and point-in-time validity.

> **⚠️ APIキーの発行はまだ一般公開されていません。**
> API は `https://api.daichodo.com` で稼働していますが、セルフサービスでの
> APIキー発行は準備中です。ご利用をご希望の場合は
> [daichodo.com](https://daichodo.com) をご確認ください。
>
> **⚠️ API keys are not self-service yet.**
> The API is live at `https://api.daichodo.com`, but the sign-up dashboard is
> still being built, so keys are issued manually. See
> [daichodo.com](https://daichodo.com) to register interest.
>
> **APIキーが不要な検証だけであれば
> [`daichodo-validate`](https://pypi.org/project/daichodo-validate/)
> が今すぐ利用できます。**
> If you only need format and check-digit validation,
> [`daichodo-validate`](https://pypi.org/project/daichodo-validate/) works today
> with no API key.

```bash
pip install daichodo
```

```python
from daichodo import AuthenticatedClient
from daichodo.api.registry import get_invoice_issuer

client = AuthenticatedClient(
    base_url="https://api.daichodo.com",
    token="dc_live_...",
)

issuer = get_invoice_issuer.sync(client=client, registration_number="T1010001153225")
```

## `name` が None でもエラーではありません / `name` is None for sole traders

国税庁は個人事業主の氏名・住所を公表データから除外しています。個人事業主のレコードは
日付を保持したまま**氏名が None** で返ります。`name is None` を「該当なし」と解釈する
のが最も多い誤りで、登録簿の約半数を無言で切り捨てることになります。

The NTA strips identity fields for individuals at source, so a sole trader
returns their dates with **no name**. Treating `name is None` as "not found" is
the most common way to get this wrong, and it silently discards about half the
register.

## 生成コードです / This code is generated

API の OpenAPI スキーマから自動生成され、リリースごとに上書きされます。
プルリクエストは受け付けられません。不具合は
[Issue](https://github.com/daichodo/daichodo-python/issues) でご報告ください。

Generated from the API's OpenAPI schema and overwritten on every release.

## ライセンス / Licence

MIT.
