one touch booking web service process v2.2 ecc. 8 1. overview of web service what is web services ?...

12
One Touch Booking Web Service Process v2.2 ECC

Upload: posy-stanley

Post on 23-Dec-2015

217 views

Category:

Documents


3 download

TRANSCRIPT

One Touch Booking Web Service Process v2.2

ECC

8

1. Overview of Web Service

What is Web Services ?- Confused the term of Web Services.- Generally, method of communication between two electronic devices- Not Web Site such as Google webpage, GSPN- SPS & XML SVC Tracking : one of old Web Services method

Web Services Definition

- A software system designed to support interoperable machine-to-machine in-

teraction over the network- Uses SOAP messages and HTTP method with a XML Serialization

Web Services Server and Client system- Web Services Server system: ASC’s system - Client system : Samsung SAP BC

※ Necessary to be genuine real-time process.

8

2. Why OTB Web Services

Repair multi brand- Not repair only Samsung product- Can not update engineer availability to GSPN in real-time

Own repair system

- Service centre has its own repair management system- Have own Diary program or Scheduling program- Have optimization routing program for on-site repair

OTB Web Services- Get real time engineer availability for the schedule- Cover multi brand repair centers- Can use Service centre’s better process like optimization routing program

8

2. OTB Web Services

Samsung

Customer

Call Centre Service Centre

① Request repair visit

dateto Call Centre

⑥ Fix the visit

date for repair

③ Call OTB Web services

Service Centre

④ Response

with availability② Openscheduler

screen

⑤ Display Engineer availability

- Real time booking

1

3. Process introduction

Process Function Process Description

OTB

Booking

getAvailabilityAfter send customer address information and de-fect product information to ASC’s Web Service , receive ASC’s availability

putReservation

customer choose a reservation date and G-CIC send the reservation date to ASC’s Web Service.After ASC’s system save the data and send the response with the result.

Cancellation putCancelBookingIf customer calls Call centre agency to cancel, call centre agency will make cancellation. The data will be transferred to ASC’s Web Service system.

SVC Tracking

Assign to ASC

getServiceRequest

To update Service Request information and to im-prove data correctness, ASC should use this process.This function contains new service request infor-mation and cancelled service request.

Acknowledge putServiceResponseTo avoid duplicated data, ASC should send ac-knowledge data with ASC’s JOB NO.

Repair Status putRepairStatusTo provide exact repair information to customer, the repair progress information should be sent to Samsung system.

IH SVC Re-quest

getAvailability Calculate available date

ChooseAppointment

date

Save ap-pointment in

G-CIC

Save the ap-pointment date

Yes

No

Samsung ASC

3. Process Flow - Booking

Call web service

Re-call getAvailability

Return the response with fetched result

④-1

Service Tracking : getServiceRequest

2

getAvailability(2) Re-Calculate available date

Call web service again

ChooseAppointment

date exist

Return the response with fetched result④

No

Yes

putReservation(Web Service)

Call booking web service

GetServiceRequest XML data

ASC send Ser-vice order in-

formation

All assigned job & cancelled job re-

turn

Job cancel

getServiceRequest – Cancellation process

One Touch Booking process

Service Tracking Process

G-CICCustomer want to cancel the

booking

putCancelBooking(Web Service)

Remove the booking info

Samsung ASC

① ② ③

3

3. Process Flow - Cancellation

5

4. Data structure Booking - getAvailability

Data set ID Booking_Request

Input/Output Input No of records 1

No Field ID Field Name Type Length Mandatory Remarks

1 COMPANY Company Code CHAR 4 Y  2 ASC_CODE ASC Code CHAR 10 Y  3 SERVICE ORDER NO GCIC Transaction Number CHAR 10 Y  4 MODEL_CODE Model Code CHAR 40 Y  5 PRODUCT_GROUP Product group CHAR 10 Y SVC Product group code(e.g. LTV03)6 COUNTRY Country CHAR 20 Y  7 REGION Region(State, Province) CHAR 20    8 POST_CODE Postal Code CHAR 10 Y  9 CITY City CHAR 40  

10 PUR_PLACE Purchase Place CHAR 10 Dealer No

