Subversion Repositories SmartDukaan

Rev

Rev 4630 | Rev 4934 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
412 ashish 1
namespace java in.shop2020.logistics
2
namespace py shop2020.thriftpy.logistics
3
 
3374 rajveer 4
include "GenericService.thrift"
5
 
646 chandransh 6
enum StationType{
7
	OWN_STATION = 0,		//The service provider's own station.
8
	ASSOCIATE_STATION = 1	//An associate's station
472 rajveer 9
}
442 rajveer 10
 
646 chandransh 11
enum WarehouseLocation{
12
	Delhi = 0,
13
	Mumbai = 1,
14
	Bangalore = 2,
15
	Kolkata = 3
412 ashish 16
}
17
 
3044 chandransh 18
enum DeliveryType {
19
	PREPAID = 0,
20
	COD = 1
21
}
22
 
23
struct ProviderDetails{
24
	1:string accountNo,
25
	2:string email
26
}
27
 
412 ashish 28
struct Provider{
29
	1:i64 id,
667 chandransh 30
	2:string name,
3044 chandransh 31
	3:map<DeliveryType, ProviderDetails> details
412 ashish 32
}
33
 
646 chandransh 34
struct AwbUpdate{
35
    1:string awbNumber,
36
    2:string providerName,
37
    3:string location,
38
    4:i64 entryDate,
39
    5:string description
412 ashish 40
}
41
 
483 rajveer 42
struct LogisticsInfo{
646 chandransh 43
	1:i64 warehouseId,
44
	2:i64 providerId,
45
	3:i64 deliveryTime,
4009 chandransh 46
	4:string airway_billno,
4865 rajveer 47
	5:i64 shippingTime,
48
	6:bool codAllowed
483 rajveer 49
}
50
 
472 rajveer 51
exception LogisticsServiceException{
52
	1:i64 id,
53
	2:string message
54
}
55
 
3374 rajveer 56
service LogisticsService extends GenericService.GenericService{
646 chandransh 57
	/**
667 chandransh 58
	 Returns a provider for a given provider ID. Throws an exception if none found.
59
	*/
60
	Provider getProvider(1:i64 providerId) throws (1:LogisticsServiceException lse),
61
 
62
	/**
673 chandransh 63
	 Returns a list containing all the providers.
64
	*/
65
	list<Provider> getAllProviders() throws (1:LogisticsServiceException lse),
66
 
67
	/**
646 chandransh 68
	 Returns a LogisticsInfo structure w/o an airway bill number. Use this method during the estimation phase.
69
	 Raises an exception if this pincode is not allocated to any warehouse zone or provider. Also, if the pincode
4630 mandeep.dh 70
	 is allocated to a warehouse zone but there are no actual warehouses in that zone, an exception is raised.
646 chandransh 71
	 */
4630 mandeep.dh 72
	LogisticsInfo getLogisticsEstimation(1:i64 itemId, 2:string destination_pin, 3:DeliveryType type) throws (1:LogisticsServiceException se),
483 rajveer 73
 
646 chandransh 74
	/**
75
	 Same as above excpet that an airway bill number is also allocated and returned.
76
	*/
3044 chandransh 77
	LogisticsInfo getLogisticsInfo(1:string destination_pincode, 2:i64 item_id, 3:DeliveryType type) throws (1:LogisticsServiceException se),
477 rajveer 78
 
646 chandransh 79
	/**
80
	 Returns an unused AWB number for the given provider.
81
	*/
82
	string getEmptyAWB(1:i64 providerId) throws (1:LogisticsServiceException se),
472 rajveer 83
 
646 chandransh 84
	/**
85
	 Returns the list of updates for the given AWB number and provider id. The list is empty if there are no updates yet.
86
	*/
729 chandransh 87
	list<AwbUpdate> getShipmentInfo(1:string awb, 2:i64 providerId) throws (1:LogisticsServiceException se),
88
 
89
	/**
90
	 Returns the short three letter code of a pincode for the given provider.
91
     Raises an exception if the pin code is not serviced by the given provider.
92
	*/
1138 chandransh 93
	string getDestinationCode(1:i64 providerId, 2:string pinCode) throws (1:LogisticsServiceException se),
94
 
95
	/**
3103 chandransh 96
	Returns the number of unused AWB numbers for the given provider of the given type  
1138 chandransh 97
	*/
3103 chandransh 98
	i64 getFreeAwbCount(1:i64 providerId, 2:string type),
1730 ankur.sing 99
 
100
	/**
101
	Returns list of Holiday dates between fromDate and toDate (both inclusive)
102
	fromDate should be passed as milliseconds corresponding to the start of the day.
103
	If fromDate is passed as -1, fromDate is not considered for filtering
104
	If toDate is passed as -1, toDate is not considered for filtering
105
	*/
4865 rajveer 106
	list<i64> getHolidays(1:i64 fromDate, 2:i64 toDate)
412 ashish 107
}