订单创建
概述
订单API支持您直接向Waldom创建并提交订单。该API专为无缝集成至现有ERP系统或网站而设计，可实现高效订单处理。
重要提示：创建订单前，您必须在公司账户中保存结账配置文件。此举可确保订单处理所需的所有必要信息已准备就绪。
有效字符范围：本API仅接受标准英文字符输入，具体为大小写字母A-Z。输入内容不得包含任何音标符号或特殊字符（如变音符号ä、ö、ü等非ASCII字符）。请确保所有输入数据严格遵守这些字符限制，以避免处理过程中出现任何问题。
请求参数
| Parameter | Description | Required |
|---|---|---|
| buyer email | The email address of the customer to be associated to the sales order | yes |
|
purchase order number
|
The customer order unique alphanumeric identifier. | yes |
|
on hold
|
On hold orders will not be processed untill they are released, allowed values: true,false. Blank is equivalent to false. | |
| shipping method | Check available shipping methods for possible values. If your account is setup with a default shipping method and this field is blank; the default shipping method will be selected. Shipping methods availability depends on the order shipping country. | yes |
|
shipping account No
|
Blank if not shipping with freight account number | |
|
other shipping carrier
|
Blank if shipping with listed carriers | |
|
invoice CC email
|
||
|
invoice CC email 2
|
||
|
notify when shipped
|
To receive email notification when order is shipped | |
|
ADM use
|
Is any product specifically earmarked for Aerospace, Defense, or Marine (ADM) end use | |
|
backorder option
|
1=order complete 2=line complete 3=split leav 0 for default | |
| shippingAddress | The shipping address for the order | yes |
| shippingAddress.company | The company name to be used for the ship-to address | yes |
| shippingAddress.countryTwoletterISOCode | The two character country code to be used for the ship-to address (e.g. US) | yes |
| shippingAddress.stateProvinceAbbreviation | The state or province to be used for the ultimate destination address | yes |
| shippingAddress.city | The city to be used for the ship-to address | yes |
| shippingAddress.address1 | The first address to be used for the ship-to address | yes |
| shippingAddress.address2 | The second address to be used for the ship-to address | |
| shippingAddress.zipPostalCode | The postal code to be used for the ship-to address | yes |
| shippingAddress.attention | The Attention to be used for the ship-to address | |
| paymentMethod | The payment method to pay for the order. Login to see payment methods possible values. | yes |
| order comment | Comment of the currently selected order | |
|
shipping comments
|
Shipping comments | |
|
EndCustomerNumber
|
End customer number | yes* |
|
EndCustomerOrderNumber
|
End customer order number | yes* |
|
EndCustomerPoNumber
|
End customer purchase order number | yes* |
|
EndCustomerCurrency
|
End customer currency | yes* |
| orderItem | yes | |
| orderItem.productId | The unique identifier for the order line item | yes |
| orderItem.lineNumber | The line number of the item | yes |
| orderItem.partNumber | ||
| orderItem.manufacturerName | ||
| orderItem.price | The product unit price | |
| orderItem.cutomerPartNumber | The customer custom part number | |
| orderItem.endCustomerCost | The cost of item for end customer | yes* |
|
orderItem.orderItemSchedules
|
||
|
orderItem.orderItemSchedules.scheduleQuantity
|
The number of items purchased | yes |
|
orderItem.orderItemSchedules.requestedShipDate
|
Requested date to ship | yes |
|
orderItem.orderItemSchedules.requestedDeliveryDate
|
Requested date to deliver | yes |
|
orderItem.orderItemSchedules.scheduleLineNumber
|
sequence number |
*Only required if order is a blind fulfilment order
可用配送方式
| Service Code | |
|---|---|
| Add to Invoice | UPS WORLDWIDE EXPRESS SAVER |
| Freight Account | CENTRAL FREIGHT, DHL EXPRESS, FEDEX 2DAY, FEDEX EXPRESS SAVER - 3 DAY, FEDEX GROUND, FEDEX INTERNATIONAL ECONOMY-3 DAY, FEDEX INTERNATIONAL GROUND, FEDEX INTERNATIONAL PRIORITY, FEDEX PRIORITY OVERNITE, FEDEX STANDARD OVERNITE, UPS NEXT DAY AIR SAT DEL, UPS WORLDWIDE EXPEDITED (3-5 DAYS), UPS WORLDWIDE EXPRESS (2-3 DAYS), UPS WORLDWIDE EXPRESS PLUS, UPS WORLDWIDE EXPRESS SAVER, UPS WW SAVER |
潜在错误信息
以下列出了因API请求错误或Waldom内部先决条件未满足而可能收到的错误信息。
| Description |
|---|
| Invalid buyer email |
| Billing address missing in account |
| Shipping address is required |
| Invalid Shipping address country ISO code |
| Invalid Shipping address state province abbreviation |
| Invalid shipping method |
| Only freight account is allowed for shipping method. |
| Invalid payment method |
| one order item is required |
| Invalid Product |
| Invalid Product quantity |