11 ADDRESS1 Street CHAR 60  12 ADDRESS2 additional address2 CHAR 40 *SEBN (House No)

13 ADDRESS3 additional address3 CHAR 40                Data set ID Retrun_Message

Input/Output Output No of records 1

No Field ID Field Name Type Length Mandatory Remarks

1 RETURN_TYPE Return Type CHAR 1 Y RETURN_TYPE : 'S' - Success, 'F' - Failure

2 ERR_CODE Error Code CHAR 10    3 ERR_MSG Error Message CHAR 100    

Data set ID Avaiable_time_slots

Input/Output Output No of records 0 ~ N

No Field ID Field Name Type Length Mandatory Remarks

1 ENGINEER Engineer Code CHAR 10    2 TIME_SLOT_TYPE Time slot type CHAR 1 Y A:Hourly, B:AM/PM/EV, C:Daily, D:2 hours3 TIME_SLOT_ID Time slot ID CHAR 40 Y  4 AVAILABLE_DATE Available date CHAR 8 Y YYYYMMDD5 AVAILABLE_TIME_FR Available time(From) CHAR 6   HHMMSS6 AVAILABLE_TIME_TO Available time(To) CHAR 6   HHMMSS

7 AVAILABILITY Availability NUMC 2   0-99

5

4. Data structure getAvailability Input

<?xml version="1.0" encoding="UTF-8"?><BOOKING_REQUEST> <COMPANY>C4B1</COMPANY> <ASC_CODE>0001781622</ASC_CODE> <SERVICEORDER_NO/> <MODEL_CODE>PS42C450B1W</MODEL_CODE> <PRODUCT_GROUP>CTVPL</PRODUCT_GROUP> <COUNTRY>BE</COUNTRY> <REGION>41</REGION> <POST_CODE>41009</POST_CODE> <CITY>SEVILLA</CITY> <PUR_PLACE/> <ADDRESS1/> <ADDRESS2>100</ADDRESS2> <ADDRESS3/></BOOKING_REQUEST>

<?xml version="1.0" encoding="UTF-8"?><RESPONSE> <RETURN_MESSAGE> <RETURN_TYPE>S</RETURN_TYPE> <ERR_CODE>0000</ERR_CODE> <ERR_MSG/> </RETURN_MESSAGE> <AVAILABILITY_LIST> <AVAILABLE_TIME_SLOTS> <TIME_SLOT_TYPE>A</TIME_SLOT_TYPE> <TIME_SLOT_ID>TS20130125160000r176</TIME_SLOT_ID> <AVAILABLE_DATE>20130125</AVAILABLE_DATE> <AVAILABLE_TIME_FR>160000</AVAILABLE_TIME_FR> <AVAILABLE_TIME_TO>170000</AVAILABLE_TIME_TO> <AVAILABILITY>1</AVAILABILITY> </AVAILABLE_TIME_SLOTS> <AVAILABLE_TIME_SLOTS> <TIME_SLOT_TYPE>A</TIME_SLOT_TYPE> <TIME_SLOT_ID>TS20130125170000r176</TIME_SLOT_ID> <AVAILABLE_DATE>20130125</AVAILABLE_DATE> <AVAILABLE_TIME_FR>170000</AVAILABLE_TIME_FR> <AVAILABLE_TIME_TO>180000</AVAILABLE_TIME_TO> <AVAILABILITY>2</AVAILABILITY> </AVAILABLE_TIME_SLOTS> <AVAILABLE_TIME_SLOTS> <TIME_SLOT_TYPE>A</TIME_SLOT_TYPE> <TIME_SLOT_ID>TS20130128120000r176</TIME_SLOT_ID> <AVAILABLE_DATE>20130128</AVAILABLE_DATE> <AVAILABLE_TIME_FR>120000</AVAILABLE_TIME_FR> <AVAILABLE_TIME_TO>130000</AVAILABLE_TIME_TO> <AVAILABILITY>1</AVAILABILITY> </AVAILABLE_TIME_SLOTS> </AVAILABILITY_LIST></RESPONSE>

getAvailability Output

6

4. Data structure Booking - putReservation

