Merge lp:~chafique-delli/openerp-connector/7.0-magentoerpconnect-map-product into lp:~openerp-connector-core-editors/openerp-connector/7.0

[Chafique DELLI]

When we import the product from Magento and this product already exist in OpenERP (same code/sku) we should link the existing product instead of creating a new one

[Guewen Baconnier @ Camptocamp (gbaconnier-c2c)]

Hi Chafique, you have targeted the wrong branch, can you merge into lp:openerp-connector/7.0-magentoerpconnect instead of lp:openerp-connector please?

review: Needs Resubmitting

[Chafique DELLI (chafique-delli)]

Le 15/08/2013 09:47, Guewen Baconnier @ Camptocamp a écrit :
> Review: Resubmit
>
> Hi Chafique, you have targeted the wrong branch, can you merge into lp:openerp-connector/7.0-magentoerpconnect instead of lp:openerp-connector please?
Hi Guewen, it's done.

--
Chafique DELLI
www.akretion.com/fr
intégration OpenERP
35B rue Montgolfier
69100 Villeurbanne
Email: <email address hidden>

[Nicolas Bessi - Camptocamp (nbessi-c2c-deactivatedaccount)]

Wrong target branch, MP rejected

Regards

Nicolas

Unmerged revisions

884. By Chafique DELLI on 2013-08-13

[IMP]:add mapping on openerp_id for an existing product with the same code

883. By Brendan Clune (Logic Supply) on 2013-06-05

[FIX] Define the partners relationships only on the creation of new records, allowing manual specification of company / contact relationships within OpenERP

882. By Brendan Clune (Logic Supply) on 2013-06-04

[FIX] State information for partners not mapped correctly

881. By Guewen Baconnier @ Camptocamp on 2013-05-15

[ADD] note in installation guide to install ntp

880. By Guewen Baconnier @ Camptocamp on 2013-05-14

[IMP] import batch of sales orders is now delayed in a job and not executed directly, should avoid TransactionRollbackError which seems to happen occasionally on this method (maybe due to the duration of the transaction?)

879. By Guewen Baconnier @ Camptocamp on 2013-05-14

[FIX] remove the transient fields from the result of the sales order mapper, they are used to create extra sales order lines but if they are still there when we create the SO, OpenERP will raise warnings (fields do not exist in magento.sale.order) or even fail to create the SO

878. By Guewen Baconnier @ Camptocamp on 2013-05-10

[FIX] removed unused code

877. By Guewen Baconnier @ Camptocamp on 2013-05-02

[IMP] a round of documentation improvement, see nested history for details

876. By Guewen Baconnier @ Camptocamp on 2013-05-02

[ADD] add the external dependency on the magento package in the manifest

875. By Guewen Baconnier @ Camptocamp on 2013-05-01

[ADD] french translation and empty .pot

