形态转换单API接口规范

  • 轻易云集成顾问-冯潇

形态转换单API接口规范

接口标识

  • 接口类型:xtzhdadd(形态转换单新增接口)

请求参数示例

{
  "Cmd":"xtzhdadd",
  "SetBook":"710",
  "SetYear":"2023",
  "LoginName":"HM200",
  "LoginPwd":"230829",
  "LoginDate":"2023-11-27",
  "Params":{
    "json":"[{
      \"AddType\":\"0\",
      \"dACDate\":\"2023-11-25\",
      \"CDepCode\":\"0201\",
      \"CIRdCode\":\"106\",
      \"CORdCode\":\"209\",
      \"CMaker\":\"任虹\",
      \"ctransFlag\":\"1\",
      \"CAVMemo\":\"备注测试55555\",
      \"Details\":[
        {
          \"bavType\":\"转换前\",
          \"cwhcode\":\"101\",
          \"cInvCode\":\"0201001\",
          \"iavQuantity\":2,
          \"iavAcost\":2,
          \"iavaPrice\":4,
          \"cassUnit\":\"0302\"
        },
        {
          \"bavType\":\"转换后\",
          \"cwhcode\":\"102\",
          \"cInvCode\":\"0201001\",
          \"iavQuantity\":2,
          \"iavAcost\":2,
          \"iavaPrice\":4,
          \"cassUnit\":\"0302\"
        }
      ]
    }]"
  }
}

核心参数说明

参数名 类型 必填 说明
AddType string 单据类型(0:固定时间)
dACDate string 单据日期(格式:YYYY-MM-DD)
CDepCode string 部门编码
CIRdCode string 入库类别编码
CORdCode string 出库类别编码
CMaker string 制单人(默认当前登录人)
ctransFlag string 转换方式(1:一对一,2:多对一)
CAVMemo string 备注信息

明细参数说明

"Details": [
  {
    "bavType": "转换前/转换后",  // 必填
    "cwhcode": "101",         // 仓库编码
    "cInvCode": "0201001",    // 存货编码
    "iavQuantity": 2,         // 数量(double)
    "iavAcost": 2,            // 单价(double)
    "iavaPrice": 4,           // 金额(自动计算)
    "cassUnit": "0302"        // 库存单位码
  }
]

扩展参数配置

// 表头自定义项
Av.CDefine1 = "";  // 自定义文本字段1
Av.CDefine4 = null; // 自定义日期字段
Av.CDefine7 = 0;    // 自定义数值字段

// 明细表扩展字段
Details.cDefine22 = "";  // 表体自定义项
Details.iGroupNO = 1;    // 组号(默认1)
Details.dMadeDate = DateTime.Now; // 生产日期

技术说明

  1. 金额字段(iavaPrice)需根据数量×单价自动计算
  2. 日期字段需符合ISO 8601格式标准
  3. 所有编码字段建议使用系统预定义的编码值
  4. 明细表支持多组数据同时提交

提示:通过轻易云数据集成平台调用此API时,系统会自动处理数据格式转换和字段映射,大幅降低集成开发难度。平台提供可视化调试工具,可实时验证接口调用效果。

更多系统对接方案