DocuSign事件通知

Question

我正在将DocuSign API集成到我们的应用程序中。我被困在一个地方，我必须把一个公共URI作为'EventNotification‘和信封一起发送。我的公共URI只不过是一个asp.net web。我搞不懂DocuSign将如何向我发送以下信息：- EnvelopeId - DocumentId (签名或拒绝)-已完成或拒绝-签名者信息(姓名和电子邮件id)

假设我的API如下所示：

[ActionName("DocuSignDocumentStatus")]

[HttpPost]

public void DocuSignDocumentStatus()
{

}

我的行动是得到还是张贴在这里？我的动作签名会包含哪些参数？

公共空DocuSignDocumentStatus(字符串envelopeId？)和/或字符串documentId和/或字符串已完成/拒绝和/或.)

请帮帮忙。

Answer 1

信封上的DocuSign eventNotification功能就像DocuSign连接模块一样，只不过是基于每个信封而不是连接的帐户级别。

eventNotification和DocuSign连接都会将实时的XML格式化消息发送给您为接受此类请求而设置的可公开访问的http侦听器。发送的始终是一个http POST，您需要在您的端编写逻辑来解析传入的消息。

例如，这就是XML可能看起来的样子，以及您需要解析的内容：

<?xml version="1.0" encoding="UTF-8"?>
<DocuSignEnvelopeInformation xmlns="http://www.docusign.net/API/3.0" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <EnvelopeStatus>
      <RecipientStatuses>
         <RecipientStatus>
            <Type>Signer</Type>
            <Email>user.email@address.com</Email>
            <UserName>User Name</UserName>
            <RoutingOrder>1</RoutingOrder>
            <Sent>2010-06-26T09:19:18.883</Sent>
            <Delivered>2010-06-26T09:19:40.723</Delivered>
            <DeclineReason xsi:nil="true" />
            <Status>Delivered</Status>
            <RecipientIPAddress>::1</RecipientIPAddress>
            <CustomFields />
            <TabStatuses>
               <TabStatus>
                  <TabType>Custom</TabType>
                  <Status>Active</Status>
                  <XPosition>364</XPosition>
                  <YPosition>52</YPosition>
                  <TabLabel>Radio</TabLabel>
                  <TabName>Two</TabName>
                  <TabValue />
                  <DocumentID>1</DocumentID>
                  <PageNumber>2</PageNumber>
                  <OriginalValue />
                  <ValidationPattern />
                  <RoleName>TestRole</RoleName>
               </TabStatus>
            </TabStatuses>
            <AccountStatus>Active</AccountStatus>
            <RecipientId>fb89d2ee-2876-4290-b530-ff1833d5d0d2</RecipientId>
         </RecipientStatus>
      </RecipientStatuses>
      <TimeGenerated>2010-06-26T09:19:45.771206-07:00</TimeGenerated>
      <EnvelopeID>0aa561b8-b4d9-47e0-a615-2367971f876b</EnvelopeID>
      <Subject>CreateEnvelopeFromTemplates Test</Subject>
      <UserName>User Name</UserName>
      <Email>user.email@address.com</Email>
      <Status>Delivered</Status>
      <Created>2010-06-26T09:16:21.27</Created>
      <Sent>2010-06-26T09:19:19.01</Sent>
      <Delivered>2010-06-26T09:19:40.747</Delivered>
      <ACStatus>Original</ACStatus>
      <ACStatusDate>2010-06-26T09:16:21.27</ACStatusDate>
      <ACHolder>ACHolder Name</ACHolder>
      <ACHolderEmail>ACHolder.email@address.com</ACHolderEmail>
      <ACHolderLocation>ACHolder Location</ACHolderLocation>
      <SigningLocation>Online</SigningLocation>
      <SenderIPAddress>::1</SenderIPAddress>
      <EnvelopePDFHash />
      <CustomFields>
         <CustomField>
            <Name>Envelope Field 1</Name>
            <Show>False</Show>
            <Required>False</Required>
            <Value />
         </CustomField>
         <CustomField>
            <Name>Envelope Field 2</Name>
            <Show>False</Show>
            <Required>False</Required>
            <Value />
         </CustomField>
      </CustomFields>
      <AutoNavigation>true</AutoNavigation>
      <EnvelopeIdStamping>true</EnvelopeIdStamping>
      <AuthoritativeCopy>false</AuthoritativeCopy>
      <DocumentStatuses>
         <DocumentStatus>
            <ID>1</ID>
            <Name>Document_Name</Name>
            <TemplateName>radio parents</TemplateName>
            <Sequence>1</Sequence>
         </DocumentStatus>
      </DocumentStatuses>
   </EnvelopeStatus>
   <DocumentPDFs>
      <DocumentPDF>
         <Name>DocumentPDF_Name</Name>
         <PDFBytes>PDFBytes_Information</PDFBytes>
      </DocumentPDF>
   </DocumentPDFs>
</DocuSignEnvelopeInformation>