Question

我们正在使用WebHook事件，也称为Connect，它类似于SOAP API调用，用于更新Web应用程序中的文档签名状态。创建或更新DocuSign文档时，Webhook事件中推送的XML数据包含无效的TimeZoneOffset数据。

例如：印度标准时间的偏移量为+5:30，但在xml中仅显示5。

请参阅下面的xml片段：

<DocuSignEnvelopeInformation>
        ...
            </DocumentStatus>
        </DocumentStatuses>
    </EnvelopeStatus>
    <TimeZone>India Standard Time</TimeZone>
    <TimeZoneOffset>5</TimeZoneOffset>

Answer 1

这是一个常见的误解，以及为什么我有文档小组记录这个，作为我的客户|开发人员总是问这个。以下是解释什么时间/日期设置和格式影响日期/时间数据的链接。

https://www.docusign.com/p/APIGuide/Content/Introduction+Changes/Appendix-Time%20Zone.htm

摘录如下：

REST API ：从REST API获取信息时，所有非PDF时区响应都以ISO 8601日期/时间格式返回，使用GMT作为时区。通过REST API检索的PDF项目，例如完成证书或带有日期标签的文档，使用先前描述的完成证书和PDF文档设置。

SOAP API ：从SOAP API获取信息时，所有非PDF项目都使用时区用于API选项设置的时区。通过SOAP API检索的PDF项目，例如完成证书或带有日期标签的文档，使用先前描述的完成证书和PDF文档设置。

API调用的日期/时间格式所有DocuSign SOAP和REST API请求都必须使用ISO 8601日期/时间格式。 REST API假定传递的所有值都代表UTC日期/时间。

为DocuSign REST API提供日期/时间格式时，首选格式为：

＆＃34; yyyy-MM-dd | HH：MM＆＃34; ＆＃34; MMMM d，yyyy | HH：MM＆＃34; ＆＃34; MMM-dd-yyyy | HH：MM＆＃34; ＆＃34; dd-MM-yyyy | HH：MM＆＃34;

Answer 2

我刚刚确认此问题仍然存在。我将我的API时区设置为尼泊尔（GMT + 5：45），并收到了一个包含以下内容的Connect POST：

尼泊尔标准时间5

省略小数部分（0:45）。

先生。 Grigsby的响应非常有趣，但与尼泊尔标准时间和印度标准时间的偏移量不是5的事实无关，因此Connect / Webhook发布的信息不正确。

但是，有一个简单的解决方法。世界上只有少数这样的时区。我们可以将它们的字典合并到我们的webhook处理程序中，从而根据节点值确定偏移量。

立即实施我的解决方法。这看起来很方便：https://www.timeanddate.com/time/time-zones-interesting.html

Docusign在WebHook事件数据中提供不正确的TimezoneOffset

2 个答案: