{"id":23765792,"url":"https://github.com/solidusio-contrib/solidus_tax_cloud","last_synced_at":"2025-09-05T09:33:01.758Z","repository":{"id":52416365,"uuid":"80756158","full_name":"solidusio-contrib/solidus_tax_cloud","owner":"solidusio-contrib","description":"A Solidus extension for US sales tax calculation via TaxCloud.","archived":false,"fork":false,"pushed_at":"2024-05-17T17:19:29.000Z","size":2477,"stargazers_count":8,"open_issues_count":7,"forks_count":11,"subscribers_count":12,"default_branch":"master","last_synced_at":"2024-12-20T14:33:04.212Z","etag":null,"topics":["ecommerce","extension","solidus","tax-calculator","taxcloud"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/solidusio-contrib.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":"2017-02-02T18:37:09.000Z","updated_at":"2024-10-29T01:16:10.000Z","dependencies_parsed_at":"2022-09-03T03:00:55.209Z","dependency_job_id":null,"html_url":"https://github.com/solidusio-contrib/solidus_tax_cloud","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/solidusio-contrib%2Fsolidus_tax_cloud","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solidusio-contrib%2Fsolidus_tax_cloud/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solidusio-contrib%2Fsolidus_tax_cloud/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solidusio-contrib%2Fsolidus_tax_cloud/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/solidusio-contrib","download_url":"https://codeload.github.com/solidusio-contrib/solidus_tax_cloud/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":232034909,"owners_count":18463362,"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":["ecommerce","extension","solidus","tax-calculator","taxcloud"],"created_at":"2024-12-31T23:17:44.858Z","updated_at":"2024-12-31T23:17:45.465Z","avatar_url":"https://github.com/solidusio-contrib.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Solidus::TaxCloud \n\n[![CircleCI](https://circleci.com/gh/solidusio-contrib/solidus_tax_cloud.svg?style=svg)](https://circleci.com/gh/solidusio-contrib/solidus_tax_cloud)\n\nSolidus::TaxCloud is a US sales tax extension for Solidus using the Tax Cloud service.\n\n## Installation\n\n### Set up your TaxCloud account\n\nIf you don't have TaxCloud credentials, now is the time to create them. Sign up for a\n[TaxCloud](https://taxcloud.com) account and note your API ID and API key.\n\nOnce you have the credentials, go to Your Account -\u003e Tax States in the TaxCloud dashboard and turn\non sales tax collection for the states where you wish to collect sales tax.\n\n### Set up Solidus::TaxCloud\n\nOnce you have an account, add this extension to your Gemfile:\n\n```ruby\ngem 'solidus_tax_cloud'\n```\n\nInstall the gem:\n\n```console\n$ bundle install\n```\n\nRun the installer:\n\n```console\n$ bundle exec rails g solidus_tax_cloud:install\n```\n\nConfigure the extension with your TaxCloud credentials:\n\n```ruby\nTaxCloud.configure do |config|\n  config.api_login_id = 'YOUR_TAX_CLOUD_API_ID'\n  config.api_key = 'YOUR_TAX_CLOUD_API_KEY'\nend\n```\n\nFinally, go to the Solidus backend and create a tax rate in order to apply rates obtained from\nTaxCloud to your line items and shipments. You can use the following configuration:\n\n- Name: Sales Tax\n- Zone: USA\n- Rate: 0.0 (because the actual rates will be applied by the calculator)\n- Tax Category: Taxable\n- Included in Price: no\n- Show Rate in Label: no\n- Calculator: Tax Cloud\n\nIf you wish, you may also configure the default Product TIC and Shipping TIC for TaxCloud to use in\nSettings -\u003e Store -\u003e TaxCloud Settings. It is recommended to leave the defaults (`00000` for\nproducts and `11010` for shipping) unless you know what you're doing.\n\n## Usage\n\nProduct-level TICs may be specified in the Products section of the Solidus backend. If you are\nuncertain about the correct TIC for a product, you can get the TIC from\n[TaxCloud](https://taxcloud.com/tic).\n\nOther than that, everything should work automatically! Sales tax rates will be retrieved from\nTaxCloud and applied to your orders.\n\n### Gotchas\n\nHere are a few things to keep in mind:\n\n- Solidus::TaxCloud is designed to function in a single TaxCategory. It is expected that all\n  products and shipping methods are in the same tax category as the one configured for the TaxCloud\n  tax rate.\n- Solidus::TaxCloud is designed to perform all US-related tax calculation itself, and does not use\n  Solidus configurations like tax categories to determine whether goods are taxable, tax-exempt etc.\n- Solidus::TaxCloud does not use the Solidus configuration `tax_address` (which specifies whether\n  the shipping or billing address should be used to compute tax). Instead, it _always_ uses the\n  shipping address if possible, only falling back to the billing address if the shipping address is\n  `nil`.\n\n## Testing\n\nFirst bundle your dependencies, then run `bin/rake`. `bin/rake` will default to building the dummy\napp if it does not exist, then it will run specs. The dummy app can be regenerated by using\n`bin/rake extension:test_app`.\n\n```shell\nbundle\nbin/rake\n```\n\nTo run [Rubocop](https://github.com/bbatsov/rubocop) static code analysis run\n\n```shell\nbundle exec rubocop\n```\n\nWhen testing your application's integration with this extension you may use its factories.\nSimply add this require statement to your spec_helper:\n\n```ruby\nrequire '\u003c%= file_name %\u003e/factories'\n```\n\n## Sandbox app\n\nTo run this extension in a sandboxed Solidus application, you can run `bin/sandbox`. The path for\nthe sandbox app is `./sandbox` and `bin/rails` will forward any Rails command to\n`sandbox/bin/rails`. Here's an example:\n\n```shell\n$ bin/rails server\n=\u003e Booting Puma\n=\u003e Rails 6.0.2.1 application starting in development\n* Listening on tcp://127.0.0.1:3000\nUse Ctrl-C to stop\n```\n\n## Releasing\n\nNew extension versions can be released using `gem-release` like this:\n\n```shell\nbundle exec gem bump -v VERSION --tag --push --remote upstream \u0026\u0026 gem release\n```\n\nCopyright (c) 2012 Jerrold Thompson, released under the New BSD License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolidusio-contrib%2Fsolidus_tax_cloud","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsolidusio-contrib%2Fsolidus_tax_cloud","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolidusio-contrib%2Fsolidus_tax_cloud/lists"}