Skip to main content

Google Sheets: export deals to a spreadsheet

The Google Sheets export sends one row per deal to a Google Sheet you own, for example a commission tracker. You pick the sheet, the tab, and the deal statuses that trigger the export. DocJacket fills in the row.

Where to find it​

Go to Settings > Advanced > Google Sheets. It is not a card on Settings > Integrations; it has its own page.

Owners and admins can save the settings. The page also shows for members who have been given access to advanced settings.

Set it up​

  1. Share your Google Sheet with the service-account email shown at the top of the page, and give it Editor access. Use the copy button next to the email.
  2. Paste the Google Sheet URL. When you click out of the field, the page checks access and shows "Sheet is accessible" or an error.
  3. Enter the Tab name. It must match the tab in your sheet exactly, including capital letters.
  4. Set the Trigger statuses. These are the deal statuses that send a row. Type each status exactly as it is named in your account. Capital letters don't matter, but spelling, spaces and renamed statuses do. At least one is required. The defaults are Under Contract, Under Contract Buyer and Under Contract Seller.
  5. Check Enable automatic export.
  6. Click Save settings.
  7. Click Test export to check the connection. It adds a sample row with the address "TEST — 123 Sample Street" and a note saying it is safe to delete. Delete that row from your sheet afterward.

A status card on the page shows when the last export ran and whether the connection is Active or Degraded.

When a row is sent​

A row is sent when a deal's status changes to one of your trigger statuses. That includes changing the status from the status chip at the top of the deal, from the deal's Edit form, and moving a listing to under contract.

  • Creating a deal does not send a row by itself.
  • The first time a deal reaches a trigger status, DocJacket adds a new row to the bottom of the tab.
  • If the same deal reaches a trigger status again later, DocJacket updates that deal's existing row with the current values and a new timestamp. It does not add a second row. DocJacket finds the row by the deal ID in column Z, so it doesn't matter where the row is now.
  • There is no button to send a single deal on demand.

What each row contains​

The export sends much more than the address. Each row has 26 columns, A through Z, in this order:

ColumnWhat it holds
AExport date and time, in UTC
BProperty address
CAgent: the listing agent on a seller-side deal, the buyer's agent otherwise
DContract date
EDue diligence / inspection deadline
FClosing date
GThe deal's status at the time of the export
HContract price
IGross commission for the deal's side: the commission dollar amount on the deal if one is entered, otherwise the contract price times the commission rate, rounded to the cent. Blank if the deal has neither an amount nor both a price and a rate
JTeam split. Blank unless DocJacket has set up commission splits for your account. Splits are not self-serve yet
KAdmin / TC fee: the deal's TC fee, or the total of its TC fee entries. Shows TC fee missing if the deal has neither
LLead source: the deal's Listing Source if it has one, otherwise its Lead Source
MAlways blank
NLender
OReferral: the computed referral amount when a commission was computed, otherwise the deal's referral fee
P, QAlways blank (two expense-cap columns)
RCommission percentage for the deal's side, such as 3%. Shows rate missing if the deal has none
SContingent: Yes if an inspection, appraisal or financing contingency is Active, otherwise N
TClient name: the seller on a seller-side deal, the buyer otherwise
UCity
VProperty type
WBuy/Sell: Buy, Sell or Dual
XAlways blank
YThe deal's Additional Notes field
ZThe deal's DocJacket ID. DocJacket uses it to find the deal's row again. Don't edit or clear it.

Dates are written as text, so Google Sheets won't reformat them.

What you can and can't change​

You can change the sheet, the tab, the trigger statuses, and turn the export on or off.

You can't choose, remove or reorder the columns. The layout above is fixed. The export writes data rows only and never writes column headings, so type your own headings into row 1 of the tab to match the columns (for column Z, something like DocJacket ID).

Troubleshooting​

  • Status shows Degraded. The card shows the last error. DocJacket marks the export Degraded after 5 failed attempts in a row.
  • "Sheet is accessible" doesn't appear, or exports fail. Check that the sheet is shared with the service-account email as Editor, and that the Tab name matches your tab exactly.
  • No row appears when a deal changes status. Check that Enable automatic export is on, that the new status is spelled exactly like one of your Trigger statuses, and that the sheet is saved in the settings.
  • Sorting and moving rows is fine. DocJacket finds each deal's row by the ID in column Z, so you can sort, filter, and insert or delete rows. If you delete a deal's row, or clear its ID, the next export adds a new row for that deal at the bottom.
  • You switched to a different sheet or tab. Each deal gets a new row in the new sheet or tab the next time it reaches a trigger status. Rows in the old sheet are left as they are.
  • Columns I and J are empty. That is expected unless commission splits have been set up for your account.