从您的 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（企业资源计划）软件，专为寻求经济实惠且灵活解决方案的中小型企业设计。 Katana 制造 ERP 提供广泛的功能，涵盖从库存管理和生产计划到销售订单管理和物料采购，旨在优化端到端的制造运营。Katana 提供多种方案，以适应您的企业规模和成熟度水平。它还提供实施套餐（需额外付费），助您快速投入运行。本应用旨在提供一个测试单元和一个最小可行产品（MVP）解决方案，使您能够追踪车间的工作订单数量，并完成工作订单。该解决方案和连接器可通过 Tulip 的应用程序编辑器和连接器框架扩展更多功能。
目的
我们将重点介绍通过向 Katana MRP API 发起 HTTP 调用来构建的各种连接器功能，这些功能可与数据交互并在 Katana 上执行基本的 CRUD 操作。连接器中使用的这些功能可让您获取工单列表、更新工单等。
API 文档
Katana MRP API 文档YouTube 上的 Katana MRP API 概述
先决条件
拥有 Katana 账户并生成一个有效的 API 密钥：
- 登录您的 Katana账户
- 进入“设置” > “API”
- 选择“添加新 API 密钥”
Tulip 连接详细信息
需要在 Tulip 的 Connectors 中配置以下信息。首先，在连接详细信息中：
- 运行于：云连接器主机
- 主机：api.katanamrp.com
- 端口：443
- TLS：是
然后，在“标头”视图中：1. 选择“OAuth 2 (Bearer Token)2. 前缀：“Bearer” 3. 令牌：输入上一步获取的 API 密钥 4. 添加一个名称为“Accept”、值为“application/json”的头 5. 添加一个名称为“content-type”、值为“application/json”的头
连接器功能
列出所有生产订单-源返回您之前创建的生产订单列表。生产订单按排序顺序返回，最新的生产订单排在最前面。
方法GET
端点https://api.katanamrp.com/v1/manufacturing\_orders
参数不适用
输出结果：连接器函数将返回工单的详细信息，以下是其中部分字段：工单 ID、工单编号、变体、计划开始日期、截止日期、工单状态、计划数量、实际数量、已完成数量```
**按状态列出所有生产订单**-[源](https://developer.katanamrp.com/reference/getallmanufacturingorders){target="\_blank"}返回您之前创建的生产订单列表。生产订单按排序顺序返回，最新的生产订单排在最前面。
方法GET
端点https://api.katanamrp.com/v1/manufacturing_orders?status={status}
参数状态：(文本) Katana MRP 识别的标准状态之一（NOT_STARTED、BLOCKED、IN_PROGRESS、DONE）
输出：连接器函数返回工单的详细信息，以下是其中部分字段：工单 ID、工单编号、变体、计划开始日期、截止日期、工单状态、计划数量、实际数量、已完成数量```
更新生产订单-源通过设置传入参数的值，更新指定的生产订单生产信息。
方法PATCH
端点https://api.katanamrp.com/v1/manufacturing\_order\_productions/{id}
参数订单ID : (整数) 工单 ID状态: (文本) 新工单状态实际数量: (整数) 新工单实际数量
输出结果：连接器函数将返回生产订单的详细信息，以下是其中部分字段：生产订单 ID、生产订单编号、变体、计划开始日期、截止日期、生产订单状态、计划数量、实际数量、已完成数量```
**检索生产订单生产记录**-[源](https://developer.katanamrp.com/reference/getmanufacturingorderproduction){target="\_blank"}根据 ID 检索现有生产订单生产记录的详细信息。
方法GET
端点https://api.katanamrp.com/v1/manufacturing_order_productions/{id}
参数工单 ID：（整数）工单 ID
输出结果：连接器函数返回工单的详细信息，以下是其中部分字段：工单 ID、工单编号、变体、计划开始日期、截止日期、工单状态、计划数量、实际数量、已完成数量```