=== added file '.bzrignore'
--- .bzrignore	1970-01-01 00:00:00 +0000
+++ .bzrignore	2013-08-13 17:30:12 +0000
@@ -0,0 +1,3 @@
+.project
+.pydevproject
+*/doc/_build/*

=== renamed file '.bzrignore' => '.bzrignore.moved'
=== added directory 'customize_example'
=== added file 'customize_example/__init__.py'
--- customize_example/__init__.py	1970-01-01 00:00:00 +0000
+++ customize_example/__init__.py	2013-08-13 17:30:12 +0000
@@ -0,0 +1,6 @@
+# -*- coding: utf-8 -*-
+
+import connector
+import backend
+import magento_model
+import partner

=== added file 'customize_example/__openerp__.py'
--- customize_example/__openerp__.py	1970-01-01 00:00:00 +0000
+++ customize_example/__openerp__.py	2013-08-13 17:30:12 +0000
@@ -0,0 +1,42 @@
+# -*- coding: utf-8 -*-
+##############################################################################
+#
+#    Author: Guewen Baconnier
+#    Copyright 2013 Camptocamp SA
+#
+#    This program is free software: you can redistribute it and/or modify
+#    it under the terms of the GNU Affero General Public License as
+#    published by the Free Software Foundation, either version 3 of the
+#    License, or (at your option) any later version.
+#
+#    This program is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU Affero General Public License for more details.
+#
+#    You should have received a copy of the GNU Affero General Public License
+#    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+##############################################################################
+
+{'name': 'Magento Connector Customization Example',
+ 'version': '1.0.0',
+ 'category': 'Connector',
+ 'depends': ['magentoerpconnect',
+             ],
+ 'author': 'Camptocamp',
+ 'license': 'AGPL-3',
+ 'description': """
+Magento Connector Customization Example
+=======================================
+
+Example of customizations:
+
+* mappings
+
+""",
+ 'data': [],
+ 'installable': True,
+ 'application': False,
+}
+

=== added file 'customize_example/backend.py'
--- customize_example/backend.py	1970-01-01 00:00:00 +0000
+++ customize_example/backend.py	2013-08-13 17:30:12 +0000
@@ -0,0 +1,6 @@
+# -*- coding: utf-8 -*-
+import openerp.addons.connector.backend as backend
+import openerp.addons.magentoerpconnect.backend as magento_backend
+
+magento_myversion = backend.Backend(parent=magento_backend.magento1700,
+                                    version='1.7-myversion')

=== added file 'customize_example/connector.py'
--- customize_example/connector.py	1970-01-01 00:00:00 +0000
+++ customize_example/connector.py	2013-08-13 17:30:12 +0000
@@ -0,0 +1,31 @@
+# -*- coding: utf-8 -*-
+##############################################################################
+#
+#    Author: Guewen Baconnier
+#    Copyright 2013 Camptocamp SA
+#
+#    This program is free software: you can redistribute it and/or modify
+#    it under the terms of the GNU Affero General Public License as
+#    published by the Free Software Foundation, either version 3 of the
+#    License, or (at your option) any later version.
+#
+#    This program is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU Affero General Public License for more details.
+#
+#    You should have received a copy of the GNU Affero General Public License
+#    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+##############################################################################
+
+from openerp.osv import orm
+
+
+class customize_example_installed(orm.AbstractModel):
+    """Empty model used to know if the module is installed on the
+    database.
+
+    If the model is in the registry, the module is installed.
+    """
+    _name = 'customize_example.installed'

=== added file 'customize_example/magento_model.py'
--- customize_example/magento_model.py	1970-01-01 00:00:00 +0000
+++ customize_example/magento_model.py	2013-08-13 17:30:12 +0000
@@ -0,0 +1,22 @@
+# -*- coding: utf-8 -*-
+from openerp.osv import orm, fields
+
+
+class magento_backend(orm.Model):
+    _inherit = 'magento.backend'
+
+    def _select_versions(self, cr, uid, context=None):
+        """ Available versions
+
+        Can be inherited to add custom versions.
+        """
+        versions = super(magento_backend, self)._select_versions(cr, uid, context=context)
+        versions.append(('1.7-myversion', '1.7 My Version'))
+        return versions
+
+    _columns = {
+        'version': fields.selection(
+            _select_versions,
+            string='Version',
+            required=True),
+        }

=== added file 'customize_example/partner.py'
--- customize_example/partner.py	1970-01-01 00:00:00 +0000
+++ customize_example/partner.py	2013-08-13 17:30:12 +0000
@@ -0,0 +1,40 @@
+# -*- coding: utf-8 -*-
+
+from openerp.osv import orm, fields
+from openerp.addons.connector.unit.mapper import mapping
+from openerp.addons.magentoerpconnect.partner import PartnerImportMapper
+from .backend import magento_myversion
+
+
+class magento_res_partner(orm.Model):
+    _inherit = 'magento.res.partner'
+
+    _columns = {
+        'created_in': fields.char('Created In', readonly=True),
+        }
+
+
+class res_partner(orm.Model):
+    _inherit = 'res.partner'
+
+    _columns = {
+        'gender': fields.selection([('male', 'Male'),
+                                    ('female', 'Female')],
+                                   string='Gender'),
+        }
+
+
+MAGENTO_GENDER = {'123': 'male',
+                  '124': 'female'}
+
+
+@magento_myversion
+class MyPartnerImportMapper(PartnerImportMapper):
+    _model_name = 'magento.res.partner'
+
+    direct = PartnerImportMapper.direct + [('created_in', 'created_in')]
+
+    @mapping
+    def gender(self, record):
+        gender = MAGENTO_GENDER.get(record.get('gender'))
+        return {'gender': gender}

=== added directory 'magentoerpconnect'
=== added file 'magentoerpconnect/CHANGES.rst'
--- magentoerpconnect/CHANGES.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/CHANGES.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,16 @@
+Changelog
+---------
+
+2.0.0
+~~~~~
+
+* First release
+
+
+..
+  Model:
+  2.0.1 (date of release)
+  ~~~~~~~~~~~~~~~~~~~~~~~
+
+  * change 1
+  * change 2

=== added file 'magentoerpconnect/__init__.py'
--- magentoerpconnect/__init__.py	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/__init__.py	2013-08-13 17:30:12 +0000
@@ -0,0 +1,17 @@
+# -*- coding: utf-8 -*-
+import setting
+import connector
+import backend
+
+import magento_model
+import product
+import product_category
+import partner
+import partner_category
+import invoice
+import sale
+import delivery
+import stock_picking
+import stock_tracking
+
+import consumer

=== added file 'magentoerpconnect/__openerp__.py'
--- magentoerpconnect/__openerp__.py	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/__openerp__.py	2013-08-13 17:30:12 +0000
@@ -0,0 +1,138 @@
+# -*- coding: utf-8 -*-
+##############################################################################
+#
+#    Author: Guewen Baconnier
+#    Copyright 2013 Camptocamp SA
+#    Copyright 2013 Akretion
+#
+#    This program is free software: you can redistribute it and/or modify
+#    it under the terms of the GNU Affero General Public License as
+#    published by the Free Software Foundation, either version 3 of the
+#    License, or (at your option) any later version.
+#
+#    This program is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU Affero General Public License for more details.
+#
+#    You should have received a copy of the GNU Affero General Public License
+#    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+##############################################################################
+
+{'name': 'Magento Connector',
+ 'version': '2.0.0',
+ 'category': 'Connector',
+ 'depends': ['account',
+             'product',
+             'delivery',
+             'sale_stock',
+             'connector_ecommerce',
+             'product_m2mcategories',
+             ],
+ 'external_dependencies': {
+     'python': ['magento'],
+ },
+ 'author': 'MagentoERPconnect Core Editors',
+ 'license': 'AGPL-3',
+ 'website': 'https://launchpad.net/magentoerpconnect',
+ 'description': """
+Magento Connector
+=================
+
+This is the new release of the Open-Source connector linking OpenERP and
+Magento also known under the name of **Magentoerpconnect**.  It is
+build on top of the `connector`_ framework. It is is structured so that
+it can be extended or modified easily from separate addons, a factor of
+success when the implementations of Magento vary a lot.
+
+Magento OpenERP Connector is mainly developed by the Magentoerpconnect Core
+Editors, these being Camptocamp_ and Akretion_. The `source is on
+launchpad`_.
+
+This connector is designed to have a strong and efficient core, with the
+ability to extend it with extension modules or local customizations.
+
+In other words, the core module contains the minimal scope to run your
+e-commerce with OpenERP and Magento. More advanced features are
+installable using extensions.
+
+It features:
+
+Synchronizations:
+
+* Import the partners and addresses book
+* Import the customer groups (becomes partner tags)
+* Import the categories of products, with translations
+* Import the products, with translations and main image
+* Import the sales orders
+* Update the the stock quantities,
+  with configuration of the warehouse and stock field to use
+* Export the delivery orders
+* Export the tracking numbers
+* Create the invoices on Magento and get their number back
+* Import the dependencies when they are not yet imported
+  (ie. customer, products for sale order)
+
+Automatizations:
+
+* Use the `Automatic workflows` to automatize the workflow of the sales
+  according to the payment method (confirm orders, create and reconcile
+  payments, ...)
+* Per payment method, choose when the orders are imported
+  (only when a payment is received, always, never)
+* Use the `Sales Exceptions` to prevents the processing of sales orders
+  with issues
+
+Technical points:
+
+* Built on top of the `connector`_ framework
+* Use the `connector_ecommerce`_ addon to share the e-commerce capabilities
+  with other e-commerce addons
+* Use the jobs system of the `connector`_ framework
+* Create `connector`_ checkpoints when new records to verify are imported
+* Support Magento 1.7, the support of earlier versions should be easy to
+  add, the `connector`_ framework being designed to handle multiple
+  versions with ease.
+* Licensed under AGPL version 3
+* Designed to be usable with multiple Magento or any other e-commerce backends
+  in the same time.
+
+Available extensions:
+
+* Pricing
+        allows to manage the prices in OpenERP using pricelists,
+        prices are update to Magento when changed
+* Export of partners (Experimental)
+        Export new partners on Magento, not complete.
+
+
+.. _connector: https://code.launchpad.net/openerp-connector
+.. _connector_ecommerce: https://code.launchpad.net/openerp-connector
+.. _Camptocamp: http://www.camptocamp.com
+.. _Akretion: http://www.akretion.com
+.. _`source is on launchpad`: https://launchpad.net/magentoerpconnect
+
+""",
+ 'images': ['images/magento_backend.png',
+            'images/jobs.png',
+            'images/product_binding.png',
+            'images/invoice_binding.png',
+            'images/magentoerpconnect.png',
+            ],
+ 'demo': [],
+ 'data': ['setting_view.xml',
+          'magentoerpconnect_data.xml',
+          'magento_model_view.xml',
+          'product_view.xml',
+          'partner_view.xml',
+          'sale_view.xml',
+          'invoice_view.xml',
+          'magentoerpconnect_menu.xml',
+          'delivery_view.xml',
+          'stock_view.xml',
+          'security/ir.model.access.csv',
+          ],
+ 'installable': True,
+ 'application': True,
+}

=== added file 'magentoerpconnect/backend.py'
--- magentoerpconnect/backend.py	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/backend.py	2013-08-13 17:30:12 +0000
@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+##############################################################################
+#
+#    Author: Guewen Baconnier
+#    Copyright 2013 Camptocamp SA
+#
+#    This program is free software: you can redistribute it and/or modify
+#    it under the terms of the GNU Affero General Public License as
+#    published by the Free Software Foundation, either version 3 of the
+#    License, or (at your option) any later version.
+#
+#    This program is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU Affero General Public License for more details.
+#
+#    You should have received a copy of the GNU Affero General Public License
+#    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+##############################################################################
+
+import openerp.addons.connector.backend as backend
+
+
+magento = backend.Backend('magento')
+""" Generic Magento Backend """
+
+magento1700 = backend.Backend(parent=magento, version='1.7')
+""" Magento Backend for version 1.7 """

=== added file 'magentoerpconnect/connector.py'
--- magentoerpconnect/connector.py	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/connector.py	2013-08-13 17:30:12 +0000
@@ -0,0 +1,85 @@
+# -*- coding: utf-8 -*-
+##############################################################################
+#
+#    Author: Guewen Baconnier
+#    Copyright 2013 Camptocamp SA
+#
+#    This program is free software: you can redistribute it and/or modify
+#    it under the terms of the GNU Affero General Public License as
+#    published by the Free Software Foundation, either version 3 of the
+#    License, or (at your option) any later version.
+#
+#    This program is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU Affero General Public License for more details.
+#
+#    You should have received a copy of the GNU Affero General Public License
+#    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+##############################################################################
+
+from openerp.osv import orm, fields
+from openerp.addons.connector.connector import Environment
+from openerp.addons.connector.checkpoint import checkpoint
+
+
+class magentoerpconnect_installed(orm.AbstractModel):
+    """Empty model used to know if the module is installed on the
+    database.
+
+    If the model is in the registry, the module is installed.
+    """
+    _name = 'magentoerpconnect.installed'
+
+
+def get_environment(session, model_name, backend_id):
+    """ Create an environment to work with.  """
+    backend_record = session.browse('magento.backend', backend_id)
+    env = Environment(backend_record, session, model_name)
+    lang = backend_record.default_lang_id
+    lang_code = lang.code if lang else 'en_US'
+    env.set_lang(code=lang_code)
+    return env
+
+class magento_binding(orm.AbstractModel):
+    """ Abstract Model for the Bindigs.
+
+    All the models used as bindings between Magento and OpenERP
+    (``magento.res.partner``, ``magento.product.product``, ...) should
+    ``_inherit`` it.
+    """
+    _name = 'magento.binding'
+    _inherit = 'external.binding'
+    _description = 'Magento Binding (abstract)'
+
+    _columns = {
+        # 'openerp_id': openerp-side id must be declared in concrete model
+        'backend_id': fields.many2one(
+            'magento.backend',
+            'Magento Backend',
+            required=True,
+            ondelete='restrict'),
+        # fields.char because 0 is a valid Magento ID
+        'magento_id': fields.char('ID on Magento'),
+    }
+
+    # the _sql_contraints cannot be there due to this bug:
+    # https://bugs.launchpad.net/openobject-server/+bug/1151703
+
+
+def add_checkpoint(session, model_name, record_id, backend_id):
+    """ Add a row in the model ``connector.checkpoint`` for a record,
+    meaning it has to be reviewed by a user.
+
+    :param session: current session
+    :type session: :py:class:`openerp.addons.connector.session.ConnectorSession`
+    :param model_name: name of the model of the record to be reviewed
+    :type model_name: str
+    :param record_id: ID of the record to be reviewed
+    :type record_id: int
+    :param backend_id: ID of the Magento Backend
+    :type backend_id: int
+    """
+    return checkpoint.add_checkpoint(session, model_name, record_id,
+                                     'magento.backend', backend_id)

=== added file 'magentoerpconnect/consumer.py'
--- magentoerpconnect/consumer.py	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/consumer.py	2013-08-13 17:30:12 +0000
@@ -0,0 +1,80 @@
+# -*- coding: utf-8 -*-
+##############################################################################
+#
+#    Author: Guewen Baconnier
+#    Copyright 2013 Camptocamp SA
+#
+#    This program is free software: you can redistribute it and/or modify
+#    it under the terms of the GNU Affero General Public License as
+#    published by the Free Software Foundation, either version 3 of the
+#    License, or (at your option) any later version.
+#
+#    This program is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU Affero General Public License for more details.
+#
+#    You should have received a copy of the GNU Affero General Public License
+#    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+##############################################################################
+
+from functools import wraps
+
+from openerp.addons.connector.event import (on_record_write,
+                                            on_record_create,
+                                            on_record_unlink
+                                            )
+from openerp.addons.connector.connector import Binder
+from .unit.export_synchronizer import export_record
+from .unit.delete_synchronizer import export_delete_record
+from .connector import get_environment
+
+_MODEL_NAMES = ()
+_BIND_MODEL_NAMES = ()
+
+
+@on_record_create(model_names=_BIND_MODEL_NAMES)
+@on_record_write(model_names=_BIND_MODEL_NAMES)
+def delay_export(session, model_name, record_id, fields=None):
+    """ Delay a job which export a binding record.
+
+    (A binding record being a ``magento.res.partner``,
+    ``magento.product.product``, ...)
+    """
+    if session.context.get('connector_no_export'):
+        return
+    export_record.delay(session, model_name, record_id, fields=fields)
+
+
+@on_record_write(model_names=_MODEL_NAMES)
+def delay_export_all_bindings(session, model_name, record_id, fields=None):
+    """ Delay a job which export all the bindings of a record.
+
+    In this case, it is called on records of normal models and will delay
+    the export for all the bindings.
+    """
+    if session.context.get('connector_no_export'):
+        return
+    model = session.pool.get(model_name)
+    record = model.browse(session.cr, session.uid,
+                          record_id, context=session.context)
+    for binding in record.magento_bind_ids:
+        export_record.delay(session, binding._model._name, binding.id,
+                            fields=fields)
+
+
+@on_record_unlink(model_names=_BIND_MODEL_NAMES)
+def delay_unlink(session, model_name, record_id):
+    """ Delay a job which delete a record on Magento.
+
+    Called on binding records."""
+    model = session.pool.get(model_name)
+    record = model.browse(session.cr, session.uid,
+                          record_id, context=session.context)
+    env = get_environment(session, model_name, record.backend_id.id)
+    binder = env.get_connector_unit(Binder)
+    magento_id = binder.to_backend(record_id)
+    if magento_id:
+        export_delete_record.delay(session, model_name,
+                                   record.backend_id.id, magento_id)

=== added file 'magentoerpconnect/delivery.py'
--- magentoerpconnect/delivery.py	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/delivery.py	2013-08-13 17:30:12 +0000
@@ -0,0 +1,83 @@
+# -*- coding: utf-8 -*-
+##############################################################################
+#
+#    Authors: Guewen Baconnier, Sébastien Beau
+#    Copyright (C) 2010 BEAU Sébastien
+#    Copyright 2011-2013 Camptocamp SA
+#
+#    This program is free software: you can redistribute it and/or modify
+#    it under the terms of the GNU Affero General Public License as
+#    published by the Free Software Foundation, either version 3 of the
+#    License, or (at your option) any later version.
+#
+#    This program is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU Affero General Public License for more details.
+#
+#    You should have received a copy of the GNU Affero General Public License
+#    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+##############################################################################
+
+from openerp.osv import fields, orm
+
+
+# TODO magento.delivery.carrier & move specific stuff
+class delivery_carrier(orm.Model):
+    """ Adds Magento specific fields to ``delivery.carrier``
+
+    ``magento_code``
+
+        Code of the carrier delivery method in Magento.
+        Example: ``colissimo_express``
+
+    ``magento_tracking_title``
+
+        Display name of the carrier for the tracking in Magento.
+        Example: Colissimo Express
+
+    ``magento_carrier_code``
+
+        General code of the carrier, the first part of the ``magento_code``.
+        Example: ``colissimo`` for the method ``colissimo_express``.
+
+    ``magento_export_tracking``
+
+        Defines if the tracking numbers should be exported to Magento.
+    """
+    _inherit = "delivery.carrier"
+
+    def _carrier_code(self, cr, uid, ids, name, args, context=None):
+        res = {}
+        for carrier in self.browse(cr, uid, ids, context=context):
+            if not carrier.magento_code:
+                res[carrier.id] = False
+                continue
+            res[carrier.id] = carrier.magento_code.split('_')[0]
+        return res
+
+    _columns = {
+        'magento_code': fields.char(
+            'Magento Carrier Code',
+            size=64,
+            required=False),
+        'magento_tracking_title': fields.char(
+            'Magento Tracking Title',
+            size=64,
+            required=False),
+        # in Magento, the delivery method is something like that:
+        # tntmodule2_tnt_basic
+        # where the first part before the _ is always the carrier code
+        # in this example, the carrier code is tntmodule2
+        'magento_carrier_code':
+            fields.function(_carrier_code,
+                            string='Magento Base Carrier Code',
+                            size=32,
+                            type='char'),
+        'magento_export_tracking': fields.boolean('Export tracking numbers')
+    }
+
+    _defaults = {
+        'magento_export_tracking': True,
+    }

=== added file 'magentoerpconnect/delivery_view.xml'
--- magentoerpconnect/delivery_view.xml	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/delivery_view.xml	2013-08-13 17:30:12 +0000
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<openerp>
+    <data>
+
+        <record id="view_magento_delivery_carrier_form" model="ir.ui.view">
+            <field name="name">magento.delivery.carrier.form</field>
+            <field name="model">delivery.carrier</field>
+            <field name="inherit_id" ref="delivery.view_delivery_carrier_form" />
+            <field name="arch" type="xml">
+                 <data>
+                    <field name="product_id" select="1" position="after">
+                        <field name="magento_code"/>
+                        <field name="magento_tracking_title"/>
+                        <field name="magento_export_tracking"/>
+                    </field>
+                </data>
+            </field>
+        </record>
+
+    </data>
+</openerp>

=== added directory 'magentoerpconnect/doc'
=== added file 'magentoerpconnect/doc/Makefile'
--- magentoerpconnect/doc/Makefile	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/Makefile	2013-08-13 17:30:12 +0000
@@ -0,0 +1,153 @@
+# Makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+PAPER         =
+BUILDDIR      = _build
+
+# Internal variables.
+PAPEROPT_a4     = -D latex_paper_size=a4
+PAPEROPT_letter = -D latex_paper_size=letter
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+# the i18n builder cannot share the environment and doctrees with the others
+I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+
+.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
+
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  html       to make standalone HTML files"
+	@echo "  dirhtml    to make HTML files named index.html in directories"
+	@echo "  singlehtml to make a single large HTML file"
+	@echo "  pickle     to make pickle files"
+	@echo "  json       to make JSON files"
+	@echo "  htmlhelp   to make HTML files and a HTML help project"
+	@echo "  qthelp     to make HTML files and a qthelp project"
+	@echo "  devhelp    to make HTML files and a Devhelp project"
+	@echo "  epub       to make an epub"
+	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
+	@echo "  text       to make text files"
+	@echo "  man        to make manual pages"
+	@echo "  texinfo    to make Texinfo files"
+	@echo "  info       to make Texinfo files and run them through makeinfo"
+	@echo "  gettext    to make PO message catalogs"
+	@echo "  changes    to make an overview of all changed/added/deprecated items"
+	@echo "  linkcheck  to check all external links for integrity"
+	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
+
+clean:
+	-rm -rf $(BUILDDIR)/*
+
+html:
+	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
+
+dirhtml:
+	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
+
+singlehtml:
+	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
+	@echo
+	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
+
+pickle:
+	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
+	@echo
+	@echo "Build finished; now you can process the pickle files."
+
+json:
+	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
+	@echo
+	@echo "Build finished; now you can process the JSON files."
+
+htmlhelp:
+	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
+	@echo
+	@echo "Build finished; now you can run HTML Help Workshop with the" \
+	      ".hhp project file in $(BUILDDIR)/htmlhelp."
+
+qthelp:
+	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
+	@echo
+	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
+	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
+	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/Connectors.qhcp"
+	@echo "To view the help file:"
+	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/Connectors.qhc"
+
+devhelp:
+	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
+	@echo
+	@echo "Build finished."
+	@echo "To view the help file:"
+	@echo "# mkdir -p $$HOME/.local/share/devhelp/Connectors"
+	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/Connectors"
+	@echo "# devhelp"
+
+epub:
+	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
+	@echo
+	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
+
+latex:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo
+	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
+	@echo "Run \`make' in that directory to run these through (pdf)latex" \
+	      "(use \`make latexpdf' here to do that automatically)."
+
+latexpdf:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Running LaTeX files through pdflatex..."
+	$(MAKE) -C $(BUILDDIR)/latex all-pdf
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
+
+text:
+	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
+	@echo
+	@echo "Build finished. The text files are in $(BUILDDIR)/text."
+
+man:
+	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
+	@echo
+	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
+
+texinfo:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo
+	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
+	@echo "Run \`make' in that directory to run these through makeinfo" \
+	      "(use \`make info' here to do that automatically)."
+
+info:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo "Running Texinfo files through makeinfo..."
+	make -C $(BUILDDIR)/texinfo info
+	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
+
+gettext:
+	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
+	@echo
+	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
+
+changes:
+	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
+	@echo
+	@echo "The overview file is in $(BUILDDIR)/changes."
+
+linkcheck:
+	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
+	@echo
+	@echo "Link check complete; look for any errors in the above output " \
+	      "or in $(BUILDDIR)/linkcheck/output.txt."
+
+doctest:
+	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
+	@echo "Testing of doctests in the sources finished, look at the " \
+	      "results in $(BUILDDIR)/doctest/output.txt."

=== added directory 'magentoerpconnect/doc/_build'
=== added directory 'magentoerpconnect/doc/_static'
=== added directory 'magentoerpconnect/doc/_templates'
=== added directory 'magentoerpconnect/doc/_themes'
=== added file 'magentoerpconnect/doc/_themes/.gitignore'
--- magentoerpconnect/doc/_themes/.gitignore	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/_themes/.gitignore	2013-08-13 17:30:12 +0000
@@ -0,0 +1,3 @@
+*.pyc
+*.pyo
+.DS_Store

=== added file 'magentoerpconnect/doc/_themes/LICENSE'
--- magentoerpconnect/doc/_themes/LICENSE	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/_themes/LICENSE	2013-08-13 17:30:12 +0000
@@ -0,0 +1,37 @@
+Copyright (c) 2010 by Armin Ronacher.
+
+Some rights reserved.
+
+Redistribution and use in source and binary forms of the theme, with or
+without modification, are permitted provided that the following conditions
+are met:
+
+* Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above
+  copyright notice, this list of conditions and the following
+  disclaimer in the documentation and/or other materials provided
+  with the distribution.
+
+* The names of the contributors may not be used to endorse or
+  promote products derived from this software without specific
+  prior written permission.
+
+We kindly ask you to only use these themes in an unmodified manner just
+for Flask and Flask-related products, not for unrelated projects.  If you
+like the visual style and want to use it for your own projects, please
+consider making some larger changes to the themes (such as changing
+font faces, sizes, colors or margins).
+
+THIS THEME IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS THEME, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.

=== added file 'magentoerpconnect/doc/_themes/README'
--- magentoerpconnect/doc/_themes/README	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/_themes/README	2013-08-13 17:30:12 +0000
@@ -0,0 +1,31 @@
+Flask Sphinx Styles
+===================
+
+This repository contains sphinx styles for Flask and Flask related
+projects.  To use this style in your Sphinx documentation, follow
+this guide:
+
+1. put this folder as _themes into your docs folder.  Alternatively
+   you can also use git submodules to check out the contents there.
+2. add this to your conf.py:
+
+   sys.path.append(os.path.abspath('_themes'))
+   html_theme_path = ['_themes']
+   html_theme = 'flask'
+
+The following themes exist:
+
+- 'flask' - the standard flask documentation theme for large
+  projects
+- 'flask_small' - small one-page theme.  Intended to be used by
+  very small addon libraries for flask.
+
+The following options exist for the flask_small theme:
+
+   [options]
+   index_logo = ''              filename of a picture in _static
+                                to be used as replacement for the
+                                h1 in the index.rst file.
+   index_logo_height = 120px    height of the index logo
+   github_fork = ''             repository name on github for the
+                                "fork me" badge

=== added directory 'magentoerpconnect/doc/_themes/flask'
=== added file 'magentoerpconnect/doc/_themes/flask/layout.html'
--- magentoerpconnect/doc/_themes/flask/layout.html	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/_themes/flask/layout.html	2013-08-13 17:30:12 +0000
@@ -0,0 +1,25 @@
+{%- extends "basic/layout.html" %}
+{%- block extrahead %}
+  {{ super() }}
+  {% if theme_touch_icon %}
+  <link rel="apple-touch-icon" href="{{ pathto('_static/' ~ theme_touch_icon, 1) }}" />
+  {% endif %}
+  <link media="only screen and (max-device-width: 480px)" href="{{
+    pathto('_static/small_flask.css', 1) }}" type= "text/css" rel="stylesheet" />
+{% endblock %}
+{%- block relbar2 %}{% endblock %}
+{% block header %}
+  {{ super() }}
+  {% if pagename == 'index' %}
+  <div class=indexwrapper>
+  {% endif %}
+{% endblock %}
+{%- block footer %}
+  <div class="footer">
+    &copy; Copyright {{ copyright }}
+    Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> and a modified <a href="https://github.com/mitsuhiko/flask-sphinx-themes">Flask theme</a>.
+  </div>
+  {% if pagename == 'index' %}
+  </div>
+  {% endif %}
+{%- endblock %}

=== added file 'magentoerpconnect/doc/_themes/flask/relations.html'
--- magentoerpconnect/doc/_themes/flask/relations.html	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/_themes/flask/relations.html	2013-08-13 17:30:12 +0000
@@ -0,0 +1,19 @@
+<h3>Related Topics</h3>
+<ul>
+  <li><a href="{{ pathto(master_doc) }}">Documentation overview</a><ul>
+  {%- for parent in parents %}
+  <li><a href="{{ parent.link|e }}">{{ parent.title }}</a><ul>
+  {%- endfor %}
+    {%- if prev %}
+      <li>Previous: <a href="{{ prev.link|e }}" title="{{ _('previous chapter')
+        }}">{{ prev.title }}</a></li>
+    {%- endif %}
+    {%- if next %}
+      <li>Next: <a href="{{ next.link|e }}" title="{{ _('next chapter')
+        }}">{{ next.title }}</a></li>
+    {%- endif %}
+  {%- for parent in parents %}
+  </ul></li>
+  {%- endfor %}
+  </ul></li>
+</ul>

=== added directory 'magentoerpconnect/doc/_themes/flask/static'
=== added file 'magentoerpconnect/doc/_themes/flask/static/flasky.css_t'
--- magentoerpconnect/doc/_themes/flask/static/flasky.css_t	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/_themes/flask/static/flasky.css_t	2013-08-13 17:30:12 +0000
@@ -0,0 +1,395 @@
+/*
+ * flasky.css_t
+ * ~~~~~~~~~~~~
+ *
+ * :copyright: Copyright 2010 by Armin Ronacher.
+ * :license: Flask Design License, see LICENSE for details.
+ */
+
+{% set page_width = '80em' %}
+{% set sidebar_width = '16em' %}
+ 
+@import url("basic.css");
+ 
+/* -- page layout ----------------------------------------------------------- */
+ 
+body {
+    font-family: 'Georgia', serif;
+    font-size: 15px;
+    background-color: white;
+    color: #000;
+    margin: 0;
+    padding: 0;
+}
+
+div.document {
+    width: {{ page_width }};
+    margin: 30px auto 0 auto;
+}
+
+div.documentwrapper {
+    float: left;
+    width: 100%;
+}
+
+div.bodywrapper {
+    margin: 0 0 0 {{ sidebar_width }};
+}
+
+div.sphinxsidebar {
+    width: {{ sidebar_width }};
+}
+
+hr {
+    border: 1px solid #B1B4B6;
+}
+ 
+div.body {
+    background-color: #ffffff;
+    color: #3E4349;
+    padding: 0 0px 0 0px;
+}
+
+img.floatingflask {
+    padding: 0 0 10px 10px;
+    float: right;
+}
+ 
+div.footer {
+    width: {{ page_width }};
+    margin: 20px auto 30px auto;
+    font-size: 12px;
+    color: #888;
+    text-align: right;
+}
+
+div.footer a {
+    color: #888;
+}
+
+div.related {
+    display: none;
+}
+ 
+div.sphinxsidebar a {
+    color: #444;
+    text-decoration: none;
+    border-bottom: 1px dotted #999;
+}
+
+div.sphinxsidebar a:hover {
+    border-bottom: 1px solid #999;
+}
+ 
+div.sphinxsidebar {
+    font-size: 12px;
+    line-height: 1.5;
+}
+
+div.sphinxsidebarwrapper {
+    padding: 0px 10px;
+}
+
+div.sphinxsidebarwrapper p.logo {
+    padding: 0 0 20px 0;
+    margin: 0;
+    text-align: center;
+}
+ 
+div.sphinxsidebar h3,
+div.sphinxsidebar h4 {
+    font-family: 'Garamond', 'Georgia', serif;
+    color: #444;
+    font-size: 22px;
+    font-weight: normal;
+    margin: 0 0 5px 0;
+    padding: 0;
+}
+
+div.sphinxsidebar h4 {
+    font-size: 18px;
+}
+ 
+div.sphinxsidebar h3 a {
+    color: #444;
+}
+
+div.sphinxsidebar p.logo a,
+div.sphinxsidebar h3 a,
+div.sphinxsidebar p.logo a:hover,
+div.sphinxsidebar h3 a:hover {
+    border: none;
+}
+ 
+div.sphinxsidebar p {
+    color: #555;
+    margin: 10px 0;
+}
+
+div.sphinxsidebar ul {
+    margin: 10px 0;
+    padding: 0;
+    color: #000;
+}
+ 
+div.sphinxsidebar input {
+    border: 1px solid #ccc;
+    font-family: 'Georgia', serif;
+    font-size: 1em;
+}
+ 
+/* -- body styles ----------------------------------------------------------- */
+ 
+a {
+    color: #004B6B;
+    text-decoration: underline;
+}
+ 
+a:hover {
+    color: #6D4100;
+    text-decoration: underline;
+}
+ 
+div.body h1,
+div.body h2,
+div.body h3,
+div.body h4,
+div.body h5,
+div.body h6 {
+    font-family: 'Garamond', 'Georgia', serif;
+    font-weight: normal;
+    margin: 30px 0px 10px 0px;
+    padding: 0;
+}
+
+{% if theme_index_logo %}
+div.indexwrapper h1 {
+    text-indent: -999999px;
+    background: url({{ theme_index_logo }}) no-repeat center center;
+    height: {{ theme_index_logo_height }};
+}
+{% endif %}
+ 
+div.body h1 { margin-top: 0; padding-top: 0; font-size: 240%; }
+div.body h2 { font-size: 180%; }
+div.body h3 { font-size: 150%; }
+div.body h4 { font-size: 130%; }
+div.body h5 { font-size: 100%; }
+div.body h6 { font-size: 100%; }
+ 
+a.headerlink {
+    color: #ddd;
+    padding: 0 4px;
+    text-decoration: none;
+}
+ 
+a.headerlink:hover {
+    color: #444;
+    background: #eaeaea;
+}
+ 
+div.body p, div.body dd, div.body li {
+    line-height: 1.4em;
+}
+
+div.admonition {
+    background: #fafafa;
+    margin: 20px -30px;
+    padding: 10px 30px;
+    border-top: 1px solid #ccc;
+    border-bottom: 1px solid #ccc;
+}
+
+div.admonition tt.xref, div.admonition a tt {
+    border-bottom: 1px solid #fafafa;
+}
+
+dd div.admonition {
+    margin-left: -60px;
+    padding-left: 60px;
+}
+
+div.admonition p.admonition-title {
+    font-family: 'Garamond', 'Georgia', serif;
+    font-weight: normal;
+    font-size: 22px;
+    margin: 0 0 10px 0;
+    padding: 0;
+    line-height: 1;
+}
+
+div.admonition p.last {
+    margin-bottom: 0;
+}
+
+div.highlight {
+    background-color: white;
+}
+
+dt:target, .highlight {
+    background: #FAF3E8;
+}
+
+div.note {
+    background-color: #eee;
+    border: 1px solid #ccc;
+}
+ 
+div.seealso {
+    background-color: #ffc;
+    border: 1px solid #ff6;
+}
+ 
+div.topic {
+    background-color: #eee;
+}
+ 
+p.admonition-title {
+    display: inline;
+}
+ 
+p.admonition-title:after {
+    content: ":";
+}
+
+pre, tt {
+    font-family: 'Consolas', 'Menlo', 'Deja Vu Sans Mono', 'Bitstream Vera Sans Mono', monospace;
+    font-size: 0.9em;
+}
+
+img.screenshot {
+}
+
+tt.descname, tt.descclassname {
+    font-size: 0.95em;
+}
+
+tt.descname {
+    padding-right: 0.08em;
+}
+
+img.screenshot {
+    -moz-box-shadow: 2px 2px 4px #eee;
+    -webkit-box-shadow: 2px 2px 4px #eee;
+    box-shadow: 2px 2px 4px #eee;
+}
+
+table.docutils {
+    border: 1px solid #888;
+    -moz-box-shadow: 2px 2px 4px #eee;
+    -webkit-box-shadow: 2px 2px 4px #eee;
+    box-shadow: 2px 2px 4px #eee;
+}
+
+table.docutils td, table.docutils th {
+    border: 1px solid #888;
+    padding: 0.25em 0.7em;
+}
+
+table.field-list, table.footnote {
+    border: none;
+    -moz-box-shadow: none;
+    -webkit-box-shadow: none;
+    box-shadow: none;
+}
+
+table.footnote {
+    margin: 15px 0;
+    width: 100%;
+    border: 1px solid #eee;
+    background: #fdfdfd;
+    font-size: 0.9em;
+}
+
+table.footnote + table.footnote {
+    margin-top: -15px;
+    border-top: none;
+}
+
+table.field-list th {
+    padding: 0 0.8em 0 0;
+}
+
+table.field-list td {
+    padding: 0;
+}
+
+table.footnote td.label {
+    width: 0px;
+    padding: 0.3em 0 0.3em 0.5em;
+}
+
+table.footnote td {
+    padding: 0.3em 0.5em;
+}
+
+dl {
+    margin: 0;
+    padding: 0;
+}
+
+dl dd {
+    margin-left: 30px;
+}
+
+blockquote {
+    margin: 0 0 0 30px;
+    padding: 0;
+}
+
+ul, ol {
+    margin: 10px 0 10px 30px;
+    padding: 0;
+}
+ 
+pre {
+    background: #eee;
+    padding: 7px 30px;
+    margin: 15px -30px;
+    line-height: 1.3em;
+}
+
+dl pre, blockquote pre, li pre {
+    margin-left: -60px;
+    padding-left: 60px;
+}
+
+dl dl pre {
+    margin-left: -90px;
+    padding-left: 90px;
+}
+ 
+tt {
+    background-color: #ecf0f3;
+    color: #222;
+    /* padding: 1px 2px; */
+}
+
+tt.xref, a tt {
+    background-color: #FBFBFB;
+    border-bottom: 1px solid white;
+}
+
+a.reference {
+    text-decoration: none;
+    border-bottom: 1px dotted #004B6B;
+}
+
+a.reference:hover {
+    border-bottom: 1px solid #6D4100;
+}
+
+a.footnote-reference {
+    text-decoration: none;
+    font-size: 0.7em;
+    vertical-align: top;
+    border-bottom: 1px dotted #004B6B;
+}
+
+a.footnote-reference:hover {
+    border-bottom: 1px solid #6D4100;
+}
+
+a:hover tt {
+    background: #EEE;
+}

