一、ERP API说明

生成【项目设定】接口

概述

该接口主要用于第三方平台或自主研发者，通过调用【项目设定】的生成接口，将第三方工程或项目方案的信息推送到Sunlike ERP或Online ERP系统中，从而生成Sunlike ERP或Online ERP系统的【项目设定】。

参数说明

1.请求方式

请求方式 POST
接口地址 http://ERPAPI站点/prjcasn/ADDDATA
格式 JSON
编码类型 UTF-8

2.header参数

Content-Type application/json
Authorization token 授权接口所获取的值

3.请求参数

字段名称 字段代号 类型 长度 必填 固定值 备注
工程案号 CAS_NO string 20 是   手工输入，可自定义，必填
内部凭证 REF_NO string 10      
客户代号 CUS string 12      
包商代号 CUS_NO string 12      
开工日期 OPN_DAT datetime   是    
预定完工日期 END_DAT datetime        
工程名称 NAME string 80      
工程总价 AMTN float        
追加总价 AMTN_ADD float        
追减总价 AMTN_SUB float        
完工结案日期 CLS_DAT datetime        
完工率 END_RTO float        
完工比率法 CLS_MTH string 1      
工程成本材料 CST1 float        
工程成本人工 CST2 float        
工程成本费用 CST3 float        
工程成本外包 CST4 float        
部门代号 DEP string 8 是    
是否径决 CAS_OK string 1      
摘      要 REM string 50      
工程地点 ADR1 string 200      
合约代号 AG_NO string 20      
合约名称 AG_NAME string 40      
当前版本 CAS_VER string 12      
终审人 CHK_MAN string 12      
终审日期 CLS_DATE datetime 0      
结案注记 CLS_ID string 1      
用户代号 USR string 12 是    
日工时 DAY_HH integer 0      
周工时 WEEK_HH integer 0      
月工作日 MONTH_DD integer 0      
班别代号 BAN_NO string 20      
文管档案编号 FILE_ID string 100      
项目类型 TYPE string 1      
归属项目 UP string 20      
合同编号2 AG_NO2 string 20      
合同链接2 FILE_ID2 string 100      
合同编号3 AG_NO3 string 20      
合同链接3 FILE_ID3 string 100      
合同编号4 AG_NO4 string 20      
合同链接4 FILE_ID4 string 100      
合同编号5 AG_NO5 string 20      
合同链接5 FILE_ID5 string 100      
施工单位1 BUILDER1 string 12      
施工单位2 BUILDER2 string 12      
施工单位3 BUILDER3 string 12      
项目状态 STATUS string 10      
订金金额 AMTN_SO float 0      
集成费用 AMTN1 float 0      
辅材费用 AMTN2 float 0      
谈楼费用 AMTN3 float 0      
其他费用 AMTN4 float 0      
工程简称 SNM string 30      
业务代号 SAL_NO string 12 是    
对方负责人 DF_USR string 40      
对方联系电话 DF_TEL string 50      
收款条件-副安装量 QTY1_RCV float 0      
收款条件-副安装完成量 QTY1_FINED float 0      
收款条件 REM_RCV string 0      
审核模版 MOB_ID string 10      
锁单人 LOCK_MAN string 12      
锁单时间 LOCK_DATE datetime 0      
副单位名称 UT1 string 8      
质保金 AMTN_ZB float 0      
质保结案日期 CLS_DD_ZB datetime 0      
质保结案否 CLS_ID_ZB string 1      
非正式项目否 TEMP_ID string 1      
质保金比率 PER_ZB float 0      
预计损耗率 LOSS_RATE1 float 0      
实际损耗率 LOSS_RATE2 float 0      
结算总价 AMTN_JS float 0      
供应商代号 SUP_CODE string 20      
纳税人标识号 TAXPAYER_CODE string 20      
开户银行 BNK_NAME string 7      
账号 ID_CODE string 30      
合同附件书 CT_FILE string 0      
合同附件书文件名 CT_FILE_NAME string 100      
签订日期 SIGN_DD datetime 0      
合同固定返点比率 CT_RTN_RTO float 0      
目标销售金额 AMTN_TARGET float 0      
账期 ACC_DAYS string 50      
收款类别(1.安装量2.出货量) RCV_TYPE string 1      
依出货量出货前金额 PAY1_AMTN float 0      
依出货量出货后金额 PAY2_AMTN float 0      
依出货量出货后收款天数 PAY2_DAYS float 0      
分类代号 IDX_NO string 20      
输单日期 SYS_DATE datetime 0      
最近修改时间 MODIFY_DD datetime 0      
最近修改人 MODIFY_MAN string 12      
单据类别 BIL_TYPE string 10      
销售目标 AMTN_TG float 0      
费用比例 RTO_FY float 0      
销售返利来源 DATA_SRC string 2      
销货返利自动产生单据 AUTO_BIL string 2      
货补可抵消比例 RTO_HB float 0      
现款核销比例 RTO_XK float 0      
返利类型 RETURN_ID string 1      
进货预算金额 AMTN_JH float 0      
资产代号 FX_NO string 30      
账扣核销比例 RTO_ZK float 0      
联系手机 CELLPHONE string 20      
项款支持1 AMTN_SP1 float 0      
项款支持2 AMTN_SP2 float 0      
项款支持3 AMTN_SP3 float 0      
项款支持4 AMTN_SP4 float 0      
项款支持5 AMTN_SP5 float 0      
保证金 AMTN_BZ float 0      
定金 AMTN_DJ float 0      
客户等级 CUS_LEVE string 1      
使用门店 DEP_NO string 8      
资产类别 KND_ID string 10      
资产类别代号 KND_NO string 30      
合约类型 CAS_ID string 1      
售卡开始时间 CARD_DAT datetime 0      
售卡金额可修改 CHK_CARD string 1      
举办方名称 ACT_NAME string 200      
举办方电话 ACT_TEL string 20      
举办地址 ACT_ADR string 200      
举办时间 ACT_DAT datetime 0      
活动缩图 ACT_IMG G 0      
厂商等级 SUP_LEVEL string 1      
取价模式 UP_TYPE string 50      
允许修改折扣 CHK_DISCNT string 1      
允许修改折扣额 CHK_AMTDISCNT string 1      
单价可修改 CHK_UP string 1      
区域 AREA_NO string 20      
单一核销比率% AUDIT_RATIO float 0      
组合核销比率% GROUP_RATIO float 0      
固定返利比率% FIXED_RATIO float 0      

