简要描述：

  • 供应商查询接口

接口说明：

  • 1.1接口描述：查询ERP内供应商档案信息–(由SCM调用FMS接口,FMS再调用奇门OMS接口进行查询)
  • 1.2注意事项：该接口最终是查询OMS系统中的供应商信息

接口版本：

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

请求URL:

环境 HTTP地址
测试环境 http://apitest.yptcgroup.com/thirdpart/oms/basic/supplierQuery
预发布环境 http://apituat.yptcgroup.com/thirdpart/oms/basic/supplierQuery
正式环境 http://apit.yptcgroup.com/thirdpart/oms/basic/supplierQuery

请求方式：

  • POST

请求头：

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

请求参数:

参数名 字段 是否必须 类型 长度 说明
供应商编号 provider_no 否 varchar 代表供应商所有属性的唯一编码，用于供应商区分，ERP内支持自定义（ERP供应商界面设置），用于创建供应商数据信息
供应商名称 provider_name 否 varchar 供应商名称（ERP内自定义的名称）
分页大小 page_size 否 int 每页返回的数据条数，输入值范围1~100，不传本参数，输入值默认为100
页号 page_no 否 int 不传值默认从0页开始

请求参数示例

{
    "provider_no": "FMS_TEST_001",
    "provider_name": "测试供应商--eptisond1"
}

返回参数说明:

参数名 字段 是否必须 类型 长度 说明
状态码 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 邮政编码
删除时间戳 deleted int 删除时间戳,1970年至删除时间的时长
最后修改时间 modified date 最后修改时间,格式：yyyy-MM-dd HH:mm:ss
创建时间 create date 创建时间,格式：yyyy-MM-dd HH:mm:ss

返回示例:

正确时返回:

{
    "code": "1",
    "data": [
        {
            "address": "浙江省杭州市滨江区西兴街道",
            "arrive_cycle_days": 12,
            "charge_cycle_days": 10,
            "contact": "测试联系人",
            "created": "2020-08-05 14:52:07",
            "deleted": 0,
            "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",
            "modified": "2020-08-05 14:52:07",
            "provider_name": "测试供应商--eptisond123",
            "provider_no": "FMS_TEST_124",
            "purchase_cycle_days": 10,
            "qq": "31313143424",
            "telno": "66666666",
            "wangwang": "联系人",
            "website": "www.website.com",
            "zip": "421321"
        }
    ],
    "flag": "success",
    "msg": "success",
    "requestId": "657acfabaa654599a1babe981c8b698e"
}

错误时返回:

{
    "errcode": 500,
    "errmsg": "invalid appid"
}

备注:

  • 更多返回错误代码请看首页的错误代码描述
文档更新时间: 2020-08-07 15:21   作者：黄会准