1.1 History

This document records the delivery summary and scanning related content. Hichain and LESHINE send the delivery summary, and PDA or AGV scans and posts it.

Version	Date	Content	Committer
v1.0	2022-06-06	init	lingcq1
v1.1	2022-06-22	Add Hikvision's real-time scanning interface with verification, add label style, and add primary key of the scanning interface	lingcq1

1.2 Public parameters

Parameter position	Parameter name	Description	Example
body	palletId	LESHINE: LES00+timestamp(10)+1 random number ； HIC: 9S9VV+timestamp(10)+1random number
body	planId	LESHINE: N/A HIC:MO starts with S,others is pull
body	shipToId	L220
body	workshopCode	South plant BOX: LSSC; South plant SMT: LSSC-SMT, default: LSSC

1.3 By MO Delivery summary

Scenario: realtime, The part that is not temporarily stored on the kitting shelf on the 3rd will be summarized and posted by MO.

User: HIC

Method:POST

ContentType: application/json

Request data description

Parameter position	Parameter name	Type	Description	unique key	necessary	Example
body	palletId	string	The unique identifier cannot be reused once the VMI is successfully entered.LSSC: LES00+timestamp(10)+1random; HIC: 9S9VV+timestamp(10)+1random	Y	Y	---
body	planId	string	S22222, N/A		Y
body	sourceSystem	string	HIC		Y
body	targetSystem	string	VMI		Y
body	systemTime	string			Y
body	shipToId	string	L220		Y
body	workshopCode	string	LSSC or LSSC-SMT, default: LSSC		Y
body	dataType	string	default: MO_DELIVERY		Y
body	loadinglistNo	string
body	shipTotalQty	string
body	shipPlanTime	string
body	deliveryNo	string	delivery note	Y	Y
body	deliveryLineNo	string	delivery line	Y	Y
body	productionOrdId	string	production order	Y	Y
body	itemId	string		Y	Y
body	sourceType	string			Y
body	sourceStorageLocation	string			Y
body	sourceBin	string			Y
body	destType	string			Y
body	destStorageLocation	string			Y
body	destBin	string			Y
body	quantity	NUMBER	mo_item quantity		Y
body	palletQty	NUMBER	pallet mo_item quantity		Y

Request sample

{
    "palletId":"P1",
    "planId":"Sdddd",
    "sourceSystem":"HIC/LESHINE",
    "targetSystem":"VMI",
    "systemTime":"2022-02-21 09:41:15",
    "shipToId":"L220",
    "workshopCode": "LSSC",           
    "dataType":"MO_DELIVERY",
	"loadinglistNo":"HICLL2202210001",
	"shipTotalQty":168, 			
	"shipPlanTime":"2022-02-21 09:41:15", 
    "data":[        
        {
			"deliveryNo":"HICDEV2202210001",
			"deliveryLineNo":"000010", 		
            "productionOrdId":"sss",
            "itemId":"P104329",
            "sourceStorageLocation":"PL123316",
            "sourceBin":"PL123316",
            "sourceType":"PL123316",
      		"destStorageLocation": "MW02",
            "destType": "W02",
      		"destBin": "KIT",
            "quantity": 2,     
            "palletQty": 1           
        }
    ]
}

Response description

Parameter position	Parameter name	Required	Type	Format	Description	Example
body	result.palletId	Y	string
body	result.loadinglistNo	Y	string		loading list no

Response sample

{
    "code":"0",
    "msg":"success",
    "result":{
    	"loadinglistNo":"HICLL2202210001", 
    	"palletId":"P1"
	} 
}


//code=-1, verify failed
{
    "code":"-1",
    "msg":"system error",
    "result":{
    	"loadinglistNo":"HICLL2202210001", 
    	"palletId":"P1"
	}  
}

//code=-2,data error
{
    "code":"-2",
    "msg":"productionOrdId itemId quantity invalid/pallet already processed",
    "result":{
    	"loadinglistNo":"HICLL2202210001", 
    	"palletId":"P1"
	} 
}

1.4 By Pull delivery summary

Scenario:No. 3 gr kanban, shipped in a non-guaranteed outer box, packaging material

User: HIC & LESHINE

Method:POST

ContentType: application/json

Request data description

Parameter position	Parameter name	Type	Description	unique key	necessary	Example
body	palletId	string	The unique identifier cannot be reused once the VMI is successfully entered.LESHINE: LES00+timestamp(10)+1random; HIC: 9S9VV+timestamp(10)+1random	Y	Y
body	planId	string	S22222, N/A		Y
body	sourceSystem	string	HIC, LESHINE		Y
body	targetSystem	string	VMI		Y
body	systemTime	string			Y
body	shipToId	string	L220		Y
body	workshopCode	string	LSSC or LSSC-SMT, default:LSSC		Y
body	dataType	string	default:PULL_DELIVERY
body	loadinglistNo	string
body	shipTotalQty	string
body	shipPlanTime	string
body	pullId	string		Y	Y
body	pullLineId	string		Y	Y
body	itemId	string
body	palletQty	number
body	quantity	NUMBER

Request sample

