探马OpenAPI

创建客户商机

POST

/api/v3/opportunity/add

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

salesId

integer

销售id

可选

客户负责人

customerId

integer

客户id

必需

name

string

商机名称

必需

限定字符长度为21

oppTypeId

number

商机类型id

必需

stage

integer

销售阶段id

必需

不要传输单、无效。

expectedDealTime

string

预计成交时间

必需

yyyy-MM-dd HH:mm:ss

expectedDealAmount

integer

预计成交金额

必需

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

fields

array [object {2}]

客户商机字段

必需

从商机设置接口读取

fieldId

integer

商机字段id

必需

value

string

商机字段值

必需

单行文本时，最大字符长度为50；多行文本时，最大字符长度为min(设置字符长度，1000)

commodities

array [object {10}]

客户商机关联商品

可选

banner

string

封面

可选

spuId

integer

商品id

必需

spuTitle

string

商品名称

可选

skuId

integer

商品规格id

必需

skuDetail

string

规格明细

可选

unitPriceOrigin

number

商品划线单价

可选

unitPriceSale

number

商品销售单价

必需

count

integer

数量

必需

totalAmount

integer

商品总售价

可选

totalAmountFinal

integer

最终总售价

可选

可以是直接修改的总售价（不提供折扣数）。如果提供了折扣，后台将忽略传入的最终总售价，按照总售价和折扣重新计算最终总售价。

示例

{
  "salesId": 444256224170048,
  "customerId": 473309460299840,
  "name": "1111111111111111111111111111111123而是哈哈哈哈哈哈哈哈哈哈哈",
  "stage": 447253093488704,
  "expectedDealTime": "2022-04-30 00:00:00",
  "expectedDealAmount": 5,
  "fields": [
    {
      "fieldId": "464217610952640",
      "value": "[]"
    },
    {
      "fieldId": "463149358395456",
      "value": ""
    },
    {
      "fieldId": "471679616186305",
      "value": ""
    },
    {
      "fieldId": "471863808317376",
      "value": ""
    }
  ],
  "commodities": [
    {
      "banner": "https://dev.tanmarket.cn/fdfsServer/group1/M00/2B/37/rBHTdWHig7mAVIVdAAJw3D-ggjY183.jpg",
      "spuId": 460710335281216,
      "spuTitle": "分销分销分销",
      "skuId": 460710335313984,
      "skuDetail": "{\"id\": null, \"detail\": \"统一规格\"}",
      "unitPriceOrigin": 5,
      "unitPriceSale": 5,
      "count": 1,
      "totalAmount": 5,
      "totalAmountFinal": 5
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/opportunity/add' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "salesId": 444256224170048,
    "customerId": 473309460299840,
    "name": "1111111111111111111111111111111123而是哈哈哈哈哈哈哈哈哈哈哈",
    "stage": 447253093488704,
    "expectedDealTime": "2022-04-30 00:00:00",
    "expectedDealAmount": 5,
    "fields": [
        {
            "fieldId": "464217610952640",
            "value": "[]"
        },
        {
            "fieldId": "463149358395456",
            "value": ""
        },
        {
            "fieldId": "471679616186305",
            "value": ""
        },
        {
            "fieldId": "471863808317376",
            "value": ""
        }
    ],
    "commodities": [
        {
            "banner": "https://dev.tanmarket.cn/fdfsServer/group1/M00/2B/37/rBHTdWHig7mAVIVdAAJw3D-ggjY183.jpg",
            "spuId": 460710335281216,
            "spuTitle": "分销分销分销",
            "skuId": 460710335313984,
            "skuDetail": "{\"id\": null, \"detail\": \"统一规格\"}",
            "unitPriceOrigin": 5,
            "unitPriceSale": 5,
            "count": 1,
            "totalAmount": 5,
            "totalAmountFinal": 5
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

integer

客户商机id

必需

示例

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

获取商机列表

修改客户商机