first commit

modules/incoterm/tests/__init__.py

@@ -0,0 +1,2 @@
+# This file is part of Tryton.  The COPYRIGHT file at the top level of
+# this repository contains the full copyright notices and license terms.

modules/incoterm/tests/scenario_incoterm.rst

@@ -0,0 +1,245 @@
+=================
+Incoterm Scenario
+=================
+
+Imports::
+
+    >>> from decimal import Decimal
+
+    >>> from proteus import Model
+    >>> from trytond.modules.account.tests.tools import create_chart, get_accounts
+    >>> from trytond.modules.company.tests.tools import create_company, get_company
+    >>> from trytond.tests.tools import activate_modules, assertEqual
+
+Activate modules::
+
+    >>> config = activate_modules(
+    ...     ['incoterm', 'sale', 'sale_shipment_cost', 'purchase'],
+    ...     create_company, create_chart)
+
+    >>> Address = Model.get('party.address')
+    >>> Carrier = Model.get('carrier')
+    >>> Country = Model.get('country.country')
+    >>> Incoterm = Model.get('incoterm.incoterm')
+    >>> Location = Model.get('stock.location')
+    >>> Move = Model.get('stock.move')
+    >>> Party = Model.get('party.party')
+    >>> ProductCategory = Model.get('product.category')
+    >>> ProductTemplate = Model.get('product.template')
+    >>> ProductUom = Model.get('product.uom')
+    >>> Purchase = Model.get('purchase.purchase')
+    >>> Sale = Model.get('sale.sale')
+    >>> ShipmentIn = Model.get('stock.shipment.in')
+
+Create countries::
+
+    >>> belgium = Country(name="Belgium", code='BE')
+    >>> belgium.save()
+    >>> china = Country(name="China", code='CN')
+    >>> china.save()
+
+Setup company::
+
+    >>> company = get_company()
+    >>> company.incoterms.extend(Incoterm.find([
+    ...         ('code', 'in', ['FCA', 'CIP', 'CFR', 'CIF']),
+    ...         ('version', '=', '2020')
+    ...         ]))
+    >>> company.save()
+
+Get accounts::
+
+    >>> accounts = get_accounts(company)
+
+Create addresses::
+
+    >>> warehouse_address = Address(
+    ...     party=company.party, building_name="Warehouse", country=belgium)
+    >>> warehouse_address.save()
+
+    >>> port = Party(name="Port of Fuzhou")
+    >>> address, = port.addresses
+    >>> address.country = china
+    >>> port.save()
+
+Set warehouse address::
+
+    >>> warehouse, = Location.find([('type', '=', 'warehouse')])
+    >>> warehouse.address = warehouse_address
+    >>> warehouse.save()
+
+Create parties::
+
+    >>> customer = Party(name="Customer")
+    >>> address, = customer.addresses
+    >>> address.country = china
+    >>> line = customer.sale_incoterms.new()
+    >>> line.type = 'sale'
+    >>> line.incoterm, = Incoterm.find([
+    ...         ('code', '=', 'CIF'), ('version', '=', '2020')])
+    >>> line = customer.sale_incoterms.new()
+    >>> line.type = 'sale'
+    >>> line.incoterm, = Incoterm.find([
+    ...         ('code', '=', 'CFR'), ('version', '=', '2020')])
+    >>> line = customer.sale_incoterms.new()
+    >>> line.type = 'sale'
+    >>> line.incoterm, = Incoterm.find([
+    ...         ('code', '=', 'FCA'), ('version', '=', '2020')])
+    >>> line.incoterm_location = warehouse_address
+    >>> customer.save()
+
+    >>> supplier = Party(name="Supplier")
+    >>> address, = supplier.addresses
+    >>> address.country = china
+    >>> line = supplier.purchase_incoterms.new()
+    >>> line.type = 'purchase'
+    >>> line.incoterm, = Incoterm.find([
+    ...         ('code', '=', 'CFR'), ('version', '=', '2020')])
+    >>> line.incoterm_location = warehouse_address
+    >>> supplier.save()
+
+Create products::
+
+    >>> unit, = ProductUom.find([('name', '=', 'Unit')])
+    >>> account_category = ProductCategory(name="Account Category")
+    >>> account_category.accounting = True
+    >>> account_category.account_expense = accounts['expense']
+    >>> account_category.account_revenue = accounts['revenue']
+    >>> account_category.save()
+
+    >>> template = ProductTemplate()
+    >>> template.name = "Product"
+    >>> template.default_uom = unit
+    >>> template.type = 'goods'
+    >>> template.salable = True
+    >>> template.purchasable = True
+    >>> template.list_price = Decimal('20')
+    >>> template.account_category = account_category
+    >>> template.save()
+    >>> product, = template.products
+
+    >>> carrier_template = ProductTemplate()
+    >>> carrier_template.name = "Carrier Product"
+    >>> carrier_template.default_uom = unit
+    >>> carrier_template.type = 'service'
+    >>> carrier_template.salable = True
+    >>> carrier_template.list_price = Decimal('3')
+    >>> carrier_template.account_category = account_category
+    >>> carrier_template.save()
+    >>> carrier_product, = carrier_template.products
+
+Create carriers::
+
+    >>> carrier = Carrier()
+    >>> party = Party(name="Carrier")
+    >>> party.save()
+    >>> carrier.party = party
+    >>> carrier.carrier_product = carrier_product
+    >>> carrier.save()
+    >>> carrier_waterway, = carrier.duplicate()
+    >>> carrier_waterway.mode = 'waterway'
+    >>> carrier_waterway.save()
+
+Test incoterms are deducted from sale::
+
+    >>> sale = Sale()
+    >>> sale.party = customer
+    >>> sale.carrier = carrier_waterway
+    >>> sale.incoterm.rec_name
+    'CIF (2020)'
+    >>> sale.incoterm_location
+    >>> sale.carrier = carrier
+    >>> sale.incoterm
+    >>> sale.shipment_cost_method = None
+    >>> sale.incoterm.rec_name
+    'FCA (2020)'
+    >>> assertEqual(sale.incoterm_location, warehouse_address)
+
+Try sale without incoterm::
+
+    >>> sale = Sale()
+    >>> sale.party = customer
+    >>> sale.carrier = carrier_waterway
+    >>> line = sale.lines.new()
+    >>> line.product = product
+    >>> line.quantity = 1
+    >>> sale.incoterm = None
+    >>> sale.click('quote')
+    Traceback (most recent call last):
+        ...
+    SaleQuotationError: ...
+
+Try sale with incoterm::
+
+    >>> sale.incoterm, = Incoterm.find([
+    ...         ('code', '=', 'CIF'), ('version', '=', '2020')])
+    >>> sale.click('quote')
+    Traceback (most recent call last):
+        ...
+    RequiredValidationError: ...
+
+Try sale with incoterm and location::
+
+    >>> sale.incoterm_location, = port.addresses
+    >>> sale.click('quote')
+    >>> sale.state
+    'quotation'
+
+Test incoterm on shipment::
+
+    >>> sale.click('confirm')
+    >>> sale.state
+    'processing'
+    >>> shipment, = sale.shipments
+    >>> shipment.incoterm.rec_name
+    'CIF (2020)'
+    >>> assertEqual(shipment.incoterm_location, port.addresses[0])
+
+Warn if incoterm on shipment is different from its origins::
+
+    >>> shipment.click('draft')
+    >>> shipment.incoterm, = Incoterm.find([
+    ...         ('code', '=', 'EXW'), ('version', '=', '2020')])
+    >>> shipment.click('wait')
+    Traceback (most recent call last):
+        ...
+    DifferentIncotermWarning: ...
+
+Test incoterm is set on purchase::
+
+    >>> purchase = Purchase()
+    >>> purchase.party = supplier
+    >>> purchase.incoterm.rec_name
+    'CFR (2020)'
+    >>> line = purchase.lines.new()
+    >>> line.product = product
+    >>> line.quantity = 1
+    >>> line.unit_price = Decimal('5.0000')
+    >>> purchase.click('quote')
+    >>> purchase.click('confirm')
+    >>> purchase.state
+    'processing'
+
+Create supplier shipment with different incoterm::
+
+    >>> shipment = ShipmentIn()
+    >>> shipment.supplier = supplier
+    >>> shipment.incoterm, = Incoterm.find([
+    ...         ('code', '=', 'EXW'), ('version', '=', '2020')])
+    >>> for move in purchase.moves:
+    ...     incoming_move = Move(id=move.id)
+    ...     shipment.incoming_moves.append(incoming_move)
+    >>> shipment.save()
+    >>> shipment.click('receive')
+    Traceback (most recent call last):
+        ...
+    DifferentIncotermWarning: ...
+
+Update supplier shipment with the same incoterm as the purchase::
+
+    >>> shipment.incoterm, = Incoterm.find([
+    ...         ('code', '=', 'CFR'), ('version', '=', '2020')])
+    >>> shipment.save()
+    >>> shipment.click('receive')
+    >>> shipment.state
+    'received'

