C300-OpenAPI

创建销售订单

POST

/api/open/v2/salesOrders/create

请求参数

Body 参数application/json

body

object (SalesOrderSaveParams)

必需

code

string

订单编码

可选

workOrderCodes

array[string]

生产单编码

可选

staffCode

string

订单负责人编码

必需

addressCode

string

可选

订单收货地址。参考：客户-收货地址API

customerCode

string

客户编码

必需

deadline

integer <int64>

预计交期

可选

customerReqDeadLine

integer <int64>

客户要求交期

可选

needInvoice

integer

可选

是否需要开票
默认开发票

currency

string

币种默认CNY

可选

exchangeRate

string

汇率

可选

comments

string

订单备注

可选

paymentsCondition

string

付款条件

可选

hasSpecialPrice

integer

可选

是否有特价
默认开发票

specialPrice

number

特价特价金额

可选

customerOrderNumber

string

客户订单编号

可选

records

array[object (Detail) {3}]

订单明细

可选

extendedFieldList

array[object (OrderExtendFieldParam) {2}]

系统自定义字段

可选

bomVersion

string

bom版本

可选

priceType

integer

可选

单价类型
1含税 2不含税

示例

{
    "body": {
        "code": "SO-20240728-HW-001",
        "workOrderCodes": [
            "WO-20240720-X1-001",
            "WO-20240725-X1-002"
        ],
        "staffCode": "SALES-002",
        "addressCode": "ADDR-HW-SH-002",
        "customerCode": "CUST-HW-001",
        "deadline": 1723766400000,
        "customerReqDeadLine": 1723680000000,
        "needInvoice": 1,
        "currency": "CNY",
        "exchangeRate": "1.0",
        "comments": "华为P70主板紧急订单 | 优先生产等级A1",
        "paymentsCondition": "50%预付款+50%货到付款",
        "hasSpecialPrice": 1,
        "specialPrice": 880.00,
        "customerOrderNumber": "HW-P70-MB-0728",
        "records": [
            {
                "itemCode": "SMARTPHONE-X1-PLUS",
                "quantity": 5000,
                "batchNumber": "BATCH-MB-20240728"
            },
            {
                "itemCode": "IC-CHIP-5NM",
                "quantity": 5500,
                "batchNumber": "BATCH-20240726-5NM"
            }
        ],
        "extendedFieldList": [
            {
                "name": "包装要求",
                "value": "防静电真空包装"
            },
            {
                "name": "物流时效",
                "value": "48小时加急空运"
            }
        ],
        "bomVersion": "BOM-P70-V3.2",
        "priceType": 2
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sit.newcoretech.com/api/open/v2/salesOrders/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "body": {
        "code": "SO-20240728-HW-001",
        "workOrderCodes": [
            "WO-20240720-X1-001",
            "WO-20240725-X1-002"
        ],
        "staffCode": "SALES-002",
        "addressCode": "ADDR-HW-SH-002",
        "customerCode": "CUST-HW-001",
        "deadline": 1723766400000,
        "customerReqDeadLine": 1723680000000,
        "needInvoice": 1,
        "currency": "CNY",
        "exchangeRate": "1.0",
        "comments": "华为P70主板紧急订单 | 优先生产等级A1",
        "paymentsCondition": "50%预付款+50%货到付款",
        "hasSpecialPrice": 1,
        "specialPrice": 880.00,
        "customerOrderNumber": "HW-P70-MB-0728",
        "records": [
            {
                "itemCode": "SMARTPHONE-X1-PLUS",
                "quantity": 5000,
                "batchNumber": "BATCH-MB-20240728"
            },
            {
                "itemCode": "IC-CHIP-5NM",
                "quantity": 5500,
                "batchNumber": "BATCH-20240726-5NM"
            }
        ],
        "extendedFieldList": [
            {
                "name": "包装要求",
                "value": "防静电真空包装"
            },
            {
                "name": "物流时效",
                "value": "48小时加急空运"
            }
        ],
        "bomVersion": "BOM-P70-V3.2",
        "priceType": 2
    }
}'

返回响应

🟢200成功

application/json

Body

com.xinheyun.model.response.BaseResponse

code

integer

可选

message

string

可选

示例

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

查询企业地址

删除销售订单