{
    "palletId":"P1",
    "planId":"Sdddd",
    "sourceSystem":"HIC/LESHINE",
    "targetSystem":"VMI",
    "systemTime":"2022-02-21 09:41:15",
    "shipToId":"L220",
    "workshopCode": "LSSC",            
    "dataType": "PULL_DELIVERY",
	"loadinglistNo":"HICLL2202210001", 
	"shipTotalQty":168, 				
	"shipPlanTime":"2022-02-21 09:41:15",
    "data":[        
        {
			"pullId": "4500375969",
			"pullLineId": "1000037984",
			"itemId": "000000A36941",
			"quantity": 1,
            "palletQty": 1
        }
    ]
}

Response description

Parameter position	Parameter name	Required	Type	Format	Description	Example
body	result.palletId	Y	string		对应的拍号
body	result.loadinglistNo	Y	string		装单号

Request sample

{
    "code":"0",
    "msg":"success",
    "result":{
    	"loadinglistNo":"HICLL2202210001", 
    	"palletId":"P1"
	} 
}


//code=-1 Verification exception, need to re-verify
{
    "code":"-1",
    "msg":"program error",
    "result":{
    	"loadinglistNo":"HICLL2202210001", 	
    	"palletId":"P1"
	}  
}

//Verification failed code=-2, there is a problem with the data
{
    "code":"-2",
    "msg":"productionOrdId itemId quantity invalid/pallet already processed",
    "result":{
    	"loadinglistNo":"HICLL2202210001", 
    	"palletId":"P1"
	} 
}

1.5 Scan the receiving

1.5.1 Scan the receiving FOR PDA

Description: real time, FOR PAD(Remove non-warranty chassis)

Method:POST

User: PDA

ContentType: application/json

Request data description

Parameter position	Parameter name	Required	Type	Description	primary key
body	palletId	Y	string	pallet id	Y
body	planId	Y	string
body	productionLine	Y	string	production line
body	sourceSystem	Y	string	PDA or HIK
body	targetSystem	Y	string	VMI
body	shipToId	Y	string	plant
body	workshopCode	Y	string	default:LSSC, SMT:LSSC-SMT
body	systemTime	Y	string	device scan time
body	deviceId	Y	string	device id
body	userId	Y	string	scan operator
body	item	Y	string	item no	Y
body	quantity	Y	string

Request sample

{
    "palletId":"9S9VL16545869971",
    "planId":"S-OPT-L6-1-1-2022060700003",
    "productionLine":"S-OPT-L6",
    "sourceSystem":"HIK/PDA", 
    "targetSystem":"VMI",
    "shipToId":"L220",
    "workshopCode":"LSSC",
 	"systemTime":"2022-03-03 12:00:11",
 	"deviceId":"26A853C7E84BF3C38A5099186A780A487",
 	"userId":"ABC", 
    "data":[        
        {  
            "itemId":"P104329",
            "quantity":10
        },
        {
			"itemId":"P104328",
            "quantity":100
        }
    ]

}

Response data description

Parameter location	Parameter name	Not null	Type	Format	Description	Example
body	code	Y	string		0:successful,others:failed
body	msg	Y	string		message

Response data description

{
    "code":"0",
    "msg":"success"
}


//system error code！=0,net exception or system error
{
    "code":"-1",
    "msg":"system error"
}

1.5.2 Scanning and verification receiving FOR HIK

Description: real time, FOR HIK. For the non-warranty chassis part, received data will be compared with the delivery summary. If the comparison is successful, the pallet will be placed in the warehouse. else return the failure reason. HIK cannot put this pallet into the warehouse.

User:HIK(AGV)

Request description: refer to 1.5.1

Request sample: refer to 1.5.1

Respose description: refer to 1.5.1

Response sample

{
    "code":"0",
    "msg":"success"
}


//code！=0, failed, reason is placed in the msg
{
    "code":"-1",
    "msg":"Exception/pallet repeat submit/compare with delivery summary failed"
}

1.6 label format

label	LESHINE	HIC	Remark
Pallet id	LES00+timestamp(10)+1random number	9S9VV+timestamp(10)+1random number	total length=16,VV,VL store location
Plan id	N/A	kanban, Non-warranty case:pull id, others:KITTING split plan(Plan id starts with S)	VMI** if N/A then data from LESHINE else from HIC, MO data starts with S, others are pull data**
Line id	S-NB or S-NB-L6-01	S-NB-L6(direct send) or S-NB-L6-01(Temporary storage No. 3-No. 1)
Plant id	L220	L220
P/N	SP10G08418	SBB1A11341
QTY	100	QTY
BOX ID		BOX ID: 1. VENDOR incoming box label is start with 100(vendor provide);2.6S6VV(16) generated by HIC **BOX ID on label, not on QR code **	no BOX ID on manufacturing and QR code, whether BOX ID on label will be determined later。all part summary quantity to one line. ****one pallet should have less 10 parts

label format	6 fields sperated by semicolon, PN quantity sperated by comma
label sample	Les2022053001A010000000000001;N/A;S-NB-L6;L220;PNA,100;PNB,200;PNC,300;
	PDA need this format,and then convert to VMI required format