1. 接口列表

  • 说明:需要在header中传递Access-Key-Id和Open-Id, Access-Key-Id是发放的accessKeyId, Open-Id是主动获取的openid

1.1. 公共header说明

header key 是否必填 默认值 说明
Content-Type 固定值:application/json
X-Amz-Date 请求时间,格式:yyyyMMdd'T'HHmmss'Z'; TimeZone 为UTC; 使用sdk无需关注该参数
Authorization 接口签名结果,签名方式请查看【接口签名
Access-Key-Id 主动申请【获取密钥
Open-Id 主动获取【获取openid
Ignore-Warn false 用于忽略警告。新增或提交时等操作时会有警告导致接口失败,比如客户查重不通过、凭证余额出现赤字,Ignore-Warn=true时,会忽略相关警告,继续执行接口
Save-As-Draft false 如果为true,新增单据时保存为草稿态,否则自动提交

1.1.1. 对象标准接口

  • 请求body结构说明 ,字段列表见数据字典

    add接口 (beta)

  • 写入单个对象数据接口

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/add
  • 请求方式:POST
  • header参数
    • 见公共header
  • 参数说明:字段externalSystemCode/externalObjectType/externalObjectId 必填,externalObjectType+externalObjectId不能重复
  • 参数示例(字段注释请以数据字典显示为准)

    body:

 {
  "json":"{\n    \"objectType\":\"RevenueConfirmation\",\n    \"data\":{\n        \"billType.name\":\"收入确认单\",\n        \"businessType.name\":\"收入确认单立账\",\n        \"businessDate\":\"2020-01-01\",\n        \"customer.name\":\"李雷\",\n        \"invoiceType.name\":\"增值税专用发票\",\n        \"currency.name\":\"人民币\",\n        \"exchangeRate\":1,\n        \"settleCustomer.name\":\"李雷\",\n        \"revenueConfirmationItems\":[\n            {\n                \"project.name\":\"应收项目1\",\n                \"product.name\":\"B商品\",\n                \"quantity\":5,\n                \"price\":1000,\n                \"priceWithoutTax\":917.43,\n                \"taxRate\":0.09,\n                \"originAmount\":5000,\n                \"amount\":5000,\n                \"originAmountWithoutTax\":4587.16,\n                \"amountWithoutTax\":4587.16,\n                \"originTaxAmount\":412.84,\n                \"taxAmount\":412.84,\n                \"originPriceWithoutTax\":917.43,\n                \"unit.name\":\"箱\"\n            },\n            {\n                \"project.name\":\"应收项目1\",\n                \"product.name\":\"B商品\",\n                \"quantity\":5,\n                \"price\":1000,\n                \"priceWithoutTax\":917.43,\n                \"taxRate\":0.09,\n                \"originAmount\":5000,\n                \"amount\":5000,\n                \"originAmountWithoutTax\":4587.16,\n                \"amountWithoutTax\":4587.16,\n                \"originTaxAmount\":412.84,\n                \"taxAmount\":412.84,\n                \"originPriceWithoutTax\":917.43,\n                \"unit.name\":\"箱\"\n            }\n        ],\n        \"externalObjectId\":1582709110221112331,\n        \"externalObjectType\":\"RevenueConfirmation\",\n        \"externalSystemCode\":\"110212001\"\n    }\n}"
 }
// json的value值:
{
 "objectType": "RevenueConfirmation",            // 目标对象名称:收入确认单
 "data": {                                       // 数据项
   "billType.name": "收入确认单",                 // 单据类型    
   "businessType.name": "收入确认单立账",          // 业务类型
   "businessDate": "2020-01-01",                 // 业务日期
   "customer.name": "李雷",                       // 客户名称
   "invoiceType.name": "增值税专用发票",           // 发票类型
   "currency.name": "人民币",                     // 币种
   "exchangeRate": 1,                            // 汇率
   "settleCustomer.name": "李雷",                // 结算单位
   "revenueConfirmationItems": [                 // 收入确认单明细
     {                                        
     "project.name": "应收项目1",                  // 项目名称
     "product.name": "B商品",                      // 存货名称
     "quantity": 5,                               // 数量
     "price": 1000.000,                           // 单价
     "priceWithoutTax": 917.430,                  // 本币无税单价 
     "taxRate": 0.09,                             // 税率    
     "originAmount": 5000.000,                    // 金额
     "amount": 5000.000,                          // 金额    
     "originAmountWithoutTax": 4587.16,           // 原币无税金额    
     "amountWithoutTax": 4587.16,                 // 本币无税金额    
     "originTaxAmount": 412.84,                   // 原币税额    
     "taxAmount": 412.84,                         // 本币税额    
     "originPriceWithoutTax": 917.430,            // 原币无税单价    
     "unit.name": "箱"                            // 计量单位名称
     },
     {
       "project.name": "应收项目1",                // 项目名称          
       "product.name": "B商品",                    // 存货名称        
       "quantity": 5,                             // 数量
       "price": 1000.000,                         // 单价    
       "priceWithoutTax": 917.430,                // 本币无税单价              
       "taxRate": 0.09,                           // 税率      
       "originAmount": 5000.000,                  // 金额           
       "amount": 5000.000,                        // 金额         
       "originAmountWithoutTax": 4587.16,         // 原币无税金额                        
       "amountWithoutTax": 4587.16,               // 本币无税金额                  
       "originTaxAmount": 412.84,                 // 原币税额                
       "taxAmount": 412.84,                       // 本币税额          
       "originPriceWithoutTax": 917.430,          // 原币无税单价                       
       "unit.name": "箱"                          // 计量单位名称                   
     }
   ],
   "externalObjectId": 1582709110221112331,       // 外部系统对象唯一标识
   "externalObjectType": "RevenueConfirmation",   // 外部系统对象类型
   "externalSystemCode": "110212001"              // 外部系统标识
 }
}
  • 接口响应
{"json":"{\"id\":\"RMUEH160PG9000M\"}"}

