4.1 创建交易订单

简要描述：‌

企业根据自己的付款需求，提交批量交易单。
平台会根据企业签订的合同费率、人员当月交易数据，计算每笔明细的服务费、经营服务费税后、经营服务费税前等费用数据，企业可以根据服务费计算结果确认是否要继续支付。

注意事项：‌

该接口批量提交明细上限为500笔，订单提交处理为异步处理。
系统只允许同时有1个批次单进行处理，如果当前需要处理第2个批次案，请确保前一个批次单已经处理完成(或者取消)。

请求头参数：

Authorization: Bearer [accessToken]

请求URL：‌

/orders/batch/add

请求方式：‌

POST

参数：‌

请求参数说明

参数	类型	是否必须	说明
providerId	string	否	服务商ID,当有多个服务商时，必填。
projectId	string	否	项目Id,当接口指定项目时，会将订单关联指定项目，当没有指定时，系统默认关联最新的有效项目。强烈建议调用方自己指定项目，因为项目决定订单的开票品目。
notifyUrl	string	否	接收该订单处理结果的后端回调url。当该url没有传值时，系统会使用后台开发者配置中的回调链接。注意:该url必须为可以直接访问的http链接,例如:https://www.baidu.com
batchNo	string	是	批次号（调用方系统对该交易订单的唯一标识，每个批次订单必须唯一）。
paymentType	int	否	个人收款方式，目前只支持：1银行卡；2支付宝，默认为银行卡，如果需要用到支付宝，请先联系客服开通个人支付宝收款。
orderDetailList	list	是	订单明细，参数说明见下表

orderDetailList

参数	类型	是否必须	说明
参数	类型	是否必须	说明
corpFlowNumber	string	是	明细流水号(系统调用方明细的唯一标识)
employeeNo	string	否	自由职业者工号
name	string	是	姓名
papersNo	string	是	身份证号码
bankPhone	string	是	银行预留手机号码
bankName	string	是	开户行名称/如果是支付宝收款，则填：支付宝
bankCardNo	string	是	银行账号/如果是支付宝收款，则填支付宝账号(支付宝账号!=手机号码)。
bizBeforeFee	string	否	经营服务费税前(与经营服务费税后选填一个),取值范围为0.01~100000，精确到分，四舍五入，单位：元
bizFee	string	否	经营服务费税后(与经营服务费税前选填一个,取值范围为0.01~50000，精确到分，四舍五入，单位：元
extendParams	string	否	预留的扩展字段，字符长度限制1000

‌

请求参数示例

{
  "batchNo": "20191015001",
  "providerId": "88888888888888888888",
  "orderDetailList": [
    {
      "bankCardNo": "124561212",
      "bankName": "中国银行",
      "bankPhone": "13800000000",
      "bizBeforeFee": "1",
      "corpFlowNumber": "1",
      "name": "张三",
      "papersNo": "110101199003071292"
    }
  ]
}

‌

响应参数说明

参数	类型	说明
id	string	平台订单唯一id，成功时返回
batchNo	string	批次号（调用方系统对该交易订单的唯一标识，每个批次订单必须唯一）。
created	string	下单时间，成功时返回, 如：20190715235959
returnType	int	返回类型:0 正常,1 有错误
errorList	list	错误信息,returnType为1时返回

‌

返回结果示例

成功示例
{
  "id": "362201688838242123",
  "batchNo":"20191015001",
  "created": "20190715235959",
  "returnType": 0,
  "errorList": []
}
失败示例
{
  "id": "",
  "batchNo":"",
  "created": null,
  "returnType": 1,
  "errorList": [
    "第1行出现校验错误:张三的身份证有误"
  ]
}

4.1 创建交易订单

4.1 创建交易订单

results matching ""

No results matching ""