生成【客户厂商资料】接口

概述

该接口主要用于第三方平台或自主研发者,通过调用【客户厂商资料】的生成接口,将第三方系统的客户或厂商信息推送到Sunlike ERP或Online ERP系统中,从而生成Sunlike ERP或Online ERP系统的【客户厂商资料档】。

参数说明

1.请求方式

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

2.header参数

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

3.请求参数

字段名称 字段代号 类型 长度 必填 固定值 备注
程序代号 PGM     CUST  
字段名称 字段代号 类型 长度 必填 固定值 备注
客户代号 CUS_NO string 12    
中类代号 IDX2 string 8      
区域 CUS_ARE string 20      
归属对象 MAS_CUS string 12      
对象别 OBJ_ID string 1   值的范围:1、2、3、4(1客户;2厂商;3客户厂商;4会员客户)
全称 NAME string 100      
简称 SNM string 30      
英文名称 NM_ENG string 200      
保留! PAY_DD integer        
结帐类别 CLS_MTH string 1      
起算日 CLS_DD integer        
间隔天数 MM_END integer        
票据到期日 CHK_DD integer        
统一编码 UNI_NO string 20      
负责人 BOS_NM string 30      
联络人1职称 CNT_JOB1 string 6      
联络人1 CNT_MAN1 string 100      
联络人2职称 CNT_JOB2 string 6      
联络人2 CNT_MAN2 string 100      
会计 ACC_MAN string 100      
责任业务 SAL string 12      
电话1 TEL1 string 100      
电话2 TEL2 string 100      
传真 FAX string 100      
发票地址 ADR1 string 200      
公司地址 ADR2 string 200      
英文地址 ADR_ENG string 200      
邮政编码 ZIP string 20      
信用额度 LIM_NR float        
票据信用额度 LIM_NC float        
信用管制 CRD_ID string 1      
发票类别 INV_ID string 2      
扣税类别 ID1_TAX string 1   值的范围:1、2、3(1不计税;2应税内含;3应税外加,默认1)
按外币冲销否 ID2_TAX string 1      
结帐方式 CLS1 string 80      
立帐方式 CLS2 string 1   值的范围:1、2、3(1单张立帐;2不立帐;3收/开到发票才立帐,默认1)
起始往来日期 STR_DD datetime     表示该客户或厂商什么时候开始在系统中使用
截止往来日期 END_DD datetime        
使用币别 CUR string 4      
需要管制信用 CRD_NR_NC string 1      
摘要 REM string 200      
电子邮件 E_MAIL string 200      
送货方式 SEND_MTH string 200      
送货仓 SEND_WH string 12      
保留! BNK_NAME string 40      
银行帐号 ID_CODE string 30      
客户等级 CUS_LEVEL string 1     为厂商时不能填;为客户时,则必填,值的范围:1、2、3、4、5(1总代理;2一级客户;3二级客户;4经销批发;5一般客户,默认5)
保留! INC_CHECK string 1      
利息率 LS_RTO float        
公司网站 COMPNET string 100      
成立时间 COMP_DD datetime        
资本总额 CAPSUM float        
营业总额 BUSISUM float        
员工数 SALMS integer        
营业性质 BUSINOTE string 50      
经营项目 WORKITM string 1      
主要产品 MAIN_PRD string 1      
信用含票据否 CHK_CRD string 1      
保留! S_FLAG string 1      
保留! INITNUM float        
到港联络人 NOTIFY string 30      
报关行 BROKER string 30      
船名 VESSEL string 60      
装货港/收货地 LOADING_PORT string 60      
卸货港/目的地 DIS_PORT string 60      
产地 MANU_PLACE string 60      
是否订阅电子报 EPAPER string 1      
是否订阅交易记录 TRAN_REC string 1      
密码 PSWD string 100      
密码提示 PSWD_HIT string 80      
密码提示答案 PSWD_ANS string 20      
核准日 APPLY_DD datetime        
行业别 BIZ_DSC string 10      
国家 COUNTRY string 20      
银行代号 BANK_NO string 7      
应收账款科目 ACC_NO_AR string 20      
应付账款科目 ACC_NO_AP string 20      
应收票据科目 ACC_NO_R0 string 20      
应付票据科目 ACC_NO_P0 string 20      
信用额度含订单否 SO_CRD string 1      
发票名称 FP_NAME string 200      
信用额度含传真汇款否 CHK_FAX string 1      
客户税率 RTO_TAX float        
信用检测 CHK_CUS_IDX string 1      
承运单位否 CY_ID string 1      
企业注册编码 REGIST_CODE string 20      
企业类型 CORP_ID string 4      
主管海关 M_CUST string 4      
主报关员 SAL_NO string 12      
审核部门 CHK_DEP string 20      
扣款比例 RTO_KK float        
所属部门 DEP string 8      
返利比率 RTO_FL float        
预留比率 RTO_YL float        
集团分公司 DEP1 string 8      
登陆人 USR string 12      
信用额度含下属 CHK_INCLUDE string 1      
信用额度含预收款否 CHK_IRP string 1      
信用额度含暂收款否 CHK_TRP string 1      
审核人 CHK_MAN string 12      
审核日期 CLS_DATE datetime        
交易管制方式一 CHK_PAY1 string 1      
帐龄天数 PAY_DAYS integer        
帐龄计算方式 PAY_FLAG string 1      
交易管制方式二 CHK_PAY2 string 1      
交易管制方式三 CHK_PAY3 string 1      
订货金额上限 AMTN_MAX_PAY float        
欠款控制 CHK_QK string 1      
欠款额度 AMTN_QK float        
录入员 USR1 string 12      
输入日期 SYS_DATE datetime        
折扣率 RTO_DISCNT float        
收款含预/暂收款否 CHK_IRP2 string 1      
是否登陆用户 LOGON string 1      
所属仓库 WH_NO string 12      
停止订货 STOP_ORDER string 1      
是否控制退货 RTN_CTRL string 1      
是否分经/销商 DRP_ID string 1      
执行分销定价政策 UPR4_ID string 1      
要货库位1 YH_WH1 string 12      
要货库位2 YH_WH2 string 12      
预收账款科目 ACC_NO_IR string 20      
预付账款科目 ACC_NO_IP string 20      
是否B2C登陆用户 B2C_ID string 1      
会员卡号 CARD_NO string 20      
采购计划打印周数 PRTWEEKS_PO integer 0      
确定采购订单周数 SOWEEKS_PO integer 0      
缺省语言别 LANG_ID string 10      
采购确认 CHK_DRP1 string 1      
收料确认 CHK_DRP2 string 1      
托工确认 CHK_DRP3 string 1      
服务人员 SRV_NO string 12      
客户类别 CUS_IDX string 10      
性能分类 XN_NO string 20      
CWORK登录人数 CWORK integer 0      
条形码控制 CHK_BARCODE string 1      
暂估应付账款科目 ACC_NO_ZP string 20      
是否豁免 HM_ID string 1      
支付密码 PSWD_PAY string 100      
返利金额 AMTN_FL float 0      
已返利金额 AMTN_FLED float 0      
计算销货退回率否 CHK_SBRTO string 1      
部门群组代号 DEPRO_NO string 8      
首付比例 RTO_FQSK float 0      
首付日期方式 DATEFLAG_FQSK string 1      
首付指定日期 DATE_FQSK datetime 0      
期数 QS_FQSK integer 0      
Sunlike客户语言别 LOCAL_ID string 1      
Sunlike客户角色 RULE_ID integer 0      
Sunlike联络电话1区码 TEL1_CODE string 10      
Sunlike统一编号2 UNI_NO2 string 20      
Sunlike发票抬头2 FP_NAME2 string 50      
帐户名称 CODE_NAME string 100      
快递否 CHK_KD string 1      
WS客户对应的注册码 WS_CUS_NO string 20      
自动带出工程案号 AUTO_CASN_CHK string 1      
纳税人识别号 NSR_CODE string 20      
助记码 NAME_PY string 150      
副行业别 BIZ_DSC1 string 10      
来源情况 CUS_SRC string 20      
应收其它账款 ACC_NO_AR2 string 20      
应付费用 ACC_NO_AP2 string 20      
拜访次数设置 VISIT_LIMIT integer 0      
报备日期 BB_DD datetime 0      
未成交期限 SO_DD datetime 0      
审核模板 MOB_ID string 10      
摊提方式设置 TT_TYPE_SET string 20      
出口客户否 EX_TRD_ID string 1      
进出口厂商类别 IM_TRD_ID string 1      
缺省快递公司 CUS_NO_KD string 12      
信用管制含不立帐销/退/折单 CHK_ZHANG_ID2 string 1      
配件申请默认仓库 PJSQ_WH string 12      
京东快递商代号 JD_NO string 20      
电子发票类型(1.B2B 2.B2C 3.B2G) FP_TYPE string 1      
启用促销否 CHK_CX string 1      
检测最低消费额 CHK_MIN_XF string 1      
检测最低消费单据 BIL_MIN_XF string 10      
检测最低消费类型 CHK_TYPE_MINXF string 1      
最低消费额 AMTN_MIN_XF float 0      
折扣限率 BK_DIS_CNTM integer 0      
倍康受定库位 BK_SO_WH string 12      
公司简介 REM_S string 1000      
发货部门 DEP_FH string 8      
发货库位 WH_FH string 8      
发货客户 CUS_FH string 12      
O2O分销商否 CHK_O2O_FX string 1      
商城客户否 CHK_MALL string 1      
分销等级 FX_LEVEL string 1      
启用对帐流程 DJ_LC string 1      
冻结付款 DJ_PAY string 1      
启用供应商付款申请流程 DJ_SQ string 1      
冻结本位币 AMTN_DJ float 0      
信用额度类型 LIM_NR_TYPE string 1      
要货订单全额定金否 CHK_FULL_PAY string 1      
信用额度含出库 CHK_CK string 1      
启用会员载具否 ISCUSTKEY string 1      
厂商等级 SUP_LEVEL string 1      
意向品牌 BRD_NO string 8      
意向车型 CA_NO string 8      
意向世代款式 CA1_NO string 40      
现有品牌 NBRD_NO string 8      
现有车型 NCA_NO string 8      
现有世代款式 NCA1_NO string 40      
兴趣爱好 INTEREST string 200      
纳税资格 NSZG_FLAG string 1      
对应我司回款账户 BACC_NO string 4      
收入单按费用项目检测额度 CHK_INDX1 string 1      
银行名称 BANK_NAME string 100      
条码简码 S_CODE string 20      
检测供应商余额 DJ_YE string 1      
离线创建否 CHK_FL string 1      
账期限制类型 ZQ_BT_CTRL string 1      
按单据类别管制要货受订销货下单货品 CHK_PRD_BT string 1      
使用补货日期 TZBH_DD datetime 0      
补货单据类型(分销要货、一般要货、受订单) TZBH_BIL_ID string 100      
停止发货日期 TZFH_DD datetime 0      
停止单据类型(出库单、销货单) TZFH_BIL_ID string 100      
受限单据类别不检测信用额度 CHK_SKIP_LIM string 1      
所属要货类型 YH_TYPE string 20      
临时供应商 TEMPFLAG string 1      
大平台交换否 B2BTYPE string 1      
商场合作商户 ISCOOP string 1      
控股子公司否 CHK_KGCOMP_HZ string 1      
临时供应商 CHK_LSCUS_HZ string 1      
是安装队 IS_AZ string 1      
加工申请打占用库存 CK_USEWH string 1      
占用商品库存需检测库存 USEWH_ID string 1      
调汇其它收入单 CHK_TH string 1      
提前交货时间 PRE_PSDAYS integer 0      
进货检验设定 CHK_PC string 1      
托工检验设定 CHK_TW string 1      
采购确认可回复期望单价 CHK_DRP4 string 1      
最后跟进时间 LAST_CNT_DD datetime 0      
日程最后跟进时间 RC_CNT_DD datetime 0      
商机最后跟进时间 SJ_CNT_DD datetime 0      
拜访最后跟进时间 BF_CNT_DD datetime 0      
最近修改日期 MODIFY_DD datetime 0      
最近修改人 MODIFY_MAN string 12      
加工申请单检测SAP库存 CHK_SAPYM string 1      
启用生产批次 CHK_SCPC string 1      
送货单采购流程(停用) TI_FROM_PO string 1      
送货单托工流程(停用) TI_FROM_TW string 1      
允许添加眼镜盒 CHK_YJH string 1      
是否必须添加眼镜盒 YJH_ID string 1      
启用供应商送货管控 CHK_SHGK string 1      
送货周期 SHZQ_M integer 0      
不合格次数计算方式 LOST_TYPE string 1      
不合格次数 LOST_ITMES integer 0      
停止送货 CHK_TZSH string 1      
不合格次数统计依据 LOST_CTYPE string 20      
报备类型代号 CUST_BB_TYPE_ID string 20      
加工室眼镜盒可选物料 HZ_JGYJH_PRD string 500      
收票作业(应税内含)的税率改变处理 FLAG_TAXCHG_I string 1      
开票作业(应税内含)的税率改变处理 FLAG_TAXCHG_O string 1      
客户等级价率 RTO_DISCNT_LEVEL float 0      
启用供应商网上对账 GDZ_WEBDZ string 1      
网上对账流程 GDZ_WEBFLOW string 1      
送货单转入依据(1.依营业人资料设定 2.指定来源单) TI_FROM string 1      
送货单可转入单据别 TI_FROM_ID string 100      
地址所属区/县代号 COUN_ID integer 0      
补充证件号 ADD_ID_NO string 50      
检测最低采购额 CHK_MIN_CG string 1      
检测最低采购单据 BIL_MIN_CG string 50      
检测最低采购类型 CHK_TYPE_MINCG string 1      
最低采购额 AMTN_MIN_CG float 0      

