Menu principal

Documentation

Modules Colissimo pour Magento

Prérequis

Magento

  • Magento supérieure ou égale à la version 2.0 (2.0+, 2.1+, 2.2+) pour les versions CE et EE
  • Pour la livraison en point de retrait, tunnel classique de Magento 2
  • REST API pour l'intégration des points de retrait sur n'importe quelle plateforme

Note : La livraison en point de retrait n'est pas encore disponible pour une commande passée depuis l'administration

PHP

  • Version de PHP comprise entre 5.6 et 7.1
  • Extension SOAP (php-soap) pour la livraison en point de retrait et l'impression des étiquettes depuis Magento

Configuration

L'activation du mode de livraison Colissimo s'effectue depuis le menu : Stores > Configuration > Sales > Shipping Methods > Colissimo

Général

  • Enabled : activer les méthodes d'expédition Colissimo
  • Title : titre de la méthode
  • Sort Order : position de la méthode dans le tunnel de commande
  • Show Method if Not Applicable : afficher la méthode Colissimo même si elle ne peut s'appliquer à l'adresse de livraison du client
  • Displayed Error Message : Message affichée si la méthode ne peut s'appliquer à l'adresse de livraison du client

Méthodes de livraison

Activez les méthodes de livraison Colissimo souhaitées :

  • Domicile sans signature
  • Domicile avec signature
  • Point de retrait
  • Expert International
  • Dom-Tom sans signature
  • Dom-Tom avec signature

