生成【采购单】接口

概述

该接口主要用于第三方平台或自主研发者,通过调用【采购单】的生成接口,将第三方的采购订单的信息推送到Sunlike ERP或Online ERP系统中,从而生成Sunlike ERP或Online ERP系统的【采购单】。

参数说明

1.请求方式

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

2.header参数

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

3.请求参数

字段名称 字段代号 类型 长度 必填 固定值 备注
第三方单号 REF_NO       第三方单号,必填
程序代号 PGM     DRPPO  
字段名称 字段代号 类型 长度 必填 固定值 备注
数据表MF_POS
采购/受订区分 OS_ID string 2   值的范围:PO; SO(PO采购单;SO受订单)
单号 OS_NO string 20     1.自动编码时,根据单据编码原则自动产生;
2.手工编码时,根据JSON的单据号码必填,且与REF_NO必须相同
3.目前删除和速查单据都只能通过online单号执行,不可以通过第三方单号,因此第三方须记录online单号
批号 BAT_NO string 40      
采购/受订日期 OS_DD datetime     格式:YYYY-MM-DD
询价/报价转入单号 QT_NO string 25      
凭证模版代号 VOH_ID string 2      
凭证号码 VOH_NO string 20      
贸易方式 TRAD_MTH string 20      
交易类别 PAY_MTH string 1      
起算日 PAY_DAYS integer        
票据天数 CHK_DAYS integer        
交易摘要 PAY_REM string 80      
送货方式 SEND_MTH string 200      
送货仓 SEND_WH string 12      
预交日 EST_DD datetime        
客户/厂商代号 CUS_NO string 12    
业务员代号 SAL_NO string 12    
使用部门 USE_DEP string 8      
币别 CUR_ID string 4      
汇率 EXC_RTO float        
订金本位币金额 AMTN_INT float        
订金外币金额 AMT_INT float        
折扣 DIS_CNT float        
结案标志 CLS_ID string 1      
销货单/受订退回区分 BACK_ID string 2      
是否入历史单价 HIS_PRICE string 1      
送货地址 ADR string 0      
摘要 REM string 0      
采购部门 PO_DEP string 8      
原受订单号 PO_SO_NO string 25      
扣税类别(1不计税[√] 2应税内含 3应税外加) TAX_ID string 1    
结帐期 PAY_DD datetime        
票据到期日 CHK_DD datetime        
间隔天数 INT_DAYS integer        
录入员 USR string 12    
审核人 CHK_MAN string 12      
合同号 CONTRACT string 80      
打印注记 PRT_SW string 1      
拷贝注记(转入/转出) CPY_SW string 1      
来源单号 BIL_NO string 20      
转入单ID BIL_ID string 2      
出[入]库单结案标志 RK_CLS_ID string 1      
确认交期否 PRE_ID string 1      
终审日期 CLS_DATE datetime        
客户/厂商订单号 CUS_OS_NO string 30      
订金是否含税 HS_ID string 1      
单据类别 BIL_TYPE string 10      
合同编号 CNTT_NO string 40      
审核模版 MOB_ID string 10      
锁单人 LOCK_MAN string 12      
锁单时间 LOCK_DATE datetime 0      
订单等级代号 DJ_NO string 4      
附件张数 FJ_NUM integer        
工程案号 CAS_NO string 20      
输单日期 SYS_DATE datetime        
退回量影响请购量 SQ_ID string 1      
分销仓库 FX_WH string 12      
要货单号 YH_NO string 20      
依箱条码要货 BYBOX string 1      
任务编号 TASK_ID integer 0      
打印人员 PRT_USR string 12      
请购单号(受订转请购) SQ_NO string 20      
会员卡号 CARD_NO string 20      
送货区域 SEND_AREA string 10      
积分截止日期 JFEND_DD datetime 0      
三角转单注记 SG_ID string 30      
打印次数 PRT_NUM integer 0      
报销费用 AMTN_BX float 0      
是维修单 ISSVS string 1      
单据标记 BIL_MARK string 1      
是否紧急放行 CHK_FX string 1      
是否已经放行 HAS_FX string 1      
作废标记 CANCEL_ID string 1      
转单标志(三角贸易) SG_ID1 string 1      
来源帐套(三角贸易) BIL_COMP string 13      
到货确认否 CFM_SW string 1      
打印日期 PRT_DATE datetime 0      
立帐方式(1单张立帐[√] 2不立帐 3收到发票才立帐) ZHANG_ID string 1      
已转储值量 AMTN_CBAC_PS float 0      
秒杀/特供活动代号 ACT_NO string 20      
摊提方式设置 TT_TYPE_SET string 20      
开始摊提年月 TT_YM_B datetime 0      
是配送订单 ICOS_ID string 1      
联系人1 CNT_MAN1 string 20      
最近修改日期 MODIFY_DD datetime 0      
最近修改人 MODIFY_MAN string 12      
订单评审分析标志 CLS_ME_ID string 1      
品牌 MRK string 8      
促销代号 PRM_NO string 20      
促销ID CX_ID string 2      
促销单号 CX_NO string 20      
最后一次订单否(T或F) CHK_LATEST string 1      
订单来源(1.订单向导) SRC_ID string 1      
三角贸易转单(转入帐套设定) SG_BIL_COMP string 20      
依订单开票 SOKP string 1      
发货商 CUS_FH string 12      
发货部门 DEP_FH string 8      
所属分销商 CUS_FX string 12      
已核销金额 AMTN_HX float 0      
最大可核销金额 AMTN_HX_MAX float 0      
核销结算方式 HXJS_ID string 1      
缓存否 CHK_CACHE string 1      
要货订单全额定金 CHK_FULL_PAY string 1      
收货门店 GROUP_DEP string 8      
全额订金支付否 CHK_FULL_PAID string 1      
EC单号 EC_NO string 20      
加急订单 FLG_RUSH string 1      
主计划批次专案字段 BJ_NO_LB string 20      
柜号(联邦)专案字段 GH_NO_LB string 3      
配送方式 SEND_WAY string 8      
特价否 CHK_SPEPRI_HZ string 1      
数据表TF_POS
采购/受订区分 OS_ID string 2   必须与表头MF_POS的OS_ID相同
单号 OS_NO string 20     必须与表头MF_POS的OS_NO相同
项次 ITM integer 0    
转入单号 QT_NO string 25      
货品代号 PRD_NO string 30    
货品名称 PRD_NAME string 160      
货品特征 PRD_MARK string 100      
库位 WH string 12    
单位 UNIT string 1    
采购/受订日期 OS_DD datetime 0   必须与表头MF_POS的OS_NO相同
数量 QTY float 0      
单价 UP float 0      
折扣 DIS_CNT float 0      
外币金额 AMT float 0      
本位币金额 AMTN float 0      
税额 TAX float 0      
副单位数量 QTY1 float 0      
已交数量 QTY_PS float 0      
未审核已交量 QTY_PS_UNSH float 0      
已交副单位数量 QTY1_PS float 0      
未审核已交副数量 QTY1_PS_UNSH float 0      
预交日 EST_DD datetime 0      
包装单位 PAK_UNIT string 20      
包装换算 PAK_EXC float 0      
包装净重 PAK_NW float 0      
包装净重单位 PAK_WEIGHT_UNIT string 8      
包装毛重 PAK_GW float 0      
包装大小 PAK_MEAST float 0      
包装大小单位 PAK_MEAST_UNIT string 8      
有效期 VALID_DD datetime 0      
摘要 REM string 1000      
抽成金额 AMTN_COM float 0      
已分析注记(生产需求分析与采购需求分析) CLS_MP_ID string 1      
标准成本 CST_STD float 0      
副单位单价 UP_QTY1 float 0      
追踪已交数量项次 EST_ITM integer 0      
送货仓 SEND_WH string 12      
海关编码 CODE_NO string 10      
出入库累积数量 QTY_RK float 0      
未审核出入库累积 QTY_RK_UNSH float 0      
批号 BAT_NO string 40      
确认交期 PRE_EST_DD datetime 0      
已采购数量 QTY_PO float 0      
未审核采购数量 QTY_PO_UNSH float 0      
已退回数量 QTY_PRE float 0      
未审核已退回数量 QTY_PRE_UNSH float 0      
退回项次 PRE_ITM integer 0      
母件配方 ID_NO string 38      
已验收累积数量 QTY_YS float 0      
未审核验收累积 QTY_YS_UNSH float 0      
搭赠注记 FREE_ID string 1      
转入单ID BIL_ID string 2      
包装类型 BZ_KND string 20      
价格代号 PRICE_ID string 4      
转入单号项次 OTH_ITM integer 0      
税率 TAX_RTO float 0      
LC分配金额 AMT_LC float 0      
备品量 QTY_BACK float 0      
农副产品否 CHK_TAX string 1      
对方货号 SUP_PRD_NO string 40      
鞋服组合栏位 COMPOSE_IDNO string 50      
收料数量 QTY_SL float 0      
未审核收料数量 QTY_SL_UNSH float 0      
客户订单号 CUS_OS_NO string 30      
其它转入单ID OTH_ID string 2      
其它转入单号 OTH_NO string 20      
设置虚拟件 ISVIR string 1      
已合并计划单注记 JH_ID string 1      
发货量 QTY_FH float 0      
未审核发货量 QTY_FH_UNSH float 0      
发货方式 FH_NO string 2      
发货日期 FH_DD datetime 0      
已配送数量 QTY_IC float 0      
未审核已配送量 QTY_IC_UNSH float 0      
追踪箱条码 BOX_ITM integer 0      
柜数 QTY_ARK float 0      
已交柜数 QTY_PS_ARK float 0      
已退柜数 QTY_PRE_ARK float 0      
出库柜数 QTY_CK_ARK float 0      
麦头代号 MAI_NO string 60      
SCM确认人 SCM_USR string 12      
SCM确认日期 SCM_DD datetime 0      
已请购数量 QTY_SQ float 0      
未审核请购数量 QTY_SQ_UNSH float 0      
采购定价 UP_PO float 0      
请购单ID SQ_ID string 2      
请购单号 SQ_NO string 20      
请购单追踪项 SQ_ITM integer 0      
分柜数量1 QTY_FRAC1 float 0      
分柜数量2 QTY_FRAC2 float 0      
分柜数量3 QTY_FRAC3 float 0      
分柜数量4 QTY_FRAC4 float 0      
库存占用量SLS QTY_USE_WH float 0      
来源识别码(三角转单用) TRD_ID string 2      
来源单号(三角转单用) TRD_NO string 30      
来源单项次(三角转单用) TRD_ITM integer 0      
图片路径 PICPATH string 128      
强制退货标记 CHK_RTN string 1      
生产单号 MO_NO string 20      
生产单标识 MO_ID string 2      
保修卡号 WC_NO string 25      
维修建议(A.保外收费 B. 保内不收费 C. 换货 D.不维修) MTN_TYPE string 1      
永久保固 MTN_ALL_ID string 1      
保修日期 MTN_DD datetime 0      
包退日 RTN_DD datetime 0      
维修描述 MTN_REM string 0      
折扣额 AMT_DIS_CNT float 0      
来源单追踪项次 OTH_ITM1 integer 0      
是否定价政策搭赠品 FREE_ID_DEF string 1      
天心在线购买明细 ONLINESERVICE_XML string 0      
单位标准成本 UP_STD float 0      
已转S/C数量 QTY_AE float 0      
对方货名 SUP_PRD_NM string 100      
说明 DETAIL string 1      
淘宝子订单号 TB_OID string 20      
对方特征 SUP_PRD_MARK string 100      
促销活动代号 DEF_NO string 100      
矩阵项次 MATRIX_ITM integer 0      
拆分代号 CF_ID string 4      
摊提期间 TT_RNG integer 0      
摊提方式 TT_TYPE_IFRS string 1      
截止摊提年月 TT_YM_E datetime 0      
配送量 QTY_IO float 0      
未审核配送量 QTY_IO_UNSH float 0      
是样品 IS_SP string 1      
母件货品 MRP_NOS string 800      
来源配件申请单项次 OR_ITM integer 0      
责任分类代号 KIND_NO string 10      
标准模板代号 XPM_NO string 20      
自选模板代号 XPM_NO1 string 20      
自选产品对应的主产品项次 XPPRD_ITM integer 0      
对应选配模板表身的KEY_ITM XPPRD_ITM1 integer 0      
订单评审分析标志 CLS_ME_ID string 1      
销售总价 AMTN_SAL float 0      
阶段编号 TASK_NO string 30      
阶段编号 PRM_NO string 20      
已锁定量 QTY_LOCK float 0      
已出库的锁定量 QTY_LOCK_CK float 0      
未审核出库的锁定量 QTY_LOCK_CK_UNSH float 0      
货补否 CHK_REP string 1      
选配备注 REM_XP string 200      
促销类别 PROMO_ID string 2      
发货项目 BK_FH_SPC string 12      
关联 FRELATION string 40      
记录类型 RECORD_TYPE string 0      
备注说明码 ZP_BEIZSMM string 40      
商标 ZP_CHKVAL string 20      
表身唯一项次 KEY_ITM integer 0      
描述 REMARK string 300      
英文描述 REMARK_ENG string 300      
客户款号 CUS_KH_NO string 30      
收货门店 GROUP_DEP string 8      
已退回数量(副) QTY1_PRE float 0      
未审核已退回数量(副) QTY1_PRE_UNSH float 0      
包装数量 QTY_BZ float 0      
包装单位 UNIT_BZ string 8      
已锁定量(副) QTY1_LOCK float 0      
已出库的锁定量(副) QTY1_LOCK_CK float 0      
未审核出库的锁定量(副) QTY1_LOCK_CK_UNSH float 0      
客户使用机型 TYPE_CUS string 40 NULL    
安排日期 ARRANGE_DD datetime 0 NULL    
拆分合计 QTY_SUM_CZ float 0 NULL    
已分配非足量 QTY_HGFP float 0 NULL    
商城宝贝ID MALL_TID string 20      
是否拆分 ISSPLIT string 1      
已分配足米量 QTY_HGFP_ZM float 0 NULL    
柜号(联邦) GH_NO_LB string 3      
材质市价 UP_CZSJ float 0 NULL    
不确 认标记 UNCFM_ID string 1      
不确信理由 UNCFM_REM string 0      
不确认人 UNCFM_USR string 12      
不确认时间 UNCFM_DATE datetime 0      
未税单价 UP_NET float 0      
需加工否 JG_ID string 1      
加工结案否 JG_CLS string 1      
左右 LR_ID string 1      
调整金额 AMT_ABJ_FREE float 0      
整单优惠分摊 AMT_MJZ_CNT float 0      
返利单号 RG_NO string 20      
需门店调拨 IC_SW string 1      
不需回调商品 IC_SW1 string 1      
电商类别 SC_TYPE_ID string 4      
电商单号 SC_TB_NO string 20      
供应商回复交期1 SUP_REP_DATE1 datetime 0      
供应商回复交期2 SUP_REP_DATE2 datetime 0      
供应商回复交期3 SUP_REP_DATE3 datetime 0      
ONLINE回复交期备注 REP_REM string 200      
已开发票金额 AMT_FP2 float 0      
已开发票未税金额 AMTN_NET_FP2 float 0      
已开发票税额金额 TAX_FP2 float 0      
已开发票数量 QTY_FP2 float 0      
已开发票数量(副) QTY1_FP2 float 0      
单联标注 ID_DL string 1      
标准配方 BOM_NO_QDXYDZ string 38      
联体台数 QDXYDZ_N integer 0      
联体套数 QDXYDZ_M integer 0      
其他(WWSCase) REM_WWS string 600      
期望单价 UP_EXPECT float 0      
排单分析标志 CLS_PC_ID string 1      
装箱数量 QTY_X float 0      
缴库数量 QTY_JK float 0      
母件配方号 M_ID_NO string 40      
报价单号 BJ_NO string 20      
报价单项次 BJ_EST_ITM integer 0      
变更标志 FLAG_CHG string 1      
原配方 ID_NO_WWS string 38      
价格来源方式 GETUP_FROM string 2      
第三方单号 OTH_BIL_NO string 50      
第三方项次 OTH_BIL_ITM string 10      
已开票差异金额 AMT_ZG_FP2 float 0      
已开票未税差额 AMTN_NET_ZG_FP2 float 0      
已开票税金差额 TAX_ZG_FP2 float 0      
到货结案标志 CFM_CLS_ID string 1      
配件包代号 PJB_NO string 35      
按零组件发货 LZJFLAG string 1      
条码按来源单匹配标记 ISMATCHBIL string 1      
数据表TF_POS_RCV(收货讯息库,有收货信息时才需要输入)
采购/受订区分 OS_ID string 2    
单号 OS_NO string 20     必须与表头MF_POS的OS_NO相同
收货人 CON_MAN string 40      
发货单号 FH_NO string 20      
快递厂商 CUS_NO_KD string 12      
地址 ADR string 200      
邮编 ZIP string 10      
电话号码 TEL_NO string 40      
手机号码 CELL_NO string 40      
保存方式 RCV_CHK string 1      
发货地址代号 SEND_WH_KD string 20      
发票类型 INV_ID string 10      
发票内容 INV_NR string 4      
发票抬头 INV_TT string 1      
单位名称 DW_NAME string 80      
纳税人识别号 NSR_CODE string 30      
注册地址 ZC_ADR string 0      
银行帐号 ID_CODE string 30      
开户银行 KH_BANK string 40      
注册电话 ZC_TEL string 20      
收货人分仓代号 RCV_WH_KD string 12      
地址所属区/县代号 COUN_ID integer 0      
收货人电子邮件 RCV_E_MAIL string 50      
收货人传真 RCV_FAX string 20      
快件编号 EXPR_NUM string 20      
运输方式 TRAF_ID string 1      
快递费 AMT_EXPR float 0      
寄样日期 POST_DD datetime 0      
联系人 CNT_MAN string 60      
支付方式 PAID_TYPE string 20      
费用承担 PAY_ASS string 1      
收件人备注 REM string 200      
费用承担 COVER_ASS string 1      
消息发送注记 MSG_SW string 1      
短信发送时间 MSG_SDD datetime 0      
邮件发送时间 MSG_MDD datetime 0      
快递单打印否 PRT_SW string 1      
销售区域代号 AREA_NO string 20      
专卖店名称 SHOP_NAME string 100      
国家 COT_ID integer 0      
PROV_ID integer 0      
CITY_ID integer 0      
快递单打印时间 PRT_DATE datetime 0      
快递单打印人 PRT_USR string 12      
物流方式 SEND_MODE string 1      
运输方式 TRANSM string 2      
物流类型 LOGIST string 2      
产品编码 PRD_CODE string 12      
发票种类 INV_KIND string 1      
网点代号 KDCODE_ID string 32      
付款方式 DZPAY_TYPEID string 4      