4.自定义参数

字段名称 字段代号 类型 长度 是否 固定值 备注
数据表CUST_Z(表头自定义字段)
自定义栏位1 自定义 string 2     自定义字段可为文件、数字、日期、备注等类型,若为数字字段,可用于计算,例如自定义三个字段:JD_NO1,JD_NO2,JD_NO3,而JD_NO3=JD_NO1*JD_NO2,那么在JSON里只要上传JD_NO1和JD_NO2即可。
自定义栏位2 自定义 string      
…… …… ……      

请求JSON示例

{
  "PGM": "CUST",       //程序代号
  "CUST": [           //新增客户或厂商资料
    {
      "CUS_NO": "C0001",    //客户代号
      "SUP_LEVEL": "1",     //客户等级
      "OBJ_ID": "3",        //客户类别
      "NAME": "珠海集团C0001",
      "SNM": "珠海集团C0001",
      "CLS_MTH": "1",
      "CLS_DD": 1,
      "MM_END": 30,
      "CHK_DD": 30,
      "BOS_NM": "王董事",
      "CNT_MAN1": "李四",
      "SAL": "0002",
      "TEL1": "12345678901",
      "ADR1": "广东珠海市吉大",
      "ADR2": "广东珠海市吉大",
      "CHK_FULL_PAY": "F",
      "CRD_ID": "3",
      "ID1_TAX": "2",
      "ID2_TAX": "F",
      "CLS1": "票据到期日:97-02-15结帐期:97-03-18",
      "CLS2": "1",
      "STR_DD": "2020-09-15 00:00:00",
      "CUS_LEVEL": "5",
      "CHK_CRD": "F",
      "CHK_MAN": "ADMIN",
      "SO_CRD": "F",
      "FP_NAME": "珠海集团C0001",
      "CHK_FAX": "F",
      "CHK_CUS_IDX": "1",
      "CY_ID": "F",
      "DEP": "103",
      "USR": "ADMIN",
      "CHK_INCLUDE": "F",
      "CHK_IRP": "F",
      "CHK_TRP": "F",
      "USR1": "ADMIN",
      "CHK_ZHANG_ID2": "T",
      "CHK_CK": "T",
      "FX_LEVEL": "1",
      "PAY_FLAG": "0",
      "TI_FROM": "1",
      "COUN_ID": 440402,
      "CITY_ID": "440400",
      "PROV_ID": "440000"
    }
  ]
}

