单据更新

• 接口：common/document/update/{externalId}
• Method：POST
• 数据格式：JSON
• 接口说明：单据更新
• 其他补充信息：
  • 单据头仅可做更新操作, 可更新字段见下文
  • 仅可更新单据状态为 approved, closed 的单据
  • 仅可更新单据头 internal_type 为 request, request_contract, request_travel, purchase_order, goods_receipt, sales_order 的单据
  • 单据行若存在 line_id 为更新, 不存在为新增, 可更新字段见下文。 新增时: 单据行详细报文见单据创建口
  • 事项明细行若存在 id 为更新, 不存在为新增
  • 预算分摊行若存在 id 为更新, 不存在为新增

请求参数

body (单据头和行仅展示可更新字段, 新增时, 对应可传字段见单据创建口报文)

单据头参数

以下字段需在 data 路径下传参

费用行参数

以下字段需在 data.claim_line 路径下传参

事项明细行参数

以下字段需在 data.custom_line 路径下传参

预算分摊行参数

以下字段需在 data.budget_line 路径下传参

请求示例:

请求数据

common/document/update/bd84fd45-038f-4a79-854b-a322031a7c19

{
  "timestamp": 1702521344000,
  "bizId": "xxx",
  "data": {
    "total_amount": 600,
    "total_claim_amount": 600,
    "total_pay_amount": 600,
    "total_pay_currency_amount": 600,
    "total_net_amount": 600,
    "total_receipt_amount": 600,
    "column37": 0.37,
    "column63": "8676",
    "charge_department_code": "2050015",
    "attachments1": [
      {
        "file_name": "file_name1.png",
        "attachment_url": "https://attachment-url.com/file_name1.png",
        "attachment_type_code": "test01"
      }
    ],
    "attachments10": [
      {
        "file_name": "file_name10.png",
        "attachment_url": "https://attachment-url.com/file_name10.png",
        "attachment_type_code": "test01"
      }
    ],
    "claim_lines": [
      {
        "line_id": 434465,
        "quantity": 8,
        "line_type_code": "T012",
        "budget_id": 18519,
        "charge_user_code": "zhaixuwen@tom.com",
        "receipt_amount": 50,
        "receipt_currency": "CNY",
        "claim_amount": 50,
        "claim_currency": "CNY",
        "fin_claim_amount": 50,
        "net_amount": 50,
        "pay_amount": 50,
        "pay_claim_amount": 50,
        "pay_currency_amount": 50,
        "fin_pay_currency_amount": 50,
        "period_name": "2024年财年-11",
        "cost_center_code": "D1",
        "project_code": "13418712",
        "column1": "1",
        "column2": "2",
        "column3": "3",
        "column100": "100",
        "attachments1": [
          {
            "file_name": "file_name1.png",
            "attachment_url": "https://attachment-url.com/file_name1.png",
            "attachment_type_code": "test01"
          }
        ],
        "attachments10": [
          {
            "file_name": "file_name10.png",
            "attachment_url": "https://attachment-url.com/file_name10.png",
            "attachment_type_code": "test01"
          }
        ]
      },
      {
        "line_type_code": "T50",
        "cost_center_code": "32006",
        "project_code": "FD004.2",
        "tax_code": "TAX_IN_13",
        "receipt_currency": "CNY",
        "receipt_amount": 340.00,
        "claim_amount": 340.00,
        "net_amount": 300.88,
        "tax_amount": 39.12,
        "column1": "column1",
        "column4": "1",
        "column24": "119",
        "column27": "0",
        "column51": "column51"
      }
    ],
    "custom_line": [
      {
        "custom_line_type_code": "T02",
        "cost_center_code": "D1",
        "customer_code": "MKS",
        "supplier_code": "AK001",
        "charge_user_name": "aaa@cloudpense.com",
        "passenger_names": [
          "aaa@cloudpense.com",
          "bbb@cloudpense.com"
        ],
        "project_code": "DRHG1",
        "destination_city_name": "上海",
        "destination_city_to_name": "北京",
        "destination_cities": "上海,北京",
        "start_datetime": 1681660800000,
        "end_datetime": 1681747200000,
        "attendee_number": 2,
        "duration_day": 1.0,
        "duration_hour": 24.0,
        "duration_minute": 1440.0,
        "comments": "comments",
        "long_comments": "long_comments",
        "column1": "100",
        "column14": "1400"
      }
    ],
    "budget_line": [
      {
        "period_name": "2023年5月",
        "cost_center_code": "C004300249",
        "supplier_code": "0070002396",
        "charge_department_code": "D1",
        "charge_user_name": "test@cloudpense.com",
        "project_code": "apipro003",
        "budget_amount": 340.00,
        "budget_currency": "CNY",
        "ratio": 1.0,
        "column1": "100",
        "column51": "5100"
      }
    ]
  }
}

返回示例

成功

{
  "resCode": 200000,
  "resMsg": "success",
  "bizId": "384a58fd-1061-4611-9437-5d1674292cd8"
}

失败

{
  "resCode": 0,
  "resMsg": "该单据 status 为 cancelled 不允许更新",
  "bizId": "20d9c2bb-9c05-4b44-af29-fac64c5ad2fb"
}

{
  "resCode": 400000,
  "resMsg": "单据不存在",
  "bizId": "d69c5943-5955-48ea-b2d8-5aa50b2808d2"
}