生成【进货折让单】接口

概述

该接口主要用于第三方平台或自主研发者,通过调用【进货折让单】的生成接口,将第三方系统由于进货而产生的折让金额信息推送到Sunlike ERP或Online ERP系统中,从而生成Sunlike ERP或Online ERP系统的【进货折让单】。

参数说明

1.请求方式

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

2.header参数

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

3.请求参数

字段名称 字段代号 类型 长度 必填 固定值 备注
第三方单号 REF_NO       第三方单号,必填
程序代号 PGM     DRPPD  
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表MF_PSS
识别代号 PS_ID string 2 PD  
单号 PS_NO string 20   1.自动编码时,根据单据编码原则自动产生;
2.手工编码时,根据JSON的单据号码必填,且与REF_NO必须相同
3.目前删除和速查单据都只能通过online单号执行,不可以通过第三方单号,因此第三方须记录online单号
日期 PS_DD datetime       格式为:YYYY-MM-DD
客户代号 CUS_NO string 12    
部门代号 DEP string 8    
扣税类别 TAX_ID string 1   1.值分别为1;2;3
2.分别表示(1不计税 2应税内含 3应税外加)
立帐方式 ZHANG_ID string 1   1.值分别为1;2;3
2.分别表示(1单张立帐 2不立帐 3收到发票才立帐)
录入员 USR string 12   1.特殊密码权限读录入员的信息
付款日期 PAY_DD datetime       即是结账日期
票据日期 CHK_DD datetime       格式为:YYYY-MM-DD
贸易方式 TRAD_MTH string 20      
模板代号 VOH_ID string 2      
凭证号码 VOH_NO string 20     1.根据VOH_ID产生凭证号码;
2.同时考虑营业人资料控制:立即产生凭证、凭证立即过帐
发票号码 INV_NO string 20      
转入单号区分 OS_ID string 2      
转入单号 OS_NO string 25      
交货方式 SEND_MTH string 200      
交货仓 SEND_WH string 12      
币别 CUR_ID string 4      
汇率 EXC_RTO float        
业务员代号 SAL_NO string 12      
送货地址 ADR string 50      
备注 REM string 50      
交易方式 PAY_MTH string 1     默认为1
付款天数 PAY_DAYS Integer        
票据天数 CHK_DAYS Integer        
间隔天数 INT_DAYS Integer        
交易备注 PAY_REM string 80      
来源单号 BIL_NO string 20      
折扣 DIS_CNT float 0      
来源单ID BIL_ID string 2      
客户订单号 CUS_OS_NO string 30      
单据类别 BIL_TYPE string 10      
工程案号 CAS_NO string 20      
锁单人 LOCK_MAN string 12      
锁单时间 LOCK_DATE datetime 0      
销售员 CUST_YG string 12      
任务编号 TASK_ID Integer 0      
打印人员 PRT_USR string 12      
会员卡号 CARD_NO string 20      
到货确认否 CFM_ID string 1      
是否维修单 ISSVS string 1      
送货区域 SEND_AREA string 10      
数据表TF_PSS
识别代号 PS_ID string 2   必须与表头MF_PSS的PS_NO相同
单号 PS_NO string 20   必须与表头MF_PSS的PS_NO相同
项次 ITM Integer      
日期 PS_DD datetime      
库位 WH string 12    
批号 BAT_NO string 40      
转入单号 OS_NO string 25      
货品代号 PRD_NO string 30    
货品名称 PRD_NAME string 160      
货品特征 PRD_MARK string 100      
单位 UNIT string 1   如果为包装单位,保存后会换算为主单位数量进行扣减库存
数量 QTY float        
副单位数量 QTY1 float        
销售外币成本 CST_SAL float        
销售本位币成本 CSTN_SAL float        
单价 UP float        
未税本位币 AMTN_NET float        
外币金额 AMT float        
税额 TAX float        
折扣 DIS_CNT float        
已退数量 QTY_RTN float        
未审核已退数量 QTY_RTN_UNSH float 0      
预交日 EST_DD datetime 0      
税率 TAX_RTO float        
标准成本 CST_STD float        
副单位单价 UP_QTY1 float        
追踪已交数量项次 EST_ITM Integer        
转入单据ID OS_ID string 2      
截取受订数量 QTY_PS float        
追踪退回数量项次 PRE_ITM Integer        
金额 AMTN float        
搭赠注记 FREE_ID string 1      
出入库单号 CK_NO string 20      
出入库单项次 OTH_ITM Integer        
客户订单号 CUS_OS_NO string 30      
入库单号 RK_NO string 20      
对方货号 SUP_PRD_NO string 40      
已销货量(SB->SA) QTY_SB float 0      
未审核已销货量 QTY_SB_UNSH float 0      
关联入库单项次(PRE_ITM) TI_ITM Integer 0      
追踪检验单项次(PRE_ITM) QC_ITM Integer 0      
借入/借出来源ID BL_OS_ID string 2      
借入/借出来源单号 BL_OS_NO string 20      
借出/借入来源项次 BL_OS_ITM Integer 0      
入库日期 RK_DD datetime 0      
转非生产领料数量 QTY_XB float 0      
未审核已领料量 QTY_XB_UNSH float 0      
折扣额 AMT_DIS_CNT float 0      
单位标准成本 UP_STD float 0      
对方特征 SUP_PRD_MARK string 100      
储位代号 CHUW string 60      
已上架标志 CWSJ_Y string 1      
数据表INV_NO(发票资料档,有发票信息需输入)
发票号码 INV_NO string 20    
来源识别码 BIL_ID string 2 PD  
来源单号 BIL_NO string 20   进货折让单号
发票字轨 TRACK_ID string 2      
发票类别 INV_ID string 2      
发票日期 INV_DD datetime        
申报期别 INV_YM Integer        
客户代号 CUS_NO string 12      
买受人统一编号 UNI_NO_BUY string 20     纳税人编号
买  受  人  台  头 TITLE_BUY string 200      
营业人统一编号 UNI_NO_PAY string 20      
营  业  人  台  头 TITLE_PAY string 100      
销项 [进项] 金额 AMT float        
税额 TAX float        
税别( 应税1 零税2 免税3) TAX_ID1 string 1      
扣抵别(进货可扣1固资可扣3进货不可扣2 固资不可扣4) TAX_ID2 string 1      
备注 REM string 1000      
用户代号 USR string 12      
部门代号 DEP string 8      
输单日期 SYS_DATE datetime 0      
发票内容 INV_NR string 4      
发票抬头 INV_TT string 1      
购方地址 BUY_ADR string 0      
购方电话 BUY_TEL string 100      
购方开户银行 BUY_KH_BANK string 100      
购方银行帐号 BUY_ID_CODE string 30      
销方地址 SAL_ADR string 0      
销方电话 SAL_TEL string 20      
销方开户银行 SAL_KH_BANK string 40      
销方银行帐号 SAL_ID_CODE string 30      