Paramètres :

  • Enabled : activer la méthode
  • Name : nom de la méthode
  • Price : prix de la méthode (montant / pays / poids (de) / poids (à). Pour un tarif unique, laissez vide les champs "poids (de)" et "poids (à)"
  • Ship to Specific Countries : pays activés pour la méthode
  • * Insurance Ad Valorem : Appliquer l'assurance Ad Valorem à l'expédition

* Uniquement si le module d'impression des étiquettes depuis Magento est activé

Uniquement en point de retrait :

  • Account : Identifiant du compte Colissimo
  • Password : Mot de passe du compte Colissimo
  • Google Map API Key : clé d'API Google pour affichage de la carte. Générer une clé.
  • Open pickup list on shipping method selection : Ouvrir directement la liste des points de retrait au clic sur la méthode de livraison. Dans le cas contraire, affichage de la liste sur le bouton "Continuer"

Configuration du prix

Pour une tarification au forfait, la configuration sera par exemple :

PrixPaysPoids (de)Poids (à)
5.90France

Pour une tarification par poids, la configuration sera par exemple :

PrixPaysPoids (de)Poids (à)
5.38France250
5.98France250500
6.70France500750
7.26France7501000
8.06France1000

Impression des étiquettes depuis Magento

Configuration

Pour l'édition de l'étiquette les paramètres natifs suivants doivent être configurés :

Store > Configuration > Sales > Shipping settings > Origin

Remplir l'ensemble des champs (lieu où sont entreprosés les produits vendus).

Store > Configuration > General > General > Store information

  • Store name : le nom commercial de la boutique
  • Store phone number : numéro de téléphone de la boutique

La configuration des paramètres d'impression s'effectue depuis le menu :

Store > Configuration > Sales > Shipping settings > Colissimo Label

  • Account : identifiant du compte La Poste
  • Password : mot de passe du compte La Poste
  • Commercial name : nom commercial du compte (nom de la boutique)
  • Site name : libellé du site de prise en charge des colis La Poste
  • Site number : identifiant du site de prise en charge des colis La Poste
  • Label Size : taille de l'étiquette (PDF A4 300dpi ou PDF 10x15 300dpi)
  • Label Path : dossier d'enregistrement des étiquettes sur le serveur
  • Delete label after : supprimer les étiquettes de la base de données X jour(s) après génération. Cette configuration permet de ne pas alourdir inutillement la base avec des données obsolètes.

Génération et impression des étiquettes

L'étiquette est générée au moment de l'expédition de la commande.

Sur la vue de création d'expédition de la commande, sélectionnez la case "Créer l'étiquette" (si vous omettez de cocher la case, l'étiquette pourra être générée utlérieurement).

Créer l'étiquette Colissimo

Dans la fenêtre suivante, sélectionner les produits à ajouter au colis. Vous ne pouvez créer qu'un seul colis pour une même expédition. Le poids est automatiquement récupérer à partir de l'attribut "poids" des produits. Vous pouvez manuellement ajuster la valeur, pour prendre par exemple en compte le poids de l'emballage. Sélectionnez ou non l'assurance Ad Valorem. Les autres champs (longueur, largeur, profondeur) ne sont pas utilisés.

Ajouter un colis

Note : le poids du colis peut être saisi en kilo-gramme (kgs) ou en Livre (lbs)

L'expédition est alors créée, le numéro de colis est automatiquement associé et transmis au client.

Pour finir, vous pouvez imprimer l'étiquette depuis la grille des commandes, en sélectionnant les commandes concernées, puis en sélectionnant l'action "Imprimer les étiquettes".

Si la commande contient déjà une expédition, vous pouvez générer ou re-générer une étiquette depuis la vue expédition de la commande.

Impression du bordereau de remise

Le bordereau de remise est à remettre à La Poste en même temps que les colis. Il contient l'ensemble des colis à distribuer.

Pour générer le bordereau de remise, accédez à la page des expéditions :

Sales > Shipments

Sélectionnez les expéditions concernées, puis sélectionnez l'action : Print Shipping Deposit (Colissimo)


Impression des étiquettes avec Expeditor Inet / Coliship

Menus

L'export des commandes s'effectue depuis le menu : Sales > Expeditor Inet > Export

L'import des numéros de tracking s'effectue depuis le menu : Sales > Expeditor Inet > Import

Export des commandes vers Expeditor Inet

Les exports vers le logiciel Expeditor Inet s'effectuent depuis l'interface d'administration.

Le fichier généré est un fichier plat au format txt. Il s'agit du fichier de base interprété par Expeditor Inet.

Il n'est pas nécessaire de définir un format de fichier d'importation de données dans le logiciel (Fichier FMT).

Depuis Expeditor Inet, Sélectionnez Colis > Importer, puis importez manuellement le fichier préalablement téléchargé. Cette action engendrera l'impression des étiquettes pour l'ensemble des commandes.

Impression des étiquettes avec Expeditor Inet

Note : dans le cas d'une livraison en point de retrait, l'adresse de facturation est exportée au lieu de l'adresse de livraison.

Import de Expeditor Inet vers Magento (numéros de suivi)

Une fois les commandes exportées depuis Magento vers Expeditor Inet, il est possible d'importer les numéros de suivi.

Pour cela, depuis le logiciel, sélectionnez "Exporter". Seules 2 colonnes sont à sélectionner : "NumeroColis" et "ReferenceExpedition". Le champ "ReferenceExpedition" correspond au numéro de commande Magento.

Renseignez ensuite les options suivantes :

  • avec ligne entête
  • Délimité
  • Séparateur ; (point-virgule)
  • Délimiteur " (guillemets)
Exporter depuis Expeditor Inet

Le fichier généré est un CSV contenant 2 colonnes. Par exemple :

"NumeroColis";"ReferenceExpedition";
"6H00000000192";"100000005";
"CI000000076FR";"100000006";
"6H00000000185";"100000007";

L'import du fichier généré dans Magento s'effectue depuis le menu : Sales > Expeditor Inet > Import


API

List of REST APIs

GET    /V1/colissimo/:pickupId/:networkCode
GET    /V1/colissimo/:cartId
GET    /V1/colissimo/order/:orderId
GET    /V1/colissimo
PUT    /V1/colissimo/:cartId/:pickupId/:networkCode
DELETE /V1/colissimo/:cartId

SOAP

colissimoShippingPickupRepositoryV1

  • getList

Récupérer la liste des points de retrait selon les critères de recherche :

['searchCriteria' =>
    ['filterGroups' =>
        [
            ['filters' =>
                [
                    [
                        'field' => 'street',
                        'value' => 'Champs-Élysées',
                    ],
                    [
                        'field' => 'city',
                        'value' => 'Paris',
                    ],
                    [
                        'field' => 'postcode',
                        'value' => '75008',
                    ],
                    [
                        'field' => 'country',
                        'value' => 'FR',
                    ],
                ]
            ]
        ]
    ]
]
  • get

Récupérer les données d'un point de retrait selon son identifiant et son code réseau :

[
    'pickupId'    => '598320',
    'networkCode' => 'R01'
]
  • save

Associer le point de retrait à la quote :

[
    'cartId'      => 1,
    'pickupId'    => '598320',
    'networkCode' => 'R01'
]
  • current

Récupérer le point de retrait associé à la quote :

[
    'cartId' => 1
]
  • reset

Supprimer le point de retrait associé à la quote :

[
    'cartId' => 1
]
  • shippingData

Récupérer les données de la livraison : code produit, identifiant du point de retrait et code réseau

[
    'orderId' => 1
]

Exemples (SOAP)

$request = new SoapClient(
    "http://website.magento2.com/index.php/soap/?wsdl&services=colissimoShippingPickupRepositoryV1",
    ["soap_version" => SOAP_1_2]
);

/* Load pickup data */
$token = $request->ColissimoShippingPickupRepositoryV1Get(
    [
        'pickupId'    => '598320',
        'networkCode' => 'R01'
    ]
);

/* Retrieve list of pickup */
$token = $request->ColissimoShippingPickupRepositoryV1GetList(
    ['searchCriteria' =>
        ['filterGroups' =>
            [
                ['filters' =>
                    [
                        [
                            'field' => 'street',
                            'value' => 'Champs-Élysées',
                        ],
                        [
                            'field' => 'city',
                            'value' => 'Paris',
                        ],
                        [
                            'field' => 'postcode',
                            'value' => '75008',
                        ],
                        [
                            'field' => 'country',
                            'value' => 'FR',
                        ],
                    ]
                ]
            ]
        ]
    ]
);

/* Save pickup for quote */
$token = $request->ColissimoShippingPickupRepositoryV1Save(
    [
        'cartId'      => 1,
        'pickupId'    => '598320',
        'networkCode' => 'R01'
    ]
);

/* Retrieve current selected pickup for quote */
$token = $request->ColissimoShippingPickupRepositoryV1Current(
    [
        'cartId' => 1,
    ]
);

/* Delete selected pickup for quote */
$token = $request->ColissimoShippingPickupRepositoryV1Reset(
    [
        'cartId' => 1,
    ]
);

/* Retrieve Shipping Data */
$token = $request->ColissimoShippingPickupRepositoryV1ShippingData(
    [
        'orderId' => 1,
    ]
);
La poste
Colissimo
Magento
Magentix
Magentix Magentix © 2009 / 2018 - 38 rue de la blanchisserie - 59450 SIN-LE-NOBLE - SIRET : 80529846000033