Bind the authorized tenant
Xero describes tenant connections created through authorization. Keep the selected organization and its connection reference associated with the corresponding customer business. A user’s sign-in identity and an organization’s data-access context are different concepts.
Handle disconnection explicitly. Do not reuse a prior tenant choice or cached records to imply that a revoked connection still authorizes new data pulls.
Separate a contact directory from payment evidence
A directory pull can help identify vendors with missing tax information. It does not establish whether a person received a reportable amount in the chosen tax year. Use the applicable paid-transaction records for that review.
Retain source contact IDs, transaction IDs, dates, signed amounts, currency and payment context. Avoid counting an invoice and its payment as separate cash outflows.
Read connection status before syncing
TaxComposer exposes provider availability, company selection and sync operations through the accounting API contract. The live status for the customer’s connection should drive the interface. Do not show a provider logo as proof that its current authorization and import succeeded.
A failed or partial sync must remain incomplete. Preserve the error and last successful source reference so the user can resume or import a supported file without silently mixing two totals.
Turn the reviewed source into a draft
Review the payer, recipient classification and reportable payments. Request missing W-9 information only with the required contact permission. Reconcile the signed W-9 or imported recipient record to the original contact before applying it.
Save the review against the exact source version, then create the intended drafts. Draft preparation, validation and eventual filing are separate states; display the current blockers rather than claiming a finished filing.
Primary sources
Sources checked November 12, 2026. Use the instructions for your reporting year and circumstances.
Your next step
Connect your bookkeeping workflow.
Use the current API contract and discover the tools available to your MCP connection.
API Documentation →Connect with MCP →TaxComposer is production-ready for IRS IRIS e-filing. Prepare for free and pay $1 per form when you file.