C300-OpenAPI

新增或修改客户

POST

/api/open/v2/customers/createOrUpdate

请求参数

Body 参数application/json

body

object (CustomerSaveParam)

必需

code

string

编码

必需

name

string

名称

必需

procurementTaxRate

number | null

采购税率

可选

staffCodes

array[string] | null

员工编码

可选

contacts

string

联系人

必需

countryCode

string | null

国家(地区)编号

可选

country

string | null

所在地区-国家

可选

province

string | null

所在地区-省份

可选

city

string | null

所在地区-城市

可选

district

string | null

所在地区-区域

可选

defaultPayCondition

string | null

默认付款条件

可选

zipcode

integer | null

邮编

可选

categoryCode

string | null

分类码

可选

fax

string | null

传真

可选

string | null

可选

mobilePhone

string | null

手机

可选

phone

string | null

电话

可选

address

string | null

详细地址

可选

comment

string | null

备注

可选

currency

string | null

可选

往来币种
默认是CNY

bankAccount

string | null

银行账户

可选

bankAccountName

string | null

开户名称

可选

bankName

string | null

开户银行

可选

invoice

string | null

发票抬头

可选

invoiceAddress

string | null

开票地址

可选

invoicePhone

string | null

开票电话

可选

taxNum

string | null

纳税人识别号

可选

trade

string | null

行业

可选

attachmentInfo

array[object (AttachmentDTO) {6}] | null

附件信息

可选

示例

{
  "body": {
    "code": "string",
    "name": "string",
    "procurementTaxRate": 0,
    "staffCodes": [
      "string"
    ],
    "contacts": "string",
    "countryCode": "string",
    "country": "string",
    "province": "string",
    "city": "string",
    "district": "string",
    "defaultPayCondition": "string",
    "zipcode": 0,
    "categoryCode": "string",
    "fax": "string",
    "email": "string",
    "mobilePhone": "string",
    "phone": "string",
    "address": "string",
    "comment": "string",
    "currency": "string",
    "bankAccount": "string",
    "bankAccountName": "string",
    "bankName": "string",
    "invoice": "string",
    "invoiceAddress": "string",
    "invoicePhone": "string",
    "taxNum": "string",
    "trade": "string",
    "attachmentInfo": [
      {
        "uid": "string",
        "url": "string",
        "type": "string",
        "name": "string",
        "size": 0,
        "status": "string"
      }
    ]
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://c2.xinheyun.com/api/open/v2/customers/createOrUpdate' \
--header 'Content-Type: application/json' \
--data-raw '{
    "body": {
        "code": "string",
        "name": "string",
        "procurementTaxRate": 0,
        "staffCodes": [
            "string"
        ],
        "contacts": "string",
        "countryCode": "string",
        "country": "string",
        "province": "string",
        "city": "string",
        "district": "string",
        "defaultPayCondition": "string",
        "zipcode": 0,
        "categoryCode": "string",
        "fax": "string",
        "email": "string",
        "mobilePhone": "string",
        "phone": "string",
        "address": "string",
        "comment": "string",
        "currency": "string",
        "bankAccount": "string",
        "bankAccountName": "string",
        "bankName": "string",
        "invoice": "string",
        "invoiceAddress": "string",
        "invoicePhone": "string",
        "taxNum": "string",
        "trade": "string",
        "attachmentInfo": [
            {
                "uid": "string",
                "url": "string",
                "type": "string",
                "name": "string",
                "size": 0,
                "status": "string"
            }
        ]
    }
}'

返回响应

🟢200成功

application/json

Body

com.xinheyun.model.response.BaseResponse

code

integer

可选

message

string

可选

示例

{
  "code": 0,
  "message": ""
}

删除客户

查询客户