tradon/modules/incoterm/tests/scenario_incoterm.rst

=================
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'