ForHosting KIT · 開発者向けツール

インドGSTINチェック桁

本体27AAPFU0939F1Zのチェック文字はVで、完全なGSTINは27AAPFU0939F1ZVになります。書類や取り込み用に最後の1文字を求めたり、取引先から届いたGSTINを保存前に確認したりできます。ブラウザで無料で使えます。

  • 無料
  • ブラウザで動作
  • 登録不要
  • データは端末の外に出ません
ご利用方法 ウェブAPIメールTelegramアプリ 近日
入力した場合
数
27AAPFU0939F1Z
結果
計算モード
Compute
入力
27AAPFU0939F1Z
チェック文字
V
チェックディジット付き
27AAPFU0939F1ZV

インドのGSTIN(Goods and Services Tax Identification Number)は、請求書・e-way bill・登録記録で使われる15文字の英数字の税務識別子です。末尾の1文字は先頭14文字から固定の36進重み付け規則で導かれる検査文字であり、1文字や1桁の打ち間違いでも保存前に検証で弾かれることがほとんどです。本機能はその公式スタイルのアルゴリズムを実装します。各文字を0から35のコードポイントに写像し、左から交互の係数1と2を掛け、各積を36での整数除算と剰余で折り畳み、ハッシュを合計し、補数の剰余を0〜9またはA〜Zに戻します。14文字の本体だけがあり、フォームやマスタ取り込み用に末尾の検査文字が必要なときはcomputeモードを、パートナー・ERP・ユーザーが15文字の完全なGSTINを送り、明確なvalidフラグとエラー表示用の期待検査文字が必要なときはvalidateモードをご利用ください。

インドGSTIN検査文字の計算方法

空白や句読点なしで書くと、GSTINは常に15文字です。先頭2桁は州コード、続く10文字は納税者のpermanent account number(PAN)で、おなじみの英字5・数字4・英字1の形です。13文字目は同じPANを共有する事業体を区別し、14文字目は通常の納税者登録では多くの場合Z、15文字目は手で決めてはいけない検査文字です。

検査文字を求めるには先頭14文字だけを取り、0〜9に続けてA〜Zのアルファベットで各文字を変換し、0をコード0、Zをコード35に対応させます。左から順にコードポイントに係数1、2、1、2…を掛けます。各積Pについて、Pを36で割った整数商とPの36剰余を累積和に加えます。

14位置の後、和の36剰余を取り、それを36から引き、再度36剰余で0剰余を検査コード0にし、同じアルファベットで戻します。15文字の完全な列は、まさにその末尾文字を持たねばなりません。アルゴリズムは決定的かつローカルで、GSTポータルへのネットワーク呼び出しも、納税者カタログも、時計も使いません。

本ツールは登録が有効かは照会せず、GSTINを商号に展開せず、有効なチェックサムが特定の税制を意味するとも主張しません。36進の重み付け規則の下で列が整形式であることの証明だけです。多国税ID検証と比べ、検索意図は狭いです。

14文字本体向けのインドGSTINチェック桁計算機を求める人向けであり、一般のVATやEINチェッカーではありません。

入力契約・モード・エラー挙動

小文字は自動で大文字化されます。computeが既定です。validateはちょうど15文字を要求します。

長さ不正はモードと送った長さ(computeは14、validateは15)を明示するエラーなので、クライアントフォームは推測なしで正確なメッセージを出せます。空文字、number欠落、無効なmode、州+PAN形に失敗する本体は、加重和を信頼する前に失敗し、課金されません。

識別子の発行・補完にはcomputeを、ユーザーやパートナーファイルの完全GSTINで照会・取込をゲートするならvalidateを優先してください。

実務フローでのGSTINチェック桁の位置づけ

財務・マスタデータチームは社内の14文字本体を受け取り、税務請求書・e-invoice・無効GSTを拒否するマーケットプレイス出品者プロフィールに書く前に、公式のGSTIN検査文字を付与する必要があります。買掛ポータルは仕入先オンボーディングで15文字GSTINを検証し、1文字の転置だけで幽霊仕入先やリバースチャージ下の支払不一致が生まれないようにします。

データ品質ジョブはCRMやERPエクスポートのGSTIN列をすべてvalidateし、valid falseの行を隔離して、人手の編集も生成器のバグも捕捉します。どのフローでも契約は同じです。GSTIN検査の通過を税務当局での有効登録や特定制度の証明とみなさないでください。

標準の交互重みの下で、base-36検査文字が14文字本体と整合していることの証明にすぎません。

