部门查询

  • 接口：common/departments/v2/findByCodes
  • Method：GET
  • 接口说明：根据部门编码列表查询部门信息（上限100）
  • 多语言环境：实现多语言环境方式是在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种

请求参数

字段名称 字段类型 字段描述 是否必填 长度
bizId String 业务唯一识别码 true 255
timestamp long 时间戳 true 无
codes Array 部门编码集合 true

请求示例

common/departments/v2/findByCodes?codes=D1,D010&bizId=7171d721-1d60-447c-930f-787eb64781ab&timestamp=1654499450621

返回参数

默认返参

字段名称 字段类型 字段描述
resCode Integer 状态码
resMsg String 描述
data.page_num Integer 当前页数
data.total_page Integer 总页数
data.page_size Integer 分页条数
data.total_count Integer 总条数
date.page_info Array 数据结果列表
data.page_info.parent.code String 父级公司/成本中心/部门编码
data.page_info.parent.department_name String 父级公司/成本中心/部门名称
data.page_info.code String 部门编号
data.page_info.department_name String 部门名称(支持多语言)
data.page_info.approval_level Integer 审批等级
data.page_info.cost_center_flag String 成本中心标志(Y/N)
data.page_info.enabled_flag String 是否启用标志(Y/N)
data.page_info.last_update_date Long 最后更新日期

可配置返参

字段名称 字段类型 字段描述
data.page_info.parent.* JSONObject 关联上级字段
data.page_info.owner_vo.* JSONObject 关联人员字段
data.page_info.sequence_num Integer 序号
data.page_info.approval_level Integer 审批级别
data.page_info.description String 描述
data.page_info.type String 类型
data.page_info.department_code String 部门编码
data.page_info.address String 地址
data.page_info.phone String 邮箱
data.page_info.email_address String 公司名
data.page_info.tax_number String 税号
data.page_info.tax_address String 税务地址
data.page_info.currency_code String 货币编码
data.page_info.receipt_currency String 票据币种
data.page_info.invoicing_limit_number decimal 单张开票限制额度(增值税电子专用发票)
data.page_info.invoicing_limit_number_common decimal 单张开票限制额度(增值税电子普通发票)
data.page_info.invoicing_limit_number_roll decimal 单张开票限制额度(增值税电子普通发票-卷式)
data.page_info.invoicing_payer String 销项开票收款人
data.page_info.invoicing_reviewer String 销项开票复核人
data.page_info.invoicing_issuer String 销项开票开票人
data.page_info.invoice_authentication_flag String 是否开启专票认证标识
data.page_info.invoice_output_flag String 是否开启销项开票标识
data.page_info.cost_center_flag String 成本中心标志
data.page_info.budget_flag String 预算标志
data.page_info.budget_control String 预算控制
data.page_info.ledger1 Integer 主帐套
data.page_info.ledger2 Integer 次帐套
data.natural_level Integer 自然层级
data.ex_rate_category String 汇率类型代码
data.page_info.column1-column10 String column字段对应的名称
data.page_info.creation_date Long 创建日期
data.page_info.last_update_date Long 最后更新日期

返回示例

{
  "resCode": 200000,
  "resMsg": "本次共查询到2个部门数据,",
  "bizId": "7171d721-1d60-447c-930f-787eb64781ab",
  "data": {
    "page_size": 100,
    "page_num": 1,
    "total_count": 2,
    "total_page": 1,
    "is_first_page": true,
    "is_last_page": true,
    "page_info": [
      {
        "code": "D1",
        "type": "B",
        "department_name": "Tiny ship",
        "department_code": "D1",
        "owner_id": 28849,
        "approval_level": 1,
        "cost_center_flag": "Y",
        "enabled_flag": "Y",
        "supervisor_id": 0,
        "owner_vo": {
          "code": "kevinchen718@hotmail.com",
          "full_name": "李四",
          "employee_number": "kevinchen718@hotmail.com",
          "user_name": "kevinchen718@hotmail.com"
        }
      },
      {
        "code": "D010",
        "type": "B",
        "parent_vo": {
          "code": "D1",
          "department_name": "Tiny ship",
          "department_code": "D1"
        },
        "department_name": "方外人事有限公司",
        "department_code": "D010",
        "owner_id": 211415,
        "approval_level": 2,
        "cost_center_flag": "Y",
        "enabled_flag": "Y",
        "supervisor_id": 14151,
        "owner_vo": {
          "code": "yhf@qq.com",
          "full_name": "杨红芳",
          "employee_number": "yhf@qq.com",
          "user_name": "yhf@qq.com"
        }
      }
    ]
  }
}

results matching ""

    No results matching ""