探马OpenAPI

修改客户商机

POST

/api/v3/opportunity/update

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

salesId

integer

销售id

必需

customerId

integer

客户id

必需

name

string

商机名称

必需

限制21字符

stage

integer

销售阶段id

必需

expectedDealTime

string

预计成交时间

必需

yyyy-MM-dd HH:mm:ss

expectedDealAmount

integer

预计成交金额

必需

如果提供了关联商品，后台将忽略传入的预计成交金额，使用关联商品的最终总售价重新计算预计成交金额

fields

array [object {2}]

客户商机字段

必需

fieldId

string

字段id

必需

value

string

字段值

必需

commodities

array [object {11}]

客户商机关联商品

必需

string

关联id

可选

为空时表示新增商品，不为空时表示修改商品信息

banner

string

可选

spuId

integer

必需

spuTitle

string

可选

skuId

integer

必需

skuDetail

string

可选

unitPriceOrigin

number

可选

unitPriceSale

number

必需

count

integer

必需

totalAmount

integer

可选

totalAmountFinal

integer

可选

customerOpportunityId

integer

客户商机id

必需

示例

{
  "salesId": 0,
  "customerId": 0,
  "name": "string",
  "stage": 0,
  "expectedDealTime": "string",
  "expectedDealAmount": 0,
  "fields": [
    {
      "fieldId": "string",
      "value": "string"
    }
  ],
  "commodities": [
    {
      "id": "string",
      "banner": "string",
      "spuId": 0,
      "spuTitle": "string",
      "skuId": 0,
      "skuDetail": "string",
      "unitPriceOrigin": 0,
      "unitPriceSale": 0,
      "count": 0,
      "totalAmount": 0,
      "totalAmountFinal": 0
    }
  ],
  "customerOpportunityId": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/opportunity/update' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "salesId": 0,
    "customerId": 0,
    "name": "string",
    "stage": 0,
    "expectedDealTime": "string",
    "expectedDealAmount": 0,
    "fields": [
        {
            "fieldId": "string",
            "value": "string"
        }
    ],
    "commodities": [
        {
            "id": "string",
            "banner": "string",
            "spuId": 0,
            "spuTitle": "string",
            "skuId": 0,
            "skuDetail": "string",
            "unitPriceOrigin": 0,
            "unitPriceSale": 0,
            "count": 0,
            "totalAmount": 0,
            "totalAmountFinal": 0
        }
    ],
    "customerOpportunityId": 0
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

null

必需

示例

成功示例异常示例

{
  "code": 0,
  "message": "success",
  "data": null
}

创建客户商机

查询客户商机