SharePoint Connector
E-Signing with Adobe Sign and DocuSign
Which e-signing services are supported by the SharePoint Connector?
Adobe Sign and DocuSign are both supported by the SharePoint Connector.
How to use Adobe Sign with SharePoint Connector
1. Overview
The Hougaard SharePoint Connector lets you move any Business Central document into SharePoint and route it to an e-signature service. This guide walks you through the complete Adobe Sign flow—configuration, sending, tracking, and retrieving the signed PDF—so you can replace manual signing with a seamless, audit-ready process.
Requirements:
• Adobe Sign “Business” plan or higher with API access
2. Prerequisites
Requirement | Notes |
---|---|
Adobe Sign API Integration Key | Generated once in the Adobe Sign admin portal (Account → Integrations → API Applications ). |
SharePoint document library | The connector stores both the original and the signed PDF here. |
Business Central user permissions | SPC SETUP and SPC E-SIGN permission sets (included with the app). |
Outbound email delivery | Ensure users receive Adobe Sign emails; whitelist @adobesign.com if needed. |
3. One-Time Setup
3.1 Create an API key in Adobe Sign
Sign in to Adobe Sign as an administrator.
Navigate to Account → Integrations → API Applications.
Click + Create → “API Application”.
Name it BC SharePoint Connector (or similar).
Under Authentication, choose User OAuth.
Tick User agreement read/write and Library templates.
Save and copy the Integration Key—you’ll paste it into Business Central.
3.2 Configure the connector in Business Central
Open Business Central → Search → SharePoint Connector Setup.
In the E-Signing FastTab, switch Adobe Sign Active to On.
Paste the Integration Key into API Key.
Press Test Connection. A green check confirms the handshake.
(Optional) Define a Default Adobe Sign Account Email if different from your BC user email.
Set the callback URL to https://businesscentral.dynamics.com/<tenantid>/<environment>?page=70319484
You’re now ready to request signatures.
4. Sending a Document for Signature
Navigate to the record that owns the document (e.g., Customer Card, Sales Order, Purch. Invoice).
In the SharePoint Attachments FactBox, select the PDF you want signed.
Choose Actions → E-Signing (this button appears once Adobe Sign is active).
Recipient window opens:
Primary signer pre-fills with your customer’s contact if available.
Click + Add Recipient for additional signers (max 10).
(Optional) Attach extra files—the connector merges them into a single signing package.
Review Email Subject/Message, then hit Send to Adobe Sign.
Tip: Use Business Central’s standard personalization to pin the E-Signing action exactly where your team expects it.
5. Tracking Signature Progress
Status in BC | Meaning | Typical Next Step |
---|---|---|
Sent to Adobe | Package was accepted by Adobe Sign API. | Wait or remind signer. |
Out for Signature | Email delivered; waiting for recipient. | Nothing—Adobe Sign sends automatic reminders. |
Signed | All recipients completed signing. | Use or archive the signed PDF. |
Declined / Canceled | Recipient refused or sender canceled. | Investigate and resend if needed. |
From the same FactBox, click Check Adobe Sign Status any time to refresh.
6. Retrieving the Signed PDF
Once Adobe Sign marks the agreement Completed, the connector automatically:
Downloads the certified PDF.
Stores it in the same SharePoint folder, appending “ _signed” to the file name.
Creates a new record version in Business Central so you never overwrite the original.
Double-click the new file to verify the applied signature stamp and Adobe’s cryptographic seal.
7. Automating Post-Signature Workflows (Advanced)
Developers can subscribe to the SPC E-SIGNATURE COMPLETED
event publisher to trigger follow-up logic, such as:
Auto-releasing a sales order.
Generating a posted invoice.
Sending a confirmation email to internal teams.
8. Best Practices & Tips
Brand your emails—edit the Adobe Sign email template to add your logo and support links.
Bulk signing—batch-post multiple documents and trigger one Adobe Sign envelope per customer.
Audit trail—the PDF includes a tamper-proof log; retain it for compliance.
Time-outs—Adobe Sign links expire after 30 days by default; adjust in your Adobe admin console.
9. Troubleshooting
Symptom | Cause | Fix |
---|---|---|
“Invalid API Key” on test connection | Key revoked or wrong account | Regenerate key in Adobe Sign; update BC setup. |
Status stuck at Sent to Adobe | Recipient email typo / spam filter | Verify email, resend; whitelist Adobe domains. |
Counterparty can’t open link | Outdated browser or corporate firewall | Advise using Chrome/Edge; ensure *.adobesign.com is accessible. |
Signed PDF not returned | Integration user lacks “REST API” permission | Grant role Account Admin or API User in Adobe Sign. |
10. FAQ
Q: Can I use both Adobe Sign and DocuSign?
Yes—enable either or both in SharePoint Connector Setup. The E-Signing dialog lets you pick the service per transaction.
Q: Where is the data stored?
Original and signed PDFs reside in your chosen SharePoint document library; minimal metadata (agreement ID, status) is stored in Business Central tables.
Q: Does the connector support parallel or sequential signers?
Sequential only (signers receive the document in the order you enter them). Parallel routing will be added in a future release.
Q: Are reminder emails automatic?
Yes—Adobe Sign sends default reminders at day 3 and day 7. Customize intervals in your Adobe Sign account settings.
How do I sign a document using DocuSign with the SharePoint Connector?
1 . Why use DocuSign with the SharePoint Connector?
-
Native BC workflow – trigger e-signature directly from a customer, sales, or service document card.
-
No file juggling – documents live in SharePoint before, during, and after signing.
-
Automatic status updates – see “Sent”, “Completed”, and download confirmations right inside BC.
-
Extensible – all functions are available to AL so partners can embed e-signing in custom processes.
2 . Prerequisites
Requirement | Notes |
---|---|
Business Central | v20 or later (SaaS or On-prem). |
SharePoint Connector | Version 5.2.0 or later. |
DocuSign account | Any plan that supports API access. |
API credentials | Integrator Key (Client ID), User ID, Auth secret, Base URL. Generate in DocuSign Admin → Apps & Keys. |
3 . One-time Setup
-
Open DocuSign Setup
-
BC Search ➜ DocuSign Setup (SharePoint Connector).
-
-
Paste API credentials
-
Client ID, User ID, Auth Secret, Base URL.
Set the callback URL to https://businesscentral.dynamics.com/<tenantid>/<environment>?page=70319480
-
-
Test Connection
-
Click Connect. Status should change to Connected.
-
-
Assign Permissions
-
Users need DocuSign E-Signature permission set (comes with the connector).
-
Tip – Sandbox or Developer accounts return documents with a “Demo” watermark; switch to Production credentials when you are ready to go live.
4 . Sending a document for e-signature
-
Create or open the document
-
Example: Navigate to Customers ➜ Documents ➜ New and choose a template (e.g., Letter to Customer).
-
-
Save in SharePoint
-
When you close the in-place Office editor, the connector automatically stores the file.
-
-
Launch E-Signing
-
On the document or customer page: Process ➜ E-Signing.
-
-
Add recipients & options
-
Enter one or multiple signers in the order they should sign.
-
Optional: Add Attachments to merge multiple files into one envelope.
-
-
Send
-
Click Send to DocuSign for Signature. BC displays the envelope ID and initial status Sent.
-
5 . Signer experience (external)
-
Each recipient receives a DocuSign email with “Review & Sign”.
-
They review, click Start, apply their signature, and press Finish.
-
DocuSign returns the completed PDF to BC automatically — no manual download required.
6 . Tracking status & retrieving the signed file
-
Open the original document record in BC.
-
Choose E-Signing ➜ Check Status.
-
Status values: Sent, Delivered, Completed, Declined, Voided.
-
-
When status is Completed, a ✓ appears and the Signed PDF is added to the same SharePoint folder (alongside the source file).
-
Click Open Document Location to view both the signed PDF and any DocuSign metadata files (useful for audits).
7 . Incorporating e-signing into custom workflows
-
All key procedures (
SendToDocuSign
,GetEnvelopeStatus
,DownloadSignedFile
) are exposed in codeunit SPC DocuSign Mgt
8 . Troubleshooting
Symptom | Likely Cause | Resolution |
---|---|---|
“Authentication failed” on connect | Wrong Client ID or Secret | Re-paste credentials; ensure no trailing spaces. |
Status stuck on Sent | Signer hasn’t completed | Ask recipient to finish; or verify email address. |
Signed PDF not downloaded | Envelope still processing | Wait up to 60 seconds and re-check status. |
Watermark “Demo Only” | Using sandbox account | Switch to production DocuSign API keys. |
9 . FAQ
Q: Can I collect multiple signatures in sequence?
A: Yes—add recipients in the desired order; DocuSign routes automatically.
Q: Does the connector support Adobe Sign too?
A: Absolutely—see the separate Adobe Sign Guide. The setup pages are parallel.
Q: How is the signed PDF secured?
A: DocuSign embeds an X.509 certificate and tamper-evident seal; the connector stores the untouched file in SharePoint.