Understand the remote invoice status used by Xero automation
Detailed client guidance covering understand the remote invoice status used by Xero automation, including prerequisites, exact controls, verification evidence, failure boundaries and safe recovery steps for the shipped Xero connector.
Audience: Administrators, finance staff and authorised integration operatorsPermission: SynchronizeModule v1.0.0
Where to goXero Accounting Automation → Invoice Sync
Before you startConfirm the intended tenant, remote account or invoice context, and your Synchronize access. Keep credentials and tokens out of screenshots, tickets and exported evidence. If a previous write may have reached an external service, verify remote state before retrying.
What you’ll accomplish
Detailed client guidance covering understand the remote invoice status used by Xero automation, including prerequisites, exact controls, verification evidence, failure boundaries and safe recovery steps for the shipped Xero connector. This article is intentionally scoped to the behaviour enforced or exposed by the supplied module and does not treat provider marketing features as implemented integration capabilities.
How the workflow fits together
The connector keeps native CRM records authoritative while mapping verified Contact, ACCREC Invoice and Payment evidence in Xero. Queue, exception, API, reconciliation and compliance records are separate evidence layers, so each material action should be verified at both the native and remote sides.
Follow these steps
Open Xero Accounting Automation → Invoice Sync.
Confirm you are in the intended tenant and connected organisation and that your role has the required Synchronize access.
Open the intended native invoice and confirm client, currency, items, quantities, tax, discounts and totals.
Resolve every required remote customer, sales-posting and tax mapping before posting.
Run the supported sync action once.
Read the result and, if successful, compare the remote invoice identity and totals with the native invoice.
If the result is ambiguous or manual-review, check the provider before any retry.
Fields and decisions to review
This guide’s focusDetailed client guidance covering understand the remote invoice status used by Xero automation, including prerequisites, exact controls, verification evidence, failure boundaries and safe recovery steps for the shipped Xero connector.
PreflightBefore posting, the integration reconstructs and validates invoice amounts, client mapping, posting references, currency and supported line/tax/discount structure.
Update safetyMapped invoice updates use guarded remote state and fresh read-back. A network interruption after a non-idempotent write can enter manual review rather than being sent again blindly.
TotalsRemote subtotal, tax and total evidence must agree with the intended native invoice before the synchronisation is certified.
Customer dependencyThe mapped remote customer/contact must be verified before the invoice is posted.
Correction policyDeletion or correction of a native invoice does not authorize an automatic destructive accounting deletion.
Remote documentThe target object is ACCREC Invoice. Invoices can be created as AUTHORISED when the setting is enabled; successful read-back accepts AUTHORISED or PAID where applicable.
Read-backinvoice SubTotal, TotalTax and Total are read back using unitdp=4; contact, invoice and payment identifiers are stored only after verification
Remote update protectionUpdates use the mapped remote record and guarded read-back rather than an unsafe blind overwrite.
Deletion/correctionDeleting a native record does not automatically delete the mapped Xero accounting record. Review the remote ledger and follow the organisation’s accounting correction policy.
PrecisionInvoice writes and read-back use four-decimal unit precision where supported to avoid false total mismatches.
How to confirm it worked
Reopen the native record and the relevant integration history/register. Confirm the stored remote accounting identifier, exact amount/status, latest timestamps and the expected audit or reconciliation evidence. If the provider-side state cannot be independently verified, keep the task unresolved and use the controlled exception or troubleshooting flow.
Questions clients commonly ask
What proves the invoice really synchronised?Invoice subtotal, totaltax and total are read back using unitdp=4; contact, invoice and payment identifiers are stored only after verification.
What should I verify before I trust the result?Verify the native record, the mapped remote record, the stored remote identifier, the current status/amount and the audit or history evidence. A success message alone is not the accounting evidence.
Should I press the action again after a timeout?Not until you have checked the remote accounting service and the Exceptions/API evidence. A timeout can occur after the remote side accepted a non-idempotent write, so a blind retry can create a duplicate.
Does the connector replace the native CRM record?No. Native clients, invoices and payments remain the operational source records. The connector records mappings, remote evidence and controlled reconciliation around them.
What should I include in a support case?Include the native record ID, remote ID if known, date/time, action, exact visible error and request/audit identifier. Never send client secrets, access tokens, refresh tokens or authorization headers.
Technical basis for this guidance
This guide was checked against the supplied module code paths: controllers/Xero_accounting_automation.php; models/Xero_accounting_automation_model.php; libraries/Xero_api_client.php; libraries/Xero_reconciliation_service.php; libraries/Xero_document_import_service.php; views/admin; install.php; docs/FEATURE_MATRIX.md. It documents shipped behaviour, validation, routes and evidence controls; it does not claim successful live provider network calls from offline inspection.
Controls, checks and common mistakes
Work in the intended tenant and remote accounting/business context.
Do not paste credentials, access tokens, refresh tokens or private keys into tickets or notes.
Do not bypass a missing mapping, validation error, permission gate, duplicate check or remote-verification requirement.
Do not repeat a non-idempotent write until you know whether the previous request reached the remote service.
Keep native record, remote evidence and audit/history state aligned before closing the task.
Provider and accounting boundaryDeleting a native record does not automatically delete the mapped Xero accounting record. Review the remote ledger and follow the organisation’s accounting correction policy.
