Spree Elta Courier
This is an Elta Courier extension for Spree Commerce, an open‑source e-commerce platform built with Ruby on Rails. It adds the ability to manage Elta Courier vouchers.
Installation
-
Add this extension to your Gemfile with this line:
bundle add spree_elta_courier
-
Restart your server
Usage (Creating & Printing Vouchers)
Prerequisites for an order:
- Shipping and billing addresses present
- Payment completed
- Order state: ready (so shipments exist and are ready to ship)
Workflow:
- Open the order in Spree Admin.
- If the order meets the prerequisites, the “Create Voucher” option appears in the top‑right dropdown.
- Click “Create Voucher” (creates one voucher per shipment or split shipment).
- After successful creation, the “Print Voucher” option becomes available.
- Click “Print Voucher”: a merged (or single) PDF opens in a new tab for download/printing.
Notes:
- Multiple shipment vouchers are merged into one PDF.
- If no voucher can be created (e.g. order not ready), the button does not appear.
- Errors will return and log details server‑side.
Developing
-
Create a dummy app
bundle update bundle exec rake test_app -
Add your new code
-
Run tests
bundle exec rspec
When testing your applications integration with this extension you may use it's factories. Simply add this require statement to your spec_helper:
require 'spree_elta_courier/factories'Releasing a new version
bundle exec gem bump -p -t
bundle exec gem releaseFor more options please see gem-release README
Contributing
If you'd like to contribute, please take a look at the instructions for installing dependencies and crafting a good pull request.
Copyright (c) 2025 OlympusOne, released under the AGPL-3.0 or later.