ERP・CRMエクスポートのGSTIN列を監査する

仕入先・顧客ファイルの15文字GSTINを一括検証し、検査文字が再計算した期待値と一致しなくなった行を隔離します。

インドGSTINのチェック桁とは何ですか?

GSTINの15文字目で、先頭14文字に対するbase-36コードポイントと交互係数から計算されます。打ち込み・取込の誤りを、識別子の保存や税務請求書への印字前に多くの場合検出します。

長さ不正・記号・形の誤りではどうなりますか?

検査文字が一致しない完全GSTINはvalid falseです。失敗した検証タスクは課金されません。

GSTINの各部分は何を表していますか?

最初の2桁は州コード、続く10文字は納税者のPAN、その次の1文字は同じPANを持つ事業体の区別、その次は通常Z、最後の1文字がチェック文字です。

計算と確認はどう使い分けますか?

最初の14文字だけがあり最後の1文字が必要なときは計算を、15文字そろったGSTINを受け取って末尾が合っているか知りたいときは確認を使います。

チェック文字が正しければ登録済みの番号ですか?

いいえ。確認できるのは15文字の計算上のつじつまだけです。GSTポータルや納税者の名簿は照会しないため、その事業者が実際に登録されているかは分かりません。

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

POSThttps://api.kit.forhosting.com/enc/gstin-india

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

curl -X POST https://api.kit.forhosting.com/enc/gstin-india \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":"27AAPFU0939F1Z"}'
{
  "number": "27AAPFU0939F1Z"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.gstin_india",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

HTTPコード意味
401unauthorizedAPIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
402insufficient_balance残高が不足しています。チャージ後に再度お試しください。
404unknown_type指定されたタスクタイプは存在しません。タイプ名を確認してください。
429rate_limitedリクエストが多すぎます。しばらく待ってから再度お試しください。

英数字以外、長さ不正、州コード+PANの標準形に合わない本体は黙って切り詰めずinvalid_inputで失敗するため、半端に清浄した税務IDを保存しません。同じ純粋な算術がブラウザ無料版と公開API料金の両方で動作します。

入力契約・モード・エラー挙動

numberフィールドにはA〜Zと0〜9のみを送ってください。空白・ドット・ハイフン・スラッシュその他の記号は非英数字としてinvalid_inputで拒否され、黙って削られた値が保存に届くことはありません。エンジンは標準のGSTIN本体形(州2桁、PANの英字5・数字4・英字1、事業体と既定の末尾2文字)に合うちょうど14文字を要求し、check_characterを1文字、with_checkを印刷・永続化できる15文字GSTINとして返します。末尾が再計算したexpected_check_characterと一致するとvalid trueとなり、payload(先頭14文字)、与えられた検査文字と期待値、length 15を含みます。gstin・code・textなどの別名は同じペイロード欄として受け付けるため、既に「gstin」と呼ぶ連携のリネームは不要です。時計・乱数・ネットワークのないpure parseのため、同じJSON本体は無料ブラウザと成功リクエストあたり$0.002のAPIで常に同じ結果になります。

実務フローでのGSTINチェック桁の位置づけ

EC・B2B登録フォームはexpected_check_characterを再計算し、インド企業が末尾を誤って貼り付けたときに分かりやすい修正を示せます。結合テストは27AAPFU0939F1ZVなどの既知フィクスチャでwith_checkを固定し、請求ライブラリと本APIのずれを防ぎます。

請求用に14文字のGSTIN本体を完成させる

14文字の本体でcomputeモードを呼び、with_checkを保存し、15文字のGSTINをe-invoice・e-way bill・マーケットプレイス出品者プロフィールに渡してください。

入力時に手入力・取込の完全GSTINを検証する

フォームやCSVが15文字を送ったらvalidateモードを呼び、validがfalseのとき保存を止め、expected_check_characterを示して1文字の打ち間違いを直せるようにします。

このAPIでGSTIN検査文字を計算するには?

numberに英数字ちょうど14文字、mode compute(省略可)でPOSTします。応答にcheck_characterとwith_check(15文字の完全GSTIN)が含まれます。

15文字の完全GSTINを検証するには?

15文字の文字列とmode validateでPOSTします。応答にvalid、check_character、expected_check_character、payload(末尾検査を除く文字)が含まれます。

インドGSTINチェック桁ツールは無料ですか?

ブラウザ版は無料でローカル実行です。APIは公開の基本価格$0.002で前払いKIT残高を使い、無効入力は課金されません。

KITの完全なドキュメントを見る →