请求JSON示例

{
  "REF_NO": "LJPO20081700000001",          //第三方单号,必输
  "PGM": "DRPPO",                     //单据程序代号
  "MF_POS": [                          //新增单据表头信息
    {
      "OS_ID": "PO",
      "OS_NO": "PO20081700000001",
      "OS_DD": "2020-08-17 00:00:00",
      "CUS_NO": "C1000",
      "SAL_NO": "0001",
      "EST_DD": "2020-08-17 00:00:00",
      "TAX_ID": "2",
      "BIL_TYPE": "01",
      "REM": "API生产",
      "PAY_MTH": "1",
      "PAY_DAYS": 1,
      "CHK_DAYS": 30,
      "PAY_REM": "结帐期:2020-09-01;票据到期日:2020-10-01",
      "SEND_MTH": "1",
      "DIS_CNT": 0.0,
      "PO_DEP": "001",
      "PAY_DD": "2020-09-01 00:00:00",
      "CHK_DD": "2020-10-01 00:00:00",
      "INT_DAYS": 30,
      "USR": "0001",
      "TOT_QTY": 200.0,
      "HIS_PRICE": "T",
      "LJ_PO1":"AAAAAAAAAA"             //新增单据表头自定义栏位信息
    }
  ],
  "TF_POS": [                          //新增单据表身信息
    {
      "OS_ID": "PO",
      "OS_NO": "PO20081700000001",
      "ITM": 1,
      "PRD_NO": "00221",
      "PRD_NAME": "00221制程一原料",
      "PRD_MARK": "0101",
      "WH": "002",
      "UNIT": "1",
      "QTY": 100.0,
      "UP": 2.0,
      "AMT": 200.0,
      "AMTN": 190.48,
      "TAX_RTO": 5.0,
      "TAX": 9.52,
      "QTY1": 200.0,
      "UP_QTY1": 1.0,
      "EST_DD": "2020-08-17 00:00:00",
      "CST_STD": 0.0,
      "EST_ITM": 1,
      "CUS_OS_NO": "",
      "UNCFM_ID": "F",
      "GROUP_DEP": "",
      "BAR_CODE": "",
      "SUP_PRD_NO": "",
      "SUP_PRD_NM": "",
      "SUP_PRD_MARK": "",
      "UP_PO": 0.0,
      "GETUP_FROM": "0",
      "CHK_TAX": "F",
      "CST_STD_UNIT": 0.0,
      "PRD_NO_NO": "00221",
      "WLGL_UP": "0.0000",
      "SIZE": "01",
      "GOOD": "01",
      "SIZE__NAME": "S码",
      "GOOD__NAME": "标准",
      "LJ_PO2":1.0                     //新增单据表身信息
    }
  ]
}

