连接器目录：ERP、外部 WMS 与运营平台
ERP、外部 WMS、车队/车联网、柜子追踪与最后一公里配送平台：每个连接向导要填的字段与获取路径。
ERP 与财务系统#
ERP 连接器双向同步同一批单据：客户、产品、销售订单在 Docklify 与 ERP 之间流动，由出库和收货生成的发票/账单可回传到 ERP 总账。下面每个连接器都列了向导要填的字段和获取路径。小提示：如果您的 ERP 提供沙箱/测试公司，可以先在那边建连接核对字段与流程，再切到正式公司。
QuickBooks Online
QuickBooks Online 是 Intuit 面向中小企业的云会计平台。它走 QuickBooks 官方 API，同步 ERP 标准单据集——客户、产品、销售订单双向同步，发票回传 QuickBooks。连接方式：OAuth2——在向导里填您 QuickBooks 应用的 Access Token 和公司 Realm ID。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Realm ID（公司 ID） | 必填 | QuickBooks → 齿轮 → 账户设置 → 账单与订阅 → Company ID |
| Access Token | 必填 | 在 Intuit Developer 门户（OAuth2 playground）用您的 QuickBooks 应用获取；1 小时过期，用应用的 Client ID / Secret 刷新 |
| Environment（环境） | 选填 | production（默认）或 sandbox |
Xero
Xero 是面向小企业及其会计师的云会计平台。它走 Xero 官方 API 同步 ERP 标准单据集。连接方式：OAuth2——填您 Xero 应用的 Access Token 和要同步的组织 Tenant ID。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Tenant ID | 必填 | OAuth 后调 GET api.xero.com/connections 返回；或在 developer.xero.com 您的应用里看 |
| Access Token | 必填 | 您的 Xero 应用的 OAuth2 token；scopes 需含 accounting.transactions.read、accounting.contacts.read、accounting.settings.read |
Odoo
Odoo 是模块化的开源 ERP——销售、库存、会计等一整套，可跑在 Odoo Online 或您自己的服务器上。它走 Odoo 外部 API 同步 ERP 标准单据集。连接方式：填实例的 Base URL 和数据库，用用户名 + API Key 登录（Odoo 把 API Key 当密码用）。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Base URL（地址） | 必填 | 您的 Odoo 地址，如 https://mycompany.odoo.com |
| Database（数据库） | 必填 | Odoo 数据库名；Odoo Online 通常就是子域名 |
| Username（用户名） | 必填 | API Key 所属的 Odoo 用户 |
| API Key | 必填 | 头像 → My Profile → Account Security → New API Key；当密码用 |
注意：Odoo Online 只有 Custom 套餐开放外部 API。
NetSuite
NetSuite 是 Oracle 面向较大规模和多实体运营的云 ERP。它走 NetSuite REST Web Services 同步 ERP 标准单据集。连接方式：OAuth2——填 Account ID 和 NetSuite 集成记录（integration record）的 Access Token（旧的 TBA 令牌认证不支持）。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Account ID（账号 ID） | 必填 | NetSuite → Setup → Company → Company Information（沙箱账号形如 1234567_SB1） |
| Access Token | 必填 | NetSuite integration record 的 OAuth2 access token，需 rest_webservices scope。不支持 TBA——用 OAuth2 |
Microsoft Dynamics 365 Business Central
Microsoft Dynamics 365 Business Central 是微软面向中小企业的云 ERP。它走 Business Central API 同步 ERP 标准单据集。连接方式：Microsoft Entra 应用注册——填 Tenant ID、Client ID、Client Secret（客户端凭证登录）。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Tenant ID | 必填 | Microsoft Entra 管理 → 应用注册 → 您的应用 → 目录（租户）ID |
| Client ID | 必填 | 同一应用注册页（Application ID） |
| Client Secret | 必填 | Entra → 证书和密码；只显示一次。Business Central 侧还要建 Entra 应用记录并分配权限集 |
| Environment（环境） | 选填 | 通常填 production |
| Company（公司） | 选填 | Business Central 公司名；留空用第一家公司 |
Sage Intacct
Sage Intacct 是面向财务主导型和多实体公司的云财务管理平台。它走 Intacct REST API 同步 ERP 标准单据集。连接方式：填您在 Sage 开发者门户里应用的 Client ID / Client Secret；多实体公司还要指定入账实体。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Client ID | 必填 | Sage 开发者门户 → 您的应用（REST API 凭证） |
| Client Secret | 必填 | 同一应用页面 |
| Entity ID（实体 ID） | 选填 | 仅多实体公司填：要入账的实体 ID |
Intacct 要用专用集成用户。以该用户登录 Intacct Web 界面会使它的 REST token 失效（报错 REST-2102）——同步突然报这个错时，重新发 token，且不要再用该用户登录界面。
Acumatica
Acumatica 是面向中型分销、制造和商贸企业的云 ERP。它走 Acumatica 基于契约的 REST API 同步 ERP 标准单据集。连接方式：用有 API 权限的用户名/密码登录您的 Acumatica 站点和公司。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Base URL（地址） | 必填 | 您的 Acumatica 地址，不带 /entity，如 https://erp.example.com/AcumaticaERP |
| Company（公司） | 必填 | 要登录的 Acumatica 公司（租户）名 |
| Username（用户名） | 必填 | 有 API 权限的 Acumatica 用户 |
| Password（密码） | 必填 | 该用户的密码 |
| Branch（分支） | 选填 | 如公司用分支则填要入账的分支 |
| Endpoint 名称 / 版本 | 选填 | 名称通常 Default，版本与 Acumatica 版本一致，如 24.200.001 |
Microsoft Dynamics 365 Finance & Supply Chain
Microsoft Dynamics 365 Finance & Supply Chain Management 是微软的企业级 ERP。它走环境自带的 OData 服务同步 ERP 标准单据集。连接方式：Microsoft Entra 应用注册——对着您的 Environment URL 填 Tenant ID、Client ID、Client Secret。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Environment URL（环境地址） | 必填 | 您的 F&SCM 环境地址，不带 /data，如 https://<env>.operations.dynamics.com |
| Tenant ID | 必填 | Microsoft Entra → 应用注册 → 目录（租户）ID |
| Client ID | 必填 | 同一应用注册。还要在 F&O 里登记：系统管理 → Microsoft Entra ID 应用程序，并绑定用户/角色 |
| Client Secret | 必填 | Entra → 证书和密码；只显示一次 |
SAP S/4HANA
通过 S/4HANA OData API 同步。没有默认地址——Cloud 与本地部署不同；两种认证二选一：填 Basic 对（用户名/密码）或 OAuth2 三件套（Client ID / Secret / Token URL），不要都填。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Base URL（地址） | 必填 | 您的 S/4HANA 主机地址（问 SAP basis 团队 / BTP destination） |
| SAP Client | 选填 | 如系统有多个 client 则填 client 号 |
| 用户名 / 密码（Basic） | 选填 | S/4HANA 里的通信用户——与下面 OAuth2 三件套二选一 |
| Client ID / Secret / Token URL（OAuth2） | 选填 | Cloud 系统：从 BTP 里集成实例的 service key 取 |
SAP Business One
SAP Business One 是 SAP 面向中小企业的 ERP。它走 Business One Service Layer 同步 ERP 标准单据集。连接方式：用有 API 权限的 Business One 用户的公司库、用户名、密码登录。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Service Layer 地址 | 必填 | Service Layer 地址，不带 /b1s/v2，如 https://<host>:50000 |
| Company Database（公司库） | 必填 | 公司数据库名，如 SBODemoUS |
| Username（用户名） | 必填 | 有 API 权限的 Business One 用户 |
| Password（密码） | 必填 | 该用户的密码 |
Oracle Fusion ERP（Cloud）
通过 Fusion REST API 同步。二选一：Basic 对（用户名/密码）或预先拿好的 OAuth token——填了 token 优先用 token。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Base URL（地址） | 必填 | 您的 Fusion 环境地址，如 https://<pod>.fa.<region>.oraclecloud.com |
| 用户名 / 密码（Basic） | 选填 | 有集成角色的 Fusion 用户——或改用下面 token |
| OAuth Token | 选填 | 从 OCI / IDCS 域预先拿到的 Bearer token |
| API 版本 | 选填 | 默认 11.13.18.05；仅当您的 Fusion 版本不同时改 |
Cin7
Cin7 是面向多渠道卖货企业的云库存与订单管理平台。它走 Cin7 API 同步 ERP 标准单据集。连接方式：填您在 Cin7 账号里 API 连接上设置的 API Username / API Password。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| API Username（用户名） | 必填 | Cin7 → go.cin7.com → API 连接 → 该连接的用户名 |
| API Password（密码） | 必填 | 同一 API 连接里设置 |
Epicor Kinetic
Epicor Kinetic 是为制造商和分销商打造的 ERP。它走 Kinetic 的 REST 服务同步 ERP 标准单据集。连接方式：用户名/密码登录，再加一把在 Kinetic 的 API Key Maintenance 里生成的 API Key，其 Access Scope 需覆盖销售订单、客户和产品服务。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Base URL（地址） | 必填 | 您的 Kinetic 服务器地址，不带 /api，如 https://<host>/Kinetic |
| Company（公司） | 必填 | 公司代码，如 EPIC06 |
| Username（用户名） | 必填 | 集成用的 Kinetic 用户 |
| Password（密码） | 必填 | 该用户的密码 |
| API Key | 必填 | Kinetic → API Key Maintenance → New Key（只显示一次）。Access Scope 需覆盖 SalesOrderSvc、CustomerSvc、PartSvc |
Fishbowl
Fishbowl 是库存管理系统，很多用 QuickBooks 记账的卖货企业在用它管库存。它走 Fishbowl 服务器 API 同步 ERP 标准单据集。连接方式：以一个 App Name 用用户名/密码登录——首次登录后要在 Fishbowl 的 Settings → Integrated Apps 里把这个应用批准一次。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Server URL（服务器地址） | 必填 | 您的 Fishbowl 服务器地址，如 http://192.168.1.10:80——必须能从公网或 VPN 访问到 |
| Username（用户名） | 必填 | 集成用的 Fishbowl 用户 |
| Password（密码） | 必填 | 该用户的密码 |
| App Name（应用名） | 必填 | 这条集成登录时用的应用名。首次登录后在 Fishbowl 里批准：Settings → Integrated Apps |
| App ID | 选填 | 如您的配置在批准后分配了 App ID 则填 |
Brightpearl
Brightpearl 是面向多渠道卖家的零售运营平台——订单、库存、会计一体。它走 Brightpearl API 同步 ERP 标准单据集。连接方式：OAuth——用您的应用走 Authorization Code Grant 拿 Access Token，再加 Account、Datacenter、App Ref、Dev Ref。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Account（子域名） | 必填 | 您 Brightpearl 地址的子域名，如 acme.brightpearl.com 里的 acme |
| Datacenter（数据中心） | 必填 | OAuth 流程返回的 api_domain，如 use1.brightpearlconnect.com |
| App Ref | 必填 | 您在 Brightpearl 开发者设置里的应用 ref |
| Dev Ref | 必填 | 同一设置里的开发者 ref |
| Access Token | 必填 | 用您的应用走 Authorization Code Grant 获得 |
外部 WMS#
外部 WMS 连接的方向和销售渠道相反：Docklify（OMS / 控制塔）把订单和 ASN 发给不是 Docklify WMS 的仓储系统，再接收库存和发货确认回来。
Item WMS（UNIS）
把 Docklify 连到 Item WMS / UNIS 仓：订单和 ASN 下发，库存和发货状态回传。下面所有 ID 都由 UNIS 分配，不能自建。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Username（用户名） | 必填 | Item WMS 登录用户名 |
| Password（密码） | 必填 | Item WMS 登录密码 |
| Company ID（公司 ID） | 必填 | UNIS 系统管理员分配；几乎每次 API 调用都要带 |
| Customer ID（客户 ID） | 必填 | UNIS 财务分配 |
| Facility ID（仓库 ID） | 必填 | 您的 ITEM CSR 分配的仓库 ID |
| Base URL（地址） | 选填 | 默认生产地址 https://wms.item.com/api/public/v1/public |
Logiwa
把 Docklify 连到 Logiwa 仓：订单下发，库存和发货确认回传。认证用 Logiwa 账号的邮箱/密码，系统自动换 session token。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Username（邮箱） | 必填 | 有 API 权限的 Logiwa 用户邮箱 |
| Password（密码） | 必填 | 该用户的 Logiwa 密码 |
Oracle WMS Cloud
把 Docklify 连到 Oracle WMS Cloud（LogFire）：订单下发，库存和发货确认回传。认证走您的 Oracle IDCS 域，OAuth2 client credentials 三件套；具体值以您的 Oracle WMS 实例配置为准。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Client ID | 必填 | 您 WMS 实例的 IDCS 机密应用 |
| Client Secret | 必填 | 同一 IDCS 应用 |
| Token URL | 必填 | 您的 IDCS 域的 OAuth token 端点 |
车队、车联网与地图（TMS）#
Samsara
把 Samsara 的车队、车辆和司机数据（位置、状态）拉进 TMS，用于调度和实时跟踪。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| API Token | 必填 | Samsara Dashboard → Settings → API Tokens——生成一个带 fleet / vehicles / stats 读权限的 token |
| Base URL（地址） | 选填 | API 区域：默认 https://api.samsara.com；欧盟客户用 https://api.eu.samsara.com |
Motive
把 Motive（KeepTruckin）的车队和车辆数据拉进 TMS。Motive 走 OAuth 2.0 authorization_code 流程：先完成授权，把换到的 access token 粘到这里。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Access Token（访问令牌） | 必填 | 经 gomotive.com/oauth/authorize → gomotive.com/oauth/token 换到的 token |
| Base URL（地址） | 选填 | 默认 https://api.gomotive.com；仅车队用区域端点时改 |
FedEx Freight
在 TMS 里做 FedEx Freight 的 LTL 报价和订舱。用 FedEx Developer Portal 同一套应用模型，但账号填 Freight 账号。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Client ID | 必填 | FedEx Developer Portal → 您的应用 → Client ID |
| Client Secret | 必填 | 同一应用页面 |
| Freight Account Number（账号） | 必填 | 您的 FedEx Freight 账号（LTL 报价与计费用） |
| Test Mode（测试模式） | 选填 | "true"（默认）走沙箱 https://apis-sandbox.fedex.com（需沙箱凭证）；"false" 走生产 https://apis.fedex.com |
Google Maps（路线）
为 TMS / LastMile 规划做路线和里程计算，走 Google Routes API。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| API Key | 必填 | Google Cloud Console → 建项目 → 启用 Routes API → 创建 API key（建议限定 Routes API + IP） |
Mapbox
为 TMS / LastMile 规划做路线和里程计算，走 Mapbox Directions API——Google Maps 的替代，二选一接即可。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Access Token | 必填 | account.mapbox.com → Access Tokens |
柜子追踪（Drayage）#
Terminal49
从 Terminal49 拉柜子节点、船期和码头可用状态给 Drayage 用。Key 可自助申请，免费 Developer Key 就能追踪 100 个柜子。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| API Key | 必填 | app.terminal49.com/developers/api-keys——在那里建 key |
Vizion
从 Vizion 拉柜子追踪事件和节点给 Drayage 用。没有自助注册——Key 由 Vizion 销售发放。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| API Key | 必填 | 开通账号时由 Vizion 销售发放（作为 X-API-Key 请求头发送） |
最后一公里配送平台#
这两个连接让 LastMile 把订单派给即时配送网络。两个都要在连接上填取件地址，因为每单都是从这个取件点创建的。
DoorDash Drive
DoorDash Drive 是 DoorDash 的即时配送网络，用您自己的订单叫骑手：LastMile 从您的取件点创建配送，并一路跟踪到客户门口。连接方式：用 DoorDash 开发者门户的 API 凭证——请求以 Developer ID、Key ID 和 Signing Secret 签成 JWT 发送。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Developer ID（开发者 ID） | 必填 | DoorDash 开发者门户 → Credentials 页 |
| Key ID（密钥 ID） | 必填 | 同一 Credentials 页（与 Signing Secret 配对） |
| Signing Secret（签名密钥） | 必填 | 同一 Credentials 页（base64；用于签 JWT） |
| 取件地址 | 选填 | 单行取件地址。除非填了下面商家外部 ID + 门店外部 ID（那时用已注册门店地址），否则必填 |
| 商家外部 ID / 门店外部 ID | 选填 | 如商家和门店已在 DoorDash 注册，两个一起填，替代地址 |
| 取件门店名称 | 选填 | 取件时配送员看到的商家名称 |
| 取件联系电话 | 选填 | 取件时配送员可拨打的电话 |
Uber Direct
Uber Direct 是 Uber 的即时配送网络，用您自己的订单叫骑手：LastMile 从您的取件点创建配送，并一路跟踪到客户门口。连接方式：OAuth2 客户端凭证——direct.uber.com 上您应用的 Client ID / Client Secret，挂在您的 Customer ID 之下。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Client ID | 必填 | direct.uber.com → Developer → 您的应用 → API credentials |
| Client Secret | 必填 | 同页；只显示一次 |
| Customer ID | 必填 | direct.uber.com → Developer → Customer ID（出现在 API 路径 /v1/customers/{customer_id}/deliveries 里） |
| 取件地址（JSON） | 必填 | 门店/仓库取件地址，JSON 字符串，如 {"street_address":["20 W 34th St"],"city":"New York","state":"NY","zip_code":"10001","country":"US"}。下单配送时必填（测试连接不需要） |
| 取件点名称 | 选填 | 展示给骑手的门店名称（默认 "Merchant"） |
| 取件点电话 | 选填 | 骑手取件时可拨打的电话 |
平台履约#
Amazon FBA
这个连接支撑平台履约功能：FBA 库存同步、自有仓与 Amazon 的统一库存视图、补货预警。它用的就是上面 Amazon SP-API 渠道连接那套凭证——多一个要求：您的 SP-API 应用必须授权了 "Amazon Fulfillment" 角色，否则 FBA 库存接口会被拒。已经接了 Amazon SP-API 连接的，Seller ID、LWA 对、refresh token 和 AWS 密钥可以复用同一套。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Seller ID（Merchant Token） | 必填 | 卖家平台 → 设置 → 账户信息 → Merchant Token |
| Marketplace ID | 必填 | 美国站：ATVPDKIKX0DER |
| LWA Client ID / Secret | 必填 | 卖家平台 → 应用与服务 → 开发应用里的 SP-API 应用（应用需有 Amazon Fulfillment 角色） |
| Refresh Token | 必填 | 经亚马逊授权流程获得（卖家平台 → 应用与服务 → 授权） |
| AWS Access Key ID / Secret | 必填 | 用于 SigV4 签名的 AWS IAM 密钥（Secret 创建时只显示一次） |
| IAM Role ARN | 选填 | 仅 STS AssumeRole 签名时填；留空用上面的密钥直接签 |
退货平台#
退货平台负责面向消费者的退货门户，并决定每件退货的去向。接上其中一家后，它的退货会进 Docklify 的退货管理（RMS）：仓库能提前看到哪些退货在路上，收到后逐件处理，并按平台的处置决定安排后续出库。
Happy Returns
Happy Returns（UPS 旗下）运营以线下 Return Bar 送回点为核心的退货门户，也支持邮寄退货。这个连接让 Docklify 的退货管理（RMS）与 Happy Returns 保持同步：消费者发起退货、退货被批准和签收时，状态变化会推送到 Docklify。连接方式：开通时发放的 API 密钥，请求时放在 X-Hr-Apikey 头里。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| API 密钥 | 必填 | 开通时由 Happy Returns 客户经理提供（API 设置页） |
| 接口基址 | 选填 | 商家接口地址在开通时单独提供。现在可以先留空，等开通时拿到地址再回来填 |
Loop Returns
Loop Returns 是面向电商品牌的退货门户：消费者在 Loop 里发起和跟踪退货，这个连接让仓库在 Docklify 的退货管理（RMS）里处理这些退货——到货时标记、工作台上逐件处理。连接方式：Loop 后台生成的 API 密钥，请求时放在 X-Authorization 头里。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| API 密钥 | 必填 | Loop 后台 → Returns Management → Tools & integrations → Developer Tools：生成带 returns 权限的密钥 |
ReturnGO
ReturnGO 是覆盖退货全流程的退货门户，从消费者申请到退款都管。这个连接把它的退货单（RMA）同步到 Docklify 的退货管理（RMS），仓库可以按单查询，退货到货前就知道要回来什么。连接方式：API 密钥 + 店铺域名，每次调用放在请求头里；另外要填 ReturnGO API 文档里给出的服务器地址。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| API 密钥 | 必填 | ReturnGO 后台 → Settings → API：生成密钥（一个密钥可管多个店铺） |
| 店铺域名 | 必填 | 在 ReturnGO 里登记的店铺域名，如 demo-store.myshopify.com（放在 x-shop-name 头里） |
| API 服务器地址 | 必填 | 在 ReturnGO 官方 API 文档（Swagger）的 Servers 一栏里复制服务器地址 |
| API 密钥请求头名 | 选填 | 多数情况下是 x-api-key。如果对接时 ReturnGO 给了别的头名，改填那个 |
Optoro
Optoro 负责决定每件退货的下一个去向——转售、清仓、退回供应商、捐赠——让退货库存尽量变现。这个连接把 Optoro 的处置决定带到 Docklify，用它驱动后续出库，把退货发往选定的渠道。连接方式：Optoro 的 Client Success 团队发放的 OAuth 2.0 客户端凭证。
| 字段 | 必填？ | 去哪拿 |
|---|---|---|
| Client ID | 必填 | 由 Optoro 的 Client Success 团队在开通 API 时发放 |
| Client Secret | 必填 | 和 Client ID 一起由 Optoro 的 Client Success 团队发放 |