Magentix - blog Magento

Les rapports de ventes disponibles sous Magento permettent de récolter un certain nombre d'informations sur une période donnée, par jour, mois ou année. Ils ne fournissent cependant pas de données détaillées sur les commandes passées. Les tableaux générés restent assez synthétiques (Nombre de commandes, total facturé, total réglé...).

L'idée est donc de développer un module (OrdersExport) capable de générer un fichier CSV et de récolter, ligne par ligne, l'ensemble des informations disponibles pour une commande, afin de les exploiter par la suite sur un ERP par exemple.

Le fichier CSV pourra contenir :

Le fichier est généré manuellement depuis la page du listing des commandes. Il est ainsi possible de filtrer les commandes que l'on souhaite récupérer (période, statut, numéros de commande...).

Le module de base utilisé pour le développement de cette extension est Manual order export, anciennement disponible sur Magento Connect.

L'extension est compatible avec les versions 1.3.X de Magento.

Architecture du module

• app/code/local/Magentix/OrdersExport/Block/
• SalesOrderGrid.php
• app/code/local/Magentix/OrdersExport/controllers/
• SalesOrderController.php
• app/code/local/Magentix/OrdersExport/etc/
• config.xml
• app/code/local/Magentix/OrdersExport/Helper/
• Data.php
• app/code/local/Magentix/OrdersExport/Model/
• SalesOrder.php
• app/locale/fr_FR/
• Magentix_OrdersExport.csv
• app/etc/modules/
• Magentix_OrdersExport.xml

Détails du module

Pour plus de souplesse, la mise en forme du CSV se configure depuis le fichier de configuration config.xml :

app/code/local/Magentix/OrdersExport/etc/config.xml

<!-- ... -->
<default>
    <ordersexport>
        <csv>
            <delimiter>[[blue]];[[/blue]]</delimiter>
            <enclose>[[blue]]"[[/blue]]</enclose>
            <mapping>
                <order_increment_id>[[blue]]Order number[[/blue]]</order_increment_id>
                <order_created_at>[[blue]]Order created at[[/blue]]</order_created_at>
                <invoice_increment_id>[[blue]]Invoice number[[/blue]]</invoice_increment_id>
                <invoice_created_at>[[blue]]Invoice created at[[/blue]]</invoice_created_at>
                <shipment_increment_id>[[blue]]Shipment number[[/blue]]</shipment_increment_id>
                <shipment_created_at>[[blue]]Shipment created at[[/blue]]</shipment_created_at>
                <creditmemo_increment_id>[[blue]]Credit memo number[[/blue]]</creditmemo_increment_id>
                <creditmemo_created_at>[[blue]]Credit memo created at[[/blue]]</creditmemo_created_at>
                <customer_name>[[blue]]Customer name[[/blue]]</customer_name>
                <customer_increment_id>[[blue]]Customer number[[/blue]]</customer_increment_id>
                <products_ordered>[[blue]]Products ordered[[/blue]]</products_ordered>
                <products_delivered>[[blue]]Products delivered[[/blue]]</products_delivered>
                <order_subtotal>[[blue]]Subtotal[[/blue]]</order_subtotal>
                <order_tax_amount>[[blue]]Tax[[/blue]]</order_tax_amount>
                <order_shipping_amount>[[blue]]Shipping[[/blue]]</order_shipping_amount>
                <order_discount_amount>[[blue]]Discount[[/blue]]</order_discount_amount>
                <order_grand_total>[[blue]]Total[[/blue]]</order_grand_total>
                <order_total_refunded>[[blue]]Refunded[[/blue]]</order_total_refunded>
                <order_payment_method>[[blue]]Payment method[[/blue]]</order_payment_method>
                <order_status>[[blue]]Status[[/blue]]</order_status>
            </mapping>
        </csv>
    </ordersexport>
</default>
<!-- ... -->

On définit ici les séparateurs de champs et de texte souhaités, les informations à récupérer et l'ordre des colonnes.

L'intitulé des colonnes peut être modifié depuis le fichier de langue Magentix_OrdersExport.csv :

app/locale/fr_FR/Magentix_OrdersExport.csv

"Order number","Commande"
"Order created at","Date commande"
"Invoice number","Facture"
"Invoice created at","Date facture"
"Shipment number","Expedition"
"Shipment created at","Date expedition"
"Credit memo number","Remboursement"
"Credit memo created at","Date remboursement"
"Customer name","Client"
"Customer number","Numero client"
"Products ordered","Produits commandes"
"Products delivered","Produits livres"
"Subtotal","Sous total HT"
"Tax","Taxe"
"Shipping","Frais de port"
"Discount","Remise"
"Refunded","Rembourse"
"Total","Total TTC"
"Payment method","Reglement"
"Status","Statut"

Le module surcharge le bloc Mage_Adminhtml_Block_Sales_Order_Grid. Il peut donc entraîner un conflit avec un autre module installé (ex : Fia-Net).

Les fichiers CSV générés sont stockés dans le dossier /var/export. Un lien de téléchargement est affiché suite à l'export :

• Télécharger l'extension OrdersExport