创建回款单 - 尘锋SCRM开放平台

POST https://qw-openapi-tx.dustess.com/java-payback-srv/open-api/payback/v2/create/batch?accessToken=

请求header

字段	值
Content-Type	application/json

接口限制：每分钟调用600次；

请求参数

参数名称	类型	描述	是否必须
paybacks	`Object[]`	回款单数据（单次最多50条）	true
paybacks.paybackMethod	`Int`	回款方式 (1：对公转账 2：微信收款3：支付宝4：银联聚合收款 5：其他 7:现金收款 8：POS机收款）	true
paybacks.paybackAmount	`String`	回款金额（单位：元，例如："128.31"）	true
paybacks.paybackDate	`String`	回款日期（格式："2023-09-20"）	true
paybacks.paybackName	`String`	回款方式名称（回款方式为「其他」时，需要填入	false
paybacks.subjectName	`String`	主体名称	false
paybacks.serialNo	`String`	流水号	false
paybacks.searchNo	`String`	检索号	false
paybacks.identificationCode	`String`	不同回款方式字段含义不同，对公转账：付方账号；微信收款：微信支付单号；支付宝：交易号；银联聚合收款：商户订单号；现金收款/POS机收款/其他：回款识别码	true
paybacks.merchantOrderNo	`String`	商户订单号	false
paybacks.bankMerchantNo	`String`	银商订单号	false
paybacks.remitter	`String`	打款人	false
paybacks.remark	`String`	备注	false
paybacks.claimantId	`String`	认领人（员工ID，有关联对象时需要传）	false
paybacks.belongDeptId	`Int`	归属部门id	false
paybacks.relateCompanyId	`String`	关联企业ID（relateCompanyId、relateCustomerId、relateOrderInfo最多传其一）	false
paybacks.relateCustomerId	`String`	关联联系人ID（relateCompanyId、relateCustomerId、relateOrderInfo最多传其一）	false
paybacks.relateOrderInfo	`Object[]`	关联订单（relateCompanyId、relateCustomerId、relateOrderInfo最多传其一）	false
paybacks.relateOrderInfo.orderId	`String`	订单ID	false
paybacks.relateOrderInfo.amount	`String`	订单本次回款金额	false

请求参数示例
json - Request-Example:


{
  "paybacks": [
    {
      "paybackMethod": 1,
      "identificationCode": "1234567",
      "serialNo": "88888888",
      "paybackAmount": "128.1",
      "paybackDate": "2023-09-08",
      "relateOrderInfo": [
        {
          "orderId": "87d649e1-13f6-440a-ab28-612b2f23b091",
          "amount": "128.1"
        }
      ],
      "claimantId": "561"
    }
  ]
}

成功响应

参数名称	类型	描述
code	`Int`	状态码
msg	`String`	状态信息
data	`Object`	响应数据
data.success	`Object[]`	成功的数据
data.success.index	`Int`	对应传入参数的数组下标
data.success.id	`String`	成功创建后的回款单ID
data.fail	`Object[]`	失败的数据
data.fail.index	`Int`	对应传入参数的数组下标
data.fail.code	`Int`	失败错误码
data.fail.msg	`String`	失败错误信息
traceId	`String`	跟踪id

成功响应示例

{
  "code": 0,
  "data": {
    "fail": [
      {
        "code": 90001004,
        "index": 1,
        "msg": "无效的关联对象"
      }
    ],
    "success": [
      {
        "code": 0, 
        "id": "492363602803044352",
        "index": 0,
        "msg": ""
      }
    ]
  },
  "msg": "OK",
  "traceId": "5fefbbc6-bbde-988a-9226-4b590c8e707b"
}

错误响应示例

 {
    "code": 500500,
    "data": {},
    "msg": "服务端错误：xxxx",
    "traceId": "5fefbbc6-bbde-988a-9226-4b590c8e707b"
}