Разработка ERP на tryton: Часть 3

Работа с модулями компании (company), контрагентами (party), товаров (product) и склада (stock).

Часть 1: Установка tryotnd, структура запросов, работа с БД
Часть 2: Структура методов, работа с пользователями и группами, установка модулей
Часть 3: Работа с модулями компании (company), контрагентами (party), товаров (product) и склада (stock).
Часть 4: Работа с модулем продаж (sale)
Часть 5: Работа с модулем планирование производственных ресурсов (mpr)

1. Пример установки модулей

У нас в качестве первой итерации поставили задание обеспечить работу склада. Так что займемся установкой соответсвующего модуля.

После скачивания и распаковки модуля stock, установить его не получится, так как для работы модуля необходимо установить зависимости. Для получения списка зависимостей модуля есть метод ir.module.dependencies, но он возвращает одну неудоволтворенную зависимость, получить сразу список необходимых модулей через этот метод у меня не получилось.

Метод model.ir.module.module.read возвращает поле dependencies, но там только id необходимых модулей. Можно опять воспользоваться эти методом, что б получить имена этих модулей. Хотя проще будет открыть tryton.cfg, который находится в корне модуля и в разделе depends, посмотреть нужные модули. Для склада это — company, currency, ir, party, product. У модуля party в зависимостях указано еще company. Скачиваем и устанавливаем нужные модули.

После установки system.server.listMethods возвращает в классе model на 625 методов больше. Ниже схематическое представление новых методов:

Теперь рассмотрим эти методы более детально.

2. API работы с модулями

У всех классов есть 6 основных методов: create, delete, fields_get, search, read, write. Ниже я расспишу их для основных классов модулей.

2.1. API модуля company

У модуля компании есть второстепенный класс employee, который позволяет создавать сотрудников. Для назначения сотрудников надо изменить поле employее у компании.

2.2. API модуля party(контрагенты)

У модуля контрагентов есть второстепенный класс address, который позволяет создавать адреса и назначать их контрагентам. Этот же класс используется в модуле склада.

2.3. API модуля product

Есть еще аналогичные методы product.template, которые делают тоже самое что и product.product.
Также необходимо обратить внимание на обязательное поле default_uom, в котором указывается единица измерения товара. Для работы с единицами измерения используется класс product.uom. Соотвественно для того, чтобы получить список имеющихся единиц измерения можно воспользоваться методами model.product.uom.search, model.product.uom.read.

import json
import requests

url = 'http://localhost:8000/try'
id = 1
methodname = 'common.server.login'
params = ('test', 'test')
request = json.dumps({
                'id': id,
                'method': methodname,
                'params': params,
                })

r = requests.post(url, data=request)

user_id, cookie = r.json()['result']
print user_id, cookie


id = 2
methodname = 'model.product.uom.search'
params = [user_id, cookie, [], 0, 1000, None, {}]

request = json.dumps({
                'id': id,
                'method': methodname,
                'params': params,
                })

r = requests.post(url, data=request)
print request
uom= r.json()['result']

id = 4
methodname = 'model.product.uom.read'
params = (user_id, cookie, uom, ['name'], {})

request = json.dumps({
                'id': id,
                'method': methodname,
                'params': params,
                })

r = requests.post(url, data=request)
print r.json()['result']

2.4. API работы с категориями

Для всех основных классов можно создавать иерархическую категоризацию. Для создания иерархии используется поле parent, в котором указывается id родителя.

2.5. API модуля stock (склад)

Очень много времени ушло на понимание того, что для работы со складскими документами надо использовать любого пользователя, кроме admin, и к тому же его необходимо привязать к компании (указать поле company), иначе будете в response получать UserError.

У модуля склада есть 5 типов докуметов:

1. stock.shipment.in — документ поставки товара на склад от поставщика.
2. stock.shipment.in.return — документ возврата товара поставщику.
3. stock.shipment.internal — документ внутренего перемещения между складами.
4. stock.shipment.out — документ отгрузки товара со склада покупателю.
5. stock.shipment.out.return — документ возврата товара от покупателя.

Ниже представлена схема, для наглядного понимания движения товаров по складам:

Для нескольких физических складов надо либо дублировать товарный склад с зонами поставки и отгрузки, либо делать несколько зон хранения.

Ниже представлено API по работе с докуметами склада, вместо звёздочки подставляем класс нужного документа, к примеру model.stock.shipment.in.search.

У модуля склада есть второстепенный класс location для работы непосредственно со складами, а не движением товаров по складам и зонам.

Вот пример параметров для метода model.stock.shipment.in.create [user_id, cookie, [{"company": 1, "incoming_moves": [["create", [{"to_location": 1, "product": 1, "from_location": 5, "company": 1, "unit_price": {"decimal": "12.000", "__class__": "Decimal"}, "currency": 123, "uom": 2, "quantity": 90.0}]]], "warehouse": 4, "supplier": 1}], {}]. Обратите внимание на «unit_price»: {«decimal»: «12.000», "__class__": «Decimal»}, если задать в запросе «unit_price»: 12.000, то запрос не выполнится, так как модуль склада не сможет переобразовать число нужный ему в класс Decimal. Такое поведение замечено только в полях, которые отвечают за цену.

У документов поставки stock.shipment.in, есть два состояния — draft (черновик), done (выполнено). У остальных документов три состояние — draft (черновик), wait (ожидание), done (выполнено). Состояние документов влияет на отчеты об остатках по товарам и складам. Если у документа состояние draft, то товар указаный в нём не отображается в отчетах. Если документ в состоянии wait, то в отчетах товар находится на складе с которого делается перемещение/отгрузка. Если документ в состоянии done, то товар в отчет находится на складе на который делается перемещение/отгрузка.

У модуля склада есть отчет остатка продукци на конкретном складе/зоне поставки-отгрузки — wizard.stock.products_by_locations. Для получения отчетов используется главный класс wizard. С помощью метода create создаётся запрос к БД и записывается в БД, метод execute выполняет запрос и результат записывается в бд, метод delete удаляет из БД запрос и результаты его выполнения.

Автор: clutcher

Источник