请求JSON示例

{
  "REF_NO": "PD20082700000001",      //第三方单号,必填
  "PGM": "DRPPD",      //单据程序代号
  "MF_PSS": [      //新增单据表头信息
    {
      "PS_ID": "PD",
      "PS_NO": "PD20082700000001",
      "PS_DD": "2020-08-27 00:00:00",
      "PAY_DD": "2020-09-01 00:00:00",
      "CHK_DD": "2020-10-01 00:00:00",
      "CUS_NO": "C1000",
      "DEP": "001",
      "TAX_ID": "2",
      "ZHANG_ID": "3",
      "CUR_ID": "",
      "EXC_RTO": 1.0,
      "SAL_NO": "9999",
      "PAY_MTH": "1",
      "PAY_DAYS": 1,
      "CHK_DAYS": 30,
      "INT_DAYS": 30,
      "PAY_REM": "结帐期:2020-09-01;票据到期日:2020-10-01",
      "USR": "ADMIN",
      "BIL_TYPE": "",
      "REM": "API产生"
    }
  ],
  "TF_PSS": [      //新增单据表身信息
    {
      "PS_ID": "PD",
      "PS_NO": "PD20082700000001",
      "ITM": 1,
      "PS_DD": "2020-08-27 00:00:00",
      "WH": "9902",
      "PRD_NO": "0001",
      "PRD_NAME": "不粘锅",
      "PRD_MARK": "",
      "UNIT": "1",
      "TAX_RTO": 5.0,
      "UP_QTY1": 0.0,
      "AMTN_NET": 95.24,
      "AMT": 100.0,
      "PRE_ITM": 1,
      "CSTN_SAL": 95.24,
      "TAX": 4.76,
      "SPC": "4L",
      "CHK_TAX": "F",
      "CST_SAL": 100.0,
      "BAR_CODE": "",
      "PRD_NO_NO": "0001",
      "WH_QTY": 311.0,
      "UP_CST": 111.7738,
      "CST_STD_UNIT": 0.0,
      "SIZE__NAME": "",
      "GOOD__NAME": ""
    }
  ]
}

返回结果示例

{
    "code": 0,             //为0表示执行成功,其他表示错误
    "message": "新增成功",            //提示信息
    "data": {
        "MF_PSS": [                 //生成单据表头信息
            {
                "PS_ID": "PD",
                "PS_NO": "PD20082700000001",
                "PS_DD": "2020-08-27 00:00:00",
                "PAY_DD": "2020-09-01 00:00:00",
                "CHK_DD": "2020-10-01 00:00:00",
                "CUS_NO": "C1000",
                "DEP": "001",
                "TAX_ID": "2",
                "ZHANG_ID": "3",
                "CUR_ID": "",
                "EXC_RTO": 1.0,
                "SAL_NO": "9999",
                "PAY_MTH": "1",
                "PAY_DAYS": 1,
                "CHK_DAYS": 30,
                "INT_DAYS": 30,
                "PAY_REM": "结帐期:2020-09-01;票据到期日:2020-10-01",
                "USR": "ADMIN",
                "CHK_MAN": "ADMIN",
                "PRT_SW": "N",
                "CLS_DATE": "2020-08-27 00:00:00",
                "BIL_TYPE": "",
                "SYS_DATE": "2020-08-28 11:00:28",
                "REM": "API产生",
                "AMT": 0.0,
                "KP_ID": "F"
            }
        ],
        "TF_PSS": [              //生成单据表身信息
            {
                "PS_ID": "PD",
                "PS_NO": "PD20082700000001",
                "ITM": 1,
                "PS_DD": "2020-08-27 00:00:00",
                "WH": "9902",
                "PRD_NO": "0001",
                "PRD_NAME": "不粘锅",
                "PRD_MARK": "",
                "UNIT": "1",
                "TAX_RTO": 5.0,
                "UP_QTY1": 0.0,
                "AMTN_NET": 95.24,
                "AMT": 100.0,
                "PRE_ITM": 1,
                "CSTN_SAL": 95.24,
                "TAX": 4.76,
                "SPC": "4L",
                "CHK_TAX": "F",
                "CST_SAL": 100.0,
                "BAR_CODE": "",
                "PRD_NO_NO": "0001",
                "WH_QTY": 311.0,
                "UP_CST": 111.7738,
                "CST_STD_UNIT": 0.0
            }
        ]
    }
}