简要描述：

  • 供应商创建接口

接口说明：

  • 1.1接口描述：创建ERP内供应商档案信息–(由SCM调用FMS接口,FMS再调用奇门OMS接口进行创建)
  • 1.2注意事项：如果供应商档案的供应商编码provider_no在系统中已经存在,供应商名称不存在,则为更新操作;
    如果供应商编码provider_no在系统中已经存在,供应商名称也存在,则会报出供应商名称已经存在的错误信息;
    如果二者都不存在则为创建操作。

接口版本：

版本号 制定人 制定日期 修订日期
1.0.0 黄会准 2020-07-20 2020-07-20

请求URL:

环境 HTTP地址
测试环境 http://apitest.yptcgroup.com/thirdpart/oms/basic/supplierCreate
预发布环境 http://apiuat.yptcgroup.com/thirdpart/oms/basic/supplierCreate
正式环境 http://api.yptcgroup.com/thirdpart/oms/basic/supplierCreate

请求方式：

  • POST

请求头：

参数名 是否必须 类型 说明
X-AUTH-TOKEN 是 string 令牌
Content-Type 是 string 请求类型,统一是 application/json

请求参数:

参数名 字段 是否必须 类型 长度 说明
供应商编号 provider_no 是 varchar 20 代表供应商所有属性的唯一编码，用于供应商区分，ERP内支持自定义（ERP供应商界面设置），用于创建供应商数据信息
供应商名称 provider_name 是 varchar 64 供应商名称
最小采购量 min_purchase_num 是 decimal (19,4) 最小采购量
采购周期 purchase_cycle_days 是 int 11 采购周期
到货周期 arrive_cycle_days 是 int 11 到货周期
联系人 contact 否 varchar 40 联系人
座机 telno 否 varchar 40 座机
移动电话 mobile 否 varchar 40 手机号
传真 fax 否 varchar 20 传真
邮编 zip 否 varchar 20 邮政编码
邮箱 email 否 varchar 64 电子邮箱
qq qq 否 varchar 20 腾讯QQ号码
旺旺 wangwang 否 varchar 64 淘宝旺旺号
地址 address 否 varchar 128 省、市、区（县）、地址详情
网址 website 否 varchar 128 供应商官网地址
停用 is_disabled 否 tinyint 1 是否停用
结算周期 charge_cycle_days 是 int 11 对供应商的账款结算周期，单位(天)，不传默认0

请求参数示例

{
    "provider_no": "FMS_TEST_100",
    "provider_name": "测试供应商--eptisond100",
    "min_purchase_num": 100,
    "purchase_cycle_days": 10,
    "arrive_cycle_days": 12,
    "charge_cycle_days": 10,
    "contact": "测试联系人",
    "telno": "66666666",
    "mobile": "888888888",
    "fax": "dsa",
    "zip": "421321",
    "email": "www.31313143424@qq.com",
    "qq": "31313143424",
    "wangwang": "联系人",
    "address": "浙江省杭州市滨江区西兴街道",
    "website": "www.website.com",
    "last_purchase_time": "2020-08-05",
    "is_disabled":1
}

返回参数说明:

参数名 字段 是否必须 类型 长度 说明
状态码 code 是 int 11 状态码:1表示成功,其他表示失败
返回信息 msg 是 varchar 255 错误原因
请求id requestId 是 varchar 255 请求后,返回唯一id(成功与否都会返回)
返回数据 data 是 object 请求成功后返回相应数据

data

参数名 字段 类型 说明
地址 address String 省、市、区（县）、地址详情
到货周期 arrive_cycle_days String 到货周期
结算周期 charge_cycle_days String 对供应商的账款结算周期，单位(天)
联系人 contact String 联系人
邮箱 email String 邮箱
传真 fax String 传真
停用 is_disabled String 是否停用
最后采购日期 last_purchase_time String 对供应商最后一次采购日期 格式：yyyy-MM-dd HH:mm:ss
最小采购量 min_purchase_num String 最小采购量
移动电话 mobile String 手机号
供应商名称 provider_name String 供应商名称
供应商编码 provider_no String 代表供应商所有属性的唯一编码，用于供应商区分
采购周期 purchase_cycle_days String 采购周期
qq qq String 腾讯QQ号码
座机 telno String 座机
旺旺 wangwang String 淘宝旺旺号
网址 website String 供应商官网地址
邮编 zip String 邮政编码

返回示例:

正确时返回:

{
    "code": "1",
    "data": {
        "address": "浙江省杭州市滨江区西兴街道",
        "arrive_cycle_days": 12,
        "charge_cycle_days": 10,
        "contact": "测试联系人",
        "email": "www.31313143424@qq.com",
        "fax": "dsa",
        "is_disabled": 0,
        "last_purchase_time": "2020-08-05 00:00:00",
        "min_purchase_num": 100.0000,
        "mobile": "888888888",
        "provider_name": "测试供应商--eptisond123",
        "provider_no": "FMS_TEST_123",
        "purchase_cycle_days": 10,
        "qq": "31313143424",
        "telno": "66666666",
        "wangwang": "联系人",
        "website": "www.website.com",
        "zip": "421321"
    },
    "flag": "success",
    "msg": "success",
    "requestId": "fec14589890340638c79312e719e65dc"
}

错误时返回:

{
    "code": "failure",
    "flag": "failure",
    "msg": "请求奇门接口失败",
    "requestId": "78fd8259ec2f4c22a8386c33e8f004d5",
    "subCode": "200003",
    "subMsg": "请求OMS奇门接口失败,失败原因【供应商名称在系统中已存在[provider_name]】"
}

备注:

  • 更多返回错误代码请看首页的错误代码描述
文档更新时间: 2026-06-17 09:44   作者：黄会准