简要描述:

  • 第三方系统,通过迅联云接入,通过API创建对账单。

接口版本:

版本号 制定人 制定日期 修订日期
1.0 米伟伟 2019-5-15 2019-5-15

请求方式:

  • POST

请求头:

参数名 是否必须 类型 说明
Content-Type string 请求类型: application/json

请求URL:

post /reconciliation/saveReconForApi

请求参数:

参数名 是否必须 类型 说明
reconciliationNo String 对账单号,唯一不能重复
currency String 货币
startTime Date 对账开始时间
endTime Date 对账结束时间
buyCompanyName String 购买方公司名称
buyCompanyTaxId String 购买方公司税号
supplierCompanyName String 供应商公司名称
supplierCompanyTaxId String 供应商公司税号
itemList List 对账单行集合
itemNo String 条目编号 行唯一性标识,相同的即为一行
itemName String 卖方商品名称
specification String 规格型号
productNo String 卖方商品编号
quantity BigDecimal 数量
unit enum 单位
unitPrice BigDecimal 单价
amountWithoutTax BigDecimal 金额(不含税)
taxPercent BigDecimal 税率
taxAmount BigDecimal 税额(金额*税率)
amount BigDecimal 价税合计(金额+税额)
discount BigDecimal 折扣
buyerItemName String 买方商品名称
buyerSpecification String 买方商品规格型号

请求示例:

{
  "reconciliationNo": "hailan-API-Buy1557883270376",
  "currency": "人民币",
  "startTime": 1557883315047,
  "endTime": 1557883315047,
  "buyCompanyName": "重庆宜迅联供应链科技有限公司",
  "buyCompanyTaxId": "91500103MA5UAHBY29",
  "supplierCompanyName": "兰馨谷开票测试",
  "supplierCompanyTaxId": "310106666888888",
  "itemList": [{
        "itemNo": "01",
        "itemName": "API条目测试商品",
        "productNo": "233W5THXL-01212",
        "specification": "BQF3 - C",
        "quantity": 10,
        "realStoreQuantity": null,
        "unit": "EA",
        "unitPrice": 4179.43,
        "unitPriceWithoutTax": null,
        "amountWithoutTax": 39428.58,
        "taxPercent": 0.06,
        "taxAmount": 2365.71,
        "amount": 41794.3,
        "discount": 100,
        "productId": null,
        "buyerProductId": null,
        "buyerItemName": "API条目测试商品",
        "buyerSpecification": "BQF3 - C",
    }]
}

返回示例:

正确时返回:

{
  "body": {
    "reconciliationUuid": "f5e5a195-394f-4e7c-8865-989fdce600b3"
  },
  "ok": true,
  "status": {
    "description": {},
    "message": "string",
    "path": "string",
    "returnCode": "string",
    "serviceCode": "string",
    "time": "2019-05-15T06:34:06.874Z"
  }
}

错误时返回:

{
  "body": {},
  "ok": false,
  "status": {
    "description": {},
    "message": "对账单号已经存在",
    "returnCode": "200", 
    "time": "2019-05-15T06:34:06.874Z"
  }
}

返回参数说明:

参数名 类型 说明
ok String 请求是否处理成功, true表示成功
reconciliationUuid String 创建的对账单UUID
文档更新时间: 2022-04-07 15:15   作者:黄勇