list接口

  • 查询数据接口
  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/list
  • 请求方式:POST
  • header参数
    • 见公共header
  • 参数示例

    body:

{
  "json":"{\n    \"objectType\":\"Customer\",\n    \"criteriaStr\":\"id is not null\",\n    \"fields\":[\n        \"id\",\n        \"name\",\n        {\n            \"fieldName\":\"category\",\n            \"fields\":[\n                \"id\",\n                \"name\"\n            ]\n        },\n        {\n            \"fieldName\":\"contacts\",\n            \"fields\":[\n                \"id\",\n                \"name\"\n            ]\n        },\n        \"code\"\n    ]\n}"
}
// json的value值:
{
 "objectType": "Customer",                 // 目标对象
 "criteriaStr": "id is not null",          // 查询参数 查询字段支持lastModifiedTime(TimeStamp)
 "fields": [                               // 查询字段列表
   "id",                                   // 主对象字段
   "name",                                 // 主对象字段
   {
     "fieldName": "category",              // 外键字段 ps:如果字段有参照对照,如果字段名以id结尾,去掉id为fieldName,如果字段名不是以id结尾,字段名+Object为fieldName。此fieldName对应的字段为categoryId
     "fields": [                           // 外键字段对应对象字段列表
       "id",                               // 外键字段对应对象字段
       "name"                              // 外键字段对应对象字段

     ]
   },
   {
     "fieldName": "contacts",             // 外键字段对应对象子表
     "fields": [                           // 外键字段对应对象子表字段列表
       "id",                               // 外键字段对应对象子表字段
       "name"                              // 外键字段对应对象子表字段
     ]
     },
   "code"                                  // 主对象字段
 ]
}
  • 接口响应
{
  "json":"{\"data\":{\"list\":[{\"id\":\"XLWV090002\",\"name\":\"企企1\",\"category\":{\"id\":\"FDWV8X52C\",\"name\":\"内部商户\"},\"contacts\":[],\"code\":\"00001\"},{\"id\":\"5XSE4W000K\",\"name\":\"企企2\",\"category\":{\"id\":\"TKTEK001U\",\"name\":\"成都\"},\"contacts\":[],\"code\":\"00002\"}]},\"errors\":[]}"
}

update接口

  • 数据更新接口
  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/update
  • 请求方式:PUT
  • header参数
    • 见公共header
  • 参数示例

    body:

{
  "json":"{\n \"objectType\":\"Customer\", \n \"data\":{ \n \"id\":\"633GUN505MB0108\", \n \"categoryId\":\"89B1GN505UR0002\",\n \"code\":\"1002000001\",\n \"contacts\":[ \n {\n \"id\":\"A5UK0R50LNT0027\", \n \"mobile\":\"18988889997\",\n \"editFlag\":\"update\" \n },\n {\n \"isPrimary\":false,\n \"name\":\"张三\",\n \"mobile\":\"13565678898\",\n \"isCooperated\":false,\n \"editFlag\":\"add\"\n }\n ],\n \"addresses\":[\n {\n \"address\":\"\",\n \"isDefault\":true,\n \"id\":\"A5UK0R50LNT0026\",\n \"editFlag\":\"update\",\n \"countryId\":\"\",\n \"districtId\":\"\"\n }\n ]\n }\n}"
}
// json的value值
{
    "objectType":"Customer",             // 目标对象类型
    "data":{                             // 目标对象数据
        "id":"633GUN505MB0108",          // 目标对象id:必需指定
        "categoryId":"89B1GN505UR0002",
        "code":"1002000001",
        "contacts":[                    // 子对象
            {
                "id":"A5UK0R50LNT0027", // 子对象id:如果是更新,则必需指定
                "mobile":"18988889997",
                "editFlag":"update"      // 子对象操作标记:update->更新(需指定子对象id) add->新增 delete->删除, 默认为add
            },
            {
                "isPrimary":false,
                "name":"12",
                "mobile":"13565678898",
                "isCooperated":false,
                "editFlag":"add"
            }
        ],
        "addresses":[
            {
                "address":"",
                "isDefault":true,
                "id":"A5UK0R50LNT0026",
                "editFlag":"update",
                "countryId":"",
                "districtId":""
            }
        ]
    }
}
  • 接口响应
{"json":"{\"success\":true}"}

审批中修改接口

  • 数据更新接口
  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/approvingUpdate
  • 请求方式:PUT
  • 参数:和上面/update接口完全一致

delete接口

  • 数据删除接口
  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/delete
  • 请求方式:POST
  • header参数
    • 见公共header
  • 参数示例

    body:

{
   "json":"{\n    \"objectType\":\"Customer\",\n    \"objectId\":\"SDFASFF00010999\"\n}"
}
//json的value值:
{
  "objectType": "Customer",       // 目标对象类型
  "objectId": "SDFASFF00010999"   // 目标数据id
}
  • 接口响应
{"json":"{\"success\":true}"}

addAutoSubmit接口 (beta)

  • 写入单个对象数据接口,自动提交
  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/addAutoSubmit
  • 说明:参数及响应和add接口保持一致,新增后自动提交,提交任务结束后接口返回,提交失败自动删除单据,单据可能删除失败

1.1.2. 根据code获取openid接口

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/code
  • 请求方式:GET
  • header参数
    • 见公共header
    • Open-Id 不用填
  • 请求参数
    • code:确认授权后收到的code
  • 接口响应
    • url:文件URL
{"openid":"openid128kjsiiyysdlq7"}