返回结果示例

{
  "code": 0,                          //为0表示执行成功,其他表示错误
  "message": "新增成功",       //提示信息
  "data": {
    "MF_POS": [               //生成单据表头信息
      {
        "OS_ID": "PO",
        "OS_NO": "PO20081700000001",
        "OS_DD": "2020-08-17 00:00:00",
        "CUS_NO": "C1000",
        "SAL_NO": "0001",
        "EST_DD": "2020-08-17 00:00:00",
        "TAX_ID": "2",
        "BIL_TYPE": "01",
        "REM": "API生产",
        "PAY_MTH": "1",
        "PAY_DAYS": 1,
        "CHK_DAYS": 30,
        "PAY_REM": "结帐期:2020-09-01;票据到期日:2020-10-01",
        "SEND_MTH": "1",
        "DIS_CNT": 0.0,
        "PO_DEP": "001",
        "PAY_DD": "2020-09-01 00:00:00",
        "CHK_DD": "2020-10-01 00:00:00",
        "INT_DAYS": 30,
        "USR": "0001",
        "PRT_SW": "N",
        "EXC_RTO": 1.0,
        "TOT_QTY": 200.0,
        "SYS_DATE": "2020-08-17 17:12:05",
        "HS_ID": "F",
        "HIS_PRICE": "T",
        "PRE_ID": "F",
        "MOB_ID": "01",
        "LJ_PO1": "AAAAAAAAAA"
      }
    ],
    "TF_POS": [                //生成单据表身信息
      {
        "OS_ID": "PO",
        "OS_NO": "PO20081700000001",
        "ITM": 1,
        "PRD_NO": "00221",
        "PRD_NAME": "00221制程一原料",
        "PRD_MARK": "0101",
        "WH": "002",
        "UNIT": "1",
        "QTY": 100.0,
        "UP": 2.0,
        "AMT": 200.0,
        "AMTN": 190.48,
        "TAX_RTO": 5.0,
        "TAX": 9.52,
        "PRE_ITM": 1,
        "QTY1": 200.0,
        "UP_QTY1": 1.0,
        "EST_DD": "2020-08-17 00:00:00",
        "CST_STD": 0.0,
        "OS_DD": "2020-08-17 00:00:00",
        "EST_ITM": 1,
        "CUS_OS_NO": "",
        "UNCFM_ID": "F",
        "GROUP_DEP": "",
        "SCM_USR": "0001",
        "SCM_DD": "2020-08-17 00:00:00",
        "BAR_CODE": "",
        "SUP_PRD_NO": "",
        "SUP_PRD_NM": "",
        "SUP_PRD_MARK": "",
        "UP_PO": 0.0,
        "GETUP_FROM": "0",
        "CHK_TAX": "F",
        "CST_STD_UNIT": 0.0,
        "PRD_NO_NO": "00221",
        "WLGL_UP": "0.0000",
        "LJ_PO2": 1.0
      }
    ],
    "MF_POS_Z": [              //生成单据表头自定义栏位信息
      {
        "LJ_PO1": "AAAAAAAAAA",
        "OS_ID": "PO",
        "OS_NO": "PO20081700000001"
      }
    ],
    "TF_POS_Z": [                //生成单据表身自定义栏位信息
      {
        "LJ_PO2": 1.0,
        "OS_ID": "PO",
        "OS_NO": "PO20081700000001",
        "ITM": 1
      }
    ]
  }
}