Чтение и создание заказов из вашей системы Katana ERP
This connector is a good starting point that implements a core set of the service's most common functions. You should expect to extend it by adding functions for the specific endpoints your workflow requires. Additionally, some configuration may be required in Katana ERP to establish a connection with Tulip. Please review our [connectors](/r230/docs/<span translate=)">connector framework to learn more about how to build and modify connectors in Tulip.
Введение
Katana — это облачное программное обеспечение ERP (планирование ресурсов предприятия) для производственных компаний малого и среднего бизнеса, которым требуется доступное и гибкое решение. Производственная ERP-система Katana предлагает широкий спектр функций — от управления запасами и планирования производства до управления заказами на продажу и закупки материалов — для оптимизации производственных операций от начала до конца. Katana предлагает несколько тарифных планов, подходящих для любого размера и уровня развития вашего бизнеса. Кроме того, она предоставляет пакет внедрения (за дополнительную плату), который поможет вам быстро начать работу.Цель этого приложения — предоставить тестовую версию и решение MVP, позволяющее отслеживать количество производственных заказов с цеха, а также выполненные заказы. Это решение и коннектор можно расширить с помощью дополнительных функций, используя редактор приложений и фреймворк коннекторов Tulip.
Цель
Мы рассмотрим различные функции коннектора, которые можно реализовать с помощью HTTP-вызовов к API Katana MRP для взаимодействия с данными и выполнения базовых операций CRUD в Katana. Функции коннектора позволяют извлекать список производственных заказов, обновлять производственные заказы и т. д.
Документация по API
ДокументацияпоAPI Katana MRPОбзор API Katana MRP на YouTube
Необходимые условия
Иметь учётную запись Katana и сгенерировать рабочий ключ API:
- Войдите в свою учётную запись Katana{target="_blank"}
- Перейдите в «Настройки» > «API»
- Выберите «Добавить новый ключ API»
Данные подключения к Tulip
В разделе «Коннекторы» Tulip необходимо настроить следующую информацию. Во-первых, в параметрах подключения:
- Работает на: хосте облачного коннектора
- Хост: api.katanamrp.com
- Порт: 443
- TLS: да
Затем в окне просмотра заголовков: 1. Выберите «OAuth 2 (Bearer Token)». 2. Префикс: «Bearer» 3. Токен: введите ключ API, полученный на предыдущем шаге 4. Добавьте заголовок с именем «Accept» и значением «application/json» 5. Добавьте заголовок с именем «content-type» и значением «application/json»
Функции коннектора
Список всех производственных заказов — sourceВозвращает список производственных заказов, которые вы создали ранее. Производственные заказы возвращаются в отсортированном порядке, причём самые последние заказы отображаются первыми.
Метод GET
Конечная точка https://api.katanamrp.com/v1/manufacturing\_orders
Параметры: нет
Выходные данные: Функция коннектора возвращает подробные сведения о производственном заказе; ниже приведены некоторые из этих полей: Идентификатор производственного заказа, Номер производственного заказа, Вариант, Запланированная дата начала, Срок выполнения, Статус производственного заказа, Запланированное количество, Фактическое количество, Выполненное количество```
**Список всех производственных заказов по статусу** — [source](https://developer.katanamrp.com/reference/getallmanufacturingorders){target="\_blank"}Возвращает список ранее созданных производственных заказов. Производственные заказы возвращаются в отсортированном порядке, причём самые последние заказы отображаются первыми.
Метод GET
Конечная точкаhttps://api.katanamrp.com/v1/manufacturing_orders?status={status}
ПараметрыStatus: (текст) один из стандартных статусов, известных системе Katana MRP (NOT_STARTED, BLOCKED, IN_PROGRESS, DONE)
Выходные данныеФункция коннектора возвращает сведения о производственном заказе; ниже приведены некоторые из этих полей:Идентификатор производственного заказаНомер производственного заказаВариантЗапланированная дата началаСрок выполненияСтатус производственного заказаПланируемое количествоФактическое количествоВыполненное количество```
Обновление производственного заказа — sourceОбновляет данные указанного производственного заказа, устанавливая значения переданных параметров.
Метод PATCH
Конечная точкаhttps://api.katanamrp.com/v1/manufacturing\_order\_productions/{id}
Параметры: OrderID : (целое число) идентификатор производственного заказа; Status: (текст) новый статус производственного заказа; Actual Quantity: (целое число) новое фактическое количество производственного заказа
Выходные данныеФункция коннектора возвращает сведения о производственном заказе; ниже приведены некоторые из этих полей:Идентификатор производственного заказаНомер производственного заказаВариантЗапланированная дата началаСрок выполненияСтатус производственного заказаПланируемое количествоФактическое количествоВыполненное количество```
**Получить данные о производстве по производственному заказу** — [source](https://developer.katanamrp.com/reference/getmanufacturingorderproduction){target="\_blank"}Получает подробные данные о существующем производстве по производственному заказу на основе ID.
Метод GET
Конечная точкаhttps://api.katanamrp.com/v1/manufacturing_order_productions/{id}
Параметры: Идентификатор заказа: (целое число) идентификатор производственного заказа
РезультатыФункция коннектора возвращает сведения о производственном заказе; ниже приведены некоторые из этих полей:Идентификатор производственного заказаНомер производственного заказаВариантЗапланированная дата началаСрок выполненияСтатус производственного заказаПланируемое количествоФактическое количествоВыполненное количество```