als_insert_client.cgi

The als_insert_client.cgi interface inserts a new client into the AL-Desk Client table. The primary key of the Client table is an Integer field named Code. Upon successful insertion the new data is returned as XML including the unique identifier for the new client.That identifier can be used to update the client row using the als_update_client.cgi method.

Client information includes the optional fields of arrival and departure date. It is common in the travel industry to consider the same clients as new clients when they return for another visit.

You also may want to require arrival and departure dates and check them when users book an activity (write a voucher). Currently the Web Portal API does no error checking when writing a voucher as to whether the arrival and departure date match an activity date.

All client changes, including inserts and updates are logged so that AL-Desk Audit trail changes are preserved.

http://127.0.0.1/als_insert_client.cgi?webusercode=1&lastname=browningd&email=aaaa@hotmail.com&arrivaldate=2005-05-21&departuredate=2005-05-31&cellphone=12345&faxphone=12361&homephone=43212

Parameter	Description	Required	Example	Data Type
webusercode	Code from WiUsers required for insert access	Required	code=5	Integer
lastname	Last Name of the Client	Required	lastname=Smith	String
firstname	First Name of the client	Optional	firstname=John	String
email	Email of the Client	Optional	email=jsmith@gmail.com	String
hotel	Hotel Code of the Client using a valid code from als_get_hotels.cgi	Optional	hotel=1	Integer
room	Room of the Client	Optional	room=200	String
homephone	Home Phone of the Client	Optional	homephone= 415-323-2322	String
faxphone	Fax of the Client	Optional	faxphone= 415-634-3222	String
cellphone	Client Cell Phone	Optional	cellphone= 415-654-2322	String
workphone	Client Work Phone	Optional	workphone= 415-323-2331	String
otherphone	Client Other Phone	Optional	otherphone= 415-987-4422	String
notes	Any Notes for the Client	Optional	notes= hello%20world Note: spaces must be escaped for http inputs	String
arrivaldate	Arrival Date of the Client	Optional	arrivaldate= 2005-05-31	Date
depaturedate	Departure Date of the Client	Optional	depaturedate= 2005-06-10	Date

Note: the important field returned is the code field that contains the unique id for the new client added to the table.