1.1.3. 企业信息接口

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/tenant
  • 请求方式:GET
  • header参数
    • 见公共header
  • 接口响应
  {
    "id": "1",
    "name": "北京企企科技有限公司",
    "error": ""
  }

1.1.4. 用户信息接口

  • 接口描述:获取授权用户信息
  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/user
  • 请求方式:GET
  • header参数
    • 见公共header
  • 接口响应
{
   "id":"J32NV555ETN0023",
   "name":"王小二",
   "mobile":"13900000000",
   "email":"",
   "tenantName":"北京企企科技有限公司",
   "gender":""
}

1.1.5. 异步弃审接口

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/withdraw
  • 请求方式:POST
  • header参数
    • 见公共header
  • 请求参数
    • objectType:弃审的目标对象
    • objectId:弃审的目标id
    • reason:弃审原因
  {
    "objectType":"RevenueConfirmation",
    "objectId":"0BX0JM5015D0001",
    "reason":"弃审原因"
  }
  • 接口响应
    • runningIds:执行中的id列表
    • requestId:请求id,使用此参数查询异步任务执行状态
    • failIds:执行失败的id及对应失败信息
 {
   "json":"{\"runningIds\":[\"LQ2AK161U2H002S\"],\"successIds\":[],\"failIds\":{},\"warningIds\":{},\"userTaskActionValue\":\"manualWithdraw\",\"objectType\":\"RevenueConfirmation\",\"failedCount\":0,\"runningCount\":1,\"successCount\":0,\"warningCount\":0,\"totalCount\":1,\"taskId\":\"W9CAK161U2H002F\",\"isCompleted\":false,\"requestId\":\"time-df78f9c4-267e-4cbe-abcd-8ae2c796bbfb\"}"
 }
{
   "runningIds":[
     "LQ2AK161U2H002S"
  ],
  "successIds":[

  ],
  "failIds":{

  },
  "warningIds":{

  },
   "userTaskActionValue":"manualWithdraw",
  "objectType":"RevenueConfirmation",
  "failedCount":0,
  "runningCount":1,
  "successCount":0,
  "warningCount":0,
  "totalCount":1,
  "taskId":"W9CAK161U2H002F",
  "isCompleted":false,
  "requestId":"time-df78f9c4-267e-4cbe-abcd-8ae2c796bbfb"
}

1.1.6. 异步任务状态查询接口

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/asynctask
  • 请求方式:POST
  • header参数
    • 见公共header
  • 请求参数

    • requestId:异步接口响应的requestId

    body:

 {
  "requestId":"time-5969aedb-e32a-4913-8da8-5a4d7ac3ad1b"
}
  • 接口响应

    • isCompleted:是否完成
    • asyncTaskItems:异步任务项
    • asyncTaskItemStatusObject:异步任务项状态
    • lastErrorMsg:错误消息
 {
   "requestId":"",
   "isCompleted":true,
   "asyncTaskItems":[
     {
       "id":"W9CAK161U2H002K",
       "billStatusObject":{
         "id":"BillStatus.effective",
         "title":"已生效"
       },
       "objectType":"RevenueConfirmation",
       "objectId":"LQ2AK161U2H002S",
       "asyncTaskItemStatus":"AsyncTaskItemStatus.succeeded",
       "asyncTaskItemStatusObject":{
         "id":"AsyncTaskItemStatus.succeeded",
         "title":"成功"
       },
       "lastErrorMsg":"null",
       "isRead":false
     }
   ]
 }

1.1.7. 红冲接口

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/toredbill
  • 请求方式:POST
  • header参数
    • 见公共header
  • 请求参数
    • objectType:目标对象
    • objectId:目标id
  {
    "objectType":"RevenueConfirmation",
    "objectId":"0BX0JM5015D0001"
  }
  • 接口响应
    • id:生成单id
    • error:错误信息
  {
      "id": "PCL9KQ50LNT0001",
      "error": ""
  }

1.1.8. 获取队列信息接口

  • 接口host:https://api2.77hub.com
    • 接口路径:/v1/queue
    • 请求方式:GET
    • header参数
      • 见公共header
    • 接口响应
      • queueUrl:队列url
      • queueHost:队列host
      • queuePath:队列path
      • error:错误信息
     {
         "queueUrl": "https://sqs.cn-north-1.amazonaws.com.cn/878775433445/Q7512J0010",
         "queueHost": "https://sqs.cn-north-1.amazonaws.com.cn",
         "queuePath": "/878775433445/Q7512J0010",
         "error":""
     }

1.1.9. 同步任务接口

  • 接口host:https://api2.77hub.com

  • 接口路径:/v1/batchDo

  • 请求方式:POST

  • header参数

    • 见公共header
  • 请求参数

    • objectType:目标对象
    • objectId:目标id
    • action:执行动作,目前支持的动作:
      动作 描述
      manualSubmit提交
      manualRestart撤回
      manualWithdraw弃审
      userAgree同意
  {
    "objectType":"Receipt",
    "objectId":"J81N8S512DM000E",
    "action":"manualSubmit",
    "reason":"原因"
  }
  • 接口响应
    • successIds:执行成功的id
    • failIds:执行失败的id及对应失败信息
   {
      "json":"{\"successIds\":[],\"failIds\":{\"9GN9K161U2H001W\":{\"type\":\"error\",\"code\":\"0000\",\"message\":\"只有待提交,已退回的单据可以提交\"}},\"warningIds\":{}}"
   }

