VATable uses three main document templates in GHL. Each serves a specific purpose in the client onboarding and engagement process.
Outlines the engagement terms, fees, and scope of work. Sent automatically when an opportunity moves to "Proposal Sent".
Formal agreement to engage. Client signs to confirm they are appointing VATable. Triggers case management workflows when signed.
HMRC authorisation form. Client signs to allow VATable to act as their tax agent. Required for all tax cases.
The proposal is sent automatically via the workflow named "2. Business Development - Send Proposal - Opportunity". This workflow has 116 total enrollments to date, confirming it is actively used.
You can send any document template manually to a contact at any time. This is useful for resending a document, sending documents outside the normal workflow, or when the automated sending did not trigger.
Every document you send goes through a clear status lifecycle. GHL tracks this automatically so you always know where a document stands.
| Status | What It Means | Action Required |
|---|---|---|
| Sent | The document email has been delivered to the client's inbox. They have not opened it yet. | Wait 1-2 business days. If still not opened, consider a follow-up call or resend. |
| Opened | The client has opened the document link but has not signed yet. They may be reviewing it or have questions. | If open for more than 2 days without signing, follow up to ask if they have questions. |
| Signed | The client has applied their e-signature and submitted the document. Workflows trigger automatically. | No action needed. Confirm the associated workflows have fired correctly (see sections 6 and 7). |
| Declined | The client has actively declined to sign the document. | Contact the client to understand their concerns. You may need to amend the document and resend. |
| Expired | The document signing link has expired before the client acted. | Resend the document. See Section 8. |
There are two places to check:
When a client signs the Engagement Letter, two automated workflows fire to handle the next steps. This is the most important document in the VATable process because it transitions the client from a prospect into an active case.
27 enrollments to date · Published · Moves the client's opportunity from the Sales Pipeline into the Case Management Pipeline.
WF8 logs a note to the contact record confirming the document was signed, including the engagement duration (using the {{opportunity.per_month_for}} merge field). Merge field fixed on 18 March 2026.
The 64-8 is the HMRC authorisation form that allows VATable to act as the client's tax agent. When a client signs it digitally, the following happens automatically:
WF8 adds a note to the contact record confirming that the 64-8 authorisation has been signed. This note includes the engagement details via the {{opportunity.per_month_for}} merge field. Live
If a client has lost the email, the signing link has expired, or the document was sent to the wrong email address, you can resend it.
Following these practices will ensure documents are processed smoothly and clients have a positive signing experience.
| Practice | Why It Matters |
|---|---|
| Always check document status before chasing a client | Open the contact's Documents tab first. If the status shows "Opened" 20 minutes ago, the client may still be reading. Do not call them immediately -- give them time. |
| Use the Documents tab on the contact record | This is the single source of truth for a contact's document history. Do not rely on email threads to track signing status. |
| Preview before sending | Always click Preview in the document editor before sending. Check that all merge fields have resolved correctly, especially monetary amounts, dates, and names. |
| Send one document at a time | Sending the Engagement Letter and 64-8 simultaneously can overwhelm clients. Send the Engagement Letter first. Once signed, send the 64-8. |
| Follow up on "Opened" documents after 48 hours | If a client opened the document but hasn't signed within 2 business days, call or email to ask if they have questions. |
| Do not edit templates without team agreement | Template changes affect all future documents. Discuss any edits with Charles before making changes. |
| Download signed copies for your records | GHL stores signed documents, but always download a copy of signed 64-8 forms for HMRC submission and keep them in the client's file. |
| Check opportunity stage before sending | The "Documents Signed" workflow relies on the opportunity being in the correct stage. If the opportunity is not in "Proposal Sent" when the Engagement Letter is signed, the automation will not fire. |
The following issues have been identified and are in the process of being resolved. Be aware of these when working with documents.
| Issue | Impact | Status |
|---|---|---|
| Engagement letter occasionally sent twice (IP3) | Clients receive duplicate emails with the same document. This undermines trust and causes confusion. |
Fix In Progress
Root cause: The same workflow triggers twice when the opportunity is moved to "Proposal Sent" more than once. Fix: Add an engagement-letter-sent tag guard so the workflow exits immediately on re-entry.
|
| "Documents Signed" workflow may not fire (Item 2) | After signing, the opportunity does not automatically move to Case Management. Requires manual intervention. |
Investigation Needed
The "Find Opportunity" step fails if the opportunity is not in the "Proposal Sent" stage at signing time. Check Execution Logs when this occurs. |
| Issue | Details | Status |
|---|---|---|
| Name auto-filling above signature (Item 10) | The client's name appears as typed text above the signature block, in addition to the signature itself. Only the signature should be there. | Manual Fix Pending |
| VAT number boxes misaligned (Item 11) | The 9-digit VAT registration number digits are not landing in the correct boxes on the HMRC form layout. | Manual Fix Pending |
| Agent code not added (Item 12) | VATable's newly issued HMRC agent code needs to be added to the form. Currently blank or showing a placeholder. | Manual Fix Pending |
| Client reference not pulling through (Item 13) | The Client Reference field from the opportunity does not auto-populate in the 64-8. Linked to the Proposal's P7 fix. | Manual Fix Pending |
| iPad / mobile signing issues (Item 14) | The signature box is too small on tablets, layout overflows, and the submit button may be hidden on mobile devices. | Manual Fix Pending |
| Address on single line (Item 64-1) | The client address appears on one line instead of three (street, city, postcode). Does not match the HMRC form layout. | Manual Fix Pending |
| Ref | Issue | Status |
|---|---|---|
| P1 | Proposal does not fit laptop screen properly -- layout/scaling needs adjustment for A4 format. | Manual Fix Pending |
| P2 | No line break after salutation -- "Dear [Name]," runs directly into the next paragraph. | Manual Fix Pending |
| P3 | "You have been making payments of" line appears even when the payment field is blank. | Manual Fix Pending |
| P4 | The word "months" is missing after the auto-filled number of months (reads "12" instead of "12 months"). | Manual Fix Pending |
| P5 | Outdated reference to Charles issuing an information request needs to be removed. | Manual Fix Pending |
| P6 | "Arrangements need to be made by" line appears with a blank date when no deadline is set. | Manual Fix Pending |
| P7 | Client Reference format not finalised -- Charles and Jock to agree on the format. | Awaiting Decision |
| Fix | Details | Status |
|---|---|---|
| WF8 merge field | The {{opportunity.per_month_for}} merge field in the auto-note was not resolving. Fixed 18 March 2026. |
Live |
| Appendix 1 layout (C22) | Appendix 1 layout on the Engagement Letter has been tidied up. | Completed |
| Jock's signature (C23) | Jock's signature has been loaded onto the Engagement Letter template. | Completed |
| BDM Form label (C14) | "Send Engagement Letter" has been renamed to "Yes - Send Proposal" on the BDM form. | Completed |
| Task | Where | Key Action |
|---|---|---|
| View document templates | Payments > Documents & Contracts > Documents tab | Click template name to preview |
| Send a document manually | Contact record > Documents tab > + New | Select template, review, click Send |
| Check document status | Contact record > Documents tab | Look for Sent / Opened / Signed status |
| View all sent documents | Payments > Documents & Contracts > Sent Documents tab | Use search and filters to find specific docs |
| Resend a document | Contact record > Documents tab > three-dot menu | Click Resend or Copy Link |
| Download signed document | Contact record > Documents tab > Signed document row | Click to download the signed PDF |
| Edit a template | Payments > Documents & Contracts > three-dot menu > Edit | Discuss with team before editing |