天心天思数字化API平台

生成【进货退回单】接口

概述

该接口主要用于第三方平台或自主研发者，通过调用【进货退回单】的生成接口，将第三方进货退回的货品相关信息推送到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
      }
    ]
  }
}