{"id":18916752,"url":"https://github.com/kufu/kirico","last_synced_at":"2025-04-04T11:12:03.915Z","repository":{"id":37405702,"uuid":"77221722","full_name":"kufu/kirico","owner":"kufu","description":"A Ruby implementation of 届書作成プログラム","archived":false,"fork":false,"pushed_at":"2024-10-29T01:48:20.000Z","size":334,"stargazers_count":39,"open_issues_count":0,"forks_count":20,"subscribers_count":76,"default_branch":"master","last_synced_at":"2025-03-28T10:06:25.016Z","etag":null,"topics":["ruby"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kufu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-12-23T11:37:15.000Z","updated_at":"2025-01-25T15:42:22.000Z","dependencies_parsed_at":"2024-06-21T18:34:33.112Z","dependency_job_id":"5294a2f9-68d8-4d41-9a0d-0721d34680db","html_url":"https://github.com/kufu/kirico","commit_stats":{"total_commits":187,"total_committers":15,"mean_commits":"12.466666666666667","dds":0.5294117647058824,"last_synced_commit":"ea2e9891f9a0e1d01b831497094ee5d7172f87fb"},"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kufu%2Fkirico","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kufu%2Fkirico/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kufu%2Fkirico/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kufu%2Fkirico/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kufu","download_url":"https://codeload.github.com/kufu/kirico/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247166168,"owners_count":20894654,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ruby"],"created_at":"2024-11-08T10:21:46.529Z","updated_at":"2025-04-04T11:12:03.893Z","avatar_url":"https://github.com/kufu.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg width=\"300\" alt=\"kirico-logo\" src=\"https://cloud.githubusercontent.com/assets/2214179/22500174/267fa8a8-e8a6-11e6-905f-fc79a049afab.png\"\u003e\n\n# kirico [ ![](https://img.shields.io/gem/v/kirico.svg)](https://rubygems.org/gems/kirico) [ ![](https://img.shields.io/gem/dt/kirico.svg)](https://rubygems.org/gems/kirico)\n\n[![CircleCI](https://circleci.com/gh/kufu/kirico.svg?style=svg)](https://circleci.com/gh/kufu/kirico)\n\nA Ruby implementation of 届書作成プログラム\n\n## 理念\n\n2008 年より[電子政府（e-Gov）のウェブサイト](https://shinsei.e-gov.go.jp/)上で社会保険・労働保険関連手続きの電子申請の受付が開始されました。\n2010 年には e-Gov の使い勝手の向上を図り、一括申請機能の提供が開始されました。\nそして 2014 年 10 月、さらなる利便性の向上を目的に、外部連携 API 仕様が公開されました。\n\nこれまで様々な取組が行われてきた一方で、確定申告などで利用される国税の電子申告（e-Tax）と比べるとまだまだ普及度が低いのが実情です。\nまた、一部の電子申請では年金機構の公開する「届書作成プログラム」を利用して CSV ファイルを生成する必要があり、一般利用者、ソフトウェア開発者共に負担となるものでした。\n\nわたしたちは kirico の開発・公開によって CSV 形式の電子申請への対応を容易にすることで e-Gov 外部連携 API に対応したソフトウェアが増えることを期待します。\nそして、電子政府の認知度の向上、利用率の向上、及び利用の拡大に貢献し、もってユーザの利便性の向上を目指します。\n\n\n## インストール\n\nGemfile に追記して:\n\n```ruby\ngem 'kirico'\n```\n\nbundle コマンドを実行します:\n\n```bash\n$ bundle\n```\n\nもしくは、直接インストール:\n\n```bash\n$ gem install kirico\n```\n\n## 使い方\n\n\n\u003cimg width=\"500\" alt=\"data structure\" src=\"https://cloud.githubusercontent.com/assets/2214179/23646339/c7f056b6-0353-11e7-9632-b1aeb0ed3458.png\"\u003e\n\n_データ構造: 仕様書 p.6-2 より_\n\n\n**FD 管理レコード**\n\n```ruby\nrequire 'kirico'\nrequire 'i18n'\nI18n.locale = :ja\n\n# FD 管理レコード\nfd = Kirico::FDManagementRecord.new do |rec|\n  rec.prefecture_code = '21'\n  rec.area_code = '03'\n  rec.office_code = 'ｷﾘｺ'\n  rec.fd_seq_number = '001'\n  rec.created_at = Date.new(2017, 1, 1)\nend\n\nfd.valid? #=\u003e true\n\nfd.office_code = 'ほげ'\nfd.valid? #=\u003e false\nfd.errors #=\u003e 略\n```\n\n**事業所情報**\n\n```ruby\nrequire 'kirico'\nrequire 'i18n'\nI18n.locale = :ja\n\n# 事業所情報\ncompany = Kirico::Company.new do |rec|\n  rec.prefecture_code = '21'\n  rec.area_code = '03'\n  rec.office_code = 'ｷﾘｺ'\n  rec.office_number = '1234'\n  rec.zip_code1 = '123'\n  rec.zip_code2 = '4567'\n  rec.address = '東京都世田谷区上馬0-0-0'\n  rec.name = '株式会社印度カレー'\n  rec.owner_name = '内藤　キリコ'\n  rec.tel_area_code = '03'\n  rec.tel_city_code = '0000'\n  rec.tel_subscriber_number = '0000'\nend\n\ncompany.valid? #=\u003e true\n\ncompany.name = '株式会社印度咖喱'\ncompany.valid? #=\u003e false\ncompany.errors #=\u003e 略\n```\n\n**データレコード（住所変更届）**\n\n```ruby\nrequire 'kirico'\nrequire 'i18n'\nI18n.locale = :ja\n\n# 住所変更届データレコード\naddress_record = Kirico::DataRecord22187041.new do |rec|\n  rec.area_code = '03'\n  rec.office_code = 'ｷﾘｺ'\n  rec.ip_code = '100'\n  rec.basic_pension_number1 = '1234'\n  rec.basic_pension_number2 = '567890'\n  rec.birth_at = Date.new(1984, 7, 23)\n  rec.zip_code1 = '123'\n  rec.zip_code2 = '4567'\n  rec.new_address_yomi = 'ﾄｳｷｮｳﾄｼﾌﾞﾔｸｻｸﾗｶﾞｵｶ'\n  rec.new_address = '東京都渋谷区桜丘'\n  rec.updated_at = Date.new(2017, 3, 7)\n  rec.ip_name_yomi = 'ﾀﾅｶ ﾀﾛｳ'\n  rec.ip_name = '田中　太郎'\n  rec.old_address_yomi = 'ﾄｳｷｮｳﾄｵｵﾀｸｳﾉｷ'\n  rec.old_address = '東京都大田区鵜の木'\n  rec.memo = 'メモメモ'\nend\n\naddress_record.valid? #=\u003e true\n\naddress_record.ip_name_yomi = 'タナカタロウ'\naddress_record.valid? #=\u003e false\naddress_record.errors #=\u003e 略\n```\n\n**CSV 生成用フォーム**\n\n```ruby\nrequire 'kirico'\nrequire 'i18n'\nI18n.locale = :ja\n\n# FD 管理用レコード\nfd = Kirico::FDManagementRecord.new do |rec|\n  rec.area_code = '03'\n  # ...\nend\n\ncompany = Kirico::Company.new do |rec|\n  rec.area_code = '03'\n  # ...\nend\n\naddress_record = Kirico::ChangingAddressRecord.new do |rec|\n  rec.area_code = '03'\n  # ...\nend\n\nform = Kirico::Form.new(fd: fd, company: company, records: [address_record])\nform.valid? #=\u003e true\n\n# CSV ファイルの生成\nFile.open(Kirico::Form::FILE_NAME, 'w') do |f|\n  f.puts(form.to_csv)\nend\n```\n\n\n## 生成した CSV の検証\n\n日本年金機構の公開している検証プログラムで生成した CSV ファイルを検証することもできます。\n※動作には Windows 環境が必要となります\n\n\u003cimg width=\"400\" alt=\"kirico-logo\" src=\"https://cloud.githubusercontent.com/assets/2214179/23650706/609ed1e6-0366-11e7-92d9-625354982b9f.png\"\u003e\n\n検証プログラムのダウンロードはこちらから。\n[電子申請を利用中の方へ｜日本年金機構](https://www.nenkin.go.jp/denshibenri/program/download.html)\n\n\n## 対応手続き\n\n|  データレコード | クラス名 | 実装状況 |\n|  ------ | ------ | ------ |\n|  資格取得届データレコード | Kirico::DataRecord22007041 | △ |\n|  資格喪失届データレコード | Kirico::DataRecord22017041 | △ |\n|  住所変更届データレコード | Kirico::DataRecord22187041 | ◯ |\n|  算定基礎届データレコード | Kirico::DataRecord2225700 | ◯ |\n|  月額変更届データレコード | Kirico::DataRecord2221700 | ◯ |\n|  賞与支払届データレコード | Kirico::DataRecord2265700 | ◯ |\n|  被扶養者（異動）届データレコード | Kirico::DataRecord22027051 | △ |\n|  3号関係届（資格取得）データレコード | Kirico::DataRecord52805011 | △ |\n|  3号関係届（資格喪失）データレコード | Kirico::DataRecord52805021 | △ |\n|  3号関係届（死亡）データレコード | Kirico::DataRecord52805031 | △ |\n|  国民年金第3号被保険者\u003cbr\u003e被扶養配偶者非該当届データレコード | Kirico::DataRecord52811001 | △ |\n\n\n※実装状況について\n\n- ◯: 実装、テスト済み\n- △: 実装予定\n\n## 参考リンク\n\n- [電子申請を利用中の方へ｜日本年金機構](https://www.nenkin.go.jp/denshibenri/program/download.html)\n    届書作成プログラム仕様について\n\n## Contributing\n\n1. Fork it ( https://github.com/kufu/kirico/fork )\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create a new Pull Request\n\n## Code of Conduct\n\nEveryone interacting in the kirico project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/kufu/kirico/blob/master/CODE_OF_CONDUCT.md).\n\n\n## Copyright\n\nCopyright (c) 2023 SmartHR, Inc.\nライセンスはこちら: [kirico/LICENSE.md](https://github.com/kufu/kirico/blob/master/LICENSE.md)\n\n\n# SmartHR について\n\n\u003cimg src=\"https://user-images.githubusercontent.com/2214179/30309095-3fb58b08-97c4-11e7-939b-b4b97414bb1d.png\" width=\"300\"\u003e\n\nkirico は株式会社 SmartHR によってメンテナンス、開発が行われています。\nわたしたちは OSS の力を信じています。\n\nSmartHR では OSS 活動に積極的なエンジニアを募集しています！\n\n[「雇用」×「国のAPI」をハックする Ruby エンジニア募集！](https://www.wantedly.com/projects/3788)\n\n\n# kirico について\n\n切子（kirico）とは江戸時代末期より生産されている伝統的なガラス細工です。\n中でも薩摩切子は薩摩藩御用達の工芸品であり、多くの大名に珍重されてきました。\n色付きの厚いガラスを被せ文様を彫るため、薄く繊細な江戸切子と比較すると、重厚な印象が特徴的です。\n幕末の動乱の中で生産設備に壊滅的な被害を受け、その技術は一時途絶えていましたが、\n近年、各地の職人の努力により復刻に成功しました。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkufu%2Fkirico","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkufu%2Fkirico","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkufu%2Fkirico/lists"}