1.1.10. 异步任务接口

  • 接口host:https://api2.77hub.com

  • 接口路径:/v1/asyncBatchDo

  • 请求方式:POST

  • header参数

    • 见公共header
  • 请求参数

    • objectType:目标对象
    • objectId:目标id
    • action:执行动作,目前支持的动作:
      动作 描述
      manualSubmit提交
      manualRestart撤回
      manualWithdraw弃审
      userAgree同意
  {
     "objectType":"Receipt",
    "objectId":"J81N8S512DM000E",
    "action":"manualSubmit",
    "reason":"原因"
  }
  • 接口响应
    • runningIds:执行中的id列表
    • requestId:请求id,使用此参数查询异步任务执行状态
    • failIds:执行失败的id及对应失败信息
{
  "json":"{\"runningIds\":[\"H5WXH161U2H000H\"],\"successIds\":[],\"failIds\":{},\"warningIds\":{},\"userTaskActionValue\":\"manualWithdraw\",\"objectType\":\"RevenueConfirmation\",\"failedCount\":0,\"runningCount\":1,\"successCount\":0,\"warningCount\":0,\"totalCount\":1,\"taskId\":\"H5WXH161U2H0024\",\"isCompleted\":false,\"requestId\":\"time-50ca75b8-feb1-4fba-9bc3-f6008e322517\"}"
}

1.1.11. 文件签名接口

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/attachment/signature/signedurl
  • 请求方式:GET
  • header参数
    • 见公共header
  • 请求参数
    • key:目标文件key,必填
    • isHttp:true返回http协议URL,否则返回https协议URL,默认false
    • expiresIn:URL过期时间,单位秒,默认7天
  • 接口响应
    • url:文件URL
   {"url":"https://www.77hub.com/"}

1.1.12. 文件批量签名接口

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/attachment/signature/batchSignedUrl
  • 请求方式:POST
  • header参数
    • 见公共header
  • 请求参数
    • keys:目标文件key,必填
    • isHttp:true返回http协议URL,否则返回https协议URL,默认false
    • expiresIn:URL过期时间,单位秒,默认7天
{
  "json": "{\"keys\":[\"1\",\"2\"],\"isHttp\":false,\"expiresIn\":3600}"
}
  • 接口响应
    • key为文件key,value为下载url
{
  "json": "{\"1\":\"https://openapi.77hub.com/1\",\"2\":\"https://openapi.77hub.com/2\"}"
}

1.1.13. 查询执行进度

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/usertask
  • 请求方式:POST
  • header参数
    • 见公共header
  • 请求参数

    • objectId:单据对象id

    body:

    {"objectId":"UGG9K161U2H000J"}
    
    • 接口响应

    • 待审批

    [
     {
       "taskName": "财务经理审批", // 任务名称
       "description": "",       // 审批意见
       "actionDate": 0,         // 执行时间
       "action": "待审批",       // 当前动作
       "userNames": "张三,王世强",    // 用户
       "isActed": false         // 是否已执行
     },
     {
       "taskName": "设置已提交",
       "description": "",
       "actionDate": 1631520004004,
       "action": "提交",
       "userNames": "王世强",
       "isActed": true
     }
    ]
    
    • 已生效
    [
     {
         "taskName": "设置已生效",
         "description": "",
         "actionDate": 1631517743882,
         "action": "生效",
         "userNames": "王世强",
         "isActed": true
     },
     {
         "taskName": "财务经理审批",
         "description": "这是同意意见",
         "actionDate": 1631517740929,
         "action": "同意",
         "userNames": "王世强",
         "isActed": true
     },
     {
         "taskName": "设置已提交",
         "description": "",
         "actionDate": 1631517712289,
         "action": "提交",
         "userNames": "王世强",
         "isActed": true
     }
    ]
    

