Lingxing
切换旧版

添加/修改供应商

POST/erp/sc/routing/storage/supplier/edit

支持添加、修改供应商信息到系统【采购】>【供应商】中

接口信息

API Path请求协议请求方式令牌桶容量
/erp/sc/routing/storage/supplier/editHTTPSPOST1

请求参数

supplier_idstring
客户供应商id,为空或者对应的值不存在时，取sys_supplier_id【已停用】
sys_supplier_idinteger
系统供应商id，取该值且该值为空时，新增供应商
supplier_namestring必填
供应商名称
supplier_codestring
供应商编码【供应商代码只支持数字、英文字母、英文句号、-】
employeesinteger
员工数：
1=>少于50人
2=>50-150人
3=>150-500人
4=>500-1000人
5 =>1000人以上
urlstring
供应商网址
contact_personstring必填
联系人
备注：支持传空值
contact_numberstring必填
联系电话
备注：支持传空值
qqstring
QQ
emailstring
email
faxstring
传真
account_namestring
户名
open_bankstring
开户行
bank_card_numberstring
银行卡号
addressstring
详细地址
remarkstring
备注
levelinteger
级别：
1=>★
2=>★★
3=>★★★
4=>★★★★
5=>★★★★★,
settlement_methodinteger必填
结算方式：
7 现结
8 月结
settlement_descriptionstring
结算描述
payment_methodinteger
支付方式：
1=>网银转账
2=>网上支付
purchaserarray<any>
跟进人uid，最多支持10个
credit_codestring
统一社会信用代码
prepay_percentstring
预付比例
payment_account_grouparray<object>
收款账户列表
隐藏子属性
namestring必填
账户名称
account_namestring必填
户名
bank_namestring必填
开户行
account_idstring必填
账号
is_defaultinteger
是否默认
0=>否
1=>是
is_openinteger
是否开启
0=>否
1=>是
remarkstring
备注
keystring
编辑时必须
versionstring
编辑时必须

请求示例

{
    "supplier_id": 25,
    "supplier_name": "xxx",
    "supplier_code": "114514",
    "employees": 1,
    "url": "/xxxx/xxx",
    "contact_person": "小强",
    "contact_number": "15700000000",
    "qq": "1111111111",
    "email": "1111111111@qq.com",
    "fax": "123",
    "account_name": "1",
    "open_bank": "lingxxx",
    "bank_card_number": "123465",
    "address": "shenzhen",
    "remark": "gogogo",
    "level": "1",
    "settlement_method": 7,
    "settlement_description": "go go go!!!",
    "payment_method": 1,
    "purchaser": [154,623],
    "payment_account_group": [{
        "name": "",
        "account_name": "",
        "bank_name": "",
        "account_id": "",
        "is_default": 0,
        "is_open": "",
        "remark": "",
        "key": "",
        "version": ""
    }],
    "credit_code": "",
    "prepay_percent": ""
}

返回结果

Json Object

codeinteger必填
状态码，0 成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
错误信息
示例 []
request_idstring必填
请求链路id
示例 929A1D7D-D656-0EA0-C78A-A686790C7090
response_timestring必填
响应时间
示例 2022-05-20 16:57:03
dataarray<object>必填
响应数据
隐藏子属性
customer_supplier_idinteger必填
客户供应商ID【已停用】
示例 235
erp_supplier_idinteger必填
系统供应商ID
示例 238

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "BCB699A2-CEA9-FEDE-7DF3-28BCD3C71727",
    "response_time": "2021-11-11 19:25:38",
    "data": {
        "customer_supplier_id": "235",
        "erp_supplier_id": "238"
    }
}

返回失败示例

{
    "code": 500,
    "message": "内部错误",
    "error_details": "规模：员工数必须在 1,2,3,4,5 范围内 [请求码:1D58EB]",
    "request_id": "143E9E96-744E-CCDE-B31D-A00C697F3C8F",
    "response_time": "2021-11-11 19:21:56",
    "data": [],
    "total": 0
}

附加说明

  1. 客户供应商ID，指客户通过领星开放接口创建的供应商，在传值时向领星传入的供应商ID，用于记录客户系统供应商ID，仅支持从开放接口创建时录入，可为空；（已停用，新创建供应商不支持录入客户供应商ID，已有数据不受影响）
  2. 系统供应商ID，指领星ERP自动生成的供应商ID，唯一标识，每个供应商均有自己的系统ID；