销售订单新建/编辑

错误码解释

异常码	异常消息	异常解决方案
404	Not Found Resource没有权限编辑XXX	若传入user_id字段，则会根据该用户ID校验用户是否有操作订单相关字段权限，若出现该错误可以到【角色权限中新增权限】或者【更改传入有订单权限的用户ID】

价格条款

需要对接 price_contract 价格条款字段的同学，临时参考下面价格条款传入对应的CODE，后面会维护在销售订单枚举接口中，目前小满CRM只下面几种：
传入例子：

{
     "price_contract": "EXW"
}

价格条款CODE	价格条款名称
EXW	卖方工厂交货
FOB	指定装运港船上交货
CFR	成本加运费
CIF	成本加运费保险费
DDU	未完税交货
DDP	完税后交货
FCA	货交承运人
CPT	运费付至
FAS	指定装运港船边交货
CIP	运费、保险费付至
DPU	卸货地交货
DEQ	目的港码头交货
DAP	目的地交货
DAF	边境交货
DE	目的港船上交货

订单产品特殊对接

注意！注意！若订单中存在多条明细，明细有相同的规格产品时，比如A，B记录都是相同的规格产品，可能在单价上存在差异，那么在新建订单后，获取返回值中的product_list的unique_id自行保留起来做好映射。下次编辑时需要带入，否则编辑时接口将会根据product_id进行去重保留一条记录。

请求参数

Header 参数

Body 参数application/json

示例

{
    "order_id": "",
    "order_no": "",
    "account_date": "2024-01-29",
    "name": "erp同步订单",
    "company_id": "3448551934",
    "customer_id": "3448551921",
    "currency": "USD",
    "users": [
        {
            "user_id": "11858712",
            "rate": 100
        }
    ],
    "departments":[{
                    "rate": 100,
                    "department_id": "148"
                }],
    "product_list": [
        {
            "product_id": "3495743811",
            "sku_id": "3495743812",
            "count": "10",
            "unit_price": "10",
            "cost_amount": "100"
        }
    ],
    "price_contract": "",
    "price_contract_remark": "",
    "receive_remittance_way": "",
    "receive_remittance_remark": "",
    "insurance_remark": "",
    "bank_info": "",
    "order_contract": "",
    "company_name": "中国宝安科技",
    "company_phone": "",
    "company_fax": "",
    "country": "",
    "company_address": "erp的公司地址",
    "opportunity_id": "",
    "shipment_deadline_remark": "",
    "customer_name": "阿嫲",
    "customer_phone": "1829383944",
    "customer_email": "am@am.com",
    "customer_address": "联系人地址",
    "transport_mode": "",
    "shipment_deadline": "",
    "shipment_port": "",
    "target_port": "",
    "more_or_less": "",
    "package_remark": "",
    "marked": "",
    "collection_date": "",
    "status_name": "",
    "collect_amount_rmb": "",
    "collect_amount_usd": "",
    "not_collect_amount_rmb": "",
    "not_collect_amount_usd": "",
    "percentage_rmb": "",
    "percentage_usd": "",
    "create_user": 11858712,
    "remark": "",
    "source_type": "",
    "tax_refund_type": "",
    "capital_account_id": "122",
    "status":12343455,
    "cost_list": [
        {
            "cost_name": "erp费用名称",
            "percent_type": "0",
            "percent_amount":"200" ,
            "cost_remark":"erp费用备注",
            "cost": 200
        }
    ],
    "file_list": [""],
    "12345677":"单选1",
    "12345678":["多选1","多选2"]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-sandbox.xiaoman.cn/v1/invoices/order/push' \
--header 'Authorization: access_token' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "order_id": "",
    "order_no": "",
    "account_date": "2024-01-29",
    "name": "erp同步订单",
    "company_id": "3448551934",
    "customer_id": "3448551921",
    "currency": "USD",
    "users": [
        {
            "user_id": "11858712",
            "rate": 100
        }
    ],
    "departments":[{
                    "rate": 100,
                    "department_id": "148"
                }],
    "product_list": [
        {
            "product_id": "3495743811",
            "sku_id": "3495743812",
            "count": "10",
            "unit_price": "10",
            "cost_amount": "100"
        }
    ],
    "price_contract": "",
    "price_contract_remark": "",
    "receive_remittance_way": "",
    "receive_remittance_remark": "",
    "insurance_remark": "",
    "bank_info": "",
    "order_contract": "",
    "company_name": "中国宝安科技",
    "company_phone": "",
    "company_fax": "",
    "country": "",
    "company_address": "erp的公司地址",
    "opportunity_id": "",
    "shipment_deadline_remark": "",
    "customer_name": "阿嫲",
    "customer_phone": "1829383944",
    "customer_email": "am@am.com",
    "customer_address": "联系人地址",
    "transport_mode": "",
    "shipment_deadline": "",
    "shipment_port": "",
    "target_port": "",
    "more_or_less": "",
    "package_remark": "",
    "marked": "",
    "collection_date": "",
    "status_name": "",
    "collect_amount_rmb": "",
    "collect_amount_usd": "",
    "not_collect_amount_rmb": "",
    "not_collect_amount_usd": "",
    "percentage_rmb": "",
    "percentage_usd": "",
    "create_user": 11858712,
    "remark": "",
    "source_type": "",
    "tax_refund_type": "",
    "capital_account_id": "122",
    "status":12343455,
    "cost_list": [
        {
            "cost_name": "erp费用名称",
            "percent_type": "0",
            "percent_amount":"200" ,
            "cost_remark":"erp费用备注",
            "cost": 200
        }
    ],
    "file_list": [""],
    "12345677":"单选1",
    "12345678":["多选1","多选2"]
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 200,
    "message": "success",
    "now": "2025-04-19 15:45:47",
    "data": {
        "order_id": 5223975283,
        "product_list": [
            {
                "unique_id": 5223975284,
                "product_name": "这是一个名称1",
                "product_no": "1",
                "product_model": "sky",
                "product_id": 3563404548,
                "sku_id": 3563404549,
                "count": 3,
                "unit_price": 10
            },
            {
                "unique_id": 5223975285,
                "product_name": "这是一个名称2",
                "product_no": "1",
                "product_model": "sky",
                "product_id": 3563404548,
                "sku_id": 3563404549,
                "count": 2,
                "unit_price": 7
            }
        ]
    }
}