https://github.com/akretion/laposte_api
https://github.com/akretion/laposte_api
Last synced: 9 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/akretion/laposte_api
- Owner: akretion
- License: agpl-3.0
- Created: 2014-06-03T22:38:04.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2024-11-16T13:53:22.000Z (over 1 year ago)
- Last Synced: 2025-07-29T05:51:37.340Z (11 months ago)
- Language: Python
- Size: 3.32 MB
- Stars: 4
- Watchers: 16
- Forks: 4
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
laposte_api
===========
'laposte_api' is a library for Python to generate label for Laposte (France), transportation services
This library allow to produce ZPL files used to print parcel label with Zebra printers
The available services are:
- Colissimo
* Colissimo France
* Colissimo International with web service.
- So Colissimo
#Motivation
The first objective of this code is to provide to applications
ZPL files generation?
The first application in which it is used is Odoo / OpenERP.
#Installation
The easiest way to install laposte_api:
pip install git+https://github.com/akretion/laposte_api.git
#Usage
#Example for Colissimo transportation service in France
from laposte_api.colissimo_and_so import (
ColiPoste,
InvalidDataForMako)
from laposte_api.exception_helper import (
InvalidWeight,
InvalidSize,
InvalidMissingField,
InvalidCode,
InvalidZipCode,
InvalidCountry,
InvalidKeyInTemplate,
InvalidType)
# example datas : update with demo datas in ColiPoste specs
product = 'colissimo'
label_code = '9V'
account = '766666'
parcel_weight = 5
def get_sequence(label_code):
""" Sequence must be unique and set only once
Range numbers are defined by La Poste
Define your OWN method
"""
return '9V 00000 00006' #example
try:
service = ColiPoste(account).get_service(product, label_code)
except (InvalidSize, InvalidCode, InvalidType, Exception) as e:
raise
tracking_ref = service.get_cab_suivi(get_sequence(label_code))
sender = {
'city': u'Paris', 'account': account, 'name': u'My Company',
'zip': u'75001', 'phone': u'01 99 99 99 99', 'country': u'France',
'support_city': u'MOISSY PFC', 'street': u'1 rue Clignacourt',
'email': u'info@mycompany.com'}
address = {
'city': u'Lyon', 'name': u'Jim NHASTIC', 'zip': u'69001',
'countryCode': u'FR', 'street': u'150 rue Vauban'}
infos = {
'zip': address['zip'],
'countryCode': address['countryCode'],
'weight': parcel_weight,
'carrier_track': tracking_ref,
}
option = {'ftd': False, 'ar': False, 'nm': True, 'insurance': u'03'}
infos.update(option)
try:
prise_en_charge_barcode = service.get_cab_prise_en_charge(infos)
except (InvalidWeight, Exception) as e:
raise
delivery = {
'weight': parcel_weight, 'date': '22/06/2014',
'ref_client': u'OUT/00033', 'Instructions': '',
'cab_suivi': tracking_ref,
'cab_prise_en_charge': prise_en_charge_barcode,
}
try:
# sender, delivery, address and option are dict contains datas
# used to generate label in ZPL format (Zebra Programming Language)
label_file = service.get_label(
sender, delivery, address, option)
# you can send these datas to your zebra printer
except (InvalidDataForMako,
InvalidKeyInTemplate,
InvalidKeyInTemplate,
InvalidMissingField) as e:
raise
print "VOICI L'ETIQUETTE ZPL POUR COLISSIMO France:\n"
print "=========================================\n\n\n", label_file
#Specification
see doc folder
#Copyright and License
laposte_api is copyright (c) 2014 David Béal
licence : GNU Affero General Public License