Skip to content

Commit

Permalink
1.🚀 新增 获取业务对象实例列表 接口 v2.1 版本
Browse files Browse the repository at this point in the history 
 - 新增了 active（是否启用）参数过滤业务对象数据。
2.🚀 新增 获取统一开票信息 接口 v2.1 版本
 - 新增了支持拉取所有统一开票发票信息（火车票、机票等），v1 只支持拉取统一开票的增值税发票信息。
3.🐞 更新 查询员工 接口
 - 响应信息中新增了 roles（角色信息）字段。
4.🐞 更新 创建单据、更新单据 接口
 - 修改了单据明细字段校验逻辑，当明细字段设置为必填项+默认值，参数传空情况下会优先校验必填项，提示字段不能为空。调整为：优先默认值赋值后，再做必填项校验。
5.🐞 更新 获取付款账户 接口
 - 修复了根据 cardNos（银行卡号）查询对应的付款账户信息时，查询条件不生效的BUG。
  • Loading branch information
@DogeFeng
DogeFeng committed Oct 23, 2023
1 parent b0a1300 commit dbec0c0
Show file tree
Hide file tree
Showing 31 changed files with 946 additions and 219 deletions.
18 changes: 9 additions & 9 deletions docs/open-api/basedata/get-basedata-city.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -51,20 +51,20 @@ curl --location --request POST 'https://app.ekuaibao.com/api/openapi/v1/city/get
{
"items": [
{
"id": "1353", //编号
"id": "1353", //城市ID
"version": 4,
"active": true,
"createTime": 1505372614205,
"updateTime": 1505372614205,
"name": "江西省", //名称
"nameSpell": "JIANGXISHENG", //拼音
"code": "360000", //编码
"name": "江西省", //城市名称
"nameSpell": "JIANGXISHENG", //城市拼音
"code": "360000", //城市编码
"corporationId": "",
"enName": "Jiangxisheng", //英文名称
"enFullName": "Jiangxi, China", //英文全称
"fullName": "中国, 江西省", //中文全称
"country": "国内",
"parentId": "", //父级编号
"enName": "Jiangxisheng", //英文名称
"enFullName": "Jiangxi, China", //英文全称
"fullName": "中国, 江西省", //中文全称
"country": "国内", //国家
"parentId": "", //父级编号
"treeLevel": 0,
"extendInfo": {
"trainCode": null,
Expand Down
334 changes: 334 additions & 0 deletions docs/open-api/basedata/get-basedata-cityById.md
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,334 @@
# 根据ID查询城市信息

import Control from "@theme/Control";

<Control
method="GET"
url="/api/openapi/v1/city/getCity"
/>

<details>
<summary><b>更新日志</b></summary>
<div>

[**1.24.0**](/docs/open-api/notice/update-log#1240) -> 🆕 新增了本接口。<br/>

</div>
</details>

## Query Parameters

| 名称 | 类型 | 描述 | 是否必填 | 默认值 | 备注 |
|:----------------| :--- |:--------| :--- |:--- |:----------------------------------------------------------------|
| **accessToken** | String | 认证token |必填 | - | 通过 [获取授权](/docs/open-api/getting-started/auth) 获取 `accessToken` |
| **id** | String | 城市ID |必填 | - | 通过 [获取城市列表数据](/docs/open-api/basedata/get-basedata-city) 获取 |


## CURL
```shell
curl --location 'https://app.ekuaibao.com/api/openapi/v1/city/getCity?accessToken=ID01tN5BpzT47Y%3ATdk3tgber501v0&id=1'
```

## 成功响应
```json
{
"value": {
"pipeline": 1,
"grayver": "9.64.0.0-prd",
"dbVersion": 0,
"threadId": "",
"id": "1", //城市ID
"version": 26,
"active": true,
"createTime": 1505372614157,
"updateTime": 1505372614157,
"name": "北京", //城市名称
"nameSpell": "BEIJINGSHI", //城市拼音
"code": "110100", //城市编码
"corporationId": "",
"sourceCorporationId": null,
"dataCorporationId": null,
"enName": "Beijing", //英文名称
"enFullName": "Beijing, China", //英文全称
"fullName": "中国, 北京市", //中文全称
"country": "国内", //国家
"hoseCityCode": "110100",
"parentId": "", //父级编号
"treeLevel": 0,
"extendInfo": {
"trainCode": [
"bjb:北京北",
"bjd:北京东",
"bji:北京",
"bjn:北京南",
"bjx:北京西",
"cpb:昌平北",
"myb:密云北"
],
"airportCode": [
"PEK:首都国际机场",
"NAY:南苑机场"
],
"cityExtendCode": "0101",
"hoseMallCityCode": "NULL",
"yeegoFlightCityCode": "BJS"
},
"haveFlight": true,
"haveTrain": true,
"flightList": [
{
"code": "PEK",
"name": "首都国际机场",
"cityFlightCode": null
},
{
"code": "PKX",
"name": "大兴国际机场",
"cityFlightCode": null
}
],
"trainList": [
{
"code": "BJP",
"name": "北京"
},
{
"code": "VAP",
"name": "北京北"
},
{
"code": "BOP",
"name": "北京东"
},
{
"code": "VNP",
"name": "北京南"
},
{
"code": "BXP",
"name": "北京西"
},
{
"code": "IPP",
"name": "北京大兴"
},
{
"code": "NKP",
"name": "南口"
},
{
"code": "NGP",
"name": "南观村"
},
{
"code": "MUP",
"name": "密云北"
},
{
"code": "MAP",
"name": "庙城"
},
{
"code": "LPP",
"name": "落坡岭"
},
{
"code": "KZP",
"name": "康庄"
},
{
"code": "HCP",
"name": "黄村"
},
{
"code": "GSP",
"name": "孤山口"
},
{
"code": "GGP",
"name": "高各庄"
},
{
"code": "GVP",
"name": "官高"
},
{
"code": "DXX",
"name": "大兴"
},
{
"code": "DHP",
"name": "大灰厂"
},
{
"code": "VBP",
"name": "昌平北"
},
{
"code": "BVP",
"name": "北宅"
},
{
"code": "AAP",
"name": "百里峡"
},
{
"code": "ILP",
"name": "八达岭"
},
{
"code": "ADP",
"name": "安定"
},
{
"code": "AOP",
"name": "燕山"
},
{
"code": "YNP",
"name": "延庆"
},
{
"code": "TAP",
"name": "通州西"
},
{
"code": "LGP",
"name": "良各庄"
},
{
"code": "HRP",
"name": "怀柔"
},
{
"code": "HBP",
"name": "怀柔北"
},
{
"code": "CPP",
"name": "昌平"
},
{
"code": "HJA",
"name": "厚街"
},
{
"code": "HAU",
"name": "淮安东"
},
{
"code": "FGP",
"name": "雁栖湖"
},
{
"code": "TOP",
"name": "通州"
},
{
"code": "QEP",
"name": "乔庄东"
},
{
"code": "HKP",
"name": "黄土店"
},
{
"code": "HVP",
"name": "黑山寺"
},
{
"code": "GKP",
"name": "古北口"
},
{
"code": "IWP",
"name": "大兴机场"
},
{
"code": "DRB",
"name": "东二道河"
},
{
"code": "IYQ",
"name": "东城南"
},
{
"code": "ZIP",
"name": "张辛"
},
{
"code": "ZOP",
"name": "珠窝"
},
{
"code": "AFP",
"name": "云居寺"
},
{
"code": "YHP",
"name": "沿河城"
},
{
"code": "YAP",
"name": "雁翅"
},
{
"code": "EEP",
"name": "斜河涧"
},
{
"code": "WSP",
"name": "魏善庄"
},
{
"code": "TZP",
"name": "统军庄"
},
{
"code": "SOP",
"name": "顺义"
},
{
"code": "SWP",
"name": "上万"
},
{
"code": "SRP",
"name": "石景山南"
},
{
"code": "ODP",
"name": "三家店"
},
{
"code": "SVP",
"name": "三合庄"
},
{
"code": "SHP",
"name": "沙河"
},
{
"code": "SEP",
"name": "十渡"
},
{
"code": "QHP",
"name": "清华园"
},
{
"code": "PYP",
"name": "平峪"
}
],
"isRuleNode": true,
"isLast": false //是否末级 true=是；false=否
}
}
```

## 失败响应

| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|:--------| :--- | :--- |:---------------------|
| **400** | - | 查询结果不存在 | 请确认 `ID`（城市ID）参数是否正确 |
Loading

0 comments on commit dbec0c0

Please sign in to comment.