Ordering API map
- API AddCatalogPosition
- API CreateOrder
- API DictionaryManagement
- API GenerateOrderInvoice
- API GetAccountOrders
- API GetOrderingCatalog
- API GetOrderList
- API InitOrderingTenant
- API OrderPositionManagement и калькуляция заказа
- API UpdateCatalogPosition
- API UpdateOrder
- Общая логика работы с тенантами и аккаунтами
- Словари и их значения
Шаг | API name | Данные | Комментарий | |
---|---|---|---|---|
1 | Старт нового ордеринг тенанта для клиента Zegoal | InitTenant | API request parameters:
| Используем имя аккаунта в биллинговой системе Zegoal и название шаблона "order" |
2 | Создание записей в каталоге | AddCatalogPosition |
| Позволяет создавать новые записи в каталоге товаров и продуктов. Работает со словарями:
|
3. | Получение каталога | GetOrderingCatalog | Request:
| Запрос без указания параметров вернет весь каталог. Указание параметров собственно фильтрует каталог и возвращает отобранные записи. |
4. | Создание нового заказа | CreateOrder |
One of conditional parameters: Account_id or External_customer_id or Customer_name** - is mandatory to be provided. | Позволяет создавать как "шапку заказа" так и заказ с позициями. Привязывает заказ к существующему аккаунту или создает новый. Более детальная логика работы API будет в полной документации. |
5. | Работа с позициями в заказе | OrderPositionManagement | Request parameters
| Позволяет добавлять, редактировать и удалять позиции заказа. В ответ система возвращает весь набор позиций заказа и новые пересчитанные суммы заказа. Actions:
|
6. | Обновление "шапки" заказа (в том числе статусов) | UpdateOrder | Request:
Response: All order attributes (include positions). | Редактирование ключевых атрибутов заказа |
7. | Получение списка заказов по всему тенанту | GetOrderList | Request parameters:
Response Orders array. All attributes without positions. | Для выборки списка заказов без уточнение аккаунта (кастомера). |
8. | Получение полных заказов по кастомеру | GetAccountOrders | Request parameters:
Response All order and order_position attributes. | Возвращает целиком заказ с позициями. |
9. | Генерация инвойса для заказа | GenerateOrderInvoice | Принимает на вход массив order_id | Выполняет формирование инвойса и PDF документа инвойса. Прикрепляет сформированные документы в заказ. |
10. | Получение инвойсов по кастомеру | GetInvoiceData | аналогично Zegoal биллингу | |
11. | Добавление-просмотр платежей | AppPayment, GetAccountPauments | аналогично Zegoal биллингу | |