流向数据直连 API

四川省新绿色医药集团有限公司 — 生产厂家流向数据查询接口（密钥认证）

📦 本接口面向药品生产厂家：凭密钥查询本厂家的全部购进记录（采购明细）、销售记录（销售明细）、库存明细，支持按商品名称 / 批号 / 日期筛选，支持一键全量下载。

🔑 已有密钥？请到密钥校验页校验密钥并预览数据（输入单位名称+联系人+联系电话+密钥）

接口列表

接口	方法	说明
`/api/health`	GET	健康检查（无需密钥）
`/check`	GET	密钥校验页面（输入四要素校验密钥+数据预览）
`/api/companies`	GET	查看本密钥绑定的单位信息
`/api/preview`	GET/POST	数据预览：本厂家销售/采购/库存三类明细的统计 + 最近10条样例
`/api/download`	GET/POST	全量下载：本厂家销售/采购/库存完整明细（csv/xlsx）
`/api/query`	GET	明细查询：本厂家数据范围内按商品名称/批号/日期筛选

身份认证（四要素）

调用接口需同时提供：单位名称全称 + 密钥 + 联系人姓名 + 手机号。请求头或URL参数均可：

X-Company-Name: 单位名称全称
X-API-Key: xlv_xxxxxxxx...
X-Contact-Name: 联系人姓名
X-Contact-Phone: 手机号

数据范围（核心功能）

密钥绑定的企业名称即生产厂家。调用接口后，系统自动按 生产厂家 = 本企业名称 过滤三类数据：

data_type	明细类别	查询范围（普通密钥）
`sale`	销售记录（销售明细）	本厂家生产的药品流向各客户单位的全部销售明细
`purchase`	购进记录（采购明细）	本厂家生产的药品被下游采购的全部购进明细
`stock`	库存明细	本厂家生产的药品在各库点的全部库存明细

即：一个厂家密钥 = 查询 / 下载该厂家全部购进记录、销售记录、库存明细的完整入口；按商品名称、批号、日期筛选均为该范围内的附加条件（可不传，不传即返回厂家全量数据）。

查询示例

# 1. 本厂家全部销售记录(JSON, 不传query_type即厂家全量)
curl -G -H "X-API-Key: 你的密钥" --data-urlencode "company_name=单位名称全称" --data-urlencode "name=联系人姓名" --data-urlencode "phone=手机号" --data-urlencode "data_type=sale" "https://liuxiang.xinlvyao.cn/api/query"

# 2. 本厂家购进记录中按商品名称筛选 + 日期范围 + 下载CSV
curl -G -H "X-API-Key: 你的密钥" --data-urlencode "company_name=单位名称全称" --data-urlencode "name=联系人姓名" --data-urlencode "phone=手机号" --data-urlencode "data_type=purchase" --data-urlencode "query_type=product_name" --data-urlencode "query_value=贞芪扶正颗粒" --data-urlencode "start_date=2025-01-01" --data-urlencode "end_date=2025-06-30" --data-urlencode "format=csv" -o 购进记录.csv "https://liuxiang.xinlvyao.cn/api/query"

# 3. 本厂家库存明细按批号筛选
curl -G -H "X-API-Key: 你的密钥" --data-urlencode "company_name=单位名称全称" --data-urlencode "name=联系人姓名" --data-urlencode "phone=手机号" --data-urlencode "data_type=stock" --data-urlencode "query_type=lot_number" --data-urlencode "query_value=240514" "https://liuxiang.xinlvyao.cn/api/query"

筛选条件（可选）

query_type	说明
`product_name`	按商品名称筛选（如：贞芪扶正颗粒）
`lot_number`	按批号筛选（如：240514）

不传 query_type / query_value 时，返回本厂家该类明细的全部记录（受 limit 上限约束）。

数据类别

data_type	说明
`sale`	销售记录（销售明细，默认）
`purchase`	购进记录（采购明细）
`stock`	库存明细

一键下载

在密钥校验页校验通过后，可直接点击销售/采购/库存分类的【下载CSV】【下载Excel】按钮，下载本厂家全量数据。也可直接调用接口：

# 下载本厂家全部销售记录(CSV, Excel打开不乱码)
curl -G -H "X-API-Key: 你的密钥" --data-urlencode "company_name=单位名称全称" --data-urlencode "name=联系人姓名" --data-urlencode "phone=手机号" --data-urlencode "data_type=sale" --data-urlencode "format=csv" -o 销售记录.csv "https://liuxiang.xinlvyao.cn/api/download"

# 下载本厂家全部库存明细(Excel)
curl -G -H "X-API-Key: 你的密钥" --data-urlencode "company_name=单位名称全称" --data-urlencode "name=联系人姓名" --data-urlencode "phone=手机号" --data-urlencode "data_type=stock" --data-urlencode "format=xlsx" -o 库存明细.xlsx "https://liuxiang.xinlvyao.cn/api/download"

注：普通密钥只能查询本厂家（生产厂家 = 企业名称全称）的销售/采购/库存三类明细；单次查询默认返回前5000条，可用 limit 调整（最大50000）；全量下载上限50000条，超出请联系管理员线下获取；密钥有效期365天，丢失请联系管理员找回；新厂家开通数据接口请联系管理员线下办理。