关于DocuSign API自动填充签署日期日/月/年的技术问询

Great question! I’ve worked through this exact use case with DocuSign API integrations, so let’s break down the two most reliable approaches to auto-populate the day, month, and year fields with the signing date (not just the envelope creation date):

1. Pre-Populate Text Tabs with Server-Side Date Calculation #

If you want to set the date when the envelope is created (and don’t need it to update if signing happens later), standard text tabs paired with server-side date logic work perfectly:

• On your backend, calculate the current date (or expected signing date) using your language’s built-in date tools—like datetime.today() in Python or DateTime.Now in C#.
• Split the date into day, month, and year components. Format the month as a full name (e.g., "October") or abbreviation ("Oct") to match your contract’s requirements.
• When defining each text tab in your envelope request, set the value field to the corresponding component, and add locked: true to prevent signers from editing the auto-filled content.

Simplified JSON snippet for a day tab:

{
  "tabLabel": "signing_day",
  "value": "15",
  "locked": true,
  "xPosition": "100",
  "yPosition": "200",
  "documentId": "1",
  "pageNumber": "1"
}

2. Use Formula Tabs for Dynamic Signing Date Values #

If you need the date to reflect the exact day the signer completes their signature (not when the envelope was sent), DocuSign’s formula tab is the ideal solution. It uses real-time functions that evaluate when the signer views the document:

• For the day field: Use DAY(TODAY()) to get the numeric day (e.g., 15).
• For the month field: Use TEXT(TODAY(), "mmmm") for the full month name (e.g., October) or "mmm" for the abbreviation (e.g., Oct).
• For the year field: Use YEAR(TODAY()) to get the 4-digit year (e.g., 2024).

When configuring formula tabs, remember to:

• Set locked: true so signers can’t modify the auto-generated value.
• Align the tab’s xPosition, yPosition, documentId, and pageNumber with the blank fields in your contract.

Simplified JSON snippet for a month formula tab:

{
  "tabLabel": "signing_month",
  "formula": "TEXT(TODAY(), \"mmmm\")",
  "locked": true,
  "xPosition": "150",
  "yPosition": "200",
  "documentId": "1",
  "pageNumber": "1"
}

Key Notes #

• Formula tabs evaluate in real-time, so they’ll always show the date the signer accesses the document (their signing date).
• Adjust the formula syntax if you need specific formatting—like 2-digit days or numeric months (check DocuSign’s formula reference for more options).
• Test with a dummy signer first to confirm the date components populate correctly before sending to real users.

内容的提问来源于stack exchange，提问作者user982124