modules/incoterm/tests/test_module.py

@@ -0,0 +1,97 @@
+# This file is part of Tryton.  The COPYRIGHT file at the top level of
+# this repository contains the full copyright notices and license terms.
+
+from unittest.mock import MagicMock, Mock
+
+from trytond.modules.company.tests import CompanyTestMixin
+from trytond.pool import Pool
+from trytond.tests.test_tryton import ModuleTestCase, with_transaction
+
+
+class IncotermTestCase(CompanyTestMixin, ModuleTestCase):
+    'Test Incoterm module'
+    module = 'incoterm'
+    extras = [
+        'carrier', 'company', 'purchase', 'purchase_request_quotation',
+        'sale', 'sale_shipment_cost', 'sale_opportunity',
+        'sale_shipment_grouping', 'stock', 'account_invoice',
+        'account_invoice_stock', 'web_shop']
+
+    @with_transaction()
+    def test_shipment_grouping(self):
+        "Test fields to group shipment"
+        pool = Pool()
+        Sale = pool.get('sale.sale')
+        ShipmentOut = pool.get('stock.shipment.out')
+
+        sale = Sale()
+        shipment = MagicMock(spec=ShipmentOut)
+
+        fields = sale._get_shipment_grouping_fields(shipment)
+
+        self.assertLessEqual({'incoterm', 'incoterm_location'}, fields)
+        self.assertLessEqual(fields, ShipmentOut._fields.keys())
+
+    @with_transaction()
+    def test_sale_incoterm_required(self):
+        "Test incoterm required on sale"
+        pool = Pool()
+        Sale = pool.get('sale.sale')
+        Country = pool.get('country.country')
+
+        from_country = Mock(spec=Country)
+        to_country = Mock(spec=Country)
+        sale = Mock(spec=Sale)
+        sale.warehouse.address.country = from_country
+        sale.shipment_address.country = to_country
+        type(sale)._incoterm_required = Sale._incoterm_required
+
+        for from_europe, to_europe, result in [
+                (False, False, True),
+                (False, True, True),
+                (True, False, True),
+                (True, True, False),
+                ]:
+            from_country.is_member.return_value = from_europe
+            to_country.is_member.return_value = to_europe
+            with self.subTest(
+                    from_europe=from_europe,
+                    to_europe=to_europe):
+                self.assertEqual(sale._incoterm_required, result)
+
+    @with_transaction()
+    def test_sale_incoterm_required_same_country(self):
+        "Test incoterm required on sale with same country"
+        pool = Pool()
+        Sale = pool.get('sale.sale')
+        Country = pool.get('country.country')
+
+        country = Mock(spec=Country)
+        sale = Mock(spec=Sale)
+        sale.warehouse.address.country = country
+        sale.shipment_address.country = country
+        type(sale)._incoterm_required = Sale._incoterm_required
+
+        for europe, result in [
+                (False, False),
+                (True, False),
+                ]:
+            country.is_member.return_value = europe
+            with self.subTest(europe=europe):
+                self.assertEqual(sale._incoterm_required, result)
+
+    @with_transaction()
+    def test_sale_incoterm_required_no_country(self):
+        "Test incoterm required on sale without country"
+        pool = Pool()
+        Sale = pool.get('sale.sale')
+
+        sale = Mock(spec=Sale)
+        sale.warehouse.address.country = None
+        sale.shipment_address.country = None
+        type(sale)._incoterm_required = Sale._incoterm_required
+
+        self.assertFalse(sale._incoterm_required)
+
+
+del ModuleTestCase

modules/incoterm/tests/test_scenario.py

@@ -0,0 +1,8 @@
+# This file is part of Tryton.  The COPYRIGHT file at the top level of
+# this repository contains the full copyright notices and license terms.
+
+from trytond.tests.test_tryton import load_doc_tests
+
+
+def load_tests(*args, **kwargs):
+    return load_doc_tests(__name__, __file__, *args, **kwargs)