Приложение Katana ERP

Чтение и запись заказов из системы Katana ERP

Введение

Katana - это облачная ERP-система (система планирования ресурсов предприятия) для малого и среднего бизнеса, который ищет доступное и гибкое решение. Производственная ERP-система Katana предлагает широкий спектр функций, от управления запасами и планирования производства до управления заказами на продажу и закупками материалов, для оптимизации сквозных производственных операций. Katana имеет несколько тарифных планов, соответствующих размеру и уровню зрелости вашего бизнеса. Целью данного приложения является создание тестового модуля и MVP-решения, позволяющего отслеживать количество рабочих заказов в цехе, а также полные рабочие заказы. Данное решение и коннектор могут быть дополнены новыми функциями с помощью редактора приложений Tulip и фреймворка коннектора.

Назначение

Мы рассмотрим различные функции коннектора, которые могут быть построены путем выполнения HTTP-вызовов к API Katana MRP для взаимодействия с данными и выполнения основных CRUD-операций в Katana. Используемые функции коннектора позволяют получить список рабочих заказов, обновить рабочие заказы и т.д.

Документация по API

Katana MRP API Documentation
Overview of Katana MRP APIs on Youtube

Предварительные условия

Иметь учетную запись Katana и сгенерировать живой API-ключ:

1. Войдите в систему Katana account
2. Перейдите в раздел Настройки > API
3. Выберите Добавить новый ключ API

Детали подключения Tulip

В коннекторах Tulip необходимо настроить следующую информацию. Во-первых, в деталях соединения:

1. Running on: Хост облачного коннектора
2. Хост: api.katanamrp.com
3. Порт: 443
4. TLS: да

Затем в представлении заголовков:

1. Выберите " OAuth 2 (Bearer Token) 2. Префикс: " Bearer".
2. Токен: введите API-ключ, полученный на предыдущем шаге 4. Добавьте заголовок с именем "Accept" и значением application/json".
3. Добавьте заголовок с именем "content-type" и значением "application/json".

Функции коннектора

Список всех производственных заказов - source
Возвращает список ранее созданных производственных заказов, отсортированных по порядку, причем первыми отображаются самые последние заказы.

Метод GET


Конечная точка https://api.katanamrp.com/v1/manufacturing\_orders


Параметры N/A


Выходные данные Функция коннектора возвращает детали производственного заказа, вот некоторые из этих полей: ID производственного заказа Номер производственного заказа Вариант ScheduledStartDate Due Date Статус производственного заказа Планируемое количество Фактическое количество Завершенное количество ````


**Список всех производственных заказов по статусу** - [source](https://developer.katanamrp.com/reference/getallmanufacturingorders){target="\_blank"}
Возвращает список ранее созданных производственных заказов, отсортированных по статусу, причем первыми отображаются самые последние заказы.

Метод GET

Конечная точка https://api.katanamrp.com/v1/manufacturing_orders?status={status}

Параметры Status: (text) один из стандартных статусов, известных Katana MRP (NOT_STARTED, BLOCKED, IN_PROGRESS, DONE).

Outputs
The connector function returns the details of the work order, here are a few of those fields:
Work Order ID
Work Order Number
Variant
ScheduledStartDate
Due Date
Work Order Status
Planned Quantity
Actual Quantity
Completed Quantity

**Обновление производственного заказа** - [source](https://developer.katanamrp.com/reference/updatemanufacturingorderproduction){target="\_blank"}
Обновляет указанный производственный заказ, устанавливая значения переданных параметров.

Метод PATCH

Конечная точка https://api.katanamrp.com/v1/manufacturing_order_productions/{id}

Параметры OrderID : (целое число) идентификатор производственного заказа Status: (текст) статус нового производственного заказа Actual Quantity: (целое число) фактическое количество нового производственного заказа

Выходные данные Функция коннектора возвращает детали заказа, вот некоторые из этих полей: Идентификатор заказа Номер заказа Вариант ScheduledStartDate Due Date Статус заказа Планируемое количество Фактическое количество Завершенное количество ```''

Получение производственного заказа - source
Получает информацию о существующем производственном заказе на основе идентификатора.

Метод GET


Конечная точка https://api.katanamrp.com/v1/manufacturing\_order\_productions/{id}


Параметры ID заказа : (целое число) идентификатор производственного заказа


Выходные данные Функция коннектора возвращает детали производственного заказа, вот некоторые из этих полей: Work Order ID Work Order Number Variant ScheduledStartDate Due Date Work Order Status Planned Quantity Actual Quantity Completed Quantity ```