返回结果示例

{
    "code": 0,              //为0表示执行成功,其他表示错误
    "message": "新增成功",           //提示信息
    "data": {
        "CUST": [                     //生成客户或厂商资料
            {
                "CUS_NO": "C0001",
                "SUP_LEVEL": "1",
                "OBJ_ID": "3",
                "NAME": "珠海集团C0001",
                "SNM": "珠海集团C0001",
                "CLS_MTH": "1",
                "CLS_DD": 1,
                "MM_END": 30,
                "CHK_DD": 30,
                "BOS_NM": "王董事",
                "CNT_MAN1": "李四",
                "SAL": "0002",
                "TEL1": "12345678901",
                "ADR1": "广东珠海市吉大",
                "ADR2": "广东珠海市吉大",
                "CHK_FULL_PAY": "F",
                "CRD_ID": "3",
                "ID1_TAX": "2",
                "ID2_TAX": "F",
                "CLS1": "票据到期日:97-02-15结帐期:97-03-18",
                "CLS2": "1",
                "STR_DD": "2020-09-15 00:00:00",
                "CUS_LEVEL": "5",
                "CHK_CRD": "F",
                "CHK_MAN": "ADMIN",
                "NAME_PY": "ZHJTC0001(ZHJTC0001)",
                "SO_CRD": "F",
                "FP_NAME": "珠海集团C0001",
                "CHK_FAX": "F",
                "CHK_CUS_IDX": "1",
                "CY_ID": "F",
                "DEP": "103",
                "USR": "ADMIN",
                "CHK_INCLUDE": "F",
                "CHK_IRP": "F",
                "CHK_TRP": "F",
                "CLS_DATE": "2020-09-05 00:00:00",
                "USR1": "ADMIN",
                "SYS_DATE": "2020-09-05 11:49:25",
                "LAST_CNT_DD": "2020-09-05 11:49:25",
                "CHK_ZHANG_ID2": "T",
                "CHK_CK": "T",
                "FX_LEVEL": "1",
                "PAY_FLAG": "0",
                "TI_FROM": "1",
                "COUN_ID": 440402,
                "CITY_ID": "440400",
                "PROV_ID": "440000"
            }
        ]
    }
}