=== added file 'magentoerpconnect/doc/_themes/flask/static/small_flask.css'
--- magentoerpconnect/doc/_themes/flask/static/small_flask.css	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/_themes/flask/static/small_flask.css	2013-08-13 17:30:12 +0000
@@ -0,0 +1,70 @@
+/*
+ * small_flask.css_t
+ * ~~~~~~~~~~~~~~~~~
+ *
+ * :copyright: Copyright 2010 by Armin Ronacher.
+ * :license: Flask Design License, see LICENSE for details.
+ */
+
+body {
+    margin: 0;
+    padding: 20px 30px;
+}
+
+div.documentwrapper {
+    float: none;
+    background: white;
+}
+
+div.sphinxsidebar {
+    display: block;
+    float: none;
+    width: 102.5%;
+    margin: 50px -30px -20px -30px;
+    padding: 10px 20px;
+    background: #333;
+    color: white;
+}
+
+div.sphinxsidebar h3, div.sphinxsidebar h4, div.sphinxsidebar p,
+div.sphinxsidebar h3 a {
+    color: white;
+}
+
+div.sphinxsidebar a {
+    color: #aaa;
+}
+
+div.sphinxsidebar p.logo {
+    display: none;
+}
+
+div.document {
+    width: 100%;
+    margin: 0;
+}
+
+div.related {
+    display: block;
+    margin: 0;
+    padding: 10px 0 20px 0;
+}
+
+div.related ul,
+div.related ul li {
+    margin: 0;
+    padding: 0;
+}
+
+div.footer {
+    display: none;
+}
+
+div.bodywrapper {
+    margin: 0;
+}
+
+div.body {
+    min-height: 0;
+    padding: 0;
+}

=== added file 'magentoerpconnect/doc/_themes/flask/theme.conf'
--- magentoerpconnect/doc/_themes/flask/theme.conf	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/_themes/flask/theme.conf	2013-08-13 17:30:12 +0000
@@ -0,0 +1,9 @@
+[theme]
+inherit = basic
+stylesheet = flasky.css
+pygments_style = flask_theme_support.FlaskyStyle
+
+[options]
+index_logo = 
+index_logo_height = 120px
+touch_icon = 

