Description

Create a draft purchase order (inbound order) in eTowerOne.

Path

HTTP Verb

URL

POST

/api/supplier-service/v1/b2b/po

Header Sample


POST /api/supplier-service/v1/b2b/po HTTP/1.1
Content-Type: application/json
Accept: application/json
User-Agent: Mozilla 5.0
Host: http://cfs-qa.etowertech.com/
X-WallTech-Date: Thu, 06 Aug 2020 06:36:24 GMT
Authorization: WallTech testLvs2jdug2qIoRsJyuxs:VaWNgikNP0NGcoxVCeWYid50MYQ=

Fields

Field

Data Type

Length

Mandatory

Description

referenceNo

String

50

M

Unique identification of PO

warehouseCode

String

20

M

Destination warehouse code

shipperWarehouseCode

String

100

O/M

Shipper address code

shipperContactName

String

20

M

Contact name(No need to insert when you send field ”shipperWarehouseCode“)

addressLine1

String

50

O/M

Shipper address Line1(No need to insert when you send field ”shipperWarehouseCode“)

addressLine2

String

100

O

Shipper address Line2(No need to insert when you send field ”shipperWarehouseCode“)

addressLine3

String

100

O

Shipper address Line3(No need to insert when you send field ”shipperWarehouseCode“)

city

String

20

O

Shipper city(No need to insert when you send field ”shipperWarehouseCode“)

state

String

20

O

Shipper state(No need to insert when you send field ”shipperWarehouseCode“)

postCode

String

20

O

Shipper postcode(No need to insert when you send field ”shipperWarehouseCode“)

district

String

20

O

Shipper district(No need to insert when you send field ”shipperWarehouseCode“)

country

String

2

O

Shipper country(Two-character,No need to insert when you send field ”shipperWarehouseCode“)

shipperPhone

String

20

O/M

Shipper phone(No need to insert when you send field ”shipperWarehouseCode“

shipperEmail

String

50

O

Shipper email(No need to insert when you send field ”shipperWarehouseCode“

shipperBizName

String

50

O

Shipper company name

boxNo

String

20

M

Box No

boxQty

Int

5

M

Box Qty

lengthDeclared

BigDecimal

(8,1)

M

Declare length of box(CM)

widthDeclared

BigDecimal

(8,1)

M

Declare width of box(CM)

heightDeclared

BigDecimal

(8,1)

M

Declare height of box(CM)

weightDeclared

BigDecimal

(8,3)

M

Declare weight of box(KG)

sku

String

20

M

SKU code

productQty

Int

10

M

Product qty in simple box

Remark

String

100

O

Remark of box

orderNo

String

-

Response

Order No

code

String

-

-

Response code

errors

Object[]

-

-

Response error

message

String

-

-

Response message

messageId

String

-

-

Response message ID

success

Boolean

-

-

Success

warnList

-

-

-

No use


Request Sample

[
    {
        "shipperAddress": {
            "country": "CN",
            "postCode": "300321",
            "state": "shanghaishi",
            "city": "shixiaqu",
            "district": "pudongxinqu",
            "addressLine1": "street no.200",
            "addressLine2": "302hao",
            "addressLine3": "009shi"
        },
        "shipperContactName": "testzhang",
        "shipperBizName": "",
        "shipperPhone": "18856789348",
        "shipperEmail": "",
        "referenceNo": "AUTEST000001",
        "warehouseCode": "testuser",
        "shipperWarehouseCode": "",
        "packingDetails": [
            {
                "boxNo": "1",
                "lengthDeclared": 100.00,
                "heightDeclared": 100.00,
                "widthDeclared": 100.00,
                "weightDeclared": 100.00,
                "boxQty": 1,
                "sku": "test001",
                "productQty": 100,
                "remark": ""
            }
        ]
    },
    {
        "shipperAddress": {
            "country": "aa",
            "postCode": "",
            "state": "",
            "city": "",
            "district": "",
            "addressLine1": "",
            "addressLine2": "",
            "addressLine3": ""
        },
        "shipperContactName": "testzhang",
        "shipperBizName": "",
        "shipperPhone": "18856789348",
        "shipperEmail": "",
        "referenceNo": "AUTEST000002",
        "warehouseCode": "testuser",
        "shipperWarehouseCode": "cnzhang",
        "packingDetails": [
            {
                "boxNo": "1",
                "lengthDeclared": 100.00,
                "heightDeclared": 100.00,
                "widthDeclared": 100.00,
                "weightDeclared": 100.00,
                "boxQty": 1,
                "sku": "test001",
                "productQty": 1,
                "remark": ""
            }
        ]
    }
]


Response

[
    {
        "code": "0",
        "data": {
            "orderNo": "E12283230203000005O",
            "referenceNo": "AUTEST000001"
        },
        "errors": "",
        "message": "",
        "messageId": "",
        "success": true,
        "warnList": ""
    },
    {
        "code": "0",
        "data": {
            "orderNo": "E12283230203000006O",
            "referenceNo": "AUTEST000002"
        },
        "errors": "",
        "message": "",
        "messageId": "",
        "success": true,
        "warnList": ""
    }
]


[
    {
        "code": "0005",
        "data": {
            "orderIndex": 1,
            "referenceNo": "AUTEST000001"
        },
        "errors": [
            {
                "code": "600904",
                "message": "referenceNo:AUTEST000001,Already exists in the system"
            }
        ],
        "message": "paramter error",
        "messageId": "",
        "success": false,
        "warnList": ""
    },
    {
        "code": "0005",
        "data": {
            "orderIndex": 2,
            "referenceNo": "AUTEST000002"
        },
        "errors": [
            {
                "code": "600904",
                "message": "referenceNo:AUTEST000002,Already exists in the system"
            }
        ],
        "message": "paramter error",
        "messageId": "",
        "success": false,
        "warnList": ""
    }
]