Colissimo Labels, Pickup Points & Tracking changelog
All notable changes to Colissimo Labels, Pickup Points & Tracking for CS-Cart and Multi-Vendor (kv_colissimo) are documented here.
The format follows Keep a Changelog and the project uses Semantic Versioning.
[Unreleased]
Section titled “[Unreleased]”[1.0.0] - 2026-11-07
Section titled “[1.0.0] - 2026-11-07”- Initial release: integration with the Colissimo (La Poste) web services. The shipping web service SLS (REST:
generateLabel,checkGenerateLabel,getLabel), the pickup point web service (findRDVPointRetraitAcheminement,findPointRetraitAcheminementByID), the pickup point widget V2 (token fromauthenticate.rest) and the timeline tracking web service. The OpenAPI, WADL and WSDL files of the services are saved in the tests and every request is validated against them. - Shipping services Home delivery without signature (DOM), with signature (DOS) and Pickup point (HD); Overseas France gets COM / CDS and
ftdby itself. Each is a shipping method with the merchant’s own price (flat or by weight), free-shipping threshold, countries and weight limit (never above 30 kg). - Label creation from the order page or at an order status: recipient with accents removed and the documented limits (company 35, last name 35, first name 29, lines 35, city 35), weight in kg, sender from the Connection page, optional insured value and package size, deposit date in the Paris time zone; labels in PDF (10x15, A4) or ZPL (203 / 300 dpi) stored with the order and never resized; parcel number, tracking link with the real number and an optional CS-Cart shipment.
- Check only mode: every request goes to
checkGenerateLabeland nothing is created (Colissimo has no sandbox); live mode creates labels. - Record-before-call idempotency: the request is saved before it is sent, runs under a per-order lock and uses a deterministic
orderNumber(O<order>-<row>). A timeout or server error is an unknown result and is never repeated automatically; the merchant adopts the parcel number from the Colissimo Box (checked with tracking, code 101 refused, label fetched again withgetLabel) or confirms that nothing was created. Authentication errors (30000, 30013, pickup 201, tracking 202/401/403) are never retried and pause the automatic calls of the account (one hour after 30013, until the next save/test otherwise). - CN23 values converted to euros with the CS-Cart currency rate (amount / EUR coefficient); customs declaration for Andorra and the EU special tax territories (Canary Islands, Ceuta, Melilla, Mount Athos, Aland, Heligoland, Busingen, Livigno, Campione); notification language mapped from the destination country.
- CN23 customs declaration for Overseas France and countries outside metropolitan France and the European Union: articles from the order lines with net values in euros (both CS-Cart tax calculation methods through
OrderTax), HS code from an “HS code” product feature or a default, country of origin, nature of the shipment, EORI, euro conversion, at most 100 articles, optional unique label (label and CN23 on one page); the CN23 PDF is stored with the label. - Pickup point choice at the checkout with the Colissimo widget in an isolated frame (own jQuery 3.6 and Mapbox GL 2.6.1, token fetched on the server by AJAX) and a built-in list when there is no application key or the widget cannot load; the point is looked up again by identifier on the server (country, closed, weight) before it is saved with the order. Mobile number and e-mail address are required for pickup point parcels.
- Return labels (Colissimo Return France, CORE) with the same protection, optionally with the label link e-mailed by Colissimo to the customer (
returnTypeSendPDFLinkByMail). - Timeline tracking by cron: steps 0 to 5 mapped to created, in transit and delivered, events with places and times on the order, about every 5 hours for open parcels, every 12 hours until day 10, then daily, never for delivered parcels, stop after 60 days.
- Job queue with retries and back-off, cron (command line and secret address), log with CSV export, encrypted credentials, connection check.
- Vendor rules for Multi-Vendor: marketplace owner mode or one account per vendor; in owner mode vendors cannot create, cancel or re-queue labels or jobs on the owner’s contract; queue-wide actions are for administrators only.
- License client and upgrade synchronizer.
- Honest limits: no cancel operation (cancellation is local; an unscanned label is not invoiced), no price operation (your own rate table), no cash on delivery, DDP, hand-over slip or international returns in this version.