=== France Couriers for WooCommerce ===
Contributors: catcodestudio
Tags: colissimo, mondial relay, chronopost, relais colis, shipping
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
WC requires at least: 7.0
WC tested up to: 11.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Colissimo, Mondial Relay, Chronopost and Relais Colis labels, pickup points on the classic and block checkout, and tracking for shops in France.

== Description ==

Ship with your own contracts from the WooCommerce order screen. No monthly fee to a shipping platform and no labels bought through a reseller: the plugin talks to the couriers directly with your own account details.

**Free**

* Eight delivery methods for your shipping zones: each of the four couriers to the address and to a pickup point.
* Pickup points near the buyer, with distance and opening hours of today, on the classic and the block checkout. The picker shows up only for its own method and never writes into the buyer's address fields.
* Flat price, free from an order amount or with a free-shipping coupon, weight limit, France and Belgium per method.
* A label from the order screen, PDF to print.
* Tracking link in the order, on the account page and in the e-mails. Refresh the status with one click.
* Cancelling a label: through the API at Chronopost, in the shop for the others.
* The PHP SOAP extension is not needed.
* Interface in English and French.

**Pro** (7-day free trial from the settings page)

* Labels created automatically when an order reaches the status you choose.
* Bulk actions in the orders list: create labels and print them all at once.
* Several parcels on one shipment, for delivery to the address.
* Signature on delivery (Colissimo) and insured value (Colissimo, Chronopost).
* Delivery prices per weight.
* Hourly status sync, order notes and automatic completion on delivery.

== Installation ==

1. Install and activate WooCommerce and this plugin.
2. Open WooCommerce → France Couriers, fill in the sender and the account details of the couriers you use, save and check the connection.
3. Add the delivery methods to your shipping zones for France and Belgium in WooCommerce → Settings → Shipping.
4. Open an order and create the label in the France Couriers box.

== Frequently Asked Questions ==

= Do I need a contract with the couriers? =

Yes, with each courier you want to use. The details come from their business accounts: Colissimo Box at La Poste, Mondial Relay Connect, your Chronopost contract, your Relais Colis account.

= Why does Mondial Relay ask for two sets of details? =

Mondial Relay has two services. The brand code and private key list the pickup points and follow parcels. The Connect login, password and customer code create labels.

= Why does Colissimo ask for a mobile number? =

For delivery to a pickup point in France, Colissimo requires the buyer's mobile number and uses it for its SMS notices. The checkout asks for a mobile number when the buyer types another kind of number, and the label shows an error if the number on the order is not a mobile one.

= Can I cancel a label? =

Chronopost takes a label back through its API until the parcel is handed over. The other couriers have no such call: the plugin marks the label cancelled in the shop, and you make a new one. Do not hand the parcel over with the cancelled label.

= Which countries does it ship to? =

France and Belgium. Relais Colis ships to France only through this plugin.

== External services ==

The plugin connects only to the couriers the shop owner sets up, and only for the actions below.

**Colissimo** (ws.colissimo.fr), operated by La Poste.

* At checkout and in the settings: the post code, city, country and when available the street of the buyer are sent to find pickup points. The account details are sent to sign in.
* When the shop creates a label: the buyer's name, address, e-mail address and phone number, the parcel weight and the order number are sent.
* When the status is refreshed: the parcel number and the IP address of the visitor or server making the request are sent, as Colissimo's tracking service asks for it.

Terms: https://www.colissimo.entreprise.laposte.fr/ Privacy: https://www.laposte.fr/politique-de-protection-des-donnees

**Mondial Relay** (api.mondialrelay.com, connect-api.mondialrelay.com), operated by Mondial Relay.

* At checkout and in the settings: the post code and country of the buyer are sent to find pickup points.
* When the shop creates a label: the buyer's name, address, e-mail address and phone number, the parcel weight and the order number are sent. The label PDF is downloaded from Mondial Relay.
* When the status is refreshed: the shipment number is sent.

Terms and privacy: https://www.mondialrelay.fr/

**Chronopost** (ws.chronopost.fr), operated by Chronopost.

* At checkout and in the settings: the post code, city, country and when available the street of the buyer are sent to find pickup points. The account details are sent to sign in.
* When the shop creates or cancels a label: the buyer's name, address, e-mail address and phone number, the parcel weight and the order number are sent; to cancel, the parcel number.
* When the status is refreshed: the parcel number is sent.

Terms and privacy: https://www.chronopost.fr/

**Relais Colis** (ws-modules.relaiscolis.com, service.relaiscolis.com), operated by Relais Colis.

* At checkout and in the settings: the coordinates of the buyer's post code are sent to find pickup points, with the post code itself. The activation key is sent to read the account configuration.
* When the shop creates a label: the buyer's name, address, e-mail address and phone number, the parcel weight and the order number are sent.
* When the status is refreshed: the parcel number is sent.

Terms: https://www.relaiscolis.com/page/mentions-legales Privacy: https://www.relaiscolis.com/page/donnees-personnelles

**Géoplateforme address service** (data.geopf.fr), operated by IGN, the French national mapping agency.

* When pickup points are looked up for a French post code and the courier needs a town or coordinates: only the post code is sent.

Terms: https://geoservices.ign.fr/cgu-licences

The Pro licence check connects to catcode.com.ua and sends the licence key and the site address.

== Changelog ==

= 1.0.0 =
* First version: Colissimo, Mondial Relay, Chronopost and Relais Colis, delivery to the address and to pickup points on the classic and the block checkout, labels, tracking; Pro automatic and bulk labels, several parcels, signature, insurance, prices per weight, hourly status sync.