1.1.14. 查询报表

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/reportdefinition
  • 请求方式:POST
  • header参数
    • 见公共header
  • 请求参数

    • params:json字符串(将json对象转义)
      {
        "params": "{\"id\":\"F5M8PQ50FKF0002\",\"outputType\":\"json\",\"queryObject\":{\"criteria\":{\"operator\":\"and\",\"values\":[{\"operator\":\"in\",\"values\":[\"K4WUXS50JUD0011\"],\"fieldName\":\"ownerExpenceOrg\",\"properties\":{\"isDefaultQueryTreeRootOnly\":false,\"isIncludeChildren\":false,\"isOrganizationRole\":true,\"orgRoleTypeIds\":[\"FinancialOrg\"]}},{\"operator\":\"between\",\"values\":[1609430400000,1640966399999],\"fieldName\":\"reimburseReportView.businessDate\",\"type\":\"Timestamp\"},{\"operator\":\"eq\",\"values\":[\"NUE2UQ50FKF0001\"],\"fieldName\":\"cost\"}]}}}"
      }
    
      {// params结构详情
          "id":"F5M8PQ50FKF0002", // 方案id
          "outputType":"json", // 输出类型为json, 支持的类型:json/excel/pdf
          "queryObject":{
              "criteria":{  // 查询条件
                  "operator":"and", // 多条件间关系
                  "values":[
                      { // 此条件解释为:ownerExpenceOrg in ('K4WUXS50JUD0011')
                          "operator":"in", // 支持in、eq(=)、like、gt(>)、ge(>=)等
                          "values":[
                              "K4WUXS50JUD0011"
                          ],
                          "fieldName":"ownerExpenceOrg",
                          "properties":{
                              "isDefaultQueryTreeRootOnly":false,
                              "isIncludeChildren":false,
                              "isOrganizationRole":true,
                              "orgRoleTypeIds":[
                                  "FinancialOrg"
                              ]
                          }
                      },
                      { // 此条件解释为:reimburseReportView.businessDate between 1609430400000 and 1640966399999
                          "operator":"between",
                          "values":[
                              1609430400000,
                              1640966399999
                          ],
                          "fieldName":"reimburseReportView.businessDate",
                          "type":"Timestamp"
                      },
                      { // 此条件解释为:cost = 'NUE2UQ50FKF0001'
                          "operator":"eq",
                          "values":[
                              "NUE2UQ50FKF0001"
                          ],
                          "fieldName":"cost"
                     }
                  ]
              }
          }
      }
    
  • 接口响应

    • data:json数据
    • error:错误信息
    • 示例(outputType=json)
    {
      "params": "{\"id\":\"F5M8PQ50FKF0002\",\"outputType\":\"json\",\"queryObject\":{\"criteria\":{\"operator\":\"and\",\"values\":[{\"operator\":\"in\",\"values\":[\"K4WUXS50JUD0011\"],\"fieldName\":\"ownerExpenceOrg\",\"properties\":{\"isDefaultQueryTreeRootOnly\":false,\"isIncludeChildren\":false,\"isOrganizationRole\":true,\"orgRoleTypeIds\":[\"FinancialOrg\"]}},{\"operator\":\"between\",\"values\":[1609430400000,1640966399999],\"fieldName\":\"reimburseReportView.businessDate\",\"type\":\"Timestamp\"},{\"operator\":\"eq\",\"values\":[\"NUE2UQ50FKF0001\"],\"fieldName\":\"cost\"}]}}}"
    }
    {// params结构详情
        "id":"F5M8PQ50FKF0002", // 方案id
        "outputType":"json", // 输出类型为json, 支持的类型:json/excel/pdf
        "queryObject":{
            "criteria":{  // 查询条件
                "operator":"and", // 多条件间关系
                "values":[
                    { // 此条件解释为:ownerExpenceOrg in ('K4WUXS50JUD0011')
                        "operator":"in", // 支持in、eq(=)、like、gt(>)、ge(>=)等
                        "values":[
                            "K4WUXS50JUD0011"
                        ],
                        "fieldName":"ownerExpenceOrg",
                        "properties":{
                            "isDefaultQueryTreeRootOnly":false,
                            "isIncludeChildren":false,
                            "isOrganizationRole":true,
                            "orgRoleTypeIds":[
                                "FinancialOrg"
                            ]
                        }
                    },
                    { // 此条件解释为:reimburseReportView.businessDate between 1609430400000 and 1640966399999
                        "operator":"between",
                        "values":[
                            1609430400000,
                            1640966399999
                        ],
                        "fieldName":"reimburseReportView.businessDate",
                        "type":"Timestamp"
                    },
                    { // 此条件解释为:cost = 'NUE2UQ50FKF0001'
                        "operator":"eq",
                        "values":[
                            "NUE2UQ50FKF0001"
                        ],
                        "fieldName":"cost"
                   }
                ]
            }
        }
    }
  • 接口响应

    • data:json数据
    • error:错误信息
    • 示例(outputType=json)

    错误返回结果:

    {
    "error": "{\"type\":\"error\",\"code\":\"0008\",\"message\":\"对象没有找到\",\"description\":\"report definition not found for id: F5M8PQ50FKF0002\"}"
    }
    

    正确返回结果:

      {
    "data": "{    \"data\":{        \"title\":\"用户权益分配\",        \"pageSettings\":{            \"titleFontSize\":16,            \"titleAlign\":\"center\",            \"fontSize\":10,            \"subTitleFontSize\":12,            \"subTitleAlign\":\"center\",            \"minFontSize\":4,            \"maxFontSize\":32,            \"entLogoHeight\":22.677166,            \"pageHeaderFontSize\":8,            \"isPreview\":false,            \"starPageNum\":1,            \"pageRotate\":false,            \"pageMargins\":[                30,                30,                30,                30            ],            \"cellPaddings\":[                2,                2,                0,                2            ],            \"adjustMinColumnSize\":30,            \"isFillBlankRow\":false,            \"isPageSubtotal\":false,            \"isPageTotal\":false        },        \"corners\":[          ],        \"rows\":[           ],        \"cols\":[              [                {                    \"startRowIndex\":0,                    \"startColIndex\":12,                    \"rowIndex\":0,                    \"colIndex\":12,                    \"rowSpan\":1,                    \"colSpan\":1,                    \"displayValue\":\"角色\",                    \"cellType\":\"colTitle\",                    \"aliasField\":\"roleName_TenantRightsAssignmentView\",                    \"aliasName\":\"roleName_TenantRightsAssignmentView\"                }            ]        ],        \"datas\":[              [                \"查询服务\",                \"\",                \"模组授权\",                \"12.00\",                \"50.00\",                \"张三\",                \"用户授权\",                \"YG009\",                \"在职\",                \"测试四部\",                \"18000595971\",                \"\",                \"系统用户\",                \"UserStatus.incumbent\"            ]        ],        \"metas\":{        },        \"totalRows\":[        ],        \"dimSubTotalRows\":{        },        \"styleIdMap\":{        },        \"rowCondStyleIds\":{        },        \"totalCols\":[        ],        \"dimSubTotalCols\":{        },        \"rowTotalDimInfo\":{        },        \"columns\":[               {                 \"width\":100,                        \"alignment\":\"left\",                   \"type\":\"String\"                }        ],        \"layout\":[              \"moduleGroupId_TenantRightsAssignmentView\",            \"moduleGroupAppId_TenantRightsAssignmentView\",            \"authType_TenantRightsAssignmentView\",            \"usedQty_TenantRightsAssignmentView\",            \"acquiredQty_TenantRightsAssignmentView\",            \"userName_TenantRightsAssignmentView\",            \"grantType_TenantRightsAssignmentView\",            \"userCode_TenantRightsAssignmentView\",            \"userStatusTitle_TenantRightsAssignmentView\",            \"userDepartmentName_TenantRightsAssignmentView\",            \"userMobile_TenantRightsAssignmentView\",            \"userEmail_TenantRightsAssignmentView\",            \"roleName_TenantRightsAssignmentView\"        ],        \"dataIndexes\":{              \"moduleGroupId_TenantRightsAssignmentView\":0,            \"moduleGroupAppId_TenantRightsAssignmentView\":1,            \"authType_TenantRightsAssignmentView\":2,            \"usedQty_TenantRightsAssignmentView\":3,            \"acquiredQty_TenantRightsAssignmentView\":4,            \"userName_TenantRightsAssignmentView\":5,            \"grantType_TenantRightsAssignmentView\":6,            \"userCode_TenantRightsAssignmentView\":7,            \"userStatusTitle_TenantRightsAssignmentView\":8,            \"userDepartmentName_TenantRightsAssignmentView\":9,            \"userMobile_TenantRightsAssignmentView\":10,            \"userEmail_TenantRightsAssignmentView\":11,            \"roleName_TenantRightsAssignmentView\":12,            \"userStatus\":13        },        \"extDatas\":[        ],        \"extDataIndexes\":{        }    },    \"reportMessages\":{    }}"
    }
    
    {
    // data下结构详情
    "data":{
      "title":"用户权益分配",
      "pageSettings":{
        "titleFontSize":16,
        "titleAlign":"center",
        "fontSize":10,
        "subTitleFontSize":12,
        "subTitleAlign":"center",
        "minFontSize":4,
        "maxFontSize":32,
        "entLogoHeight":22.677166,
        "pageHeaderFontSize":8,
        "isPreview":false,
        "starPageNum":1,
        "pageRotate":false,
        "pageMargins":[
          30,
          30,
          30,
          30
        ],
        "cellPaddings":[
          2,
          2,
          0,
          2
        ],
        "adjustMinColumnSize":30,
        "isFillBlankRow":false,
        "isPageSubtotal":false,
        "isPageTotal":false
      },
      "corners":[ // Corner区域数据,同cols
    
      ],
      "rows":[ // // 列维度区域数据,同cols
    
      ],
      "cols":[ //  列维度区域数据,二维数组,表示有m行n列的列维度数据
        [
          "查询服务",
          "",
          "模组授权",
          "12.00",
          "50.00",
          "周小七",
          "用户授权",
          "1111110004",
          "",
          "总部",
          "15386620539",
          "",
          "系统用户",
          ""
        ]
      ],
      "metas":{
    
      },
      "totalRows":[ // 合计行索引
    
      ],
      "dimSubTotalRows":{
    
      },
      "styleIdMap":{
    
      },
      "rowCondStyleIds":{
    
      },
      "totalCols":[ // 合计列索引
    
      ],
      "dimSubTotalCols":{
    
      },
      "rowTotalDimInfo":{
    
      },
      "columns":[. // 所有列的布局信息(包括行维度列)
        {
          "width":100,        // 列宽
          "alignment":"left", // 对其方式
          "type":"String".    // 值类型
        }
      ],
      "layout":[
        "moduleGroupId_TenantRightsAssignmentView",
        "moduleGroupAppId_TenantRightsAssignmentView",
        "authType_TenantRightsAssignmentView",
        "usedQty_TenantRightsAssignmentView",
        "acquiredQty_TenantRightsAssignmentView",
        "userName_TenantRightsAssignmentView",
        "grantType_TenantRightsAssignmentView",
        "userCode_TenantRightsAssignmentView",
        "userStatusTitle_TenantRightsAssignmentView",
        "userDepartmentName_TenantRightsAssignmentView",
        "userMobile_TenantRightsAssignmentView",
        "userEmail_TenantRightsAssignmentView",
        "roleName_TenantRightsAssignmentView"
      ],
      "dataIndexes":{. // 值为对应的值在datas中的索引
        "moduleGroupId_TenantRightsAssignmentView":0,
        "moduleGroupAppId_TenantRightsAssignmentView":1,
        "authType_TenantRightsAssignmentView":2,
        "usedQty_TenantRightsAssignmentView":3,
        "acquiredQty_TenantRightsAssignmentView":4,
        "userName_TenantRightsAssignmentView":5,
        "grantType_TenantRightsAssignmentView":6,
        "userCode_TenantRightsAssignmentView":7,
        "userStatusTitle_TenantRightsAssignmentView":8,
        "userDepartmentName_TenantRightsAssignmentView":9,
        "userMobile_TenantRightsAssignmentView":10,
        "userEmail_TenantRightsAssignmentView":11,
        "roleName_TenantRightsAssignmentView":12,
        "userStatus":13
      },
      "extDatas":[
    
      ],
      "extDataIndexes":{
    
      }
    },
    "reportMessages":{
    
    }
    }
    
    • 示例(outputType=excel)
    {
      "data": "\"https://openapi.77hub.com/static/images/logo_color.svg\"",
      "error": ""
    }
    
    • 示例(outputType=pdf)
    {
      "data": "\"https://openapi.77hub.com/static/images/logo_color.svg\"",
      "error": ""
    }
    