=== added directory 'magentoerpconnect/doc/_themes/flask_small'
=== added file 'magentoerpconnect/doc/_themes/flask_small/layout.html'
--- magentoerpconnect/doc/_themes/flask_small/layout.html	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/_themes/flask_small/layout.html	2013-08-13 17:30:12 +0000
@@ -0,0 +1,22 @@
+{% extends "basic/layout.html" %}
+{% block header %}
+  {{ super() }}
+  {% if pagename == 'index' %}
+  <div class=indexwrapper>
+  {% endif %}
+{% endblock %}
+{% block footer %}
+  {% if pagename == 'index' %}
+  </div>
+  {% endif %}
+{% endblock %}
+{# do not display relbars #}
+{% block relbar1 %}{% endblock %}
+{% block relbar2 %}
+  {% if theme_github_fork %}
+    <a href="http://github.com/{{ theme_github_fork }}"><img style="position: fixed; top: 0; right: 0; border: 0;"
+    src="http://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png" alt="Fork me on GitHub" /></a>
+  {% endif %}
+{% endblock %}
+{% block sidebar1 %}{% endblock %}
+{% block sidebar2 %}{% endblock %}

=== added directory 'magentoerpconnect/doc/_themes/flask_small/static'
=== added file 'magentoerpconnect/doc/_themes/flask_small/static/flasky.css_t'
--- magentoerpconnect/doc/_themes/flask_small/static/flasky.css_t	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/_themes/flask_small/static/flasky.css_t	2013-08-13 17:30:12 +0000
@@ -0,0 +1,287 @@
+/*
+ * flasky.css_t
+ * ~~~~~~~~~~~~
+ *
+ * Sphinx stylesheet -- flasky theme based on nature theme.
+ *
+ * :copyright: Copyright 2007-2010 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+ 
+@import url("basic.css");
+ 
+/* -- page layout ----------------------------------------------------------- */
+ 
+body {
+    font-family: 'Georgia', serif;
+    font-size: 17px;
+    color: #000;
+    background: white;
+    margin: 0;
+    padding: 0;
+}
+
+div.documentwrapper {
+    float: left;
+    width: 100%;
+}
+
+div.bodywrapper {
+    margin: 40px auto 0 auto;
+    width: 700px;
+}
+
+hr {
+    border: 1px solid #B1B4B6;
+}
+ 
+div.body {
+    background-color: #ffffff;
+    color: #3E4349;
+    padding: 0 30px 30px 30px;
+}
+
+img.floatingflask {
+    padding: 0 0 10px 10px;
+    float: right;
+}
+ 
+div.footer {
+    text-align: right;
+    color: #888;
+    padding: 10px;
+    font-size: 14px;
+    width: 650px;
+    margin: 0 auto 40px auto;
+}
+ 
+div.footer a {
+    color: #888;
+    text-decoration: underline;
+}
+ 
+div.related {
+    line-height: 32px;
+    color: #888;
+}
+
+div.related ul {
+    padding: 0 0 0 10px;
+}
+ 
+div.related a {
+    color: #444;
+}
+ 
+/* -- body styles ----------------------------------------------------------- */
+ 
+a {
+    color: #004B6B;
+    text-decoration: underline;
+}
+ 
+a:hover {
+    color: #6D4100;
+    text-decoration: underline;
+}
+
+div.body {
+    padding-bottom: 40px; /* saved for footer */
+}
+ 
+div.body h1,
+div.body h2,
+div.body h3,
+div.body h4,
+div.body h5,
+div.body h6 {
+    font-family: 'Garamond', 'Georgia', serif;
+    font-weight: normal;
+    margin: 30px 0px 10px 0px;
+    padding: 0;
+}
+
+{% if theme_index_logo %}
+div.indexwrapper h1 {
+    text-indent: -999999px;
+    background: url({{ theme_index_logo }}) no-repeat center center;
+    height: {{ theme_index_logo_height }};
+}
+{% endif %}
+ 
+div.body h2 { font-size: 180%; }
+div.body h3 { font-size: 150%; }
+div.body h4 { font-size: 130%; }
+div.body h5 { font-size: 100%; }
+div.body h6 { font-size: 100%; }
+ 
+a.headerlink {
+    color: white;
+    padding: 0 4px;
+    text-decoration: none;
+}
+ 
+a.headerlink:hover {
+    color: #444;
+    background: #eaeaea;
+}
+ 
+div.body p, div.body dd, div.body li {
+    line-height: 1.4em;
+}
+
+div.admonition {
+    background: #fafafa;
+    margin: 20px -30px;
+    padding: 10px 30px;
+    border-top: 1px solid #ccc;
+    border-bottom: 1px solid #ccc;
+}
+
+div.admonition p.admonition-title {
+    font-family: 'Garamond', 'Georgia', serif;
+    font-weight: normal;
+    font-size: 24px;
+    margin: 0 0 10px 0;
+    padding: 0;
+    line-height: 1;
+}
+
+div.admonition p.last {
+    margin-bottom: 0;
+}
+
+div.highlight{
+    background-color: white;
+}
+
+dt:target, .highlight {
+    background: #FAF3E8;
+}
+
+div.note {
+    background-color: #eee;
+    border: 1px solid #ccc;
+}
+ 
+div.seealso {
+    background-color: #ffc;
+    border: 1px solid #ff6;
+}
+ 
+div.topic {
+    background-color: #eee;
+}
+ 
+div.warning {
+    background-color: #ffe4e4;
+    border: 1px solid #f66;
+}
+ 
+p.admonition-title {
+    display: inline;
+}
+ 
+p.admonition-title:after {
+    content: ":";
+}
+
+pre, tt {
+    font-family: 'Consolas', 'Menlo', 'Deja Vu Sans Mono', 'Bitstream Vera Sans Mono', monospace;
+    font-size: 0.85em;
+}
+
+img.screenshot {
+}
+
+tt.descname, tt.descclassname {
+    font-size: 0.95em;
+}
+
+tt.descname {
+    padding-right: 0.08em;
+}
+
+img.screenshot {
+    -moz-box-shadow: 2px 2px 4px #eee;
+    -webkit-box-shadow: 2px 2px 4px #eee;
+    box-shadow: 2px 2px 4px #eee;
+}
+
+table.docutils {
+    border: 1px solid #888;
+    -moz-box-shadow: 2px 2px 4px #eee;
+    -webkit-box-shadow: 2px 2px 4px #eee;
+    box-shadow: 2px 2px 4px #eee;
+}
+
+table.docutils td, table.docutils th {
+    border: 1px solid #888;
+    padding: 0.25em 0.7em;
+}
+
+table.field-list, table.footnote {
+    border: none;
+    -moz-box-shadow: none;
+    -webkit-box-shadow: none;
+    box-shadow: none;
+}
+
+table.footnote {
+    margin: 15px 0;
+    width: 100%;
+    border: 1px solid #eee;
+}
+
+table.field-list th {
+    padding: 0 0.8em 0 0;
+}
+
+table.field-list td {
+    padding: 0;
+}
+
+table.footnote td {
+    padding: 0.5em;
+}
+
+dl {
+    margin: 0;
+    padding: 0;
+}
+
+dl dd {
+    margin-left: 30px;
+}
+ 
+pre {
+    padding: 0;
+    margin: 15px -30px;
+    padding: 8px;
+    line-height: 1.3em;
+    padding: 7px 30px;
+    background: #eee;
+    border-radius: 2px;
+    -moz-border-radius: 2px;
+    -webkit-border-radius: 2px;
+}
+
+dl pre {
+    margin-left: -60px;
+    padding-left: 60px;
+}
+
+tt {
+    background-color: #ecf0f3;
+    color: #222;
+    /* padding: 1px 2px; */
+}
+
+tt.xref, a tt {
+    background-color: #FBFBFB;
+}
+
+a:hover tt {
+    background: #EEE;
+}

=== added file 'magentoerpconnect/doc/_themes/flask_small/theme.conf'
--- magentoerpconnect/doc/_themes/flask_small/theme.conf	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/_themes/flask_small/theme.conf	2013-08-13 17:30:12 +0000
@@ -0,0 +1,10 @@
+[theme]
+inherit = basic
+stylesheet = flasky.css
+nosidebar = true
+pygments_style = flask_theme_support.FlaskyStyle
+
+[options]
+index_logo = ''
+index_logo_height = 120px
+github_fork = ''

=== added file 'magentoerpconnect/doc/_themes/flask_theme_support.py'
--- magentoerpconnect/doc/_themes/flask_theme_support.py	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/_themes/flask_theme_support.py	2013-08-13 17:30:12 +0000
@@ -0,0 +1,86 @@
+# flasky extensions.  flasky pygments style based on tango style
+from pygments.style import Style
+from pygments.token import Keyword, Name, Comment, String, Error, \
+     Number, Operator, Generic, Whitespace, Punctuation, Other, Literal
+
+
+class FlaskyStyle(Style):
+    background_color = "#f8f8f8"
+    default_style = ""
+
+    styles = {
+        # No corresponding class for the following:
+        #Text:                     "", # class:  ''
+        Whitespace:                "underline #f8f8f8",      # class: 'w'
+        Error:                     "#a40000 border:#ef2929", # class: 'err'
+        Other:                     "#000000",                # class 'x'
+
+        Comment:                   "italic #8f5902", # class: 'c'
+        Comment.Preproc:           "noitalic",       # class: 'cp'
+
+        Keyword:                   "bold #004461",   # class: 'k'
+        Keyword.Constant:          "bold #004461",   # class: 'kc'
+        Keyword.Declaration:       "bold #004461",   # class: 'kd'
+        Keyword.Namespace:         "bold #004461",   # class: 'kn'
+        Keyword.Pseudo:            "bold #004461",   # class: 'kp'
+        Keyword.Reserved:          "bold #004461",   # class: 'kr'
+        Keyword.Type:              "bold #004461",   # class: 'kt'
+
+        Operator:                  "#582800",   # class: 'o'
+        Operator.Word:             "bold #004461",   # class: 'ow' - like keywords
+
+        Punctuation:               "bold #000000",   # class: 'p'
+
+        # because special names such as Name.Class, Name.Function, etc.
+        # are not recognized as such later in the parsing, we choose them
+        # to look the same as ordinary variables.
+        Name:                      "#000000",        # class: 'n'
+        Name.Attribute:            "#c4a000",        # class: 'na' - to be revised
+        Name.Builtin:              "#004461",        # class: 'nb'
+        Name.Builtin.Pseudo:       "#3465a4",        # class: 'bp'
+        Name.Class:                "#000000",        # class: 'nc' - to be revised
+        Name.Constant:             "#000000",        # class: 'no' - to be revised
+        Name.Decorator:            "#888",           # class: 'nd' - to be revised
+        Name.Entity:               "#ce5c00",        # class: 'ni'
+        Name.Exception:            "bold #cc0000",   # class: 'ne'
+        Name.Function:             "#000000",        # class: 'nf'
+        Name.Property:             "#000000",        # class: 'py'
+        Name.Label:                "#f57900",        # class: 'nl'
+        Name.Namespace:            "#000000",        # class: 'nn' - to be revised
+        Name.Other:                "#000000",        # class: 'nx'
+        Name.Tag:                  "bold #004461",   # class: 'nt' - like a keyword
+        Name.Variable:             "#000000",        # class: 'nv' - to be revised
+        Name.Variable.Class:       "#000000",        # class: 'vc' - to be revised
+        Name.Variable.Global:      "#000000",        # class: 'vg' - to be revised
+        Name.Variable.Instance:    "#000000",        # class: 'vi' - to be revised
+
+        Number:                    "#990000",        # class: 'm'
+
+        Literal:                   "#000000",        # class: 'l'
+        Literal.Date:              "#000000",        # class: 'ld'
+
+        String:                    "#4e9a06",        # class: 's'
+        String.Backtick:           "#4e9a06",        # class: 'sb'
+        String.Char:               "#4e9a06",        # class: 'sc'
+        String.Doc:                "italic #8f5902", # class: 'sd' - like a comment
+        String.Double:             "#4e9a06",        # class: 's2'
+        String.Escape:             "#4e9a06",        # class: 'se'
+        String.Heredoc:            "#4e9a06",        # class: 'sh'
+        String.Interpol:           "#4e9a06",        # class: 'si'
+        String.Other:              "#4e9a06",        # class: 'sx'
+        String.Regex:              "#4e9a06",        # class: 'sr'
+        String.Single:             "#4e9a06",        # class: 's1'
+        String.Symbol:             "#4e9a06",        # class: 'ss'
+
+        Generic:                   "#000000",        # class: 'g'
+        Generic.Deleted:           "#a40000",        # class: 'gd'
+        Generic.Emph:              "italic #000000", # class: 'ge'
+        Generic.Error:             "#ef2929",        # class: 'gr'
+        Generic.Heading:           "bold #000080",   # class: 'gh'
+        Generic.Inserted:          "#00A000",        # class: 'gi'
+        Generic.Output:            "#888",           # class: 'go'
+        Generic.Prompt:            "#745334",        # class: 'gp'
+        Generic.Strong:            "bold #000000",   # class: 'gs'
+        Generic.Subheading:        "bold #800080",   # class: 'gu'
+        Generic.Traceback:         "bold #a40000",   # class: 'gt'
+    }

=== added directory 'magentoerpconnect/doc/api'
=== added file 'magentoerpconnect/doc/api/api_backend.rst'
--- magentoerpconnect/doc/api/api_backend.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/api/api_backend.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,7 @@
+Backend
+=======
+
+.. automodule:: openerp.addons.magentoerpconnect.backend
+   :members:
+   :undoc-members:
+   :show-inheritance:

=== added file 'magentoerpconnect/doc/api/api_backend_adapter.rst'
--- magentoerpconnect/doc/api/api_backend_adapter.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/api/api_backend_adapter.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,7 @@
+Backend Adapters
+================
+
+.. automodule:: openerp.addons.magentoerpconnect.unit.backend_adapter
+   :members:
+   :undoc-members:
+   :show-inheritance:

=== added file 'magentoerpconnect/doc/api/api_binder.rst'
--- magentoerpconnect/doc/api/api_binder.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/api/api_binder.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,7 @@
+Binders
+=======
+
+.. automodule:: openerp.addons.magentoerpconnect.unit.binder
+   :members:
+   :undoc-members:
+   :show-inheritance:

=== added file 'magentoerpconnect/doc/api/api_connector.rst'
--- magentoerpconnect/doc/api/api_connector.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/api/api_connector.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,7 @@
+Connector
+=========
+
+.. automodule:: openerp.addons.magentoerpconnect.connector
+   :members:
+   :undoc-members:
+   :show-inheritance:

=== added file 'magentoerpconnect/doc/api/api_consumer.rst'
--- magentoerpconnect/doc/api/api_consumer.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/api/api_consumer.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,7 @@
+Consumers
+=========
+
+.. automodule:: openerp.addons.magentoerpconnect.consumer
+   :members:
+   :undoc-members:
+   :show-inheritance:

=== added file 'magentoerpconnect/doc/api/api_delivery.rst'
--- magentoerpconnect/doc/api/api_delivery.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/api/api_delivery.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,7 @@
+Delivery
+========
+
+.. automodule:: openerp.addons.magentoerpconnect.delivery
+   :members:
+   :undoc-members:
+   :show-inheritance:

=== added file 'magentoerpconnect/doc/api/api_exception.rst'
--- magentoerpconnect/doc/api/api_exception.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/api/api_exception.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,9 @@
+Exceptions
+==========
+
+.. automodule:: openerp.addons.magentoerpconnect.exception
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+

=== added file 'magentoerpconnect/doc/api/api_invoice.rst'
--- magentoerpconnect/doc/api/api_invoice.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/api/api_invoice.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,7 @@
+Invoice
+=======
+
+.. automodule:: openerp.addons.magentoerpconnect.invoice
+   :members:
+   :undoc-members:
+   :show-inheritance:

=== added file 'magentoerpconnect/doc/api/api_magento_model.rst'
--- magentoerpconnect/doc/api/api_magento_model.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/api/api_magento_model.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,7 @@
+Magento Models
+==============
+
+.. automodule:: openerp.addons.magentoerpconnect.magento_model
+   :members:
+   :undoc-members:
+   :show-inheritance:

=== added file 'magentoerpconnect/doc/api/api_partner.rst'
--- magentoerpconnect/doc/api/api_partner.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/api/api_partner.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,7 @@
+Partner
+=======
+
+.. automodule:: openerp.addons.magentoerpconnect.partner
+   :members:
+   :undoc-members:
+   :show-inheritance:

=== added file 'magentoerpconnect/doc/api/api_partner_category.rst'
--- magentoerpconnect/doc/api/api_partner_category.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/api/api_partner_category.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,7 @@
+Partner Category
+================
+
+.. automodule:: openerp.addons.magentoerpconnect.partner_category
+   :members:
+   :undoc-members:
+   :show-inheritance:

=== added file 'magentoerpconnect/doc/api/api_product.rst'
--- magentoerpconnect/doc/api/api_product.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/api/api_product.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,7 @@
+Product
+=======
+
+.. automodule:: openerp.addons.magentoerpconnect.product
+   :members:
+   :undoc-members:
+   :show-inheritance:

=== added file 'magentoerpconnect/doc/api/api_product_category.rst'
--- magentoerpconnect/doc/api/api_product_category.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/api/api_product_category.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,7 @@
+Product Category
+================
+
+.. automodule:: openerp.addons.magentoerpconnect.product_category
+   :members:
+   :undoc-members:
+   :show-inheritance:

=== added file 'magentoerpconnect/doc/api/api_sale.rst'
--- magentoerpconnect/doc/api/api_sale.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/api/api_sale.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,7 @@
+Sale
+====
+
+.. automodule:: openerp.addons.magentoerpconnect.sale
+   :members:
+   :undoc-members:
+   :show-inheritance:

=== added file 'magentoerpconnect/doc/api/api_stock_picking.rst'
--- magentoerpconnect/doc/api/api_stock_picking.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/api/api_stock_picking.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,7 @@
+Stock Picking
+=============
+
+.. automodule:: openerp.addons.magentoerpconnect.stock_picking
+   :members:
+   :undoc-members:
+   :show-inheritance:

=== added file 'magentoerpconnect/doc/api/api_stock_tracking.rst'
--- magentoerpconnect/doc/api/api_stock_tracking.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/api/api_stock_tracking.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,7 @@
+Stock Tracking
+==============
+
+.. automodule:: openerp.addons.magentoerpconnect.stock_tracking
+   :members:
+   :undoc-members:
+   :show-inheritance:

=== added file 'magentoerpconnect/doc/api/api_synchronizer.rst'
--- magentoerpconnect/doc/api/api_synchronizer.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/api/api_synchronizer.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,26 @@
+Synchronizers
+=============
+
+Import
+------
+
+.. automodule:: openerp.addons.magentoerpconnect.unit.import_synchronizer
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Export
+------
+
+.. automodule:: openerp.addons.magentoerpconnect.unit.export_synchronizer
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Delete
+------
+
+.. automodule:: openerp.addons.magentoerpconnect.unit.delete_synchronizer
+   :members:
+   :undoc-members:
+   :show-inheritance:

=== added file 'magentoerpconnect/doc/conf.py'
--- magentoerpconnect/doc/conf.py	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/conf.py	2013-08-13 17:30:12 +0000
@@ -0,0 +1,275 @@
+# -*- coding: utf-8 -*-
+#
+# Connectors documentation build configuration file, created by
+# sphinx-quickstart on Mon Feb  4 11:35:44 2013.
+#
+# This file is execfile()d with the current directory set to its containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys, os
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#sys.path.insert(0, os.path.abspath('.'))
+sys.path.append(os.path.abspath('_themes'))
+sys.path.append(os.path.abspath('../../../server'))
+
+# Load OpenERP with correct addons-path so the doc can be built even if
+# the addon import modules from other branches
+import openerp
+BASE_PATH = os.path.abspath(os.path.join(os.getcwd(), '../../..'))
+# You may need to change with your own paths
+ADDONS_PATHS = ('server/openerp/addons',
+                'webclient/addons',
+                'addons',
+                'connector',
+                'e-commerce-addons',
+                'magentoerpconnect')
+pathes = [os.path.join(BASE_PATH, path) for path in ADDONS_PATHS]
+options = ['--addons-path', ','.join(pathes)]
+openerp.tools.config.parse_config(options)
+os.environ['TZ'] = 'UTC'
+openerp.service.start_internal()
+
+# -- General configuration -----------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+#needs_sphinx = '1.0'
+
+# Add any Sphinx extension module names here, as strings. They can be extensions
+# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
+extensions = ['sphinx.ext.autodoc',
+              'sphinx.ext.intersphinx',
+              'sphinx.ext.todo',
+              'sphinx.ext.viewcode']
+
+todo_include_todos = True
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# The suffix of source filenames.
+source_suffix = '.rst'
+
+# The encoding of source files.
+#source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = 'index'
+
+# General information about the project.
+project = u'Magentoerpconnect'
+copyright = u'2013, Camptocamp SA'
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The short X.Y version.
+version = '0.1'
+# The full version, including alpha/beta/rc tags.
+release = '0.1'
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+#today = ''
+# Else, today_fmt is used as the format for a strftime call.
+#today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ['_build']
+
+# The reST default role (used for this markup: `text`) to use for all documents.
+#default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+#add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+#add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+#show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = 'sphinx'
+
+# A list of ignored prefixes for module index sorting.
+#modindex_common_prefix = []
+
+
+# -- Options for HTML output ---------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = 'flask'
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+#html_theme_options = {}
+
+# Add any paths that contain custom themes here, relative to this directory.
+html_theme_path = ['_themes']
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+#html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+#html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+#html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+#html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+#html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+#html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+#html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+#html_additional_pages = {}
+
+# If false, no module index is generated.
+#html_domain_indices = True
+
+# If false, no index is generated.
+#html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+#html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+#html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+#html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+#html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+#html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+#html_file_suffix = None
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = 'magentoerpconnect-doc'
+
+
+# -- Options for LaTeX output --------------------------------------------------
+
+latex_elements = {
+# The paper size ('letterpaper' or 'a4paper').
+#'papersize': 'letterpaper',
+
+# The font size ('10pt', '11pt' or '12pt').
+#'pointsize': '10pt',
+
+# Additional stuff for the LaTeX preamble.
+#'preamble': '',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title, author, documentclass [howto/manual]).
+latex_documents = [
+  ('index', 'Magentoerpconnect.tex', u'Magentoerpconnect Documentation',
+   u'Camptocamp SA', 'manual'),
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+#latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+#latex_use_parts = False
+
+# If true, show page references after internal links.
+#latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+#latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+#latex_appendices = []
+
+# If false, no module index is generated.
+#latex_domain_indices = True
+
+
+# -- Options for manual page output --------------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    ('index', 'magentoerpconnect', u'Magentoerpconnect Documentation',
+     [u'Camptocamp SA'], 1)
+]
+
+# If true, show URL addresses after external links.
+#man_show_urls = False
+
+
+# -- Options for Texinfo output ------------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+  ('index', 'Magentoerpconnect', u'Magentoerpconnect Documentation',
+   u'Camptocamp SA', 'Magentoerpconnect', 'Connector between OpenERP and Magento',
+   'Miscellaneous'),
+]
+
+# Documents to append as an appendix to all manuals.
+#texinfo_appendices = []
+
+# If false, no module index is generated.
+#texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+#texinfo_show_urls = 'footnote'
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {
+    'python': ('http://docs.python.org/2.6', None),
+    'openerpweb': ('http://doc.openerp.com/trunk/developers/web', None),
+    'openerpdev': ('http://doc.openerp.com/trunk/developers', None),
+#    'openerpconnector': ('', None),
+}

=== added directory 'magentoerpconnect/doc/develop'
=== added directory 'magentoerpconnect/doc/guides'
=== added file 'magentoerpconnect/doc/guides/connector_checkpoint.rst'
--- magentoerpconnect/doc/guides/connector_checkpoint.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/guides/connector_checkpoint.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,20 @@
+.. _connector-checkpoint:
+
+
+##############################
+Check the connector checkpoint
+##############################
+
+Located at `Connectors > Connectors > Checkpoint`,
+this is a list of records which have been imported
+from Magento and have to be verified.
+
+Records such as products or product categories could
+have some configuration to do once they are imported,
+so they appear in that list.
+
+For each item in that list,
+you can open the related record,
+proceed with your configuration or verification,
+and when you are done,
+click on the `Reviewed` button.

=== added file 'magentoerpconnect/doc/guides/installation_guide.rst'
--- magentoerpconnect/doc/guides/installation_guide.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/guides/installation_guide.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,143 @@
+.. _installation-guide:
+
+
+##################
+Installation Guide
+##################
+
+
+************
+Installation
+************
+
+The installation steps assume that you already have a working OpenERP
+setup with all the OpenERP pre-requisites.
+
+Requirements on both servers
+============================
+
+The ``ntp`` package should be install on the servers hosting Magento and
+OpenERP to ensure a correct synchronization between them
+
+OpenERP
+=======
+
+Download the branches where you installed OpenERP::
+
+    $ bzr branch lp:openerp-connector/7.0 connector
+    $ bzr branch lp:openerp-connector/7.0-e-commerce-addons e-commerce-addons
+    $ bzr branch lp:openerp-connector/7.0-magentoerpconnect magentoerpconnect
+    $ bzr branch lp:openerp-product-attributes/7.0 openerp-product-attributes
+
+Add the branches in the addons path, either using the server command
+line or adding them in the OpenERP server configuration file.
+
+You also need to install the ``magento`` Python package.
+So install it with either pip or either easy_install::
+
+    $ pip install magento
+
+    $ easy_install magento
+
+Note that you may need to use the root rights on your system.
+
+In OpenERP, update the modules list using `Settings > Modules > Update
+Modules List`.
+
+Go to the menu `Settings > Modules > Installed Modules`, remove the
+`Installed` filter and search for `Magento Connector`, then click on
+`Install`.
+
+
+Magento
+=======
+
+For the time being, the Magento extension originally built by OpenLabs
+is still used  by the connector. But the version published on `Magento
+Connect` is outdated.
+
+Download the following branch and install it in Magento::
+
+    $ bzr branch lp:magentoerpconnect/magento-module-oerp6.x-stable magento-module
+
+In order to install it:
+
+1. Move the `Openlabs` folder in the
+   `magento_root/app/code/community`.
+#. Move the file `app/etc/modules/Openlabs_OpenERPConnector.xml` in
+   `magento_root/app/etc/modules`.
+#. Flush the Magento cache from the admin panel or by removing everything in
+   `magento_root/var/cache`
+
+Configuring the Magento web-services
+====================================
+
+1. In the Magento admin panel, go to `System > Web-Services >
+   SOAP/XML-RPC - Roles`.
+#. Create a new role named `openerp` with access to `All` resources.
+#. In `System > Web-Services > SOAP/XML-RPC - Users`, create a new user
+   named as you want, for instance `openerp_connect`, and an API key.
+   In `User Role`, choose the `openerp` role.
+
+
+**********************
+After the installation
+**********************
+
+Once the addon is installed, you may want to:
+
+1. Read or read again :ref:`key-questions`
+
+#. Assign the `Connector Manager` group on your user.
+
+#. Create the Backend in `Connectors > Magento > Backend`,
+   use the role created in `Configuring the Magento web-services`_.
+
+#. Synchronize the initial metadata using the button `Synchronize Metadata` on the backend.
+
+#. Configure the translations if you use them: :ref:`configure-translations`
+
+#. Configure: :ref:`configure-emails`
+
+#. Configure: :ref:`configure-payment-methods`
+
+#. Configure: :ref:`configure-automatic-workflows`
+
+#. Configure: :ref:`configure-shipping-methods`
+
+#. Configure: :ref:`configure-warehouses`
+
+#. Configure: :ref:`configure-pricing`
+
+On the backend,
+
+#. Import the customer groups
+
+#. Optionally, import the partners, otherwise they
+   will be imported on the fly with the sales orders
+
+#. Import the product categories
+
+#. Configure the default values (accounting, ...)
+   of the new categories, using the :ref:`connector-checkpoint`
+
+#. Import the products
+
+#. Configure the new products (accounting, suppliers, stock rules, ...)
+   of the new products, using the :ref:`connector-checkpoint`
+
+#. Create an inventory for your products
+
+#. Update the stock quantities on Magento
+
+#. Import the sales orders
+
+#. Once you are all done and happy, configure the schedulers: :ref:`configure-schedulers`
+
+
+****************
+On a daily basis
+****************
+
+* :ref:`connector-checkpoint`
+* :ref:`monitor-resolve-jobs`

