Doc.365-post.io

Item Management

  1. Summary
  1. Clients can Add / Update / Delete the item
  2. Item which have been stocked in cannot be deleted
  3. Stocked in records won’t change even item master update successes

  1. Request Content Explanation

#

Item

Description

1

Request URL

/api/system/itapi_edi2?edi_code=MAITEM_IMPORT&user_code={USERCODE}

2

Request Method

POST

3

Request Data Format

XML

4

Request Data Encoding

UTF-8

5

Complete URL Example

http://www1.jflog.com:8008/WHS_TEST/api/system/itapi_edi2?edi_code=MAITEM_IMPORT&user_code={USERCODE}

  1. Request Data Sample and Explanation

#

Node with Example

Explanation

Max Length

Remark

1

<?xml version=”1.0″ encoding=”UTF-8″?>

 

 

 

2

<Request>

 

 

 

3

<RequestID>##REQUEST_ID##</RequestID>

Request ID.

20

Generated by client. Will return in response message for reference

4

<RequestDate>2001-12-17T09:30:47+08:00</RequestDate>

Request time.

25

 

 

<Auth>

 

 

 

5

<user_code>{USERCODE}</user_code>

API username

30

Mandatory

6

<password>{PASSWORD}</password>

API Password

30

Mandatory

7

</Auth>

 

 

 

8

<ItemMaster>

 

 

 

9

<RequestSeq>1</RequestSeq>

 

 

 

10

<TransactionType>NEW</TransactionType>

 

 

You can leave this blank or ignore this XML element, default NEW,

Allow value: NEW/UPDATE/DELETE

11

<Customer>CUSTCODE</Customer>

Customer Code

8

Mandatory,Pre-assign code

*Every customer has their own customer code in WMS system, please consult IT for the customer code

12

<ItemNumber>ITEM001</ItemNumber>

SKU/Item Number

30

Mandatory

13

<ItemSize></ItemSize>

Item attribute

30

These fields will be required to fill in create order if they are filled when item create

14

<ItemClass></ItemClass>

Item attribute

30

15

<ItemColor></ItemColor>

Item attribute

30

16

<ItemSeason></ItemSeason>

Item attribute

30

17

<ItemName>ITEM001 NAME</ItemName>

Item Name

80

You may leave it blank.

Default item number/ItemSize/ItemClass/ItemColor/ItemSeason

18

<ClientItemNumber>TT-11101</ClientItemNumber>

Client item number

 

 

19

<PKGUnit>PCS</PKGUnit>

Outer package unit code

 

Mandatory

*Please consult IT for the unit code

20

<InnerPKGUnit>PCS</InnerPKGUnit>

Inner package unit code

 

Mandatory

*Please consult IT for the unit code

21

<PackageRatio>1</PackageRatio>

 

 

 

22

<UnitKGS>0.20</UnitKGS>

Gross weight

 

 

23

<UnitNetKGS>0.15</UnitNetKGS>

Net weight

 

 

24

<UnitCBM>0.036</UnitCBM>

CBM

 

 

25

<UnitLength>10.01</UnitLength>

Length

 

 

26

<UnitWidth>12.02</UnitWidth>

Width

 

 

27

<UnitHeight>14.03</UnitHeight>

Height

 

 

28

<Currency>USD</Currency>

Price currency

3

*Please consult IT for the currency

29

<UnitPrice>9.99</UnitPrice>

Price

 

 

30

<MinPKG>0</MinPKG>

 

 

 

31

<MaxPKG>0</MaxPKG>

 

 

 

32

<Marks>NA</Marks>

 

500

 

33

<Description>Item TT</Description>

Item description

500

 

34

<Remark>NA</Remark>

 

500

 

35

<HSCode>HS11223344</HSCode>

Harmonized System Code

 

 

36

<UniqueItemBarcode>1122334455</UniqueItemBarcode>

UPC

20

 

37

<ProductionCountryCode>CN</ProductionCountryCode>

Country code

2

*Please consult IT for the full list of country code

38

<FreeText1>FreeText1</FreeText1>

 

255

 

39

<FreeText2>FreeText2</FreeText2>

 

255

 

40

<FreeText3>FreeText3</FreeText3>

 

255

 

41

<FreeText4>FreeText4</FreeText4>

 

255

 

42

<FreeText5>FreeText5</FreeText5>

 

255

 

43

<FreeText6>FreeText6</FreeText6>

 

255

 

44

<FreeText7>FreeText7</FreeText7>

 

255

 

45

<FreeText8>FreeText8</FreeText8>

 

255

 

46

<FreeText9>FreeText9</FreeText9>

 

255

 

47

<FreeText10>FreeText10</FreeText10>

 

255

 

48

<FreeText11>FreeText11</FreeText11>

 

255

 

49

<FreeText12>FreeText12</FreeText12>

 

255

 

50

<FreeText13>FreeText13</FreeText13>

 

255

 

51

<FreeText14>FreeText14</FreeText14>

 

255

 

52

