帮助 › 集成目录

集成目录：HNR 能连接哪些系统？

本页集中说明 HNR 如何连接银行、物流公司、电商平台、税务机关、会计文件和其他程序。每行前面的标签说明今天的真实情况：哪些可以独立运行，哪些需要您自己的账户或合同才能开通，哪些目前还没有。如果某个连接尚未用真实账户测试过，会直接写明。

1. 标签的含义

• 已可用今天即可使用。不需要外部账户或合同；如需什么，也只是您自己的服务器、文件或密钥。
• 已就绪，需用您的账户测试连接代码已按对方的官方文档完整编写，并通过了 HNR 自己的测试，但尚未用真实账户试过。请先在对方的测试环境中建立第一个连接并加以验证。
• 需要签约对方只在签约后提供技术文档。HNR 中的位置已准备好；文档和凭据到位后即可完成连接。
• 即将推出已在开发队列中；目前尚不可用。
• 暂无目前没有，也不在队列中。通常通过文件方式（CSV、XLSX、XML）也能完成同样的工作。

2. 银行

• 已可用银行流水导入 — 可读取 MT940、CSV/Excel 和 DBS 文件；已为土耳其和印度尼西亚银行准备了列格式模板，您自己的银行只需映射一次。流水按评分与发票匹配，经您确认后生成收款单。
• 已可用银行服务（邮件和 PDF） — 银行发送的交易通知邮件和 PDF 对账单由单独运行的银行服务读取；POS 结算也在这里跟踪。
• 已就绪，需用您的账户测试实时银行连接：开放银行 — 土耳其采用 ÖHVPS 标准（BKM 账户信息服务），印度尼西亚采用印尼央行 SNAP 标准（BCA、Mandiri、BNI、BRI 及通用 SNAP）。无需下载对账单即可拉取流水；需要持牌服务商协议和银行发放的密钥。
• 需要签约土耳其银行的企业网络服务 — Garanti BBVA、İş Bankası、Yapı Kredi、Akbank、Ziraat、Halkbank、VakıfBank、QNB、DenizBank 和 Kuveyt Türk 已列入目录。服务文档随与支行签订的 ERP 集成合同提供，当天即可接入驱动。
• 已可用工资代发文件 — 根据工资表，通过模板生成银行要求的定长文本文件。银行不公开此格式，因此您需要与开户银行核对一次模板。
• 即将推出供应商批量付款指令文件 — 根据付款计划，以单个文件向银行发送批量付款指令。

3. 快递与物流

• 已可用快递跟踪链接和标签 — 只需填写一次快递公司的跟踪地址，并使用占位符 {takip}；发货单上的运单号即变成可点击链接。快递面单、装箱单、箱标和送货单作为一套 PDF 文件一起打印。
• 需要签约快递公司 API — 目前无法在快递系统中自动下单，也无法自动查询状态；快递状态需在发货单上手动填写。与快递公司签订 API 协议后，驱动的位置已经准备好。
• 即将推出运费价目表和托盘标签 — 按“区域 × 公斤/体积重”运费表把发货成本分摊到订单和客户，以及 SSCC/GS1-128 托盘标签。

4. 电商平台

• 已就绪，需用您的账户测试Trendyol、Hepsiburada、Tokopedia、Shopee — 拉取订单、商品映射、推送库存和价格、打包发货、退货和结算。按平台官方 API 文档编写，尚未用真实店铺账户测试；请先在平台的测试环境中建立第一个连接。
• 已可用模拟平台 — 用您自己的库存卡片和示例订单演练整个流程，不会触及真实店铺。
• 暂无其他平台 — Amazon、N11、Çiçeksepeti、Lazada、TikTok Shop 等平台没有驱动；这些平台的订单目前需手动录入。

5. 电子单据和官方文件

