{"id":19813882,"url":"https://github.com/strzibny/ruby-ares","last_synced_at":"2025-05-01T10:31:06.685Z","repository":{"id":5760629,"uuid":"6973585","full_name":"strzibny/ruby-ares","owner":"strzibny","description":"Gem for accesing business information from ARES database","archived":false,"fork":false,"pushed_at":"2023-05-19T05:50:37.000Z","size":29,"stargazers_count":4,"open_issues_count":2,"forks_count":11,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-10-31T13:54:56.247Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/strzibny.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-12-02T23:11:06.000Z","updated_at":"2019-10-02T09:09:10.000Z","dependencies_parsed_at":"2022-09-06T02:52:18.857Z","dependency_job_id":null,"html_url":"https://github.com/strzibny/ruby-ares","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/strzibny%2Fruby-ares","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/strzibny%2Fruby-ares/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/strzibny%2Fruby-ares/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/strzibny%2Fruby-ares/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/strzibny","download_url":"https://codeload.github.com/strzibny/ruby-ares/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224251643,"owners_count":17280814,"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":[],"created_at":"2024-11-12T09:37:33.731Z","updated_at":"2024-11-12T09:37:34.701Z","avatar_url":"https://github.com/strzibny.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ruby-ares\n\nGem for accesing business information from ARES database.\n\nARES is the Czech business database maintained by Ministry of Finance of the Czech Republic.\nThis gem helps to retrieve data provided by this database. Currently ruby-ares supports only retrieval of basic information and addresses for business contacts by IČ (Czech business contact identification number).\n\n## Installation and Requirements\n\nInstall the gem and require it:\n```\n$ gem install ruby-ares\n```\n```ruby\nrequire 'ruby-ares'\n```\n\nThis will need libxml2 (with header files) installed. On Fedora:\n\n```\nsu -c 'yum install libxml2-devel'\n```\n\n### Gained information\n\n* ICO / Company number\n* DIC / VAT number\n* Company name\n* Company state\n* Addresses\n* Legal form / Legal form ARES id\n* Case reference (where company is registered)\n\n## Usage\n\nTo get an ARES subjet/party by IČ:\n```ruby\nsubject = RubyARES::Subject.get(27074358)\n```\nAnd then:\n```ruby\nsubject =\u003e #\u003cRubyARES::Subject:0x00000002502470 @ico=”27074358”, @ic=”27074358”, @dic=”CZ27074358”, @name=”Asseco Central Europe, a.s.”, @company=nil, @status=”Aktivní”, @addresses=[#\u003cRubyARES::Address:0x000000025026f0 @id=”200015797”, @street=”Budějovická”, @postcode=”14000”, @city=”Praha”, @city_part=”Michle”, @house_number=”778”, @house_number_type=”1”, @orientational_number=”3a”\u003e], @updated_at=nil, @legal_form=”Akciová společnost”, @legal_form_id=”121”, @case_reference=#\u003cRubyARES::CaseReference:0x00000001e386f8 @place=”Městský soud v Praze”, @section=”B”, @insert=”8525”\u003e\u003e\nsubject.name =\u003e “Asseco Central Europe, a.s.”\nsubject.ic =\u003e “27074358”\nsubject.address =\u003e #\u003cRubyARES::Address:0x000000025026f0 @id=”200015797”, @street=”Budějovická”, @postcode=”14000”, @city=”Praha”, @city_part=”Michle”, @house_number=”778”, @house_number_type=”1”, @orientational_number=”3a”\u003e\nsubject.address.to_str =\u003e “Budějovická 3a/778\\n14000 Praha\\nMichle\\n”\nsubject.case_reference =\u003e #\u003cRubyARES::CaseReference:0x00000001e386f8 @place=”Městský soud v Praze”, @section=”B”, @insert=”8525”\u003e\nsubject.case_reference.to_str =\u003e “Městský soud v Praze B 8525”\n```\n\n### Exceptions\n\nruby-ares will raise either `RubyARES::Parser::ARESDatabaseError` or `RubyARES::Parser::ParseError` if the ARES database responds with an error or the XML doesn't contain the information you are looking for.\n\nIf the connection to the ARES database can't be established ruby-ares raises `RubyARES::HTTP::ConnectionError`.\n\n## License\n\nruby-ares is written and maintained by [Josef Strzibny](http://strzibny.name).\n\nSee LICENSE file.\n\n## Contributors\n\nContributions are welcome!\n\nHere are the list of current contributors:\n\n- Jindřich Skupa\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstrzibny%2Fruby-ares","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstrzibny%2Fruby-ares","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstrzibny%2Fruby-ares/lists"}