1.1.15. 项目变更

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/changeproject
  • 请求方式:PUT
  • header参数
    • 见公共header
  • 请求参数
    • json:json字符串(将json对象转义)
     {"json": "{\"data\":{\"id\":\"F5M8PQ50FKF0002\", \"description\": \"修改描述\"}}"}
     { // json结构
       "data": { // 项目对象
         "id": "F5M8PQ50FKF0002", // 项目id
         "description": "修改描述" // 变更的项目字段
       }
     }
  • 接口响应
    • data:json数据
    • error:错误信息
      {
        "json": "{\"success\":true}",
        "error": ""
      }

1.1.16. 工作日类型

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/workcalendar/querydatetype
  • 请求方式:GET
  • header参数
    • 见公共header
  • 请求参数

    • workCalendarId:String 工作日历id 非必填
    • date:Timestamp 查询的工作日日期 必填
  • 接口响应

    • workDayType:String 工作日类型
     { 
       "workDayType": "xxx"
     }

1.1.17. 部门分配

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/department/momanualassign
  • 请求方式:POST
  • header参数
    • 见公共header
  • 请求参数
    {
      "operateOrgId": "",// 发起分配的组织id,必填
      "assignInfo": {
        "objectId": "",// 待分配对象id
        "usedOrgId": ""// 目标组织id,必填
      }
    }
  • 接口响应
   {
     "error": "", // 错误信息
     "successIds": "" // 成功的id
   }