• 已可用电子发票 XML（UBL-TR 1.2） — 可根据销售发票和退货发票生成并下载基础发票和商业发票格式的 XML；无需集成商账户即可校验。
• 需要签约直接发送电子单据 — 在土耳其，电子发票（e-Fatura）通过私营集成商发送：已编写 Uyumsoft 和 İzibiz 驱动，接口地址在开通集成商账户后核实，财务电子印章由集成商加盖；电子存档发票（e-Arşiv）和电子发货单（e-İrsaliye）的发送也将依同一合同加入。在印度尼西亚，HNR 不是 PJAP；文件需由您自行上传到 Coretax。
• 已可用Coretax 和 e-Bupot 文件（印度尼西亚） — 可生成 e-Faktur 批量 XML、退货（retur）XML、e-Bupot Unifikasi、PPh 21（BPMP）和 1721-A1 文件；每个文件都按 DJP 的 XSD 校验，若 DJP 未公布 XSD，则按从 DJP 模板推导出的模式校验，不合格的文件不会输出。上传到门户由您完成。
• 已可用官方申报文件 — 土耳其：代扣代缴与社保合并申报表中的 SGK 部分（XML）；印度尼西亚：BPJS（SIPP、Edabu）、SPT Masa PPN、LKPM、SAK EP 和 IT Inventory 数据导出。义务日历会提醒截止日期。
• 已可用读取收到的发票 — 供应商的电子发票（e-Fatura 或 e-Faktur）XML、PDF 或照片会转换为采购发票草稿；由您核对并批准。

6. 会计与数据传输

• 已可用CSV 和 Excel 导出 — 每个列表都可导出 CSV；公司报表、会计凭证、试算平衡表和财务报表也可下载为 Excel（XLSX）。
• 已可用无需另外的会计软件 — 发票、收款、支票和生产确认会自动生成记账凭证（土耳其统一会计科目表、印尼 SAK EP）；试算平衡表、资产负债表和利润表直接由 HNR 出具。
• 已可用Logo 数据桥（只读） — 往来单位卡片上并排显示 Logo Wings 对账单，HNR↔Logo 库存报表对比两个系统。需要 Logo MCP 服务器；HNR 不向 Logo 写入。
• 已可用从旧 HNR 数据库迁移 — 在首次安装向导中使用“导入数据库”，可把旧 HNR（Firebird）公司的卡片、单据、生产数据和附件连同核对报告一起迁移过来。
• 已可用文件导入 — 价目表和电商平台商品映射（CSV/XLSX）、三坐标 CMM 测量报告（Q-DAS ASCII）以及客户 EDI 订单（CSV/JSON → 订单草稿）。不支持 EDIFACT/VDA 报文和 OFTP2 传输。
• 即将推出从其他软件导入的向导 — 从 Logo、Mikro、Netsis、Nebim、Accurate、Jurnal、Zahir 和 Excel 导入往来单位、库存、未结余额和价目表，使用各软件的官方导出格式。
• 暂无面向外部会计软件的凭证文件及电子账簿（e-Defter） — 没有可将日记账导入 Logo、Mikro、Luca 或 Accurate 的现成文件，也没有向土耳其税务局（GİB）报送电子账簿（e-Defter）的功能。凭证可导出为 XLSX。

7. 通信与外部服务

• 已可用WhatsApp — 消息服务通过二维码绑定您自己的号码（经由 WhatsApp Web，并非官方 WhatsApp Business API）。可发送报价单、订单和发票的 PDF 以及 CRM 消息模板。
• 已可用电子邮件 — 报价单、订单和发票通过您自己的 SMTP 服务器发送给客户。
• 已可用汇率 — 土耳其：自动读取土耳其央行（TCMB）汇率。印度尼西亚：印尼央行（JISDOR）汇率需手动录入汇率表；没有自动读取。
• 已可用HNR 智能助手（AI） — 只读助手基于 Anthropic Claude API 运行；API 密钥和使用费用由您承担。

8. 开放 API、门户和数据库

• 已可用HTTP API（REST/JSON） — 界面使用的所有接口（按 2026 年 10 月 2 日统计超过 2,150 个）同样向其他程序开放。每个请求都携带安装时设定的 API 密钥（Authorization: Bearer）和某个用户的会话令牌（/api/auth/login → X-Oturum-Token）；操作以该用户的权限和公司执行。写入请求可借助 Idempotency-Key 安全重试。
• 暂无公开的 API 文档和事件通知（Webhook） — 没有 OpenAPI/Swagger 文档，数据变化时也不会向外推送通知。接口清单向安装团队索取；如需跟踪变化，可轮询更新计数器。
• 已可用门户 — 客户门户、供应商报价门户、外协加工门户、B2B 订货、外勤销售应用和员工门户；各自独立登录，并有各自的权限边界。
• 已可用数据库引擎 — Firebird、PostgreSQL、CockroachDB、Microsoft SQL Server 和 Oracle；云端可用 PostgreSQL（Neon）和 CockroachDB Cloud。数据库引擎在创建公司时选定。