How to write a contra to Xero and settle the net

This guide covers the second half of a contra: marking the documents paid in Xero and settling the balance. It follows on from how to create and agree a contra.

1. Write the contra to Xero

  1. Open the contra and select Write to Xero.
  2. Check the summary: the number of documents, the contra account, the contra date and the net that will remain to settle.
  3. Select Write to Xero to confirm.
The Write contra to Xero confirmation dialog stating that 11 documents will be marked paid against the EUR Contra Clearing account, dated 16 Nov 2026, with Not yet and Write to Xero buttons.
Check the summary before you confirm. Payments in Xero can only be reversed in Xero.

HedgeFlows first re-reads every document from Xero. If any has changed since you selected it, for example it was paid, voided or its amount changed, nothing is written and the contra stays Agreed. Each changed document shows why. Select Remove from contra to take it out, then select Write to Xero again.

An agreed contra where one bill shows Xero: Voided in Xero with a Remove from contra button, and the other documents show Xero: Waiting.
A bill was voided in Xero after the contra was agreed, so nothing was written. Remove it and write again.

If the check passes, the contra moves to Writing to Xero. Xero limits how fast payments can be posted, so a large contra takes several minutes. The page updates on its own and you can leave it.

What is posted in Xero

Each document gets one payment against the contra account, dated the contra date and already reconciled, with the contra reference on it.

DocumentWhat happens in Xero
BillPaid from the contra account
Sales invoiceReceived into the contra account
Supplier credit noteRefunded into the contra account
Customer credit noteRefunded from the contra account

When every document is written, the contra shows Written to Xero, each document shows Xero: Written, and the contra account holds the net as its balance. Disputed documents are left open in Xero.

If a document fails

If some documents could not be written, the contra shows Written – incomplete and each failed document shows the reason.

StatusWhat to do
Voided in Xero, Already paid in Xero, Changed in XeroThe document no longer matches the contra. Remove it from the contra.
Xero connection expiredReconnect Xero in your settings, then retry.
Payments permission missingSwitch the payments permission back on in your Xero integration settings, then retry.
Xero unavailable, FailedRead the message from Xero shown under the document, for example a locked period. Fix it in Xero and retry, or remove the document.
  • Retry sends the document to Xero again.
  • Remove from contra takes it out. The net follows the documents that were written, and the statement is marked as revised after agreement so the change is on record.

A contra cannot be settled until every remaining document is written. If Xero has not reported on some documents for several hours, select Stop waiting to mark them failed, check them in Xero, then retry or remove each one.

2. Settle the net

The Settlement panel shows who pays whom and how much.

You owe the balance: Pay via HedgeFlows

  1. Select Pay via HedgeFlows. A single transfer for the net opens, addressed to the counterparty.
  2. Fund and submit it as you would any other payment.
  3. A second person approves it. Payments that settle a contra always need approval by someone other than the person who created them, even if your company doesn't use transfer approvals. Approvers can do this from the contra page with Approve payment.

When the payment is sent, HedgeFlows posts a bank transfer in Xero from your HedgeFlows currency account to the contra account, emails the counterparty a remittance with the contra statement attached, and marks the contra Settled.

The counterparty needs to be a HedgeFlows contact with bank details in the contra currency. If not, the Settlement panel says so and offers Add bank details for them instead. Add the details, then come back to the contra.

The Settlement panel reading You pay Adriatica Logistics SRL €1,964.60, a note that the counterparty is not a HedgeFlows contact yet in EUR with an Add bank details button, and a Record bank transfer button.
Until the counterparty has bank details in HedgeFlows, you can add them or record a payment from your own bank.

You owe the balance: pay from your own bank

  1. Pay the counterparty from your bank as usual.
  2. On the contra, select Record bank transfer and enter the date of the payment.

HedgeFlows posts a bank transfer in Xero from your bank account for that currency to the contra account. Match it to the bank statement line in Xero when it appears.

They owe the balance

  1. When their payment arrives, select Record receipt and enter the date.

HedgeFlows posts a bank transfer in Xero from the contra account to your bank account for that currency. Match it to the bank statement line in Xero.

The Settlement panel reading Nordvik Shipping AS pays you €639.60, with a Record receipt button.
When the counterparty owes the balance, record their payment once it arrives.

Nothing to settle

If the two sides offset exactly, select Close contra. Nothing is posted.

Recording a transfer or a receipt uses the currency-to-bank-account mapping in your Xero integration settings, the same one Bills to Xero uses. Set the bank account for the contra currency there first.

After settlement

The contra shows Settled and the contra account in Xero is back to zero for this contra. The statement, the agreement and the full history stay on the contra for your records and your auditor.

A settled contra: every document shows Xero: Written except one disputed bill, and the Settlement panel shows Bank transfer recorded, the bank account in Xero, the date, and Settled. The contra account in Xero is back to zero for this contra.
A settled contra. The disputed bill was left open in Xero for a later contra.

If settlement fails

  • The HedgeFlows payment did not go through. Nothing was posted in Xero. Settle again.
  • The bank transfer could not be posted to Xero. Select Retry the Xero posting. A transfer that is already in Xero is not duplicated.
  • The payment changed after it was linked. Do not pay it again. Check the payment and the contra account in Xero, and contact support if you are unsure.

Related

Questions? Email support@hedgeflows.com.