1.1.18. 出纳确认

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/receipt/cashierconfirm
  • 请求方式:POST
  • header参数
    • 见公共header
  • 请求参数

    在一次请求中receiptId或paymentId不能同时指定

    {
      "receiptId": "", // 收款单id
      "paymentId": "" // 付款单id
    }
  • 接口响应
   {
     "successIds": [""], // 成功的id
     "failIds": "{\"1\":\"没有该记录\"}", // 失败的id及对应错误信息
     "error": "" // 其他错误信息
   }

1.1.19. 取消出纳确认

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/receipt/cancelconfirm
  • 请求方式:POST
  • header参数
    • 见公共header
  • 请求参数

    {
      "objectType": "", // 对象类型
      "objectId": "" // 对象id
    }
    
  • 接口响应

   {
     "successIds": [""], // 成功的id
     "failIds": "{\"1\":\"没有该记录\"}", // 失败的id及对应错误信息
     "error": "" // 其他错误信息
   }

1.1.20. 项目阶段执行开始

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/project/startStage
  • 请求方式:POST
  • header参数
    • 见公共header
  • 请求参数
    {
      "id": "1",                // String,项目阶段id
      "projectId": "1",         // String,项目id
      "date": "1672898824632",  // Timestamp,开始日期,如果为空,则表示取消开始
      "usedOrgId": "1"          // String,项目的使用组织
    }
  • 接口响应
   {
     "error": "" // 错误信息
   }

1.1.21. 项目阶段执行完成

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/project/finishStage
  • 请求方式:POST
  • header参数
    • 见公共header
  • 请求参数
    {
      "id": "1",                // String,项目阶段id
      "projectId": "1",         // String,项目id
      "date": "1672898824632",  // Timestamp,完成日期,如果为空,则表示取消完成
      "usedOrgId": "1"          // String,项目的使用组织
    }
  • 接口响应
   {
     "error": "" // 错误信息
   }

1.1.22. 打印预览

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/printPreview
  • 请求方式:POST
  • header参数
    • 见公共header
  • 请求参数

    {
      "objectType": "ReimburseApply", // 对象类型
      "objectId": "U4DT9361UKQ001E",  // 对象id
      "templateId": "5hs1@zEZR"       // 打印模板id
    }
    
  • 接口响应

    {
     "url": "",  // pdf文件地址,有效期24小时
     "error": "" // 错误信息
    }
    

1.1.23. 库存可用量、现存量

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/inventoryAvailQty
  • 请求方式:POST
  • header参数
    • 见公共header
  • 请求参数

    {"json":"{\n  \"productIds\": [\n    \"LA5NF261UKQ00DD\",\n    \"1\"\n  ],\n  \"warehouseIds\": [\n    \"A3CL4461URL002A\",\n    \"2\"\n  ],\n  \"batchNos\": [\n    \"1\",\n    \"2\"\n  ],\n  \"orgId\": \"\",\n  \"atpDate\": 1686649339283\n}"}
    

    json的value

    {
      "productIds": [ // 存货id列表
        "LA5NF261UKQ00DD",
        "1"
      ],
      "warehouseIds": [ // 仓库id列表
        "A3CL4461URL002A",
        "2"
      ],
      "atpDate": 1686649339283, // 供需日期,非必填,0时区毫秒时间戳,默认值为当前时间
      "orgId": "", // 多组织企业必填
      "batchNos": [ // 批次号,非必填
        "1",
        "2"
      ]
    }
    
  • 接口响应

    {
     "json": "[\n      {\n        \"onHandBaseQty\": 0,\n        \"onHandAuxQty\": 0,\n        \"availAuxQty\": 0,\n        \"availBaseQty\": 10,\n        \"invCtrlObject\": {\n          \"id\": \"WNCR6461URL001E\",\n          \"inventoryOrg\": {\n            \"id\": \"K4WUXS50JUD0011\",\n            \"name\": \"总账/资产集群1-多组织\"\n          },\n          \"product\": {\n            \"code\": \"0000000038-010100-0001\",\n            \"id\": \"LA5NF261UKQ00DD\",\n            \"name\": \"冰箱12\",\n            \"spec\": \"台\"\n          },\n          \"warehouse\": {\n            \"id\": \"A3CL4461URL002A\",\n            \"name\": \"成都仓库\"\n          }\n        },\n        \"invCtrlObjectId\": \"WNCR6461URL001E\"\n      }\n    ]"
    }
    

    json的value

    [
      {
        "onHandBaseQty": 0, // 主单位现存量
        "onHandAuxQty": 0, // 辅单位现存量
        "availBaseQty": 10, //主单位可用量
        "availAuxQty": 0, //辅单位可用量
        "invCtrlObject": {
          "id": "WNCR6461URL001E",
          "inventoryOrg": { // 组织信息
            "id": "K4WUXS50JUD0011",
            "name": "总账/资产集群1-多组织"
          },
          "product": { // 存货
            "code": "0000000038-010100-0001",
            "id": "LA5NF261UKQ00DD",
            "name": "冰箱12",
            "spec": "台"
          },
          "warehouse": { // 仓库
            "id": "A3CL4461URL002A",
            "name": "成都仓库"
          }
        },
        "invCtrlObjectId": "WNCR6461URL001E"
      }
    ]
    

