销售订单新建/编辑

错误码解释

异常码	异常消息	异常解决方案
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	目的港船上交货

产品单位枚举unit：

单位枚举
Bag
Short Ton
Pound
Piece
Pair
Ounce
Metric Ton
Meter
Long Ton
Kilometer
Ton
Square Meter
Cubic Meter
Dozen
Gallon
Kilogram
Gram
Bushel
Barrel
Set
Pack
Liter
Yard
Milligram
Unit
Acre
Ampere
Box
Carton
Case
Centimeter
Chain
Cubic Centimeter
Cubic Foot
Cubic Inch
Cubic Yard
Degrees Celsius
Degrees Fahrenheit
Dram
Fluid Ounce
Foot
Furlong
Gill
Grain
Hectare
Hertz
Inch
Kiloampere
Kilohertz
Kiloohm
Kilovolt
Kilowatt
Megahertz
Mile
Milliampere
Millihertz
Milliliter
Millimeter
Milliohm
Millivolt
Milliwatt
Nautical Mile
Ohm
Parcel
Perch
Pint
Pole
Quart
Quarter
Rod
Roll
Square Centimeter
Square Foot
Square Inch
Square Mile
Square Yard
Stone
Tonne
Tray
Volt
Watt
Wp
Twenty-Foot Container
Strand
Plant
Pallet
Gross
Forty-Foot Container
Sheet
Carat
Blade
Combo
Bottle
LB

订单特殊对接

注意！注意！

1、订单产品明细(product_list)不是必要的，并且接口不会自动创建非产品库中的产品。也不接受乱传入。若需要产品明细至少传入产品库的product_id和sku_id，否则乱传入非小满产品库id或者没有上述两个字段，则会忽略该明细。

2、若订单中存在多条产品明细，明细有相同的规格产品时，比如A，B记录都是相同的规格产品，可能在单价上存在差异，那么在新建订单后，获取返回值中的product_list的unique_id自行保留起来做好映射。下次编辑时需要带入，否则编辑时接口将会根据product_id、sku_id进行去重保留一条记录。（实际上小满使用unique_id作为唯一区别。删除明细的时候需要带入至少有unique_id，remove字段，举例：unique_id=123，remove=1，product_id=321，sku_id=456）。

3、订单中产品明细的金额小计(cost_amount)，与在小满web端不同的是，open接口不会主动计算，需要用户自己计算后传入，否则当成0重新保存。

4、处理人(handler)，新建时不传入则默认使用当前操作人(user_id)，而user_id不传入则使用获取token时的账号作为默认值。订单中用户和部门相关字段传入值是小满内的用户ID和部门ID。

5、订单状态(status)，状态值不通用也不是固定，每个企业有自己的状态ID，该字段的值必须来自/v1/invoices/order/orderEnums中的order_status_list的code，传入不是自己企业的订单状态或者乱传入可能订单变更失败，但不会有什么提示，即会忽略本次变更。

6、订单汇率（exchange_rate，exchange_rate_usd）和币种(currency)传入时，若只传入currency字段，没有exchange_rate字段时，系统会主动补充exchange_rate，exchange_rate_usd汇率的值，但是若传入exchange_rate字段，不管该字段有没有值都不会自动补充。我们只看有没有exchange_rate字段去取默认值。小满系统内记录的实际汇率都是乘了100的，比如订单是USD币种，那么exchange_rate_usd=100，则订单兑换人民币的应该是exchange_rate=710。乘100的逻辑需要用户自己计算后传入，系统不会自主处理。

请求参数

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
            }
        ]
    }
}