xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField Sales & SFACRMRewardsClaimsInventoryProcurementWarehouse ManagementField ServiceServiceSupportTelephony & MessagingFinance & AccountingPayrollExpense ManagementCommercePortalsAnalytics & ReportingData StudioMobile AppSee all products →
PLATFORM
Platform overviewApp BuilderAutomationIntegrationsSecurity & GovernanceChange ManagementDevelopers
SENSE AI
Sense AI overviewSense AssistSense ControlSense VisionAI StudioTrust & governanceIn Claude & ChatGPTUse cases
SOLUTIONS
Auto DMSConsumer Goods DMSSales Force Automation (SFA) FMCG & DistributionManufacturing & Dealer NetworksAutomotive & DealershipsPharma & HealthcareConsumer DurablesAgri-InputsBuilding MaterialsService NetworksWarehousing & 3PLFinancial AccountingERP SoftwareIndia GST ComplianceUAE VAT & e-InvoicingSaudi ZATCA & VATAll solutions →
RESOURCES
Knowledge CenterDeveloper & CLIBlogGuidesWhat is xMatix?Company facts
COMPANY
AboutCareersPartnersEventsContactAuthorsLegal
Sign in Request demo
Home/Docs/Entity Reference/Cheque Transaction — entity reference
REFERENCE · Last reviewed

Cheque Transaction — entity reference

One paper cheque, either written by the company or received from a customer, tracked from issue until the bank clears or returns it. Listed in the Finance app under Banking (and in the Banking app) as Cheque Transactions. Rows are normally created automatically when a new cheque-mode Payment is saved on the web and posts: a payment given (or a refund paid to a customer) creates Direction Issued, a payment taken (or a refund received from a supplier) creates Direction Received, and both start with Status Issued. For an issued cheque whose number was left blank, the number is drawn from an active cheque register of the payment's company and written back to the payment; otherwise the typed number is recorded as is. Payments saved in the mobile app, and payments that do not post because the company has GL posting turned off, create no cheque. Changing an existing cheque's Status to Cleared posts a clearing journal between the Cheques In Hand account and the company's Bank-type GL account; changing it to Bounced reverses the source payment's posted journals so the settled invoice or bill opens again. Issued, Presented and Cancelled post nothing. The record page does not lock a cheque after Cleared or Bounced, and changing the status again does not undo what was posted. Saves refuse an amount of zero or less, a cheque date later than today, a number already used on the same bank account and a number outside its register's range.

Fields

FieldLabelTypeRequiredWhat it does
AmountAmountCurrencyThe cheque amount, taken from the payment. Must be greater than zero. The clearing journal is posted for this amount; Direction, not the sign, decides which way it goes.
BankAccountIdBank AccountLookup → BankAccountThe company bank account the cheque is drawn on. Filled only when the number was drawn from a cheque register; empty for received cheques and for numbers typed on the payment. The duplicate-number check applies only when this is filled. The picker lists active bank accounts.
ChequeDateCheque DateDateAndTimeThe date written on the cheque, taken from the payment's cheque date or, when that is empty, its payment date. A date later than today is refused, so post-dated cheques cannot be recorded, and the payment that would create the cheque is refused with it.
ChequeNumberCheque NumberTextThe number on the cheque. Numbers drawn from a register include the register's prefix. A number typed on a payment is stored without leading zeros because the payment's cheque number is numeric. Must be unique per bank account, which is only checked when Bank Account is filled.
ChequeRegisterIdCheque RegisterLookup → ChequeRegisterThe cheque book the number was drawn from, set only for numbers allocated automatically. When set, the number (without the prefix) must lie between the register's start and end numbers.
ClearedDateCleared DateDateAndTimeThe date the bank settled the cheque and the date of the clearing journal. Enter it before setting Status to Cleared; if it is empty, the journal is dated today and this field stays empty.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated OnDateAndTimeYes
DirectionDirectionTextIssued for a cheque the company writes, Received for one the company takes. It decides the clearing journal: a received cheque debits the bank and credits Cheques In Hand, an issued one does the reverse. Only issued cheques draw numbers from a register.
IdIdGuidYes
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYesThe cheque's name: the cheque number (with prefix for register numbers), or CHQ- followed by a date and time when a cheque from a payment has no number.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner AccountLookup → AccountThe company that owns the cheque: the payment's company, or the register's for a register number. The clearing journal posts under it, and a cheque with no partner account posts nothing when cleared.
PartyAccountIdParty AccountLookup → AccountThe customer or supplier on the other side of the cheque, taken from the payment's account. Not the owning company, which is the partner account.
RecordTypeIdRecord TypeGuid, hidden
SourceEntityNameSource Entity NameTextThe kind of record the cheque came from; Payment for cheques created by payments. With Source Record it stops a payment getting a second cheque.
SourceRecordIdSource RecordGuidThe payment the cheque came from. Setting Status to Bounced reverses this record's posted journals; a cheque created by hand has none, so bouncing it reverses nothing.
StatusStatusPickListIssued, Presented, Cleared, Bounced or Cancelled. Every new cheque starts as Issued, including received ones. Changing an existing cheque to Cleared posts the clearing journal (once only) and to Bounced reverses the source payment; the other values only record progress. A cheque created with Status already Cleared posts nothing. Cancelled does not undo the payment. Nothing locks the cheque after Cleared or Bounced, so treat both as final.
UIPropsUI PropsText
UpdatedDateTimeUpdated OnDateAndTimeYes

Actions

ActionLabelTypeWhat it does
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
EditEditEditEdit
EditInlineEdit InlineEditInlineEdit Inline
NewNewNewNew

Validations

ValidationApplies toError messageNotes
Amount ValidationAmount, ErrorAmount cannot be 0 or NegativeAmount Validation

Lookup filters

FilterLookup fieldNotes
Bank Account FilterBankAccountId