1.1.24. 人员调动

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/user/transfer
  • 请求方式:POST
  • header参数
    • 见公共header
  • 请求参数

    {"json": "{\n    \"userId\": \"03LGK261UKQ00EP\",\n    \"autoFinishJobRelationship\": true,\n    \"transferInOrgId\": \"FJVC7X50C09000A\",\n    \"transferInDeptId\": \"VNMMF461UWT00BC\",\n    \"jobStartTime\": 1690387200000,\n    \"type\": \"create\"\n}\n"}
    

    json的value

    {
        "userId": "03LGK261UKQ00EP",
        "autoFinishJobRelationship": true,
        "transferInOrgId": "FJVC7X50C09000A",
        "transferInDeptId": "VNMMF461UWT00BC",
        "jobStartTime": 1690387200000,
        "type": "create"
    }
    
参数 名称 类型 说明
userId 人员 String 必填
transferInOrgId 调入组织 String 必填
transferInDeptId 调入部门 String 必填
jobStartTime 调入任职开始时间 Timestamp 必填
jobEndTime 调入任职结束时间 Timestamp 非必填
autoFinishJobRelationship 调入任职记录是否自动结束 Boolean 非必填
type create 其他传此值
update 选择是传此值,不检测人员是否已兼职过
String 必填
supervisorId 上级主管 String 非必填
rankId 职级 String 非必填
positionId 岗位 String 非必填

1.1.25. 查询联行号

  • 接口host:https://api2.77hub.com
  • 接口路径:/v1/bank/query
  • 请求方式:POST
  • header参数
    • 见公共header
  • 请求参数

    {"json": "{\n    \"name\":\"工行\",\n    \"pageNo\":1,\n    \"pageSize\":10}"}
    

    json的value

    {
      "name": "工行", // 必填;支持联行号、支行名称、银行名称、银行代码
      "pageNo": 1, //必填 
      "pageSize": 10 //必填
    }
    
  • 返回结果

    {"json":"[{\"id\":\"103100005098\",\"code\":\"103100005098\",\"name\":\"中国农业银行股份有限公司北京中关村支行\",\"epayBankCode\":\"ABC\",\"epayBankId\":\"RA344T50J040024\",\"bankId\":\"JTP2XT50JB30004\"},{\"id\":\"104100004064\",\"code\":\"104100004064\",\"name\":\"中国银行股份有限公司北京中关村北大街支行\",\"epayBankCode\":\"BOC\",\"epayBankId\":\"RA344T50J040025\",\"bankId\":\"JTP2XT50JB30003\"},{\"id\":\"104100005660\",\"code\":\"104100005660\",\"name\":\"中国银行股份有限公司北京中关村科技园区支行\",\"epayBankCode\":\"BOC\",\"epayBankId\":\"RA344T50J040025\",\"bankId\":\"JTP2XT50JB30003\"},{\"id\":\"104100006652\",\"code\":\"104100006652\",\"name\":\"中国银行股份有限公司北京中关村支行\",\"epayBankCode\":\"BOC\",\"epayBankId\":\"RA344T50J040025\",\"bankId\":\"JTP2XT50JB30003\"},{\"id\":\"104304383348\",\"code\":\"104304383348\",\"name\":\"中国银行股份有限公司溧阳中关村支行\",\"epayBankCode\":\"BOC\",\"epayBankId\":\"RA344T50J040025\",\"bankId\":\"JTP2XT50JB30003\"},{\"id\":\"303100000135\",\"code\":\"303100000135\",\"name\":\"中国光大银行股份有限公司北京中关村支行\",\"epayBankCode\":\"CEB\",\"epayBankId\":\"RA344T50J040050\",\"bankId\":\"JTP2XT50JB30009\"},{\"id\":\"305100001057\",\"code\":\"305100001057\",\"name\":\"中国民生银行股份有限公司北京中关村支行\",\"epayBankCode\":\"CMBC\",\"epayBankId\":\"RA344T50J040019\",\"bankId\":\"JTP2XT50JB30010\"},{\"id\":\"310100000052\",\"code\":\"310100000052\",\"name\":\"上海浦东发展银行北京中关村支行\",\"epayBankCode\":\"SPDB\",\"epayBankId\":\"RA344T50J040037\",\"bankId\":\"JTP2XT50JB30013\"},{\"id\":\"313100016035\",\"code\":\"313100016035\",\"name\":\"盛京银行股份有限公司北京中关村支行\",\"epayBankCode\":\"SJB\",\"epayBankId\":\"RA344T50J040115\",\"bankId\":\"JTP2XT50JB30069\"},{\"id\":\"597100000055\",\"code\":\"597100000055\",\"name\":\"韩亚银行(中国)有限公司北京中关村支行\",\"epayBankCode\":\"QTCB\",\"epayBankId\":\"RA344T50J040022\",\"bankId\":\"JTP2XT50JB30112\"}]"}
    

    json的value

    [
    {
      "id": "304100040091", // 企企中的数据id
      "code": "304100040091", // 联行号
      "name": "华夏银行北京中关村支行", // 支行名称
      "epayBankCode": "HB" // 银行代码
    },
    {
      "id": "313100000193",
      "code": "313100000193",
      "name": "北京银行中关村广场支行",
      "epayBankCode": "BCCB"
    }
    ]
    

results matching ""

    No results matching ""