Create Order

Request Service

  • createFbaOrder

Request Method：

  • POST

Request Sample:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/">
    <SOAP-ENV:Body>
        <ns1:callService>
            <paramsJson>
                {
                  "reference_no":"test-api",
                  "platform":"OTHER",
                  "shipping_method":"US_FEDEX_GROUND",
                  "warehouse_code":"WPLA",
                  "is_prime":"0",
                  "remark":"测试备注",
                  "fba_name":"ONT8",
                  "country_code":"US",
                  "province":"IL",
                  "city":"ROMEOVILLE",
                  "address1":"1125 W REMINGTON BLVD",
                  "zipcode":"142970",
                  "name":"tester",
                  "phone":"123456789",
                  "fba_no":"fba123456",
                  "fba_reference_no":"frn123456",
                  "seller_id":"",
                  "inventory_type":0,
                  "other_ware_operation":"1",
                  "items":[
                    {
                      "product_sku":"12345554",
                      "box_no":"2",
                      "quantity":"1",
                      "platform_barcode":"pb_sku_1"
                    },
                    {
                      "product_sku":"SKU2",
                      "box_no":"2",
                      "quantity":"1",
                      "platform_barcode":"pb_sku_2"
                    }],
                    "file_items":{
                        "file_type":"pdf",
                        "file_name":"1111.pdf",
                        "file_data":"MjM06K6pMTM0MTI="
                    },
                    "expected_ship_time":"2023-10-10",
                    "other_address_type_remark":"其他地址类型备注",
                    "change_packaging":0,
                    "change_barCode":0,
                    "overlay_barcode":0,
                    "change_shippingMark":0,
                    "overLay_shippingMark":0,
                    "other_requirements":[1,2],
                    "palletizing":1,
                    "double_plate":0,
                    "mixed_late":0,
                    "tray_mark":0,
                    "palletizing_scheme":0,
                    "limit_plate_qty":0,
                    "limit_plate_height":0,
                    "limit_plate_weight":0,
                    "batch_delivery_order":"",
                    "feedback_information":[1,2,3],
                    "tray_file":{
                        "file_type":"pdf",
                        "file_name":"1111.pdf",
                        "file_data":"MjM06K6pMTM0MTI="
                    }
                }
            </paramsJson>
            <appToken>appToken</appToken>
            <appKey>appKey</appKey>
            <service>createFbaOrder</service>
        </ns1:callService>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Request Parameter:

Parameter Type Required Remark Length Limited
reference_no String Y Reference no 50
platform String N Platform， ALIEXPRESS, AMAZON, B2C, EBAY, OTHER 20
third_partner_account String N Third party account (set this parameter when fees need to be paid by the third party account) 16
shipping_method String Y Shipping methohd，refer to API getShippingMethod 20
warehouse_code String Y Warehouse Code，refer to API getWarehouse 20
fba_name String Y FBA Warehouse Code 20
country_code String Y Country Code 20
province String Y State 20
city String Y City 29
address1 String Y Address line 1 (length:30) 30
address2 String N Address line 2 (length:30) 30
zipcode String Y Postal code 20
doorplate String N doorplate 32
company String N Company name 360
name String Y Name 200
phone String Y Phone 1 20
cell_phone String N Phone 12 20
email String N Emal 20
platform_shop String N Platform Shop Name 50
order_cod_currency String N Currency
is_signature int N Signature: 0-No 1-Yes
is_insurance int N Insurance: 0-No 1-Yes
is_prime int N Urgent level: 0-None 1-SFP order 2-VC order
is_split int N Split forecast: 1 yes 0 no
insurance_value String N Insured amount
remark String N Order remark 200
seller_id String N Seller ID 128
inventory_type int N Inventory type: 0: standard 4: return 9: all (priority return inventory) Note: default 0 standard
verify int N 0-Save as draft 1: Submit to warehouse
items Object Y Order items
file_items Object N order attachment
other_ware_operation String N Other operations in the library: 0: none, 1: change pallet label, default to 0
fba_no String N FBA shipment number (corresponding to Amazon backend Shipment ID) is mandatory when selecting TRUCK or TRUCK-PALLET for logistics channels 50
fba_reference_no String N Shipment tracking number (corresponding to Amazon Reference ID in the Amazon backend) is required when selecting TRUCK or TRUCK-PALLET for logistics channels 50
inquiry_code String N Inquiry number (obtained from the cost module - truck inquiry) 50
expected_ship_time String N Expected delivery time, must be greater than the current date(yyyy-mm-dd,ex:2023-10-10)
other_address_type_remark String N Remarks for other address types (to be filled in when fbaName=Other) 255
change_packaging int N Change packaging 0. No 1. Yes
change_barCode int N Change barcode 0. No 1. Open the box for replacement 2. Do not open the box for replacement
overlay_barcode int N Whether to overwrite all barcodes 0. No 1. Yes (effective when selecting to change barcodes)
change_shippingMark int N Change the box label 0. No, 1. Single sided, 2. Double sided, 3. Four sided]
overLay_shippingMark int N Cover all box labels 0. No 1. Yes (effective when changing box labels)
other_requirements Array N Other requirements: 1. Loading photos, 2. Additional shipping documents
palletizing int N 0. No 1. Yes (When selecting palletizing, the following palletizing requirements will only take effect)
double_plate int N Double board palletizing 0. No 1. Yes
mixed_late int N Mix and hold 0. No 1. Yes
tray_mark int N 1. No 2. Single sided 3. Double sided 4. Four sided labeling
limit_plate_qty int N Limit the number of plates
limit_plate_height BigDecimal N Limit plate height (default CM)
limit_plate_weight BigDecimal N Limit plate weight (default KG)
batch_delivery_order String N Batch delivery note
feedback_information Array N Feedback 1. Pallet size and weight 2. SKU details for palletizing 3. Pallet photos
palletizing_scheme int N Specify SKU palletizing scheme 0. No 1. Yes
tray_file Object N Attachment for palletizing (effective when specifying palletizing scheme, please refer to the tray_file parameter, data type is single object)）

items:

Parameter Type Required Remark Length Limited
product_sku String Y SKU 20
product_name String N Chinese declaration name 50
product_name_en String N English declaration name 50
product_declared_value String N Declared value
quantity int Y Quantity
box_no String N Box number 50
platform_barcode String N platform barcode (FNSKU) 80
shipment_tracking_number String N Amazon Reference ID 50
fba_number String N Amazon Shipment ID 50
box_pu_number int N SKU total per box

file_items:

Parameter Type Required Remark
file_type String N File type(zip/pdf/docx/xlsx/png/jpg)
file_name String N File name
file_data String N base64 of file

tray_file:

Parameter Type Required Remark
file_type String N File type(zip/pdf/docx/xlsx/png/jpg)
file_name String N File name
file_data String N base64 of file

Response Sample：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<SOAP-ENV:Envelope xmlns:ns1="http://www.example.org/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Body>
        <ns1:callServiceResponse>
            <response>
                {
                  "ask":"Success",
                  "message":"Success",
                  "nextPage":false,
                  "order_code":"ZY-XK-191212-0002"
                }
            </response>
        </ns1:callServiceResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Response Parameter：

Parameter Type Remark
ask String Request Result: success or failure
message String Response message
nextPage boolean Identify if have next page or not
order_code String System Order Code
Error Object Reference to Error section
作者：WesternPost  创建时间：2021-07-02 20:09
最后编辑：覃超华  更新时间：2024-12-31 02:56