<FreeText15>FreeText15</FreeText15>

 

255

 

53

<FreeText16>FreeText16</FreeText16>

 

60

 

54

<FreeText17>FreeText17</FreeText17>

 

60

 

55

<FreeText18>FreeText18</FreeText18>

 

60

 

56

<FreeText19>FreeText19</FreeText19>

 

60

 

57

<FreeText20>FreeText20</FreeText20>

 

60

 

58

</ItemMaster>

 

 

 

59

<ItemMaster>

 

 

 

60

<RequestSeq>2</RequestSeq>

 

 

 

61

<Customer>CUSTCODE</Customer>

Customer Code

8

Mandatory,Pre-assign code

*Every customer has their own customer code in WMS system, please consult IT for the customer code

62

<ItemNumber>ITEM-T</ItemNumber>

SKU/Item Number

30

Mandatory

63

<ItemSize>XL</ItemSize>

Item attribute

30

These fields will be required to fill in create order if they are filled when item create

64

<ItemClass>A</ItemClass>

Item attribute

30

 

65

<ItemColor>Red</ItemColor>

Item attribute

30

 

66

<ItemSeason>17Winter</ItemSeason>

Item attribute

30

 

67

<ItemName>TT-Item</ItemName>

Item Name

80

You may leave it blank.

Default item number/ItemSize/ItemClass/ItemColor/ItemSeason

68

<ClientItemNumber>TT-11101</ClientItemNumber>

Client item number

 

 

69

<PKGUnit>PCS</PKGUnit>

Outer package unit code

 

Mandatory

*Please consult IT for the unit code

70

<InnerPKGUnit>PCS</InnerPKGUnit>

Inner package unit code

 

Mandatory

*Please consult IT for the unit code

71

<PackageRatio>1</PackageRatio>

 

 

 

72

<UnitKGS>0.20</UnitKGS>

Gross weight

 

 

73

<UnitNetKGS>0.15</UnitNetKGS>

Net weight

 

 

74

<UnitCBM>0.036</UnitCBM>

CBM

 

 

75

<UnitLength>10.01</UnitLength>

Length

 

 

76

<UnitWidth>12.02</UnitWidth>

Width

 

 

77

<UnitHeight>14.03</UnitHeight>

Height

 

 

78

<Currency>USD</Currency>

Price currency

3

*Please consult IT for the currency

79

<UnitPrice>9.99</UnitPrice>

Price

 

 

80

<MinPKG>0</MinPKG>

 

 

 

81

<MaxPKG>0</MaxPKG>

 

 

 

82

<Marks>NA</Marks>

 

500

 

83

<Description>Item TT</Description>

Item description

500

 

84

<Remark>NA</Remark>

 

500

 

85

<HSCode>HS11223344</HSCode>

Harmonized System Code

 

 

86

<UniqueItemBarcode>1122334455</UniqueItemBarcode>

UPC

20

 

87

<ProductionCountryCode>CN</ProductionCountryCode>

Country code

2

*Please consult IT for the full list of country code

88

<FreeText1>FreeText1</FreeText1>

 

255

 

89

<FreeText2>FreeText2</FreeText2>

 

255

 

90

<FreeText3>FreeText3</FreeText3>

 

255

 

91

<FreeText4>FreeText4</FreeText4>

 

255

 

92

<FreeText5>FreeText5</FreeText5>

 

255

 

93

<FreeText6>FreeText6</FreeText6>

 

255

 

94

<FreeText7>FreeText7</FreeText7>

 

255

 

95

<FreeText8>FreeText8</FreeText8>

 

255

 

96

<FreeText9>FreeText9</FreeText9>

 

255

 

97

<FreeText10>FreeText10</FreeText10>

 

255

 

98

<FreeText11>FreeText11</FreeText11>

 

255

 

99

<FreeText12>FreeText12</FreeText12>

 

255

 

100

<FreeText13>FreeText13</FreeText13>

 

255

 

101

<FreeText14>FreeText14</FreeText14>

 

255

 

102

<FreeText15>FreeText15</FreeText15>

 

255

 

103

<FreeText16>FreeText16</FreeText16>

 

60

 

104

<FreeText17>FreeText17</FreeText17>

 

60

 

105

<FreeText18>FreeText18</FreeText18>

 

60

 

106

<FreeText19>FreeText19</FreeText19>

 

60

 

107

<FreeText20>FreeText20</FreeText20>

 

60

 

108

</ItemMaster>

 

 

 

109

</Request>

 

 

 

  1. Response Data Sample and Explanation

#

Node with Example

Explanation

Remark

1

<Response>

 

 

2

<RequestID>##REQUEST_ID##</RequestID>

 

 

3

<RequestDate>2001-12-17T09:30:47+08:00</RequestDate>

 

 

4

<ResponseDate>2020-08-21T12:25:47+08:00</ResponseDate>

 

 

5

<ResponseStatus>SUCCESS</ResponseStatus>

 

 

6

<ResponseMessage/>

 

 

7

</Response>