生成【进货退回单】接口

概述

该接口主要用于第三方平台或自主研发者,通过调用【进货退回单】的生成接口,将第三方进货退回的货品相关信息推送到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     DRPPB  
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表MF_PSS
识别代号 PS_ID string 2 PB  
单号 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     来源单时必须填写,ID有SO,CK,SB,FH,OM
转入单号 OS_NO string 25     1、来源单时必须填写单号;
2、多张来源单时格式为【最小单号-N】,N为单号张数,如【PC200716001-2】表示两张来源出库单号。
交货方式 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     值为T或F
是否维修单 ISSVS string 1     值为T或F
送货区域 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       AMT必须等于QTY*UP*DIS_CNT-AMT_DIS_CNT,否则不允许通过
税额 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 PB  
来源单号 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": "PB20081800000001",          //第三方单号,必填
  "PGM": "DRPPB",             //单据程序代号
  "MF_PSS": [             //新增单据表头信息
    {
      "MOB_ID": "",
      "PS_ID": "PB",
      "PS_NO": "PB20081800000001",
      "PS_DD": "2020-08-18 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": "1",
      "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": "",
      "TOT_QTY": 5.0,
      "AMT": 610.0,
      "LJ_PB1": "外部单据"            //新增单据表头自定义栏位信息
    }
  ],
  "TF_PSS": [               //新增单据表身信息
    {
      "PS_ID": "PB",
      "PS_NO": "PB20081800000001",
      "ITM": 1,
      "PS_DD": "2020-08-18 00:00:00",
      "WH": "9902",
      "PRD_NO": "0001",
      "PRD_NAME": "不粘锅",
      "PRD_MARK": "",
      "UNIT": "1",
      "TAX_RTO": 5.0,
      "QTY": 5.0,
      "UP": 122.0,
      "AMTN_NET": 580.95,
      "AMT": 610.0,
      "CST_STD": 0.0,
      "PRE_ITM": 1,
      "CSTN_SAL": 580.95,
      "TAX": 29.05,
      "SPC": "4L",
      "CHK_TAX": "F",
      "UP_MAIN": 122.0,
      "CST_SAL": 610.0,
      "BAR_CODE": "",
      "PRD_NO_NO": "0001",
      "UP_CST": 111.7694,
      "CST_STD_UNIT": 0.0,
      "LJ_PB2": 10.0,                    //新增单据表身自定义栏位信息
      "SIZE__NAME": "",
      "GOOD__NAME": ""
    }
  ]
}

返回结果示例

{
  "code": 0,                      //为0表示执行成功,其他表示错误
  "message": "新增成功",          //提示信息
  "data": {
    "MF_PSS": [                 //生成单据表头信息
      {
        "MOB_ID": "",
        "PS_ID": "PB",
        "PS_NO": "PB20081800000001",
        "PS_DD": "2020-08-18 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": "1",
        "CUR_ID": "",
        "EXC_RTO": 1.0,
        "SAL_NO": "9999",
        "ARP_NO": "AP20081800000001",
        "ARP_DD": "2020-08-20 00:00:00",
        "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-18 00:00:00",
        "BIL_TYPE": "",
        "SYS_DATE": "2020-08-20 12:09:35",
        "TOT_QTY": 5.0,
        "AMT": 610.0,
        "KP_ID": "F",
        "LJ_PB1": "外部单据"
      }
    ],
    "TF_PSS": [                    //生成单据表身信息
      {
        "PS_ID": "PB",
        "PS_NO": "PB20081800000001",
        "ITM": 1,
        "PS_DD": "2020-08-18 00:00:00",
        "WH": "9902",
        "PRD_NO": "0001",
        "PRD_NAME": "不粘锅",
        "PRD_MARK": "",
        "UNIT": "1",
        "TAX_RTO": 5.0,
        "QTY": 5.0,
        "UP": 122.0,
        "AMTN_NET": 580.95,
        "AMT": 610.0,
        "CST_STD": 0.0,
        "PRE_ITM": 1,
        "CSTN_SAL": 580.95,
        "TAX": 29.05,
        "SPC": "4L",
        "CHK_TAX": "F",
        "UP_MAIN": 122.0,
        "CST_SAL": 610.0,
        "BAR_CODE": "",
        "PRD_NO_NO": "0001",
        "WH_QTY": 326.0,
        "CW_QTY": 0.0,
        "UP_CST": 111.7694,
        "CST_STD_UNIT": 0.0,
        "LJ_PB2": 10.0
      }
    ],
    "MF_PSS_Z": [                     //生成单据表头自定义栏位信息
      {
        "LJ_PB1": "外部单据",
        "PS_ID": "PB",
        "PS_NO": "PB20081800000001"
      }
    ],
    "TF_PSS_Z": [                     //生成单据表身自定义栏位信息
      {
        "LJ_PB2": 10.0,
        "PS_ID": "PB",
        "PS_NO": "PB20081800000001",
        "ITM": 1
      }
    ]
  }
}