IMI 法人種別名の抽出コンポーネント imi-enrichment-hojin ES

入力となる JSON-LD に含まれる ID>識別値をもつ法人型 に対して各種のプロパティを補完して返す、IMI 法人種別名の抽出コンポーネントをforkしたESモジュールです。

API (web / Deno)

モジュール imi-enrichment-hojin は以下のような API の関数を提供します。

import IMIEnrichmentHojin from "https://code4sabae.github.io/imi-enrichment-hojin-es/IMIEnrichmentHojin.mjs";

console.log(await IMIEnrichmentHojin("4000012090001"));

toplevel await 非対応のブラウザでは、async関数内で使用してください。

input.json

{
  "@type": "法人型",
  "ID" : {
    "@type": "ID型",
    "識別値" : "4000012090001"
  }
}

output.json

{
  "@type": "法人型",
  "組織種別": {
    "@type": "コード型",
    "コード種別": {
      "@type": "コードリスト型",
      "表記": "法人種別"
    },
    "識別値": "101",
    "表記": "国の機関"
  },
  "ID": {
    "@type": "ID型",
    "体系": {
      "@type": "ID体系型",
      "表記": "法人番号"
    },
    "識別値": "4000012090001"
  },
  "表記": "経済産業省",
  "名称": {
    "@type": "名称型",
    "表記": "経済産業省",
    "ローマ字表記": "Ministry of Economy, Trade and Industry",
    "カナ表記": "ケイザイサンギョウショウ"
  },
  "住所": [
    {
      "@type": "住所型",
      "種別": "国内所在地",
      "表記": "東京都 千代田区 霞が関１丁目３－１",
      "郵便番号": "1000013",
      "都道府県": "東京都",
      "都道府県コード": "http://data.e-stat.go.jp/lod/sac/C13000",
      "市区町村": "千代田区",
      "市区町村コード": "http://data.e-stat.go.jp/lod/sac/C13101"
    },
    {
      "@type": "住所型",
      "種別": "国内所在地(英語表記)",
      "表記": "1-3-1, Kasumigaseki, Chiyoda ku, Tokyo",
      "都道府県": "Tokyo"
    }
  ]
}

補完される情報は国税庁法人番号公表サイトで公開されている情報を 法人型 にマッピングしたものとなります
データソースは国税庁法人番号公表サイト・基本3情報をダウンロードしたものです
本パッケージに添付されているデータは令和2年6月5日更新のものになります（元パッケージは、令和元年12月27日更新）
所与の法人番号に問題がある場合には メタデータ プロパティにメッセージが記述されます

output_with_error.json

{
  "@context": "https://imi.go.jp/ns/core/context.jsonld",
  "@type": "法人型",
  "ID": {
    "@type": "ID型",
    "体系": {
      "@type": "ID体系型",
      "表記": "法人番号"
    },
    "識別値": "2876543210987"
  },
  "メタデータ": {
    "@type": "文書型",
    "説明": "該当する法人番号がありません"
  }
}

以下のエラーが検出されます

法人番号が 13桁の数字でない場合
法人番号の先頭が 2～9 でない場合
法人番号のチェックデジットが不正な場合
指定された法人番号が存在しない場合

インストール

以下の手順でインストールしローカルでも使用できます。（全法人番号をダウンロードするため重いので注意！）

$ github clone https://github.com/code4sabae/imi-enrichment-hojin-es.git

データ生成

国税庁法人番号公表サイト・全件データのダウンロード（各都道府県別）から CSV 形式・Unicode をダウンロードする download.mjs と、makedata.sh を使って data ファルダ内のCSVファイルを生成します。（1時間ほどかかります）生成後、tempフォルダは削除して構いません。

$ cd tools
$ deno run -A download.mjs
$ sh makedata.sh

テスト

以下の手順でテストを実行します

$ deno test -A *.mjs

依存モジュール

util.mjs (decodeCSV)
https://github.com/taisukef/util

出典

本ライブラリは IMI 情報共有基盤コンポーネントツール https://info.gbiz.go.jp/tools/imi_tools/ の「IMI 法人種別名の抽出コンポーネント」をESモジュール対応したものです。

国税庁法人番号を使った経産省発、法人種別名の抽出コンポーネントのESモジュール版公開
https://fukuno.jig.jp/2870

Deno対応ESモジュール対応、IMIコンポーネントツールx4とDenoバッジ
https://fukuno.jig.jp/2866

日本政府発のJavaScriptライブラリを勝手にweb標準化するプロジェクト、全角-半角統一コンポーネントのESモジュール/Deno対応版公開
https://fukuno.jig.jp/2865

code4sabae/imi-enrichment-hojin-es

IMI 法人種別名の抽出コンポーネント imi-enrichment-hojin ES

API (web / Deno)

インストール

データ生成

テスト

依存モジュール

出典

関連記事