接 Epicor Kinetic：拉订单与客户进来，查库存
在 Epicor Kinetic 里建服务账号并新建 API Key，把服务器基址、公司 ID、用户名、密码和 API Key 填进 Integration，测试、配 Mapping、激活——销售订单与客户拉进来，库存可查。
Epicor Kinetic 连接器把您 Epicor Kinetic ERP 里的销售订单与客户拉进本系统，还能查 Epicor 里的库存数量。它是从 Epicor 读数据：不把库存变化推回 Epicor。每次请求同时用两套凭证——服务账号走 Basic 登录，加上 API Key——所以两套缺一不可。一个 Epicor 实例加一个公司对应一个连接。
前置条件#
- 一个能登录的 Epicor Kinetic 实例及其服务器基址——云版形如 https://mycompany.epicorsaas.com/MyInstance；本地部署为 https://<服务器>/<实例名>。
- 您的公司 ID，例如 EPIC06。它是 v2 OData 地址里的公司段，必须与您要拉数据的公司完全一致。
- 一个专用 Epicor 服务账号，在 User Account Security Maintenance 里建，并有该公司的访问权限。它的用户名和密码是凭证的一半。
- 有在 API Key Maintenance 里新建 Key 的权限，并能给该 Key 分配覆盖 Erp.BO.SalesOrderSvc、Erp.BO.CustomerSvc、Erp.BO.PartSvc 的 Access Scope。
拿凭证#
- 在 User Account Security Maintenance 里新建或确认专用服务账号，并确认它有您要拉数据的公司的访问权限。记下它的用户名，备好它的密码。
- 打开 Epicor Kinetic → API Key Maintenance → New Key，新建一个 API Key。
- 给该 Key 分配覆盖全部三个服务的 Access Scope：Erp.BO.SalesOrderSvc、Erp.BO.CustomerSvc、Erp.BO.PartSvc。Scope 漏了某个服务，Key 就读不到那类数据。
- 在 Key 显示的那一刻就复制它——它只显示一次。丢了就新建一个 Key，不要回头找旧的。
- 同时记下另外两个值：不带任何 /api 后缀的服务器基址，以及公司 ID，例如 EPIC06。
填进 Integration#
- 打开 Integration → 连接器市场 → Epicor Kinetic → 新建连接。
- base_url——必填，Epicor 服务器基址：填您的实例地址，例如 https://mycompany.epicorsaas.com/MyInstance。不要加 /api 后缀——地址的其余部分由系统自己拼。
- company——必填，公司 ID：填公司段，例如 EPIC06。必须是服务账号能访问的那个公司。
- username——必填，服务账号用户名：填 User Account Security Maintenance 里那个专用服务账号的用户名。
- password——必填，服务账号密码：填同一个服务账号的密码。这是密码类型字段，作为秘密保存。
- api_key——必填，REST API 密钥：粘贴从 API Key Maintenance → New Key 复制的 API Key，其 Access Scope 须覆盖 Erp.BO.SalesOrderSvc、Erp.BO.CustomerSvc、Erp.BO.PartSvc。这是密码类型字段，作为秘密保存。
测试连接#
点测试连接。测试先检查五个字段是否都已填写——base_url 缺失会以 MISSING_BASE_URL 停下，其他字段任一缺失也会在发送任何请求前停下测试。然后它用两套凭证一起发一次真实的只读请求：向 SalesOrder 服务要一条销售订单，同一个请求里服务账号走 Basic 登录、API Key 一并发送。返回 200 才算测通。报错能告诉您该查哪套凭证：401 表示服务账号的用户名或密码被拒，400 或 403 表示 API Key 本身被拒、或它的 Access Scope 没覆盖该服务。实例约 12 秒不应答，测试会超时停下。
配 Mapping / 选模板#
选 Epicor Kinetic 标准 Mapping。它对接 API Key 的 Scope 覆盖的三个服务：销售订单来自 Erp.BO.SalesOrderSvc，客户来自 Erp.BO.CustomerSvc，库存查询读 Erp.BO.PartSvc。测试通过后先拉一次，把一个真实订单对照核对——订单号、客户、明细行与数量——再拿一个料号的数量和 Epicor 里显示的对一遍，确认后再激活。如果您实例上的某个字段不同，在 Mapping 里调整那个字段，不要去改 Epicor 里的东西。
激活#
激活后，连接按您设的频率把 Epicor Kinetic 的销售订单与客户拉进本系统，库存查询从 Epicor 读当前数量。先在 运行监控 / 日志里盯头几次拉取、和 Epicor 对照无误，再放手跑。
这个连接不做的事：不把库存变化推回 Epicor Kinetic。Epicor 里的数量仍由 Epicor 管——本连接只是读取。库存请继续在 Epicor 里维护。
常见问题#
测试报 401
Epicor 拒绝了 Basic 登录：服务账号的用户名或密码对不上，或该账号访问不了 company 字段里的公司。这个报错查的是服务账号——不是 API Key。
对照 User Account Security Maintenance 里的账号核对 username 与 password，确认该账号能访问您填的公司，然后重新测试。遇到 401 不要去改 API Key。
测试报 400 或 403
API Key 本身被拒，或它的 Access Scope 没覆盖测试调用的服务。服务账号可能完全没问题——这个报错查的是 Key 和它的 Scope，也就是凭证的另一半。
到 API Key Maintenance 里核对您粘贴的 Key 及其 Access Scope：必须覆盖 Erp.BO.SalesOrderSvc、Erp.BO.CustomerSvc、Erp.BO.PartSvc。如果 Key 复制不全或 Scope 不够，修 Scope 或新建一个 Key，完整粘贴进 api_key 后重新测试。
测试以 MISSING_BASE_URL 或其他缺字段信息停下
五个必填字段里有空的，测试在发送任何请求前就停下了。base_url、company、username、password、api_key 五个都必填，因为每次请求都需要两套凭证加公司地址。
按填进 Integration 一节把五个字段补全，保存后重新测试。base_url 要填完整的实例地址，开头不要缺。
每个值看着都对，但测试还是失败
一个常见原因是地址：如果 base_url 末尾带了 /api 后缀，系统会在它后面再拼自己的地址段，请求就去了错误的地址。company 值也会造成同类问题——它是地址的一部分，公司 ID 填错，测试就指向了一个不会为这套凭证应答的公司。
把 base_url 末尾的 /api 后缀去掉，让它正好是实例地址，例如 https://mycompany.epicorsaas.com/MyInstance；再对照服务账号能访问的公司，核对 company 的公司 ID。保存后先重新测试，不要先改凭证。
订单能拉进来，但客户或库存拉不进来
连接本身是通的——测试是在 SalesOrder 服务上通过的。缺的那类数据指向 API Key 的 Scope：每个服务都需要各自的覆盖，Scope 覆盖了 SalesOrderSvc 却漏了 CustomerSvc 或 PartSvc，就会订单能读、另外两类一直为空。
到 API Key Maintenance 里把该 Key 的 Access Scope 扩全，覆盖全部三个：Erp.BO.SalesOrderSvc、Erp.BO.CustomerSvc、Erp.BO.PartSvc。如果现有 Key 改不了 Scope，就新建一个带完整 Scope 的 Key，粘贴进 api_key，重新测试后再拉一次。
连接成功，但没有销售订单拉进来
连接是通的——测试已经真实读到了 SalesOrder 服务——只是没有新单可拉：Epicor 里该公司在拉单范围内没有新的销售订单，或那里的订单属于另一个公司、不是 company 字段里的那个。
在 Epicor 里用连接所用的同一个公司 ID 新建或确认一个销售订单，再手动拉一次，在预览或 运行监控 / 日志里确认订单出现。