SQL 应用程序接口

SQL 应用程序接口 支持自动化数据交换,减少手动数据录入,并通过 Postman 工具、清晰的负载(Payload)文档以及适用于常见编程技术栈的现成示例,加快集成开发速度。

sql-api

快速集成所需的一切

从安全认证到预构建示例以及支持的工作流程,所有关键要素一应俱全,帮助您的团队更快完成集成与部署。

security

AWS SIGV4 AUTHENTICATION

系统间安全请求认证与控制机制

postman collection

POSTMAN COLLECTION

使用预置请求进行快速接口测试

json-pdf

JSON AND PDF WORKFLOWS

支持数据交换与文档处理流程

programming

PROGRAMMING LANGUAGES

主流编程语言的入门示例代码

document

DOCUMENTED OBJECTS

可用于处理发票、库存、付款等数据对象

支持的工作流程

R

连接销售、采购、库存、客户、付款、日记账以及转账等工作流程

R

创建、编辑、删除并检索业务记录

R

支持启用 GST 与 SST 的 SQL 会计业务流程,实现自动化税务合规与无缝对账处理

R

增强实时与批量数据更新能力

处理的内容

探索当前 API 文档中可用的业务对象和输出格式。

可用输出格式

业务对象

stock_transfer

库存调拨

stock_received

库存收货

stock

产品项目

stock_received

销售发票

purchase invoice

采购发票

sale invoice

销售订单转销售发票

customer

客户资料维护

agent

代理

stock_transfer

日记账分录

payment voucher

总账付款凭证

payment

客户付款

json
pdf

工作原理

从受控测试环境开始,验证你的数据载荷(Payload),然后使用相同的集成方式进入生产环境上线。

安全 API 凭证申请

通过入驻流程发放访问密钥和密钥,以确保 API 使用的安全与可控性。

使用Postman测试点

使用提供的集合验证请求签名、必填字段以及模块行为。

发送获取 JSON 记录

使用结构化数据与字段规则进行数据增删改查操作与管理。

进入正式集成

使用相同托管API方法进行演示,获取凭证后完成生产环境上线。

如何开始

使用资源集合,从首次请求到生产环境规划,实现更少的试错与猜测。

api-step-1

下载 Postman 集合

快速导入请求,并验证身份认证、请求头以及接口行为。

设置与配置

按照 SQL会计 API 的设置流程,使用服务商签发的凭证完成配置。

api-step-2
api-step-3

查看示例负载(Payload)

在映射外部系统字段之前,先查看最小字段的 JSON 示例。

浏览代码示例

从不同编程语言的示例代码入手,适配常见开发技术栈。

api-step-4
api-step-5

查看字段详情

使用字段参考资料来规划字段映射、数据验证以及必填数据处理。

阅读集成常见问题

查看常见请求模式、限制说明以及 JSON 结构指引。

api-step-6
api-step-7

讨论您的集成需求

当您准备确认适用性、上线流程及后续步骤时,可与 SQL 团队联系沟通。

需求条件

在开始 API 集成项目之前,请先准备好合适的软件版本、网络设置以及相关技术资源。

SQL 会计与环境需求
N

建议使用 SQL会计版本

5.2025.1038.875 或以上版本

N

建议使用 Firebird版本3.0.9 或以上版本。

N

建议使用 Microsoft Windows 11 或以上版本,优先选择 64 位系统。

N

运行 SQL会计与集成流程的电脑、服务器或托管环境需具备互联网连接。

N

网络连接应来自互联网服务提供商(ISP),并配备适当的路由器或办公室网络环境,以确保系统能够稳定连接至 API 端点。

N

不建议使用手机数据、个人热点或临时移动网络作为主要的集成连接方式。

集成凭证与设置流程
N

Access Key 与 Secret Key 将由服务提供商针对目标数据库发放。

N

API 端点域名可用于演示及正式生产环境上线,因此凭证管理应明确区分不同环境。

N

路由器、防火墙及对外网络访问设置应允许 SQL会计环境稳定连接至 API 端点。

SQL会计与环境需求
N

需要具备编程知识,以处理请求签名、数据负载(Payload)映射以及错误处理。

N

该 API 主要面向技术团队、实施合作伙伴或后端/中间件工作流程使用。

N

独立环境或仅浏览器端(Client-side)的使用方式并非建议的部署方案。

N

为获得最佳稳定性,建议在正式办公室、服务器或托管环境中运行集成,而不是依赖移动设备网络连接。

API 的使用方式

通过 API 将日常业务活动与会计记录及库存流程连接起来。

从 CRM 创建与更新客户资料

让 CRM、客户门户或销售工具中的客户资料与 SQL会计的客户维护记录保持同步。

将供应商账单导入采购发票

将采购系统或供应商系统与采购发票流程集成,实现更顺畅的会计处理。

从外部工作流程生成财务过账

根据外部工作流程创建财务记录,例如日记账分录、客户付款以及总账凭证。

仅同步订单至销售发票

将已确认的电商订单发送至 SQL会计作为销售发票,减少销售与财务团队的手动输入工作。

提取库存项目数据用于外部目录同步

使用库存项目数据来支持产品目录更新、客户门户、仓库工具以及运营仪表板。