10.07.2015 Views

SuiteTalk (Web Services) Platform Guide - NetSuite

SuiteTalk (Web Services) Platform Guide - NetSuite

SuiteTalk (Web Services) Platform Guide - NetSuite

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

<strong>Web</strong> <strong>Services</strong> OperationsgetServerTime187getServerTimeThis operation takes no arguments and returns the <strong>NetSuite</strong> server time in GMT, regardless ofa user’s time zone. Developers do not have to rely on client time when writing synchronizationprocedures because the client time may not be in synch with the <strong>NetSuite</strong> server time.If you choose, you can write client code that takes the GMT returned by <strong>NetSuite</strong> and convertthe time to your local time zone. The format of the dateTime value returned by getServerTimecontains integer-valued year, month, day, hour and minute properties, a decimal-valued secondproperty and a boolean time-zoned property (timestamp) – for example, 2005-09-21T15:24:00.000-07:00, where 2005-09-21 is the date, 15:24:00.000 is the time and -07:00 isyour own time zone offset, if you choose to set one.Any user with an active session can call getServerTime. There are no explicit permissions forthis operation. For example, if you need to synchronize customer data with <strong>NetSuite</strong>, you cancall getServerTime to initialize your synchronization process. To synchronize new or changedcustomers records, you can search customers and filter by lastModifiedDate using the valuereturned in getServerTime. To synchronize deleted customer records, you can call thegetDeleted operation and use the value returned in getServerTime. This makes yoursynchronization process independent of your client time,which may not be in sync with the<strong>NetSuite</strong> server time and hence the timestamp we use to track changes.RequestThe GetServerTimeRequest type is used for the request. It takes no arguments.ResponseThe GetServerTimeResponse type is used for the response. It contains the following elements.Element Name XSD Type NotesresponseGetServerTime See GetServerTimeResult, below.ResultGetServerTimeResultThe GetServerTimeResult type contains the following elements.Element Name XSD Type Notesstatus Status The status for this request. All applicable errors or warnings willbe listed within this type, which is defined in the platformCoreXSD.serverTime dateTime dateTime value returned is in GMT.<strong>SuiteTalk</strong> <strong>Platform</strong> <strong>Guide</strong>

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!