=== added file 'magentoerpconnect/doc/guides/key_questions.rst'
--- magentoerpconnect/doc/guides/key_questions.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/guides/key_questions.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,281 @@
+.. _key-questions:
+
+
+##################################################
+Key questions when connecting OpenERP with Magento
+##################################################
+
+Installing a connector between OpenERP and Magento
+is not as simple as clicking on the 'Install' button
+in the OpenERP Apps.
+
+In the e-commerce domain,
+there are many use cases
+which are strongly domain-specific.
+Every website has its own set of specific requirements.
+As such, the connector cannot include all the
+domain-specific requirements in a generic manner.
+
+This document lists the key questions
+you have to answer when connecting your applications.
+The questions link to the relevant part in the
+documentation when it currently exists.
+Some points have no response,
+but are things you have to consider and think
+before and meanwhile your setup.
+You can also consider it as
+a checklist for your implementation.
+
+**************
+Sale workflows
+**************
+
+Payment methods
+===============
+
+Are you going to use 'manual' payment types like check or invoices?
+
+Are you going to use 'automatic' payment types like bankcard, paypal,
+...?
+
+Each method needs to be configured, follows:
+:ref:`configure-payment-methods`.
+
+Automatic workflows
+===================
+
+For each `Payment methods`_,
+you will want to configure a different workflow,
+for instance,
+the sales orders of an automatic payment is automatically confirmed.
+
+More details on this configuration in
+:ref:`configure-automatic-workflows`.
+
+
+Exception rules
+===============
+
+Do you need to block a sale order according to some conditions?
+
+The connector adds this possibility,
+it applies some rules,
+for example, it blocks the sale order
+if the total amount is different in OpenERP and in Magento,
+so that is a safe-guard against errors.
+
+You can add your own rules, see :ref:`configure-exception-rules`.
+
+
+Support and Claims
+==================
+
+How will you handle them?
+
+*******
+Catalog
+*******
+
+Master of data
+==============
+
+Where should the data of the products be maintained and edited?
+
+Magento is the master of data:
+
+  Managing the catalog in Magento has the lowest impact on OpenERP.
+  Much information stay only on Magento
+  (product attributes, images, links).
+  The categories of products are still imported in OpenERP for
+  classification.
+  However 2 related informations will be updated in OpenERP and
+  exported to Magento:
+
+  * Price of the products, based on the OpenERP pricelists
+  * Available quantity in the stock
+
+OpenERP is the master of data:
+
+  As of today, the handling of the catalog
+  in the connector has not been implemented
+  (it was in the version for OpenERP 6.1).
+  It is in the :doc:`/project/roadmap` though.
+
+Types of products
+=================
+
+Magento is able to handle many types of products:
+simple, configurable, bundle, grouped, virtual, downloadable
+
+Special options can also be added on the products.
+
+None all of theses types are supported by the connector.
+All the product types are planned to be supported
+(:doc:`/project/roadmap`).
+But, as of today, only simple products are supported.
+Using advanced types of products like bundle or configurable,
+will need development,
+wether it is generic or specific to your implementation
+
+However, the fact is using a bundle or configurable products
+complexifies a lot the synchronizations of the products.
+If you need them, try to use only bundle, or only configurable.
+
+The special options would probably be part of a specific development.
+
+
+*******
+Pricing
+*******
+
+Taxes included
+==============
+
+When you input the prices of your products,
+are the taxes included?
+
+Note that, although it is possible to work with taxes included,
+that's never recommended because you will lose a lot in OpenERP,
+mainly in analysis.
+
+Only the base price is relevant,
+Magento itself can display tax included or tax excluded
+without issues.
+
+Discounts
+=========
+
+What kind of discount do you plan do use?
+OpenERP can't have such advanced discounts as Magento,
+so try to keep the things simple here
+if you do not want too much specific developments
+in your implementation.
+
+Pricing
+=======
+
+Do you plan to use multi-currency?
+
+Do you plan to have different prices per websites?
+You will need to create different price lists in OpenERP.
+
+**********
+Accounting
+**********
+
+Reconciliations
+===============
+
+The connector automatically reconcile the payments
+and the invoices entries for the 'automatic' workflows.
+
+However, you will still need to reconcile the bank entries.
+
+You may want to use the reconciliation modules of the
+branch `lp:banking-addons/bank-statement-reconcile/7.0`_.
+They are widely used in production and
+are specifically designed for the e-commerce.
+
+.. _`lp:banking-addons/bank-statement-reconcile/7.0`: https://code.launchpad.net/~banking-addons-team/banking-addons/bank-statement-reconcile-70
+
+
+Fiscal Positions
+================
+
+Due to the limitations of the Magento API and the intrinsic difference
+between OpenERP and Magento,
+the fiscal positions are not synchronized.
+If you need to use fiscal positions,
+you may want to use the module
+`account_fiscal_position_rules` in the project
+`lp:openerp-fiscal-rules`_.
+
+Note that this configuration will be done
+1 time in Magento and 1 time in OpenERP.
+But once the configuration is done, that works fine.
+
+.. _`lp:openerp-fiscal-rules`: https://code.launchpad.net/openerp-fiscal-rules
+
+
+*******************************
+Stock, availability, deliveries
+*******************************
+
+Shipping methods
+================
+
+Which shipping methods will be available?
+
+Configure them using the :ref:`configure-shipping-methods`.
+
+Warehouses
+==========
+
+How are you going to organize your warehouses,
+do you have several of them?
+If you have several Magento Stores,
+do you have a warehouse per store
+or do they share the same one?
+
+Keep in mind that Magento,
+in a standard installation,
+does not allow to have different stock quantities
+on each store.
+
+Shipping
+========
+
+Do you send partial deliveries, or only complete ones?
+
+Replacement of products
+=======================
+
+Do you sometimes replace products in the sales orders?
+Are you going to modify the sale order on Magento,
+or do you want to modify the delivery orders in OpenERP?
+
+The latter choice could be complicated because Magento
+does not allow to change products in delivery orders.
+
+Tracking and delivery labels
+============================
+
+Do you want tracking numbers on your deliveries?
+
+For the printing of your packets' labels,
+are you going to use external software
+or do you want to print them directly from OpenERP?
+
+.. todo:: add a pointer to the modules, I don't have the url actually.
+
+Management of returned goods
+============================
+
+How will you manage the returned goods (RMA)?
+
+
+*********
+Technical
+*********
+
+E-mails
+=======
+
+Would you want to send e-mails from Magento or from OpenERP?
+Which transactional e-mails do you plan to send?
+
+Translations
+============
+
+Do you need translations for the descriptions of your products?
+
+The language must be configured on the Magento Storeviews in OpenERP,
+think about it before importing your whole catalog.
+
+Which fields to synchronize
+===========================
+
+Think about which fields you have in Magento and you need in OpenERP.
+You will maybe need to create a customization module
+and add the mapping for the new fields,
+see :ref:`add-custom-mappings`

=== added file 'magentoerpconnect/doc/guides/monitor_resolve_jobs.rst'
--- magentoerpconnect/doc/guides/monitor_resolve_jobs.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/guides/monitor_resolve_jobs.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,83 @@
+.. _monitor-resolve-jobs:
+
+
+########################
+Monitor and resolve jobs
+########################
+
+Jobs are located in ``Connector > Queue > Jobs``.
+
+A job is a unit of work for a single synchronization action.
+Jobs are executed by the 'Workers'.
+
+***
+Q&A
+***
+
+My jobs are not executed, why?
+==============================
+
+The first thing to note is that the jobs are enqueued all the minutes.
+Their execution is not immediate.
+
+If you see no jobs executed in more than 1 minute, possibilities are:
+
+1. Jobs are assigned to a worker which died. A worker
+   can die when OpenERP reloads his modules registry (after a module
+   upgrade for instance). The dead workers are cleaned after 5 minutes,
+   then the jobs are enqueued in a new one.
+
+#. The jobs all have an ``eta`` (estimated time of arrival), so they
+   will be executed later.
+
+#. The scheduler action is not running, check in ``Settings > Scheduler
+   > Scheduled Actions`` if the action ``Enqueue Jobs`` is active.
+
+#. OpenERP is running in multiprocess and it doesn't have a Cron Worker
+   process running (when using Gunicorn).
+
+
+A job is in state 'Failed', what should I do?
+=============================================
+
+The job encountered a problem.
+Display the details of the job,
+a section displays information about the exception.
+
+The most comprehensible part of the error
+is at the bottom of the error trace.
+Sometimes, it proposes a resolution action.
+Other times, you'll have to dive deeper to find the cause of the issue.
+Anyway, once you think the issue should not happen anymore,
+you can retry the job by clicking on ``Requeue``.
+
+.. danger:: At any time, you can use the button ``Set to 'Done'``. This
+            button will cancel the job. It should be used only if you
+            really, really know what you are doing, because you may miss
+            important synchronizations actions.
+
+
+What happens if I shutdown the server when jobs are processing?
+===============================================================
+
+When jobs are interrupted, they won't commit any changes to the database
+and will be restarted on the start of the OpenERP server.
+
+Note that the actions performed on Magento by a job could of course not
+be reverted, so they will be done 2 times.
+
+
+Why do I have a couple of Workers?
+==================================
+
+When OpenERP is running in standalone (one process),
+you'll always have 1 Jobs Worker.
+When OpenERP is running in multiprocess,
+you'll have 1 Jobs Worker for each OpenERP worker.
+
+.. note:: To benefits of multiple workers, you need to:
+
+          * have multiple Cron Workers (using the ``--max-cron-threads``
+            option).
+          * Copy the Scheduled Actions ``Enqueue Jobs`` as many times as
+            you have Cron Workers.

