エクアドルRUCチェックディジット
1710034065001は有効です。州コード17の個人で、10桁目のチェックディジットは5、事業所番号は001です。第3桁から正しい計算方法を選び、検出した納税者の種類も示します。ブラウザで無料で使えます。
- 無料
- ブラウザで動作
- 登録不要
- データは端末の外に出ません
無料で実行
計算例
- Ruc
- 1710034065001
- 種類
- natural_person
- 種類の名称
- Natural person (persona natural)
- 3桁目
- 1
- 州コード
- 17
エクアドルのRUC（Registro Único de Contribuyentes）は、Servicio de Rentas Internasが自然人・民間会社・公的機関に発行する13桁の税務識別子です。先頭2桁は州コード、第3桁は納税者区分を選び、その区分に応じて重み付きチェックディジットが第9位または第10位に置かれ、末尾ブロックは事業所または支店コードです。本機能は純粋な13桁RUCを第3桁で振り分けて検証します。0から5はcédulaと共通の自然人向けmodulo-10規則、6は公的機関のmodulo-11重み、9は民間会社のmodulo-11重みを使います。応答には、保存されたチェックディジットが再計算値と一致するか、検出されたタイプ、州コード、事業所ブロック、期待チェックディジット（存在する場合）が含まれます。どちらの経路も同じ純粋な算術を共有し、ネットワーク往復もSRI登録簿照会もありません。
エクアドルRUCのタイプとチェックディジットの仕組み
整形されたRUCは句読点を除くと常に13個の十進数字です。位置1と2は州コードで、国内管轄では01から24、エクアドルに登録された外国人居住者では30でなければなりません。位置3は法的区分と算術の両方を選ぶタイプ判別子です。
0から5は自然人（persona natural）を示し、cédula形式の本体に従う特別制度も含みます。6は公的機関（sector público）、9は民間会社（sociedad privada）を示します。7と8は予約され有効なタイプコードではないため、本ツールは重み付き合計の前に拒否します。
自然人では先頭10桁が国民ID（cédula）と一致し、チェックディジットは係数2-1の繰り返しによるmodulo-10で位置10です。積が9以上なら9を減らし（桁和）、合計をmodulo-10し、チェックは10からその余りを引いた値、余りが既に0なら0です。
民間会社でもチェックは位置10ですが、重みは先頭9桁に対して4,3,2,7,6,5,4,3,2で、合計のmodulo-11の余りが0なら0、それ以外は11から余りを引きます。写像値が10なら単一の十進チェックディジットは存在せず番号は有効になり得ません。
公的機関ではチェックは位置9、重みは先頭8桁に3,2,7,6,5,4,3,2で、同じmodulo-11写像が適用されます。チェックの後、自然人と民間のRUCは1から999の3桁事業所コード（本社は通常001）を持ち、公的機関は1から9999の4桁支店ブロックを持ちます。
各ステップが固定重みのモジュラー算術であるため、同じ13桁はブラウザ・Worker・オフラインハーネスのいずれでも同じ妥当性判定を生みます。だからこそ本機能はモデル呼出やライブSRI照会ではなく、ティアAのparseエンジンとして提供されます。
RUC検証が実際のプロダクトワークフローに合う場面
エクアドルのフィンテックやマーケットプレイスのオンボーディングは早い段階でRUCを求めます。フォーカス喪失時にチェックディジットとタイプを検証すれば、キー入力ごとにSRIを呼ばずに送信失敗とサポート票を減らせます。
電子証憑（comprobantes electrónicos）を発行する会計・電子請求システムは、チェックが一致しなくなった行や事業所ブロックがすべてゼロの行を、文書が認可に達する前に隔離すべきです。どのワークフローでも契約は同じです。
合格したチェックディジットを、納税者がSRIに存在する・RUCが有効・事業所が請求発行を認可されている証拠とみなさないでください。それは13桁文字列が公式のタイプ依存規則の下で算術的に整形式であることの証明にすぎず、任意の税IDチェックサムツールに適用するのと同じ誠実さの基準です。
活用例
電子請求エクスポートのRUC列を監査する
売上または源泉CSVの各RUCを一括検証し、チェックディジットが再計算値と一致しない行、または第3桁が予約コードの行を隔離してください。
よくある質問
エクアドルRUCのチェックディジットとは何ですか？
13桁RUC内の検証桁で、先頭本体から第3桁に依存する重みで計算されます。自然人（0–5）はmodulo-10、公的機関（6）と民間会社（9）はmodulo-11です。
第3桁は何を意味しますか？
0–5は自然人（位置10でmodulo-10チェック）、6は公的機関（位置9でmodulo-11）、9は民間会社（位置10でmodulo-11）です。
文字・ハイフン・桁数誤り・不正な州コードではどうなりますか？
失敗した検証タスクは課金されません。呼び出し前にクライアントで書式を取り除いてください。
有効なRUCなら納税者として登録されていますか？
いいえ。番号の形とチェックディジットが正しいかを計算するだけで、税務当局SRIの登録簿は照会しません。番号が実際に発行され、今も有効かどうかは判断できません。
個人のRUCとセドゥラは同じですか？
個人の場合、RUCの最初の10桁はチェックディジットを含めて身分証明番号のセドゥラと同じで、最後の3桁が001のような事業所番号です。そのため、どちらも同じモジュロ10の規則を使います。
関連ツール
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/enc/ruc-ecuador \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"ruc":"1710034065001"}'const res = await fetch("https://api.kit.forhosting.com/enc/ruc-ecuador", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"ruc": "1710034065001"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/ruc-ecuador",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"ruc": "1710034065001"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/ruc-ecuador", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"ruc":"1710034065001"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"ruc":"1710034065001"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/ruc-ecuador", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"ruc": "1710034065001"
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.ruc_ecuador",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。
料金
単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。
エラー
| HTTP | コード | 意味 |
|---|---|---|
401 | unauthorized | APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。 |
402 | insufficient_balance | 残高が不足しています。チャージ後に再度お試しください。 |
404 | unknown_type | 指定されたタスクタイプは存在しません。タイプ名を確認してください。 |
429 | rate_limited | リクエストが多すぎます。しばらく待ってから再度お試しください。 |
技術的な注記
非数字文字、誤った桁数、無効な州コード、予約された第3桁は明確なinvalid_inputエラーで拒否されます。ブラウザで無料実行するかKIT APIを呼び出してください。
このAPIでRUCを検証する方法
フォームが黙って掃除された値を受け入れないように、呼び出し前にクライアントで書式マスクを取り除いてください。validがtrueになるのはチェックディジットが一致し、事業所ブロックがそのタイプで許可される非ゼロ範囲にある場合だけです。空文字、欠落したruc、13以外の長さ、01–24と30の外の州コード、第3桁の7または8は重み付き合計の前に失敗し、課金されません。エクアドル固有のタイプ報告と公式のmodulo-10 / modulo-11二重ルーティングが必要なときは本機能を選んでください。汎用の多国税ID形式チェッカーはSRI第3桁分岐や事業所規則を適用しません。0から9の文字だけを含み、ちょうど13桁のrucフィールドを送ってください。空白・点・ハイフン・文字・小数点は非数値入力としてinvalid_inputで拒否されます。成功時、エンジンは正規化された数字列としてのruc、真偽値のvalid、natural_person / public_entity / private_companyのいずれかとしてのtype、短い説明のtype_label、third_digit、province_code、modulo_10またはmodulo_11としてのalgorithm、check_position（9または10）、送信どおりのcheck_digit、十進桁が計算できた場合のexpected_check_digit、末尾支店ブロックのestablishment、length 13、algorithm_id ruc_ecuadorを返します。誤ったチェックでもvalid falseの構造化ペイロードが返るので、2回目の要求なしに「期待X、実際Y」を表示できます。時計・乱数源・ネットワークのない純粋なparse経路のため、同じ入力は無料ブラウザツールとAPIで常に同じJSONになります。成功リクエストあたり$0.002で、CRM一括取込、電子請求ゲート、パートナーファイル監査を、専用ティア交渉なしで守れます。
RUC検証が実際のプロダクトワークフローに合う場面
独立請負者の給与・人事取込は、保存をvalid trueにゲートし、type_labelを表示して番号が自然人・民間会社・公的機関のどれかを運用者に示せます。データ品質ジョブはERPエクスポートの各RUC列でexpected_check_digitを再計算し、税務報告や源泉ファイルに届く前に不一致をフラグします。
連携の活用例
登録とKYCフォームを有効なRUCでゲートする
顧客が13桁RUCを入力したら、フォーカス喪失時に検証し、validがfalseならtype_labelとexpected_check_digitを示し、チェックディジットと事業所ブロックが通るまで先へ進ませないでください。
ワークフロー振分け前に納税者タイプを分類する
返却されたtypeフィールド（natural_person、private_company、public_entity）を使い、別の登録簿呼出なしに帳票テンプレート・源泉率・承認経路を選んでください。
技術的な質問
このAPIでRUCを検証するにはどうしますか？
rucをちょうど13桁（0-9のみ）に設定してPOSTしてください。応答にはvalid、type、type_label、check_digit、利用可能な場合のexpected_check_digit、province_code、establishment、algorithmが含まれます。
エクアドルRUCチェックディジットツールは無料ですか？
ブラウザツールは無料でローカル実行されます。API呼出は公開された基本価格$0.002の前払いKIT残高を使い、無効入力は課金されません。