This interface is applicable for data integration API， read Api Access Process first
send data to partner’s
Description:Lenovo will send by calling partner’s web API
Method:POST
ContentType:application/json
Path:provide by partner
| Environment | URL |
|---|---|
| test | provide by partner |
| prod | provide by partner |
Request body structure：
| Field | desc | field type | mandatory | comments |
|---|---|---|---|---|
| seq_no | A unique number of LLGW message | String(19) | Y | It should be increasing but maybe not continuous |
| user_name | partner’s account name that registered in LLGW | String(100) | Y | |
| data_type | Indicator which kind of data | String(4) | Y | 0 - reserved or test message; 1 - FG DESADV; 2 – outbound DN |
| data | message body | Object Array | Y | |
| { | object begin | delivery object | ||
| bill_of_lading | String(35) | Y | ||
| hawb | String(35) | N | ||
| delivery_number | String(10) | Y | ||
| business_unit | String(35) | Y | MBG or DCG | |
| mode_of_transport | String(20) | Y | ||
| route | String(6) | Y | len=6 | |
| service_level | String(3) | Y | ||
| shipping_conditions | String(2) | Y | len=2 | |
| shipping_instructions | String(200) | N | ||
| shipping_point | String(4) | Y | len=4 | |
| incoterms | String(30) | N | ||
| dangerous_goods | String(4) | N | ||
| ship_from_city | String(10) | N | ||
| ship_from_city2 | String(10) | N | ||
| ship_from_country | String(10) | Y | ||
| ship_from_id | String(40) | Y | ||
| ship_from_name | String(40) | Y | ||
| ship_from_name2 | String(40) | N | ||
| ship_from_name3 | String(40) | N | ||
| ship_from_postal_code | String(40) | N | ||
| ship_from_region | String(10) | N | ||
| ship_from_street | String(40) | N | ||
| ship_to_city | String(10) | Y | ||
| ship_to_country | String(10) | Y | ||
| ship_to_id | String(40) | Y | ||
| ship_to_name | String(40) | Y | ||
| ship_to_name2 | String(40) | N | ||
| ship_to_name3 | String(40) | N | ||
| ship_to_postal_code | String(40) | N | ||
| ship_to_region | String(10) | N | ||
| ship_to_street | String(40) | N | ||
| ship_to_street2 | String(40) | N | ||
| ship_to_street3 | String(40) | N | ||
| ultimate_contact_person_city | String(10) | Y | ||
| ultimate_contact_person_country | String(10) | Y | ||
| ultimate_contact_person_id | String(40) | Y | ||
| ultimate_contact_person_name | String(40) | Y | ||
| ultimate_contact_person_phone | String(20) | Y | ||
| ultimate_contact_person_email | String(40) | N | ||
| ultimate_contact_person_postal_code | String(40) | Y | ||
| ultimate_contact_person_region | String(10) | N | ||
| ultimate_contact_person_street | String(40) | Y | ||
| actual_shipping_date | String(8) | Y | len=8 and should be all numbers | |
| actual_shipping_time | String(6) | Y | len=6 and should be all numbers | |
| asd_time_zone | String(6) | Y | ||
| customer_request_arrival_date | String(8) | Y | len=8 and should be all numbers | |
| customer_request_arrival_time | String(6) | Y | len=6 and should be all numbers | |
| crad_time_zone | String(6) | Y | ||
| target_delivery_date | String(8) | Y | len=8 and should be all numbers | |
| target_delivery_time | String(6) | Y | len=6 and should be all numbers | |
| target_delivery_time_zone | String(6) | Y | ||
| customer_committed_arrival_date | String(8) | Y | len=8 and should be all numbers | |
| customer_committed_arrival_time | String(6) | Y | len=6 and should be all numbers | |
| ccad_time_zone | String(6) | Y | ||
| connection_points_border | String(30) | N | ||
| connection_points_border_address | String(100) | N | ||
| connection_points_border_city | String(30) | N | ||
| connection_points_border_country | String(10) | N | ||
| connection_points_border_name | String(30) | N | ||
| connection_points_load_transfer | String(30) | N | ||
| connection_points_load_transfer_address | String(100) | N | ||
| connection_points_load_transfer_city | String(30) | N | ||
| connection_points_load_transfer_country | String(10) | N | ||
| connection_points_load_transfer_name | String(30) | N | ||
| forwarder_city | String(10) | N | ||
| forwarder_code | String(10) | Y | ||
| forwarder_country | String(10) | N | ||
| forwarder_id | String(40) | Y | ||
| forwarder_name | String(40) | Y | ||
| forwarder_postal_code | String(40) | N | ||
| forwarder_region | String(10) | N | ||
| forwarder_street | String(40) | N | ||
| net_weight | String(17) | N | ||
| total_weight | String(17) | Y | ||
| weight_unit | String(3) | Y | len=3 | |
| volume | String(17) | Y | ||
| volume_unit | String(3) | Y | len=3 | |
| total_number_of_packages | String(5) | Y | ||
| delivery_item | Object Array | N | ||
| [ | array begin | delivery item array | ||
| { | object begin | delivery item object | ||
| delivery_number | String(10) | Y | ||
| delivery_item_number | String(6) | Y | ||
| material_number | String(10) | Y | ||
| item_texts | Object Array | N | ||
| [ | array begin | item texts array | ||
| { | object begin | item texts object | ||
| td_id | String(4) | N | ||
| td_lines | String Array(300) | N | ||
| } | object end | item texts object | ||
| ] | array end | item texts array | ||
| } | object end | delivery item object | ||
| ] | array end | delivery item array | ||
| handling_unit | Object Array | Y | ||
| [ | array begin | handling unit array | ||
| { | object begin | handling unit object | ||
| hu_id | String(20) | Y | ||
| sscc | String(20) | Y | ||
| hu_loading_volume | String(17) | N | ||
| hu_total_volume | String(17) | Y | len=3 | |
| volume_unit | String(3) | N | len=3 | |
| hu_net_weight | String(17) | N | ||
| hu_total_weight | String(17) | Y | ||
| hu_weight_unit | String(3) | N | ||
| length | String(17) | Y | ||
| width | String(17) | Y | ||
| height | String(17) | Y | ||
| unit_of_dimension | String(3) | N | len=3 | |
| packaging_material_desc | String(40) | N | ||
| packed_item | Object Array | Y | ||
| [ | array begin | packed item array | ||
| { | object begin | packed item object | ||
| base_quantity_packed | String(17) | Y | ||
| base_unit_of_packed_quantity | String(3) | N | ||
| customer_po_number | String(10) | N | ||
| customer_part_number | String(20) | N | ||
| delivery_item_desc | String(40) | N | ||
| delivery_item_number | String(6) | Y | len=6 | |
| delivery_number | String(10) | Y | ||
| hts_code | String(17) | Y | ||
| international_article_number | String(18) | N | ||
| material_number | String(18) | Y | ||
| origin_country_of_material | String(2) | N | ||
| original_quantity_of_delivery_item | String(17) | N | ||
| serial_number | String(17) | N | ||
| so_item_number | String(6) | Y | len=6 | |
| so_number | String(10) | Y | ||
| } | object end | packed item object | ||
| ] | array end | packed item array | ||
| } | object end | handling unit object | ||
| ] | array end | handling unit array | ||
| } | object end | delivery object |
Request body sample：
json
JSON
{
"seq_no":"13245****5984",
"user_name":"****",
"data_type":"1",
"data":{
"bill_of_lading":"****",
"hawb":"****",
"delivery_number":"****",
"business_unit":"",
"mode_of_transport":"Truck",
"route":"****",
"service_level":"****",
"shipping_conditions":"****",
"shipping_instructions":"****",
"shipping_point":"****",
"dangerous_goods":"",
"ship_from_city":"****",
"ship_from_country":"****",
"ship_from_id":"****",
"ship_from_name":"Lenovo****",
"ship_from_name2":"c/o ****",
"ship_from_postal_code":"****CD",
"ship_from_street":"**** 24",
"ship_to_city":"****",
"ship_to_country":"GB",
"ship_to_id":"****",
"ship_to_name":"**** **** Ltd",
"ship_to_name2":"",
"ship_to_name3":"",
"ship_to_postal_code":"****",
"ship_to_region":"****",
"ship_to_street":"****",
"ship_to_street2":"****",
"ship_to_street3":"****",
"ultimate_contact_person_city":"****",
"ultimate_contact_person_country":"****",
"ultimate_contact_person_id":"11111",
"ultimate_contact_person_name":"****",
"ultimate_contact_person_phone":"****",
"ultimate_contact_person_postal_code":"********",
"ultimate_contact_person_region":"****",
"ultimate_contact_person_street":"********",
"actual_shipping_date":"****",
"actual_shipping_time":"****",
"asd_time_zone":"CET",
"customer_request_arrival_date":"20190809",
"customer_request_arrival_time":"000000",
"crad_time_zone":"****",
"target_delivery_date":"20190809",
"target_delivery_time":"000000",
"target_delivery_time_zone":"****",
"customer_committed_arrival_date":"99999999",
"customer_committed_arrival_time":"000000",
"ccad_time_zone":"****",
"connection_points_border":"NL00001",
"connection_points_border_address":"****",
"connection_points_border_city":"****",
"connection_points_border_country":"****",
"connection_points_border_name":"****",
"connection_points_load_transfer":"****",
"connection_points_load_transfer_address":"****",
"connection_points_load_transfer_city":"****",
"connection_points_load_transfer_country":"****",
"connection_points_load_transfer_name":"********",
"forwarder_city":"****",
"forwarder_code":"****",
"forwarder_country":"****",
"forwarder_id":"****",
"forwarder_name":"****SERVICES",
"forwarder_postal_code":"****3L2",
"forwarder_region":"****",
"forwarder_street":"****",
"net_weight":"0.0",
"total_weight":"0.0",
"weight_unit":"KGM",
"volume":"0.288",
"volume_unit":"MTQ",
"total_number_of_packages":"00001",
"delivery_item":[
{
"delivery_number":"****",
"delivery_item_number":"****",
"material_number":"****",
"item_texts":[
{
"td_id":"****",
"td_lines":[
"customer part 1"
]
},
{
"td_id":"****",
"td_lines":[
"test external number1"
]
},
{
"td_id":"****",
"td_lines":[
"Lenovo ************"
]
}
]
}
],
"handling_unit":[
{
"hu_id":"****",
"sscc":"****",
"hu_loading_volume":"0.000",
"hu_total_volume":"0.000",
"volume_unit":"CMQ",
"hu_net_weight":"0.0",
"hu_total_weight":"0.0",
"hu_weight_unit":"KGM",
"length":"0.000",
"width":"0.000",
"height":"0.000",
"unit_of_dimension":"CMT",
"packaging_material_desc":"Carton (****)",
"packed_item":[
{
"base_quantity_packed":"0.000",
"base_unit_of_packed_quantity":"EA",
"customer_po_number":"****",
"customer_part_number":"****",
"delivery_item_desc":"****Lenovo",
"delivery_item_number":"1",
"delivery_number":"****",
"hts_code":"****",
"material_number":"****",
"origin_country_of_material":"CN",
"original_quantity_of_delivery_item":"0.000",
"serial_number":"****",
"so_item_number":"1",
"so_number":"****"
}
]
}
]
}
}Response structure：
| Field | desc | field type | mandatory | comments |
|---|---|---|---|---|
| seq_no | A unique number of LLGW message | String(19) | N | Required when asynchronous return |
| data | message body | Object Array | Y | |
| { | object begin | delivery feedback obj | ||
| delivery_number | String(10) | Y | ||
| is_valid | String(10) | Y | true or false | |
| message | String(200) | N | mandatory when is_valid='false' | |
| } | object end | delivery feedback obj |
Response body sample:
json
JSON
{
"seq_no":"132456****5984",
"data":{
"delivery_number":"52****0",
"is_valid":"true",
"message":""
}
}