Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jmaupetit/satchmo-colissimo


https://github.com/jmaupetit/satchmo-colissimo

Last synced: 15 days ago
JSON representation

Awesome Lists containing this project

README

        

# Satchmo-Colissimo

**satchmo-colissimo** is a custom shipping module for [satchmo](http://www.satchmoproject.com/) [django](https://www.djangoproject.com/) e-commerce solution.

## Dependancies

Considering you have a properly configured (and working) satchmo project. The only required dependancy is the [django-colissimo](https://github.com/matm/django-colissimo) module up-to-date with LaPoste Colissimo shipping rates. For more informations on how to update django-colissimo to `youryear` rates, please refer to the project page.

Most of the time, a simple:

pip install django-colissimo

will do the trick. If pip does not found the module on PyPI, use the
github repository

pip install git+git://github.com/matm/django-colissimo

## Installation

### Configure django-colissimo

Once dependancies installed, edit your satchmo project `settings.py` and add `colissimo` to your `INSTALLED_APPS`, *e.g.*:

INSTALLED_APPS = (
...
'colissimo',
)

Now you need to create `colissimo` database scheme with

python manage.py syncdb

This will also load colissimo rates in the db. If not, fetch initial data:

mkdir data
wget https://raw.github.com/matm/django-colissimo/master/colissimo/fixtures/initial_data.json \
-O data/colissimo_initial_data.json
python manage.py loaddata data/colissimo_initial_data.json

Now you need to install satchmo-colissimo from github, either by cloning the project of using pip.

### Clone the module from github

git clone git://github.com/jmaupetit/satchmo-colissimo
cd satchmo-colissimo
python setup.py install

### Use pip

pip install git+git://github.com/jmaupetit/satchmo-colissimo

### Activate satchmo-colissimo

To activate your custom shipping module, add `satchmo_colissimo` to your `CUSTOM_SHIPPING_MODULES` list, *e.g.*:

SATCHMO_SETTINGS = {
....
'CUSTOM_SHIPPING_MODULES':['satchmo_colissimo'],
}

Now go to your site settings (once logged in the django admin): in development mode it would be something like `http://127.0.0.1:8000/settings/`. Click on `Shipping settings` and select `Colissimo` as an activated shipping module. Then, `update settings` and a new configuration section will appear for [Colissimo shipping module](https://github.com/jmaupetit/satchmo-colissimo).

## Changelog

* Initial release based on the django-colissimo module
* Applies colissimo rates given a package weight, destination and recommanded level

## Roadmap

* Complete support of 'So Colissimo' WS (multiple delivery modes, tracking number, shipping label, etc.)