=== added file 'magentoerpconnect/doc/guides/tutorial_customize.rst'
--- magentoerpconnect/doc/guides/tutorial_customize.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/guides/tutorial_customize.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,407 @@
+.. _tutorial-customize:
+
+
+#################################
+Tutorial: customize the connector
+#################################
+
+This tutorial will explain how you can customize several parts of the
+connector in your own OpenERP module. It assumes that you already have
+some knowledge in the OpenERP development. You can still refer to the
+`official OpenERP documentation`_.
+
+
+.. contents:: Sections:
+   :local:
+   :backlinks: top
+
+
+.. _official OpenERP documentation: http://doc.openerp.com/trunk/developers/server/
+
+***************************************
+Bootstrap your own customization module
+***************************************
+
+You should never make changes in the official modules, instead, you need
+to create your own module and apply your personalizations from there.
+
+As an example, throughout this tutorial, we'll create our own
+customization module, we'll name it, in a very original manner,
+``customize_example``. The final example module can be found in the root
+of the ``magentoerpconnect`` bazaar branch.
+
+Common OpenERP files
+====================
+
+A ``magentoerpconnect`` customization module is like any OpenERP module,
+so you will first need to create the **manifest**
+``customize_example/__openerp__.py``:
+
+.. code-block:: python
+   :emphasize-lines: 4,5
+
+    # -*- coding: utf-8 -*-
+    {'name': 'Magento Connector Customization',
+     'version': '1.0.0',
+     'category': 'Connector',
+     'depends': ['magentoerpconnect',
+                 ],
+     'author': 'Myself',
+     'license': 'AGPL-3',
+     'description': """
+    Magento Connector Customization
+    ===============================
+
+    Explain what this module changes.
+    """,
+     'data': [],
+     'installable': True,
+     'application': False,
+    }
+
+Nothing special but 2 things to note:
+
+* It depends from ``magentoerpconnect``.
+* The module category should preferably be ``Connector``.
+
+Of course, you also need to create the ``__init__.py`` file where you will
+put the imports of your python modules.
+
+Declare the module to the connector
+===================================
+
+Each module using the ``connector`` needs to create a special empty
+model, which will be used by the framework to know if the module is
+installed or not on each database.
+
+That's just a matter of following a convention and creating in ``customize_example/connector.py``::
+
+    from openerp.osv import orm
+
+
+    class customize_example_installed(orm.AbstractModel):
+        """Empty model used to know if the module is installed on the
+        database.
+
+        If the model is in the registry, the module is installed.
+        """
+        _name = 'customize_example.installed'
+
+Note:
+
+* the ``_name`` is in the form: ``module_name.installed``, where
+  ``.installed`` is the part which does never change.
+
+
+Create your custom Backend
+==========================
+
+The connector can support the synchronization with various Magento
+versions.
+
+Actually the supported versions are referenced in
+``magentoerpconnect/backend.py``::
+
+    import openerp.addons.connector.backend as backend
+
+    magento = backend.Backend('magento')
+    magento1700 = backend.Backend(parent=magento, version='1.7')
+
+In the connector, we are able to link pieces of code to a specific
+version of Magento. If I link a piece of code to ``magento1700``, it
+will be executed only if my Magento's version is actually Magento 1.7.
+
+``magento`` is the parent of ``magento1700``. When the latter has no
+specific piece of code, it will execute the former's one.
+
+As you want to change parts of code specifically to **your version** of
+Magento, you need to:
+
+* create your own backend version
+* link your custom parts of code with your own backend version (we'll
+  cover this later)
+
+Let's create our own backend, in ``customize_example/backend.py``::
+
+    # -*- coding: utf-8 -*-
+    import openerp.addons.connector.backend as backend
+    import openerp.addons.magentoerpconnect.backend as magento_backend
+
+    magento_myversion = backend.Backend(parent=magento_backend.magento1700,
+                                        version='1.7-myversion')
+
+And in ``customize_example/magento_model.py``::
+
+    # -*- coding: utf-8 -*-
+    from openerp.osv import orm
+
+
+    class magento_backend(orm.Model):
+        _inherit = 'magento.backend'
+
+        def _select_versions(self, cr, uid, context=None):
+            """ Available versions
+
+            Can be inherited to add custom versions.
+            """
+            versions = super(magento_backend, self)._select_versions(cr, uid, context=context)
+            versions.append(('1.7-myversion', '1.7 - My Version'))
+            return versions
+
+        _columns = {
+            'version': fields.selection(_select_versions, string='Version', required=True),
+        }
+
+Things to note:
+
+* The ``parent`` argument of my version is the 1.7 version. You have to
+  set the correct parent according to your Magento version. If your
+  Magento version does not exist, take the nearest version.
+* the version should be the same in the ``backend.Backend`` and the
+  model.
+* We add the version in the model ``magento.backend`` so we'll be able to
+  select it from the OpenERP front-end.
+* Do not forget to add the new python modules in ``__init__.py``.
+
+Use it in OpenERP
+=================
+
+Great, you now have the minimal stuff required to customize your
+connector. When you create your backend in OpenERP (menu ``Connectors >
+Magento > Backends``), you have now to select **1.7 - My Version**.
+
+In the next chapter, we'll cover the most common personalization:
+`Add mappings of fields`_.
+
+
+.. _add-custom-mappings:
+
+**********************
+Add mappings of fields
+**********************
+
+The mappings of the fields define how the fields are related between OpenERP and Magento.
+
+They defines whether field `A` should be written in field `B`, whether
+it should be converted then written to `C` and `D`, etc.
+
+To be able to customize the mappings, you need to already have a
+customization module. If that's not already done, you can go through the
+previous chapter: `Bootstrap your own customization module`_.
+
+We'll see how to map new fields on the imports.
+
+A bit of theory
+===============
+
+The mappings of the fields are defined in subclasses of
+:py:class:`connector.connector.unit.mapper.ImportMapper` or
+:py:class:`connector.connector.unit.mapper.ExportMapper`, respectively
+for the imports and the exports.
+
+.. note:: The connector almost never works with the OpenERP Models
+          directly. Instead, it works with its own models, which
+          ``_inherits`` (note the final ``s``) the base models. For
+          instance, the Magento model for ``res.partner`` is
+          ``magento.res.partner``. That's why you'll see
+          ``magento.res.partner`` below.
+
+          More details in `Magento Models`_.
+
+When you need to change the mappings, you'll need to dive in the
+``magentoerpconnect``'s code and locate the class which does this job for
+your model. You won't change anything on this class, but you'll extend
+it so you need to have a look on it.  For example, the mapping for
+``magento.res.partner`` in ``magentoerpconnect`` is the following
+(excerpt)::
+
+  @magento
+  class PartnerImportMapper(ImportMapper):
+      _model_name = 'magento.res.partner'
+
+      direct = [('email', 'email'),
+                ('dob', 'birthday'),
+                ('created_at', 'created_at'),
+                ('updated_at', 'updated_at'),
+                ('email', 'emailid'),
+                ('taxvat', 'taxvat'),
+                ('group_id', 'group_id'),
+                ]
+
+      @mapping
+      def is_company(self, record):
+          # partners are companies so we can bind
+          # addresses on them
+          return {'is_company': True}
+
+      @mapping
+      def names(self, record):
+          parts = [part for part in (record['firstname'],
+                                     record['middlename'],
+                                     record['lastname']) if part]
+          return {'name': ' '.join(parts)}
+
+      [...snip...]
+
+Here we can see 2 types of mappings:
+
+* ``direct`` mappings, a field in Magento is directly written in the
+  OpenERP field. The Magento field is on the left, the OpenERP one is on
+  the right.
+* methods decorated with ``@mapping``, when the mapping is more complex
+  and need to apply some logic. The name of the methods is meaningless.
+  They should return a ``dict`` with the field(s) to update and their
+  values. A ``None`` return value will be ignored.
+* the ``record`` argument receives the Magento record.
+
+.. note:: This is not covered here, but for the ``ExportMapper``, an
+          additional decorator ``@changed_by()`` is used to filter the
+          mappings to apply according to the fields modified in OpenERP.
+
+
+Magento Models
+==============
+
+As said in the previous section, the connector uses its own models
+on top of the base ones. The connector's models are usually in the form
+``magento.{model_name}``.
+
+Basically, a Magento Model is an ``_inherits`` from the base model, so
+it knows all the original fields along with its own. Its own fields are
+the ID of the record on Magento, the ``many2one`` relations to the
+``magento.backend`` or to the ``magento.website`` and the attributes
+which are peculiar to Magento.
+
+Example with an excerpt of the fields for ``magento.res.partner``:
+
+* ``openerp_id``: ``many2one`` to the ``res.partner`` (``_inherits``)
+* ``backend_id``: ``many2one`` to the ``magento.backend`` model (Magento
+  Instance), for the partner this is a ``related`` because we already
+  have a link to the website, itself associated to a ``magento.backend``.
+* ``website_id``: ``many2one`` to the ``magento.website`` model
+* ``magento_id``: the ID of the customer on Magento
+* ``group_id``: ``many2one`` to the ``magento.res.partner.category``,
+  itself a Magento model for ``res.partner.category`` (Customer Groups)
+* ``created_at``: created_at field from Magento
+* ``taxvat``: taxvat field from Magento
+* and all the fields from ``res.partner``
+
+This datamodel allows to:
+
+* Share the same ``res.partner`` with several ``magento.website``  (or
+  even several ``magento.backend``) as we can have as many
+  ``magento.res.partner`` as we want on top of a ``res.partner``.
+* The values can be different for each website or backend
+
+
+.. note:: In the mappings, we'll write some fields on ``res.partner``
+          (via ``_inherits``) and some on ``magento.res.partner``. When
+          we want to add a new field, we have to decide where to add it.
+          That's a matter of: does it make more sense do have this data
+          on the base model rather than on the Magento's one and should
+          this data be shared between all websites / backends?
+
+Examples
+========
+
+Example 1.
+----------
+
+I want to import the field ``created_in`` from customers.
+
+I add it on ``magento.res.partner`` because it doesn't make sense on
+``res.partner``.
+
+For this field, the Magento API returns a string. I add it in
+``customize_example/partner.py`` (I willingly skip the part 'add them in
+the views')::
+
+  # -*- coding: utf-8 -*-
+  from openerp.osv import orm, fields
+
+  class magento_res_partner(orm.Model):
+      _inherit = 'magento.res.partner'
+
+      _columns = {
+          'created_in': fields.char('Created In', readonly=True),
+      }
+
+
+In the same file, I add the import of the Magento Backend to use and the
+current mapper::
+
+  from openerp.addons.magentoerpconnect.partner import PartnerImportMapper
+  from .backend import magento_myversion
+
+And I extend the partner's mapper, decorated with
+``@magento_myversion``::
+
+  @magento_myversion
+  class MyPartnerImportMapper(PartnerImportMapper):
+      _model_name = 'magento.res.partner'
+
+      direct = PartnerImportMapper.direct + [('created_in', 'created_in')]
+
+And that's it! The field will be imported along with the other fields.
+
+.. attention:: Verify that you have selected the right version when you
+               have created your backend in ``Connectors > Magento > Backends``
+               otherwise your code will not be used.
+
+Example 2.
+----------
+
+I want to import the ``gender`` field. This one is a bit special because
+Magento maps 'Male' to ``123`` and 'Female' to ``124``. They are surely
+the identifiers of the attributes in Magento, and there's maybe an entry
+point in the API to get the proper values, but for the sake of the
+example, we'll assume we can hard-code theses values in the mappings.
+
+This time, I will create the field in ``res.partner``, because the value
+will likely be the same even if we have many ``magento.res.partner`` and
+this information can be useful at this level.
+
+In ``customize_example/partner.py``, I write::
+
+  # -*- coding: utf-8 -*-
+  from openerp.osv import orm, fields
+
+  class res_partner(orm.Model):
+      _inherit = 'res.partner'
+
+      _columns = {
+          'gender': fields.selection([('male', 'Male'),
+                                      ('female', 'Female')],
+                                     string='Gender'),
+      }
+
+The same imports than in the `Example 1.`_ are needed, but we need to
+import ``mapping`` too::
+
+  from openerp.addons.connector.unit.mapper import mapping
+  from openerp.addons.magentoerpconnect.partner import PartnerImportMapper
+  from .backend import magento_myversion
+
+This is not a `direct` mapping, I will use a method to define the
+``gender`` value::
+
+  MAGENTO_GENDER = {'123': 'male',
+                    '124': 'female'}
+
+  @magento_myversion
+  class MyPartnerImportMapper(PartnerImportMapper):
+      _model_name = 'magento.res.partner'
+
+      @mapping
+      def gender(self, record):
+          gender = MAGENTO_GENDER.get(record.get('gender'))
+          return {'gender': gender}
+
+The ``gender`` field will now be imported.
+
+And now?
+========
+
+With theses principles, you should now be able to extend the original
+mappings and add your own ones. This is applicable for the customers but
+for any other model actually imported as well.

=== added file 'magentoerpconnect/doc/guides/tutorial_development.rst'
--- magentoerpconnect/doc/guides/tutorial_development.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/guides/tutorial_development.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,398 @@
+.. _tutorial-development:
+
+
+Tutorial: development
+=====================
+
+This tutorial explains how to take part in the development of
+Magentoerpconnect. It will explain how to use the different pieces of
+the ``Connector`` addon to synchronize records with Magento.
+
+.. contents:: Sections:
+   :local:
+   :backlinks: top
+
+
+Run a function on an Event
+--------------------------
+
+3 events are registered in the ``Connector`` addon:
+
+* ``on_record_create``
+* ``on_record_write``
+* ``on_record_unlink``
+
+If you need to create a new :py:class:`connector.event.Event`, please
+refer to the ``Connector`` documentation.
+
+When a function has to be run when an event is fired, it must be
+registered on this event. Those functions are called ``Consumers``.
+
+In ``magentoerpconnect/consumer.py``, some consumers are already
+defined. You can add your one, it should be decorated by
+:py:func:`magentoerpconnect.consumer.magento_consumer` and by the event
+which has to fire it::
+
+    @on_record_write(model_names=['my.model'])
+    @magento_consumer
+    def my_consumer(session, model_name, record_id, fields=None):
+        print 'Yeah'
+
+.. note:: The consumers always start with the arguments ``session`` and
+          ``model_name``. The next arguments vary, but they are defined
+          by the :py:class:`connector.event.Event`
+
+
+Find the 'connector unit' for a model
+-------------------------------------
+
+Assume that you already have an ``Environment``.
+
+.. note:: An ``Environment`` is the scope where the synchronizations are
+          done. It contains the browse record of the backend
+          (``magento.backend``), a ``ConnectorSession`` (container for
+          ``cr``, ``uid``, ``context``) and the name of the model we are
+          working with).
+
+You can get an instance of the ``ConnectorUnit`` to use from the
+environment.  You'll need to ask a connector unit with the base class
+which interests you.  Say you want a Synchronizer which import records
+from Magento::
+
+    importer = environment.get_connector_unit(MagentoImportSynchronizer)
+
+``importer`` is an instance of the importer to use for the model of the
+environment.
+
+Say you want a binder for your model::
+
+    binder = environment.get_connector_unit(connector.Binder)
+
+``binder`` is an instance of the binder for your model.
+
+And so on...
+
+.. note:: Every ``ConnectorUnit`` instance keeps the environment as
+          attribute. It means that you can access to the environment
+          from a synchronizer with ``self.environment``.
+
+
+Create an import
+----------------
+
+You'll need to work on at least 4 connector units:
+
+* a Synchronizer (presumably 2, we'll see why soon)
+* a Mapper
+* a Backend Adapter
+* a Binder
+
+You will also need to create / change the OpenERP models.
+
+.. note:: Keep in mind: try to modify at least as possible the OpenERP
+          models and classes.
+
+The synchronizer will handle the flow of the synchronization. It will
+get the data from Magento using the Backend Adapter, transform it using
+the Mapper, and use the Binder(s) to search the relation(s) with other
+imported records.
+
+Why do we need 2 synchronizers? Because an import is generally done in 2
+phases:
+
+1. The first synchronizer searches the list of all the ids to import.
+2. The second synchronizer imports all the ids atomically.
+
+We'll see in details a simple import: customer groups.
+Customer groups are importer as categories of partners
+(``res.partner.category``).
+
+Models
+''''''
+
+First, we create the model::
+
+    class magento_res_partner_category(orm.Model):
+        _name = 'magento.res.partner.category'
+        _inherit = 'magento.binding'
+        _inherits = {'res.partner.category': 'openerp_id'}
+
+        _columns = {
+            'openerp_id': fields.many2one('res.partner.category',
+                                           string='Partner Category',
+                                           required=True,
+                                           ondelete='cascade'),
+            'tax_class_id': fields.integer('Tax Class ID'),
+        }
+
+        _sql_constraints = [
+            ('magento_uniq', 'unique(backend_id, magento_id)',
+             'A partner tag with same ID on Magento already exists.'),
+        ]
+
+Observations:
+
+* We do not change ``res.partner.category`` but create a
+  ``magento.res.partner.category`` model instead.
+* It `_inherit` from `magento.binding`
+* It contains the links to the Magento backend, the category and the
+  ID on Magento.
+* This model stores the data related to one category and one Magento
+  backend as well, so this data does not pollute the category and does
+  not criss-cross when several backends are connected.
+* It ``_inherits`` the ``res.partner.category`` so we can directly use
+  this model for the imports and the exports without complications.
+
+We need to add the field ``magento_bind_ids`` in
+``res.partner.category`` to relate to the Magento Bindings::
+
+    class res_partner_category(orm.Model):
+        _inherit = 'res.partner.category'
+
+        _columns = {
+            'magento_bind_ids': fields.one2many(
+                'magento.res.partner.category',
+                'openerp_id',
+                string='Magento Bindings',
+                readonly=True),
+        }
+
+That's the only thing we need to change (besides the view) on the
+OpenERP category!
+
+.. note:: The name of the field ``magento_bind_ids`` is a convention.
+
+Ok, we're done with the models. Now the **synchronizations**!
+
+Batch Importer
+''''''''''''''
+
+The first Synchronizer, which get the full list of ids to import is
+usually a subclass of
+:py:class:`magentoerpconnect.unit.import_synchronizer.BatchImportSynchronizer`.
+
+The customer groups are simple enough to use a generic class::
+
+    @magento
+    class DelayedBatchImport(BatchImportSynchronizer):
+        """ Delay import of the records """
+        _model_name = [
+                'magento.res.partner.category',
+                ]
+
+        def _import_record(self, record):
+            """ Delay the import of the records"""
+            job.import_record.delay(self.session,
+                                    self.model._name,
+                                    self.backend_record.id,
+                                    record)
+
+Observations:
+
+* Decorated by ``@magento``: this synchronizer will be available for all
+  versions of Magento. Decorated with ``@magento1700`` it would be only
+  available for Magento 1.7.
+* ``_model_name``: the list of models allowed to use this synchronizer
+* We just override the ``_import_record`` hook, the search has already
+  be done in
+  :py:class:`magentoerpconnect.unit.import_synchronizer.BatchImportSynchronizer`.
+* ``import_record`` is a job to import a record from its ID.
+* Delay the import of each record, a job will be created for each record id.
+* This synchronization does not need any Binder nor Mapper, but does
+  need a Backend Adapter to be able to speak with Magento.
+
+So, let's implement the **Backend Adapter**.
+
+Backend Adapter
+'''''''''''''''
+
+Most of the Magento objects can use the generic class
+:py:class`magentoerpconnect.unit.backend_adapter.GenericAdapter`.
+However, the ``search`` entry point is not implemented in the API for
+customer groups.
+
+We'll replace it using ``list`` and select only the ids::
+
+    @magento
+    class PartnerCategoryAdapter(GenericAdapter):
+        _model_name = 'magento.res.partner.category'
+        _magento_model = 'ol_customer_groups'
+
+        def search(self, filters=None):
+            """ Search records according to some criterias
+            and returns a list of ids
+
+            :rtype: list
+            """
+            with magentolib.API(self.magento.location,
+                                self.magento.username,
+                                self.magento.password) as api:
+                return [int(row['customer_group_id']) for row
+                           in api.call('%s.list' % self._magento_model,
+                                       [filters] if filters else [{}])]
+            return []
+
+Observations:
+
+* ``_model_name`` is just ``magento.res.partner.category``, this adapter
+  is available only for this model.
+* ``_magento_model`` is the first part of the entry points in the API
+  (ie. ``ol_customer_groups.list``)
+* Only the ``search`` method is overriden.
+
+We have all the pieces for the first part of the synchronization, just
+need to...
+
+Delay execution of our Batch Import
+'''''''''''''''''''''''''''''''''''
+
+This import will be called from the **Magento Backend**, we modify it in
+``magentoerpconnect/magento_model.py`` and add a method (to add in the
+view as well, I won't write the view code here)::
+
+    def import_customer_groups(self, cr, uid, ids, context=None):
+        if not hasattr(ids, '__iter__'):
+            ids = [ids]
+        session = connector.ConnectorSession(cr, uid, context=context)
+        for backend_id in ids:
+            job.import_batch.delay(session, 'magento.res.partner.category',
+                                   backend_id)
+
+        return True
+
+Observations:
+
+* Declare a :py:class:`connector.connector.ConnectorSession`.
+* Delay the job ``import_batch`` when we click on the button.
+* if the arguments were given to ``import_batch`` directly, the import
+  would be done synchronously.
+
+Overview on the jobs
+''''''''''''''''''''
+
+We use 2 jobs: ``import_record`` and ``import_batch``. These jobs are
+already there so you don't need to write them, but we can have a look
+on them to understand what they do::
+
+    def _get_environment(session, model_name, backend_id):
+        model = session.pool.get('magento.backend')
+        backend_record = model.browse(session.cr,
+                                      session.uid,
+                                      backend_id,
+                                      session.context)
+        return connector.Environment(backend_record, session, model_name)
+
+
+    @connector.job
+    def import_batch(session, model_name, backend_id, filters=None):
+        """ Prepare a batch import of records from Magento """
+        env = _get_environment(session, model_name, backend_id)
+        importer = env.get_connector_unit(BatchImportSynchronizer)
+        importer.run(filters)
+
+
+    @connector.job
+    def import_record(session, model_name, backend_id, magento_id):
+        """ Import a record from Magento """
+        env = _get_environment(session, model_name, backend_id)
+        importer = env.get_connector_unit(MagentoImportSynchronizer)
+        importer.run(magento_id)
+
+Observations:
+
+* Decorated by :py:class:`connector.connector.queue.job.job`, allow to
+  ``delay`` the function.
+* We create a new environment and ask for the good importer, respectively
+  for batch imports and record imports. The environment returns an
+  instance of the importer to use.
+* The docstring of the job is its description for the user.
+
+At this point, if one click on the button to import the categories, the
+batch import would run, generate one job for each category to import,
+and then all these jobs would fail. We need to create the second
+synchronizer, the mapper and the binder.
+
+Record Importer
+'''''''''''''''
+
+The import of customer groups is so simple that it can use a generic
+class
+:py:class:`magentoerpconnect.unit.import_synchronizer.SimpleRecordImport`.
+We just need to add the model in the ``_model_name`` attribute::
+
+    @magento
+    class SimpleRecordImport(MagentoImportSynchronizer):
+        """ Import one Magento Website """
+        _model_name = [
+                'magento.website',
+                'magento.store',
+                'magento.storeview',
+                'magento.res.partner.category',
+            ]
+
+However, most of the imports will be more complicated than that. You
+will often need to create a new class for a model, where you will need
+to use some of the hooks to change the behavior
+(``_import_dependencies``, ``_after_import`` for example).
+Refers to the importers already created in the module and to the base
+class
+:py:class:`magentoerpconnect.unit.import_synchronizer.MagentoImportSynchronizer`.
+
+The synchronizer asks to the appropriate **Mapper** to transform the data
+(in ``_map_data``). Here is how we'll create the **Mapper**.
+
+Mapper
+''''''
+
+The mapper takes the record from Magento, and generates the OpenERP
+record. (or the reverse for the export Mappers)
+
+The mapper for the customer groups is as follows::
+
+    @magento
+    class PartnerCategoryImportMapper(connector.ImportMapper):
+        _model_name = 'magento.res.partner.category'
+
+        direct = [
+                ('customer_group_code', 'name'),
+                ('tax_class_id', 'tax_class_id'),
+                ]
+
+        @mapping
+        def magento_id(self, record):
+            return {'magento_id': record['customer_group_id']}
+
+        @mapping
+        def backend_id(self, record):
+            return {'backend_id': self.backend_record.id}
+
+
+Observations:
+
+* Some mappings are in ``direct`` and some use a method with a
+  ``@mapping`` decorator.
+* Methods allow to have more complex mappings.
+
+Binder
+''''''
+
+For the last piece of the construct, it will be an easy one, because
+normally all the Magento Models will use the same Binder, the so called
+:py:class:`magentoerpconnect.unit.binder.MagentoModelBinder`.
+
+We just need to add our model in the ``_model_name`` attribute::
+
+    @magento
+    class MagentoModelBinder(MagentoBinder):
+        """
+        Bindings are done directly on the model
+        """
+        _model_name = [
+                'magento.website',
+                'magento.store',
+                'magento.storeview',
+                'magento.res.partner.category',
+            ]
+
+    [...]
+

=== added directory 'magentoerpconnect/doc/howto'
=== added file 'magentoerpconnect/doc/howto/configure_automatic_workflows.rst'
--- magentoerpconnect/doc/howto/configure_automatic_workflows.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/howto/configure_automatic_workflows.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,12 @@
+.. _configure-automatic-workflows:
+
+
+####################################
+Howto: configure automatic workflows
+####################################
+
+Find the configuration in the menu
+`Sales > Configuration > Sales > Automatic Workflow`.
+
+
+.. todo:: document the configuration

=== added file 'magentoerpconnect/doc/howto/configure_emails.rst'
--- magentoerpconnect/doc/howto/configure_emails.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/howto/configure_emails.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,14 @@
+.. _configure-emails:
+
+#######################
+How to configure emails
+#######################
+
+On the Magento Stores, activate the options:
+
+* Send email notification on picking done
+* Send email notification on invoice paid
+
+If you want Magento to send email on thoses events.
+
+You can otherwise configure OpenERP to send e-mails.

=== added file 'magentoerpconnect/doc/howto/configure_exception_rules.rst'
--- magentoerpconnect/doc/howto/configure_exception_rules.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/howto/configure_exception_rules.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,12 @@
+.. _configure-exception-rules:
+
+
+################################
+Howto: configure exception rules
+################################
+
+Find the configuration in the menu
+`Sales > Configuration > Sales > Exception Rules`.
+
+
+.. todo:: document the configuration

=== added file 'magentoerpconnect/doc/howto/configure_payment_methods.rst'
--- magentoerpconnect/doc/howto/configure_payment_methods.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/howto/configure_payment_methods.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,14 @@
+.. _configure-payment-methods:
+
+
+################################
+Howto: configure payment methods
+################################
+
+Find the configuration in the menu
+`Sales > Configuration > Sales > E-Commerce Payment Methods`.
+
+The name of the payment method is the code of the payment in Magento,
+for instance: `checkmo`.
+
+.. todo:: document the configuration

=== added file 'magentoerpconnect/doc/howto/configure_pricing.rst'
--- magentoerpconnect/doc/howto/configure_pricing.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/howto/configure_pricing.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,41 @@
+.. _configure-pricing:
+
+
+########################
+How to configure pricing
+########################
+
+Install the pricing extensions by going in: `Settings > Configuration >
+Connector` and by checking the `Price are managed in OpenERP with
+pricelists` option.
+
+**********************************
+Prices are shared accross websites
+**********************************
+
+The pricelist used for the prices sent to Magento is configured on the
+Magento Backend (`Connectors > Magento > Backends`).
+
+*************************************
+Prices are different accross websites
+*************************************
+
+.. note:: Verify that the option `Use pricelists to adapt your price per
+          customers` is active in the OpenERP `Settings > Configuration
+          > Sales`.
+
+The pricelist used for the prices sent to Magento is configured on the
+Magento Backend (`Connectors > Magento > Backends`). Magento will use
+theses prices as default prices.
+
+.. note:: In Magento, the default is to share the prices between websites.
+          If you want to have different prices per websites, go to
+          `System > Catalog > Catalog > Price` and set the `Catalog
+          Price Scope` to `Website` instead of `Global`.
+
+When you need different prices for a website, set the pricelist for this
+website in `Connectors > Magento > Websites`.
+
+.. warning:: The prices are actually updated on Magento when the price
+             is changed on the products, not when a pricelist is
+             modified.

=== added file 'magentoerpconnect/doc/howto/configure_schedulers.rst'
--- magentoerpconnect/doc/howto/configure_schedulers.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/howto/configure_schedulers.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,25 @@
+.. _configure-schedulers:
+
+###########################
+How to configure schedulers
+###########################
+
+Once your configuration is fine,
+you will want to automate the import
+of the products, sales orders, ...
+
+Go to `Settings > Technical > Scheduler > Scheduled Actions`.
+
+Activate the wanted schedulers:
+
+* Magento - Import Customer Groups
+
+* Magento - Import Partners
+
+* Magento - Import Product Categories
+
+* Magento - Import Sales Orders
+
+* Magento - Update Stock Quantities
+
+You can change the `Interval Number` and `Interval Unit` as well.

=== added file 'magentoerpconnect/doc/howto/configure_shipping_methods.rst'
--- magentoerpconnect/doc/howto/configure_shipping_methods.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/howto/configure_shipping_methods.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,36 @@
+.. _configure-shipping-methods:
+
+
+#################################
+How to configure shipping methods
+#################################
+
+Find the configuration in the menu
+`Warehouse > Configuration > Delivery Methods`.
+
+For each shipping method in Magento,
+you need to create a delivery method in OpenERP.
+
+The connector creates a product `[SHIP] Shipping costs`,
+you can use it for the Delivery Product.
+
+.. note:: If you import a sale order but the shipping method does not
+          exist, it will create it for you. But the configuration will
+          not be correct, so you better have to create them before
+          any import.
+
+The 'Magento Carrier Code' is the code of the shipping method in Magento,
+for instance: `flatrate_flatrate`.
+
+The 'Magento Tracking Title' is the text which will be displayed on
+Magento next to the tracking number.
+
+'Export tracking numbers' defines wether the tracking numbers should be
+sent to Magento.
+
+
+
+.. warning:: If you use the `flatrate` shipping method, you need to
+             deactivate the option `Export tracking numbers` because
+             this shipping method does not support to send tracking
+             numbers.

=== added file 'magentoerpconnect/doc/howto/configure_translations.rst'
--- magentoerpconnect/doc/howto/configure_translations.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/howto/configure_translations.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,15 @@
+.. _configure-translations:
+
+
+#############################
+How to configure translations
+#############################
+
+If you have different translations on Magento,
+say one store view displayed in english and a second in french,
+you have to configure the languages to use in OpenERP.
+
+1. Set the default language in the Magento Backend (`Connectors > Magento > Backend`)
+   in the field `Default Language`.
+2. Then, for each storeview (`Connectors > Magento > Storeviews`),
+   change the language of the storeview.

=== added file 'magentoerpconnect/doc/howto/configure_warehouse.rst'
--- magentoerpconnect/doc/howto/configure_warehouse.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/howto/configure_warehouse.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,19 @@
+.. _configure-warehouses:
+
+###########################
+How to configure warehouses
+###########################
+
+The warehouse defined on the Magento Backend
+(`Connectors > Magento > Backend`) is the
+warehouse used to update the stock quantities on Magento.
+
+On the backend, you can also change the field from which the
+stock quantity is read in the product.
+By default, the quantity send to Magento is the forecasted quantity,
+but you can use another standard or custom field by changing the field
+`Stock Field`.
+
+For each Magento Store, the connector has created an OpenERP Sale Shop.
+So you may want to check the Sales Shops to ensure they have the correct
+warehouses.

=== added file 'magentoerpconnect/doc/howto/modify_an_order.rst'
--- magentoerpconnect/doc/howto/modify_an_order.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/howto/modify_an_order.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,45 @@
+.. _modify-an-order:
+
+
+###################################
+How to cancel / modify a sale order
+###################################
+
+****************************************
+Handle a sale order cancelled on Magento
+****************************************
+
+If a sales order has already been imported in OpenERP and is cancelled
+in Magento, the change won't be reflected in OpenERP.  If a sales order
+is still waiting for a payment and is canceled, it won't be imported in
+OpenERP.
+
+*******************
+Modify a sale order
+*******************
+
+When you need to modify a product in a sale order,
+you should not modify it in the sale order directly.
+The sale order represents what the customer really ordered.
+
+You would be able to change the product in the delivery order.
+But Magento does not accept any change in the shipments,
+so it won't be modified on the Magento side
+(and you will have issues with partial deliveries).
+The changes would not be repercuted on the invoices neither.
+
+Instead, you can modify the sale order on the Magento backend.
+When Magento modifies a sale order,
+it cancels it and creates a new one.
+When the new order is imported in OpenERP,
+it flags the old one as 'Cancelled on Backend',
+then link the new order with the old one as a 'parent' order.
+
+If it can automatically cancel the parent order,
+it will do it.
+Otherwise, you'll have to handle it manually.
+You can search for them using the search filters.
+
+Until the old sale order is not cancelled or done,
+a rule prevents the new and the parent sales orders
+to be confirmed.

=== added file 'magentoerpconnect/doc/index.rst'
--- magentoerpconnect/doc/index.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/index.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,154 @@
+.. Connectors documentation master file, created by
+   sphinx-quickstart on Mon Feb  4 11:35:44 2013.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+#########################
+Magento OpenERP Connector
+#########################
+
+This is the new release of the Open-Source connector linking OpenERP and
+Magento also known under the name of **Magentoerpconnect**.  It is
+build on top of the `connector`_ framework. It is is structured so that
+it can be extended or modified easily from separate addons, a factor of
+success when the implementations of Magento vary a lot.
+
+Magento OpenERP Connector is mainly developed by the Magentoerpconnect Core
+Editors, these being Camptocamp_ and Akretion_. The `source is on
+launchpad`_.
+
+This connector is designed to have a strong and efficient core, with the
+ability to extend it with extension modules or local customizations.
+
+.. _connector: https://code.launchpad.net/openerp-connector
+.. _Camptocamp: http://www.camptocamp.com
+.. _Akretion: http://www.akretion.com
+.. _`source is on launchpad`: https://launchpad.net/magentoerpconnect
+
+
+***********
+First steps
+***********
+
+.. toctree::
+   :maxdepth: 2
+
+   guides/installation_guide
+   guides/key_questions
+
+
+***********************************
+Using and configuring the connector
+***********************************
+
+Be efficient using and configuring the connector.
+
+.. toctree::
+   :maxdepth: 1
+
+   howto/configure_translations
+   howto/configure_warehouse
+   howto/configure_pricing
+   howto/configure_payment_methods
+   howto/configure_automatic_workflows
+   howto/configure_exception_rules
+   howto/configure_shipping_methods
+   howto/configure_emails
+   howto/configure_schedulers
+   guides/connector_checkpoint
+   guides/monitor_resolve_jobs
+   howto/modify_an_order
+
+
+***************************
+Developing on the connector
+***************************
+
+Learn about how you can contribute or use the connector as a developer.
+
+Develop
+=======
+
+.. toctree::
+   :maxdepth: 2
+
+   guides/tutorial_development
+   guides/tutorial_customize
+
+
+API
+===
+
+General API
+-----------
+
+.. toctree::
+   :maxdepth: 2
+
+   api/api_connector.rst
+   api/api_consumer.rst
+   api/api_backend.rst
+   api/api_binder.rst
+   api/api_synchronizer.rst
+   api/api_backend_adapter.rst
+   api/api_exception.rst
+
+Models API
+----------
+
+.. toctree::
+   :maxdepth: 2
+
+   api/api_delivery.rst
+   api/api_invoice.rst
+   api/api_magento_model.rst
+   api/api_partner.rst
+   api/api_partner_category.rst
+   api/api_product.rst
+   api/api_product_category.rst
+   api/api_sale.rst
+   api/api_stock_picking.rst
+   api/api_stock_tracking.rst
+
+
+Project
+=======
+
+.. toctree::
+   :maxdepth: 1
+
+   project/roadmap
+   project/contributors
+   project/contribute
+   project/changes
+
+
+Concepts
+========
+
+Glossary:
+
+.. glossary::
+
+    Job
+
+        A unit of work consisting of a single complete and atomic task.
+        Example: import of a product.
+
+    Backend
+
+        An external service on which we connect OpenERP. In the context
+        of the Magento connector, Magento is a backend.
+
+    Mapping
+
+        A mapping defines how the data is converted from Magento to
+        OpenERP and reversely.
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`
+

=== added file 'magentoerpconnect/doc/make.bat'
--- magentoerpconnect/doc/make.bat	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/make.bat	2013-08-13 17:30:12 +0000
@@ -0,0 +1,190 @@
+@ECHO OFF
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+	set SPHINXBUILD=sphinx-build
+)
+set BUILDDIR=_build
+set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% .
+set I18NSPHINXOPTS=%SPHINXOPTS% .
+if NOT "%PAPER%" == "" (
+	set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
+	set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS%
+)
+
+if "%1" == "" goto help
+
+if "%1" == "help" (
+	:help
+	echo.Please use `make ^<target^>` where ^<target^> is one of
+	echo.  html       to make standalone HTML files
+	echo.  dirhtml    to make HTML files named index.html in directories
+	echo.  singlehtml to make a single large HTML file
+	echo.  pickle     to make pickle files
+	echo.  json       to make JSON files
+	echo.  htmlhelp   to make HTML files and a HTML help project
+	echo.  qthelp     to make HTML files and a qthelp project
+	echo.  devhelp    to make HTML files and a Devhelp project
+	echo.  epub       to make an epub
+	echo.  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter
+	echo.  text       to make text files
+	echo.  man        to make manual pages
+	echo.  texinfo    to make Texinfo files
+	echo.  gettext    to make PO message catalogs
+	echo.  changes    to make an overview over all changed/added/deprecated items
+	echo.  linkcheck  to check all external links for integrity
+	echo.  doctest    to run all doctests embedded in the documentation if enabled
+	goto end
+)
+
+if "%1" == "clean" (
+	for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i
+	del /q /s %BUILDDIR%\*
+	goto end
+)
+
+if "%1" == "html" (
+	%SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished. The HTML pages are in %BUILDDIR%/html.
+	goto end
+)
+
+if "%1" == "dirhtml" (
+	%SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.
+	goto end
+)
+
+if "%1" == "singlehtml" (
+	%SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml.
+	goto end
+)
+
+if "%1" == "pickle" (
+	%SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished; now you can process the pickle files.
+	goto end
+)
+
+if "%1" == "json" (
+	%SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished; now you can process the JSON files.
+	goto end
+)
+
+if "%1" == "htmlhelp" (
+	%SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished; now you can run HTML Help Workshop with the ^
+.hhp project file in %BUILDDIR%/htmlhelp.
+	goto end
+)
+
+if "%1" == "qthelp" (
+	%SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished; now you can run "qcollectiongenerator" with the ^
+.qhcp project file in %BUILDDIR%/qthelp, like this:
+	echo.^> qcollectiongenerator %BUILDDIR%\qthelp\Connectors.qhcp
+	echo.To view the help file:
+	echo.^> assistant -collectionFile %BUILDDIR%\qthelp\Connectors.ghc
+	goto end
+)
+
+if "%1" == "devhelp" (
+	%SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished.
+	goto end
+)
+
+if "%1" == "epub" (
+	%SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished. The epub file is in %BUILDDIR%/epub.
+	goto end
+)
+
+if "%1" == "latex" (
+	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.
+	goto end
+)
+
+if "%1" == "text" (
+	%SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished. The text files are in %BUILDDIR%/text.
+	goto end
+)
+
+if "%1" == "man" (
+	%SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished. The manual pages are in %BUILDDIR%/man.
+	goto end
+)
+
+if "%1" == "texinfo" (
+	%SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo.
+	goto end
+)
+
+if "%1" == "gettext" (
+	%SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Build finished. The message catalogs are in %BUILDDIR%/locale.
+	goto end
+)
+
+if "%1" == "changes" (
+	%SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.The overview file is in %BUILDDIR%/changes.
+	goto end
+)
+
+if "%1" == "linkcheck" (
+	%SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Link check complete; look for any errors in the above output ^
+or in %BUILDDIR%/linkcheck/output.txt.
+	goto end
+)
+
+if "%1" == "doctest" (
+	%SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest
+	if errorlevel 1 exit /b 1
+	echo.
+	echo.Testing of doctests in the sources finished, look at the ^
+results in %BUILDDIR%/doctest/output.txt.
+	goto end
+)
+
+:end

=== added directory 'magentoerpconnect/doc/project'
=== added file 'magentoerpconnect/doc/project/changes.rst'
--- magentoerpconnect/doc/project/changes.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/project/changes.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,8 @@
+.. _changes:
+
+#######
+Changes
+#######
+
+.. include:: ../../CHANGES.rst
+   :start-line: 3

=== added file 'magentoerpconnect/doc/project/contribute.rst'
--- magentoerpconnect/doc/project/contribute.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/project/contribute.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,19 @@
+.. _contribute:
+
+##########
+Contribute
+##########
+
+We do accept merge proposals!
+
+
+.. todo:: Complete this page.
+
+          Some topics to cover:
+
+          * mailing list (irc?)
+          * bug reports
+          * submit merge proposals for features or fixes
+          * use and write tests
+          * improve documentation
+          * translations

=== added file 'magentoerpconnect/doc/project/contributors.rst'
--- magentoerpconnect/doc/project/contributors.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/project/contributors.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,10 @@
+############
+Contributors
+############
+
+Special thanks to:
+
+* Mohammed Nahhas for creating Maverick-Entity-Generator_ to help us in
+  our tests.
+
+.. _Maverick-Entity-Generator: https://github.com/maverick193/entity-generator

=== added file 'magentoerpconnect/doc/project/roadmap.rst'
--- magentoerpconnect/doc/project/roadmap.rst	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/doc/project/roadmap.rst	2013-08-13 17:30:12 +0000
@@ -0,0 +1,61 @@
+.. _roadmap:
+
+
+#######
+Roadmap
+#######
+
+This document lists the feature that we want to develop for the
+connector. They are not sorted by priority. Any contribution on theses
+points will be welcome.
+
+*******
+Catalog
+*******
+
+Types of products
+=================
+
+* Support of Bundles with a split in the sale order
+
+* Support of Bundles with a manufacturing order
+
+* Support of Configurables
+
+* Support of Grouped products
+
+* Support of Virtual products
+
+* Support of Downloadable products
+
+Product links
+=============
+
+* Import of links
+
+* Related, Upsell, Cross-sell, ...
+
+* Gifts
+
+Product images
+==============
+
+* Import product images
+
+* Management of several images on a product
+
+Export of the catalog
+=====================
+
+* Export products
+
+* Export product categories
+
+* Export product links
+
+* Export product images
+
+Pricing
+=======
+
+* Push the new prices to Magento when a pricelist is modified

=== added file 'magentoerpconnect/exception.py'
--- magentoerpconnect/exception.py	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/exception.py	2013-08-13 17:30:12 +0000
@@ -0,0 +1,26 @@
+# -*- coding: utf-8 -*-
+##############################################################################
+#
+#    Author: Guewen Baconnier
+#    Copyright 2013 Camptocamp SA
+#
+#    This program is free software: you can redistribute it and/or modify
+#    it under the terms of the GNU Affero General Public License as
+#    published by the Free Software Foundation, either version 3 of the
+#    License, or (at your option) any later version.
+#
+#    This program is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU Affero General Public License for more details.
+#
+#    You should have received a copy of the GNU Affero General Public License
+#    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+##############################################################################
+
+from openerp.addons.connector.exception import RetryableJobError
+
+
+class OrderImportRuleRetry(RetryableJobError):
+    """ The sale order import will be retried later. """

=== added directory 'magentoerpconnect/i18n'
=== added file 'magentoerpconnect/i18n/fr_FR.po'
--- magentoerpconnect/i18n/fr_FR.po	1970-01-01 00:00:00 +0000
+++ magentoerpconnect/i18n/fr_FR.po	2013-08-13 17:30:12 +0000
@@ -0,0 +1,1007 @@
+# Translation of OpenERP Server.
+# This file contains the translation of the following modules:
+#	* magentoerpconnect
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: OpenERP Server 7.0\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2013-05-01 12:45+0000\n"
+"PO-Revision-Date: 2013-05-01 12:45+0000\n"
+"Last-Translator: <>\n"
+"Language-Team: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: \n"
+"Plural-Forms: \n"
+
+#. module: magentoerpconnect
+#: help:magento.backend,pricelist_id:0
+msgid "The price list used to define the prices of the products in Magento."
+msgstr "La liste de prix utilisée pour définir les prix des articles sur Magento."
+
+#. module: magentoerpconnect
+#: help:magento.store,send_invoice_paid_mail:0
+msgid "Does the invoice export/creation should send an email notification on Magento side?"
+msgstr "Définit si Magento doit envoyer un e-mail lors de l'export des factures."
+
+#. module: magentoerpconnect
+#: view:magento.backend:0
+msgid "Import sales orders from all store views"
+msgstr "Importer les commandes depuis toutes les vues magasin"
+
+#. module: magentoerpconnect
+#: model:sale.exception,description:magentoerpconnect.excep_wrong_total_amount_tax
+msgid "The tax amount computed in OpenERP doesn't match with the tax amount in Magento.\n"
+"\n"
+"Cause:\n"
+"The taxes are probably different between OpenERP and Magento. A fiscal position could have changed the final price.\n"
+"\n"
+"Resolution:\n"
+"Check your taxes and fiscal positions configuration and correct them if necessary."
+msgstr "Les taxes calculées par OpenERP ne correspondent pas aux tax calculées par Magento.\n"
+"\n"
+"Cause:\n"
+"La configuration des taxes est probablement différente entre OpenERP et Magento. Une position fiscale peut avoir modifié le prix final.\n"
+"\n"
+"Résolution:\n"
+"Contrôler la configuration des taxes et positions fiscales et les corriger si nécessaire."
+
+#. module: magentoerpconnect
+#: help:magento.backend,warehouse_id:0
+msgid "Warehouse used to compute the stock quantities."
+msgstr "Entrepôt utilisé pour calculer les quantités en stock."
+
+#. module: magentoerpconnect
+#: field:magento.account.invoice,sync_date:0
+#: field:magento.address,sync_date:0
+#: field:magento.binding,sync_date:0
+#: field:magento.product.category,sync_date:0
+#: field:magento.product.product,sync_date:0
+#: field:magento.res.partner,sync_date:0
+#: field:magento.res.partner.category,sync_date:0
+#: field:magento.sale.order,sync_date:0
+#: field:magento.sale.order.line,sync_date:0
+#: field:magento.stock.picking.out,sync_date:0
+#: field:magento.store,sync_date:0
+#: field:magento.storeview,sync_date:0
+#: field:magento.website,sync_date:0
+msgid "Last synchronization date"
+msgstr "Dernière date de synchronisation"
+
+#. module: magentoerpconnect
+#: help:magento.backend,default_category_id:0
+msgid "If a default category is selected, products imported without a category will be linked to it."
+msgstr "Si une catégorie par défaut est sélectionnée, les articles importés sans catégorie y seront liés."
+
+#. module: magentoerpconnect
+#: help:magento.storeview,import_orders_from_date:0
+msgid "do not consider non-imported sale orders before this date. Leave empty to import all sale orders"
+msgstr "Ignore les commandes non importées avant cette date. Laisser vide pour importer toutes les commandes."
+
+#. module: magentoerpconnect
+#: help:magento.store,send_picking_done_mail:0
+msgid "Does the picking export/creation should send an email notification on Magento side?"
+msgstr "Définit si Magento doit envoyer un e-mail lors de l'export des bons de livraisons."
+
+#. module: magentoerpconnect
+#: selection:magento.product.product,manage_stock:0
+msgid "Do Not Manage Stock"
+msgstr "Ne pas gérer les stock"
+
+#. module: magentoerpconnect
+#: field:connector.config.settings,module_magentoerpconnect_catalog:0
+msgid "Handle the product's catalog (not implemented)"
+msgstr "Gérer le catalogue d'articles depuis OpenERP (non supporté)"
+
+#. module: magentoerpconnect
+#: field:res.partner,company:0
+msgid "Company"
+msgstr "Société"
+
+#. module: magentoerpconnect
+#: sql_constraint:magento.website:0
+msgid "A website with the same ID on Magento already exists."
+msgstr "Un site web avec le même ID sur Magento existe déjà."
+
+#. module: magentoerpconnect
+#: field:magento.backend,import_categories_from_date:0
+msgid "Import categories from date"
+msgstr "Importer les catégories depuis la date"
+
+#. module: magentoerpconnect
+#: view:account.invoice:0
+#: field:account.invoice,magento_bind_ids:0
+#: view:product.category:0
+#: field:product.category,magento_bind_ids:0
+#: view:product.product:0
+#: field:product.product,magento_bind_ids:0
+#: view:res.partner:0
+#: field:res.partner,magento_bind_ids:0
+#: field:res.partner.category,magento_bind_ids:0
+#: field:sale.order,magento_bind_ids:0
+#: field:sale.order.line,magento_bind_ids:0
+#: field:sale.shop,magento_bind_ids:0
+#: field:stock.picking,magento_bind_ids:0
+#: view:stock.picking.out:0
+#: field:stock.picking.out,magento_bind_ids:0
+msgid "Magento Bindings"
+msgstr "Liens Magento"
+
+#. module: magentoerpconnect
+#: help:connector.config.settings,module_magentoerpconnect_catalog:0
+msgid "This installs the module magentoerpconnect_catalog."
+msgstr "Installe le module magentoerpconnect_catalog"
+
+#. module: magentoerpconnect
+#: field:magento.address,is_magento_order_address:0
+msgid "Address from a Magento Order"
+msgstr "Adresse d'une commande Magento"
+
+#. module: magentoerpconnect
+#: field:magento.sale.order,magento_order_id:0
+msgid "Magento Order ID"
+msgstr "ID de commande Magento"
+
+#. module: magentoerpconnect
+#: model:ir.model,name:magentoerpconnect.model_magentoerpconnect_installed
+msgid "magentoerpconnect.installed"
+msgstr "magentoerpconnect.installed"
+
+#. module: magentoerpconnect
+#: help:connector.config.settings,module_magentoerpconnect_export_partner:0
+msgid "This installs the module magentoerpconnect_export_partner."
+msgstr "Installe le module magentoerpconnect_export_partner."
+
+#. module: magentoerpconnect
+#: field:magento.sale.order.line,notes:0
+msgid "Notes"
+msgstr "Notes"
+
+#. module: magentoerpconnect
+#: field:magento.sale.order,openerp_id:0
+msgid "Sale Order"
+msgstr "Bons de Commande"
+
+#. module: magentoerpconnect
+#: field:magento.stock.picking.out,openerp_id:0
+msgid "Stock Picking"
+msgstr "Bon de livraison"
+
+#. module: magentoerpconnect
+#: view:connector.config.settings:0
+msgid "Extensions"
+msgstr "Extensions"
+
+#. module: magentoerpconnect
+#: view:magento.backend:0
+msgid "Advanced Configuration"
+msgstr "Configuration avancée"
+
+#. module: magentoerpconnect
+#: field:magento.res.partner,group_id:0
+msgid "Magento Group (Category)"
+msgstr "Groupe de client Magento (Catégorie)"
+
+#. module: magentoerpconnect
+#: model:ir.ui.menu,name:magentoerpconnect.menu_magento_store
+#: view:magento.website:0
+#: field:magento.website,store_ids:0
+msgid "Stores"
+msgstr "Magasins"
+
+#. module: magentoerpconnect
+#: field:magento.backend,product_stock_field_id:0
+msgid "Stock Field"
+msgstr "Champ de stock"
+
+#. module: magentoerpconnect
+#: field:magento.res.partner.category,openerp_id:0
+msgid "Partner Category"
+msgstr "Catégorie de partenaire"
+
+#. module: magentoerpconnect
+#: help:magento.product.product,magento_qty:0
+msgid "Last computed quantity to send on Magento."
+msgstr "Dernière quantité calculée à envoyer à Magento"
+
+#. module: magentoerpconnect
+#: model:ir.ui.menu,name:magentoerpconnect.menu_magento_root
+#: view:res.partner.category:0
+msgid "Magento"
+msgstr "Magento"
+
+#. module: magentoerpconnect
+#: model:ir.model,name:magentoerpconnect.model_connector_config_settings
+msgid "connector.config.settings"
+msgstr "connector.config.settings"
+
+#. module: magentoerpconnect
+#: field:magento.backend,import_products_from_date:0
+msgid "Import products from date"
+msgstr "Importer les articles depuis la date"
+
+#. module: magentoerpconnect
+#: model:ir.model,name:magentoerpconnect.model_res_partner
+#: field:magento.address,openerp_id:0
+#: field:magento.res.partner,openerp_id:0
+msgid "Partner"
+msgstr "Partenaire"
+
+#. module: magentoerpconnect
+#: model:ir.model,name:magentoerpconnect.model_sale_order
+msgid "Sales Order"
+msgstr "Bon de commande"
+
+#. module: magentoerpconnect
+#: model:ir.model,name:magentoerpconnect.model_stock_picking_out
+msgid "Delivery Orders"
+msgstr "Bons de livraisons"
+
+#. module: magentoerpconnect
+#: model:ir.model,name:magentoerpconnect.model_sale_order_line
+msgid "Sales Order Line"
+msgstr "Ligne de commande"
+
+#. module: magentoerpconnect
+#: field:connector.config.settings,module_magentoerpconnect_pricing:0
+msgid "Prices are managed in OpenERP with pricelists"
+msgstr "Les prix de vente sont gérés dans OpenERP avec des listes de prix"
+
+#. module: magentoerpconnect
+#: field:magento.address,is_default_shipping:0
+msgid "Default Shipping"
+msgstr "Adresse de livraison par défaut"
+
+#. module: magentoerpconnect
+#: sql_constraint:magento.stock.picking.out:0
+msgid "A stock picking with same ID on Magento already exists."
+msgstr "Un bon de livraison avec le même ID Magento existe déjà."
+
+#. module: magentoerpconnect
+#: view:magento.backend:0
+msgid "By clicking on the buttons,\n"
+"                                    you will initiate the synchronizations\n"
+"                                    with Magento.\n"
+"                                    Note that the import or exports\n"
+"                                    won't be done directly,\n"
+"                                    they will create 'Jobs'\n"
+"                                    executed as soon as possible."
+msgstr "En cliquant sur les boutons,\n"
+"                                    Vous allez initier les synchronisations\n"
+"                                    avec Magento.\n"
+"                                    Important: les imports et exports\n"
+"                                    ne sont pas exécutés immédiatement,\n"
+"                                    ils vont créer des 'jobs',\n"
+"                                    exécutés aussitôt que possible."
+
+#. module: magentoerpconnect
+#: help:magento.backend,product_stock_field_id:0
+msgid "Choose the field of the product which will be used for stock inventory updates.\n"
+"If empty, Quantity Available is used."
+msgstr "Choisir le champ de l'article qui doit être utilisé pour mettre à jour la quantité en stock."
+"Quand le champ est vide, la quantité en stock est utilisée."
+
+#. module: magentoerpconnect
+#: sql_constraint:magento.product.product:0
+msgid "A product with the same ID on Magento already exists"
+msgstr "Un article avec le même ID Magento existe déjà."
+
+#. module: magentoerpconnect
+#: model:ir.ui.menu,name:magentoerpconnect.menu_magento_backend
+msgid "Backends"
+msgstr "Backends"
+
+#. module: magentoerpconnect
+#: field:magento.backend,location:0
+msgid "Location"
+msgstr "Emplacement"
+
+#. module: magentoerpconnect
+#: model:ir.model,name:magentoerpconnect.model_stock_picking
+msgid "Picking List"
+msgstr "Liste de colisage"
+
+#. module: magentoerpconnect
+#: field:magento.backend,warehouse_id:0
+msgid "Warehouse"
+msgstr "Entrepôt"
+
+#. module: magentoerpconnect
+#: field:magento.backend,catalog_price_tax_included:0
+msgid "Prices include tax"
+msgstr "Prix taxes-incluses"
+
+#. module: magentoerpconnect
+#: view:magento.backend:0
+msgid "Import products categories since"
+msgstr "Importer les catégories d'articles depuis"
+
+#. module: magentoerpconnect
+#: field:magento.sale.order.line,openerp_id:0
+msgid "Sale Order Line"
+msgstr "Ligne de commande"
+
+#. module: magentoerpconnect
+#: field:magento.backend,username:0
+msgid "Username"
+msgstr "Utilisateur"
+
+#. module: magentoerpconnect
+#: model:ir.model,name:magentoerpconnect.model_product_category
+#: field:magento.product.category,openerp_id:0
+msgid "Product Category"
+msgstr "Catégorie d'articles"
+
+#. module: magentoerpconnect
+#: field:magento.res.partner,guest_customer:0
+msgid "Guest Customer"
+msgstr "Client invité"
+
+#. module: magentoerpconnect
+#: help:connector.config.settings,module_magentoerpconnect_pricing:0
+msgid "Prices are set in OpenERP and exported to Magento.\n"
+"\n"
+"This installs the module magentoerpconnect_pricing."
+msgstr "Les prix sont définis dans OpenERP et exportés vers Magento.\n"
+"\n"
+"Installe le module magentoerpconnect_pricing."
+
+#. module: magentoerpconnect
+#: field:delivery.carrier,magento_carrier_code:0
+msgid "Magento Base Carrier Code"
+msgstr "Code de base de transporteur sur Magento"
+
+#. module: magentoerpconnect
+#: view:magento.website:0
+msgid "Import partners since"
+msgstr "Importer les partenaires depuis"
+
+#. module: magentoerpconnect
+#: view:magento.backend:0
+#: view:magento.website:0
+msgid "Import in background"
+msgstr "Importer en arrière-plan"
+
+#. module: magentoerpconnect
+#: field:magento.account.invoice,magento_id:0
+#: field:magento.address,magento_id:0
+#: field:magento.binding,magento_id:0
+#: field:magento.product.category,magento_id:0
+#: field:magento.product.product,magento_id:0
+#: field:magento.res.partner,magento_id:0
+#: field:magento.res.partner.category,magento_id:0
+#: field:magento.sale.order,magento_id:0
+#: field:magento.sale.order.line,magento_id:0
+#: field:magento.stock.picking.out,magento_id:0
+#: field:magento.store,magento_id:0
+#: field:magento.storeview,magento_id:0
+#: field:magento.website,magento_id:0
+msgid "ID on Magento"
+msgstr "ID sur Magento"
+
+#. module: magentoerpconnect
+#: model:ir.actions.act_window,name:magentoerpconnect.action_magento_store
+msgid "Magento Stores"
+msgstr "Magasins Magento"
+
+#. module: magentoerpconnect
+#: field:magento.backend,pricelist_id:0
+#: field:magento.website,pricelist_id:0
+msgid "Pricelist"
+msgstr "Liste de prix"
+
+#. module: magentoerpconnect
+#: field:magento.sale.order,total_amount:0
+msgid "Total amount"
+msgstr "Montant total"
+
+#. module: magentoerpconnect
+#: model:ir.model,name:magentoerpconnect.model_magento_product_category
+#: view:magento.product.category:0
+msgid "Magento Product Category"
+msgstr "Catégorie d'articles Magento"
+
+#. module: magentoerpconnect
+#: view:magento.product.product:0
+msgid "(recompute)"
+msgstr "(recalculer)"
+
+#. module: magentoerpconnect
+#: field:magento.store,openerp_id:0
+msgid "Sale Shop"
+msgstr "Magasin"
+
+#. module: magentoerpconnect
+#: field:magento.product.product,manage_stock:0
+msgid "Manage Stock Level"
+msgstr "Gérer les stocks"
+