Data set ID Booking_Request         Input/Output Input No of records 1

No Field ID Field Name Type Length Mandatory Remarks

1 COMPANY Company Code CHAR 4 Y  2 ASC_CODE ASC Code CHAR 10 Y  3 SERVICE ORDER NO GCIC Transaction Number CHAR 10 Y  4 MODEL_CODE Model Code CHAR 40 Y  5 PRODUCT_GROUP Product group CHAR 10 Y SVC Product group code(e.g. LTV03)6 COUNTRY Country CHAR 20 Y  7 REGION Region(State, Province) CHAR 20    8 POST_CODE Postal Code CHAR 10 Y  9 CITY City CHAR 40 Y  

10 PUR_PLACE Purchase Place CHAR 10 Dealer No

11 ADDRESS1 Street CHAR 60  12 ADDRESS2 House No CHAR 40  13 ADDRESS3 additional address CHAR 40  14 ENGINEER Engineer Code CHAR 10    15 TIME_SLOT_TYPE Time slot type CHAR 1   A:Hourly, B:AM/PM/EV, C:Daily, D:2 hours16 TIME_SLOT_ID Time slot ID CHAR 40 Y  17 AVAILABLE_DATE Available date CHAR 8    18 AVAILABLE_TIME_FR Available time(From) CHAR 6    19 AVAILABLE_TIME_TO Available time(To) CHAR 6    

              Data set ID Return_Message

Input/Output Output No of records 1

No Field ID Field Name Type Length Mandatory Remarks

1 RETURN_TYPE Return Type CHAR 1 Y RETURN_TYPE : 'S' - Success, 'F' - Failure

2 ERR_CODE Error Code CHAR 10    3 ERR_MSG Error Message CHAR 100    

5

4. Data structure putReservation Input

<?xml version="1.0" encoding="UTF-8"?><PUT_BOOKING> <BOOKING_REQUEST> <COMPANY>C4B1</COMPANY> <ASC_CODE>000178162</ASC_CODE> <SERVICEORDER_NO>4001221112</SERVICEORDER_NO> <MODEL_CODE>PS42C450B1W</MODEL_CODE> <PRODUCT_GROUP>CTVPL</PRODUCT_GROUP> <COUNTRY>BE</COUNTRY> <REGION>41</REGION> <POST_CODE>4100</POST_CODE> <CITY>SEVILLA</CITY> <PUR_PLACE/> <ADDRESS1/> <ADDRESS2>100</ADDRESS2> <ADDRESS3/> </BOOKING_REQUEST> <TIME_SLOT_CHOSEN> <TIME_SLOT_TYPE>A</TIME_SLOT_TYPE> <TIME_SLOT_ID>TS20130125160000r176</TIME_SLOT_ID> <AVAILABLE_DATE>20130125</AVAILABLE_DATE> <AVAILABLE_TIME_FR>160000</AVAILABLE_TIME_FR> <AVAILABLE_TIME_TO>170000</AVAILABLE_TIME_TO> <AVAILABILITY>1</AVAILABILITY> </TIME_SLOT_CHOSEN></PUT_BOOKING>

<?xml version="1.0" encoding="UTF-8"?><PUT_BOOKING_RESULT> <RETURN_TYPE>S</RETURN_TYPE> <ERR_CODE>0000</ERR_CODE> <ERR_MSG/></PUT_BOOKING_RESULT>

putReservation Output

8

4. Data structure Booking – putCancelBooking

Data set ID Cancel_Request

Input/Output Input No of records 1

No Field ID Field Name Type Length Mandatory Remarks

1 COMPANY Company Code CHAR 4 Y  2 ASC_CODE ASC Code CHAR 10 Y  3 SERVICE ORDER NO GCIC Transaction Number CHAR 10 Y                            

              Data set ID Return_Message

Input/Output Output No of records 1

No Field ID Field Name Type Length Mandatory Remarks

1 RETURN_TYPE Return Type CHAR 1 Y RETURN_TYPE : 'S' - Success, 'F' - Failure

2 ERR_CODE Error Code CHAR 10    3 ERR_MSG Error Message CHAR 100