MossGenerator

Generate CSV-formatted string from specified data to be able to create a MOSS (Mini One Stop Shop) file for Skatteverket.

Installation

Add this line to your application's Gemfile:

gem 'moss_generator'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install moss_generator

Usage

Stripe

# charges - array of charges in json-format from stripe
# vat_number - the company's vat number
# period - for which period of the year this report should be for
# year - corresponding year for the period
MossGenerator::Stripe.call(charges, vat_number, period, year)

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.

Vat Rates

* Current Vat rates fetched at 2021/01/11
* Vat rates in spec file from 2021/01/11

Vat rates currently needs to be updated manually in config/vat_rates.json. VatLayer has a nice API one could use (100 requests for free each month) to make this process automatic. Until then, do a request through their api and copy JSON-response to file and remove status from response.

Rates can also be found on the official website of the European Union https://europa.eu/youreurope/business/taxation/vat/vat-rules-rates/index_en.htm#shortcut-8, updates two times a year.

Custom VAT rates

If standard VAT rates is not enough a custom VAT service can be written and used instead. To create a VAT service that change VAT for a country with a standard VAT rates fallback this one could be used.

class CustomVat
# Insane 50.5% VAT for France
  def for(country_code)
    return 50.5 if country_code == 'FR'

    MossGenerator::VatRate.for(country_code)
  end
end

csv_string = MossGenerator::Stripe.call(charges, vat_number, period, year, rates, 'SERVICES', CustomVat.new)

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/standout/moss_generator.

License

The gem is available as open source under the terms of the MIT License.