We're using the DocuSign SDK (version 3.5.0) We are developing an integration with DocuSign using JWT authentication.
In regional settings of the account, I have set the value of time zone to Canberra, Melbourne, Sydney.
But, whatever the time zone is, in webhooks, the datetime fields are always in UTC. Also, I have noticed that the other APIs such as (audit trail endpoint) also returns the datetime field in UTC.
Will this be constant or this can be changed by any other methods?
DocuSign's developer support group can update your account's API Timezone to a timezone other than UTC. But:
The API Timezone may not work with the newest JSON Connect webhook notification messages.
If your application is later connected to any additional accounts, then you'd need to have those accounts updated too.
My recommendation is that your software change the timezone for the incoming UTC datetime values. There are library methods for doing this for all languages. (Don't try to write the code by hand, there are some weird corner cases.)
Related
My Stripe API in Developer settings is 2021+. It means it uses the newer payment methods API with i.e. Ids of payment methods prefix being pm_. I noticed when I create a card through the Dashboard though, it appears in logs as an 2019 API version call, and the card ID prefix becomes card_.
Is it the expected behaviour? My concern is that the Dashboard calls the 2019 API despite 2021+ being set up in the settings.
Testing out the platform I was running on both a developer account and a Trial Business Pro account until I purchased a standard plan.
Up until I purchased the standard plan, envelope statuses would update by the second and the functionality built with the Apex Toolkit was working well.
Once changing to the standard paid plan, envelopes statuses take 10-15 minutes to update and some functionality is not working.
My question is:
Do the different plans have different status updating times in Salesforce?
Is functionality of the Apex Toolkit limited between the different plans?
Does the Connect option (which is missing now) have anything to do with the above?
Thanks!
They do not. Writeback to Salesforce takes place via DocuSign Connect. Some plans don't support Connect out of the box but the actual writeback times / delays do not differ between account plan types.
Indirectly, the only way that a plan type can interfere with an API call that worked on another plan type is if it had entitlement to a feature that your new plan does not, IE: The ability to allow Comments, to set recipient signing language, to set envelopeID Stamp Control, etc...
I would highly suspect that it does -- in fact I'm a little surprised that your writebacks are happening at all if you don't have Connect enabled. Salesforce adds an object reference IE: Opportunity / AccountIds to the envelope's custom fields on send. When Connect sees these fields, it knows to write back to that specific object. Without Connect enabled and configured it shouldn't be able to process these writebacks at all.
I think you should have a conversation with your Account Rep first regarding Connect entitlement, then you can reconnect your Salesforce instances to the updated DocuSign account which is something that we can help you with.
Regards,
Matt
I am a signer and sender of a document. The time zone configured under Regional Settings in Admin and My Preferences is Mountain Time but the time zone from the event notification is Pacific Time with an offset of -7 (Mountain Time).
The documentation states:
Date Signed field: The time zone and date/time format information shown in >Date fields and form data in the signing user interface and PDF documents >depends on the signer:
If the signer has a DocuSign account, then the signer's time zone and the >sender's date/time format settings are used for the information. If the >sender’s account does not allow users to set their own date/time format, then >the date/time format setting for the account is used. Note: By Default, all >signer accounts are set to a default of PST for the time zone.
There is no 'time zone' under Signing Settings.
Expecting <TimeZone>Mountain Standard Time</TimeZone> but receiving <TimeZone>Pacific Standard Time</TimeZone>
EDIT: As a separate but related question: Is the time zone shown in the event notification the time zone specified in the account settings? This post says it is Completed event notification - date time zone but that is 2 years old now so just wanted to be sure.
The DocuSign Connect timezone passed is a legacy setting and in order to change it you'll need to contact the DocuSign Developer Support. Thanks.
For webhook event notifications, the completed event in particular, will the delivered and signed dates always be in PST or will they vary based on the server the user's base url points at or their account? I don't see that mentioned anywhere in documentation and it's impossible to tell from a demo account.
Of note:
1) We are not using Connect, just redirect url(s) on our integrator key that are added to envelope definition's envelope notification properties.
2) We are supporting multiple clients, each with their own DocuSign account.
The dates in the event notification will be in the Timezone that is set in your account settings. This will be applicable to all the envelopes sent from your account.
You can go to the Docusign Admin page and manage your account settings.
See this answer for more information.
EDIT:
You can set the property includeTimeZone in your eventNotification. The envelope’s time zone information will then be included in the webhook messages.
I am using DocuSign Connect/DocuSign Event Notifications to update DocuSign envelope/recipient statuses. I have written a .net application that parses an XML posted by Connect/Event notifications to update the statuses. Since each of my client's DocuSign account lies in a different time zone, I retrieve time zone of each of my client's DocuSign account from Connect update and my .net application adds offset based upon the time zone to update the statuses.
I need to know all possible values of DocuSign account time zone that I can retrieve from XML posted by Connect/Event notifications as the time zone values in DocuSign account are different than the time zone values that I get from Connect updates.
For example, if the time zone set in the DocuSign account is "Pacific Time(US & Canada)",the time zone that I get from Connect/Event notifications is "Pacific Standard Time".
Is there is a list of all possible values of Time zone that DocuSign Connect process posts?
Connect will use your Time Zone used for API for almost all of the timestamps.
In Features, Set Time Zone used for API:
The correct Time Zone will be used in your Connect XML:
There are very few time entries in Connect that do use UTC and they are identified with a Z.
Example: 2014-07-24T18:09:14.9430000Z
This should be manually converted by your listener to the approperiate time zone.