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

RequirementNotes
Adobe Sign API Integration KeyGenerated once in the Adobe Sign admin portal (Account → Integrations → API Applications).
SharePoint document libraryThe connector stores both the original and the signed PDF here.
Business Central user permissionsSPC SETUP and SPC E-SIGN permission sets (included with the app).
Outbound email deliveryEnsure users receive Adobe Sign emails; whitelist @adobesign.com if needed.

3. One-Time Setup

3.1 Create an API key in Adobe Sign

  1. Sign in to Adobe Sign as an administrator.

  2. Navigate to Account → Integrations → API Applications.

  3. Click + Create → “API Application”.

  4. Name it BC SharePoint Connector (or similar).

  5. Under Authentication, choose User OAuth.

  6. Tick User agreement read/write and Library templates.

  7. Save and copy the Integration Key—you’ll paste it into Business Central.

3.2 Configure the connector in Business Central

  1. Open Business CentralSearchSharePoint Connector Setup.

  2. In the E-Signing FastTab, switch Adobe Sign Active to On.

  3. Paste the Integration Key into API Key.

  4. Press Test Connection. A green check confirms the handshake.

  5. (Optional) Define a Default Adobe Sign Account Email if different from your BC user email.

  6. 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

  1. Navigate to the record that owns the document (e.g., Customer Card, Sales Order, Purch. Invoice).

  2. In the SharePoint Attachments FactBox, select the PDF you want signed.

  3. Choose Actions → E-Signing (this button appears once Adobe Sign is active).

  4. Recipient window opens:

    • Primary signer pre-fills with your customer’s contact if available.

    • Click + Add Recipient for additional signers (max 10).

  5. (Optional) Attach extra files—the connector merges them into a single signing package.

  6. 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 BCMeaningTypical Next Step
Sent to AdobePackage was accepted by Adobe Sign API.Wait or remind signer.
Out for SignatureEmail delivered; waiting for recipient.Nothing—Adobe Sign sends automatic reminders.
SignedAll recipients completed signing.Use or archive the signed PDF.
Declined / CanceledRecipient 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:

  1. Downloads the certified PDF.

  2. Stores it in the same SharePoint folder, appending “ _signed” to the file name.

  3. 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

SymptomCauseFix
“Invalid API Key” on test connectionKey revoked or wrong accountRegenerate key in Adobe Sign; update BC setup.
Status stuck at Sent to AdobeRecipient email typo / spam filterVerify email, resend; whitelist Adobe domains.
Counterparty can’t open linkOutdated browser or corporate firewallAdvise using Chrome/Edge; ensure *.adobesign.com is accessible.
Signed PDF not returnedIntegration user lacks “REST API” permissionGrant 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

  1. Open DocuSign Setup

    • BC Search ➜ DocuSign Setup (SharePoint Connector).

  2. Paste API credentials

    • Client ID, User ID, Auth Secret, Base URL.

    • Set the callback URL to https://businesscentral.dynamics.com/<tenantid>/<environment>?page=70319480

  3. Test Connection

    • Click Connect. Status should change to Connected.

  4. 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

  1. Create or open the document

    • Example: Navigate to Customers ➜ Documents ➜ New and choose a template (e.g., Letter to Customer).

  2. Save in SharePoint

    • When you close the in-place Office editor, the connector automatically stores the file.

  3. Launch E-Signing

    • On the document or customer page: Process ➜ E-Signing.

  4. Add recipients & options

    • Enter one or multiple signers in the order they should sign.

    • Optional: Add Attachments to merge multiple files into one envelope.

  5. 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

  1. Open the original document record in BC.

  2. Choose E-Signing ➜ Check Status.

    • Status values: Sent, Delivered, Completed, Declined, Voided.

  3. When status is Completed, a ✓ appears and the Signed PDF is added to the same SharePoint folder (alongside the source file).

  4. 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.