请求JSON示例

{
  "REF_NO": "LJCASN20210312002",      //第三方单号
  "PGM": "CASN",     //程序代号
  "CASN": [        //增加项目内容
    {
      "CAS_NO": "CASN0312001",    //项目代号，必填，自定义手工编码
      "CUS": "A0002",
      "OPN_DAT": "2021-03-12",
      "NAME": "2021年工程项目",
      "DEP": "00000000",
      "USR": "ADMIN",
      "REM_RCV": "",
      "SAL_NO": "10001",
      "RCV_TYPE": "1",
      "RETURN_ID": "1",
      "AREA_NO": "",
      "CUS_SNM": "中国广东省珠海市吉大景山路82号客户A0001"
    }
]
}

返回结果示例

{
    "code": 0,
    "message": "新增成功",
    "data": {
        "CASN": [
            {
                "CAS_NO": "CASN0312001",
                "CUS": "A0002",
                "OPN_DAT": "2021-03-12 00:00:00",
                "NAME": "2021年工程项目",
                "DEP": "00000000",
                "CHK_MAN": "ADMIN",
                "CLS_DATE": "2021-03-12 14:39:53",
                "USR": "ADMIN",
                "REM_RCV": "",
                "SAL_NO": "10001",
                "RCV_TYPE": "1",
                "SYS_DATE": "2021-03-12 14:39:53",
                "RETURN_ID": "1",
                "AREA_NO": "",
                "CUS_SNM": "中国广东省珠海市吉大景山路82号客户A0001"
            }
        ]
    }
}