Skip to content

Balance

API Name: Balance__c

The balance object is used to track invoices, credits, payments, refunds etc. for invoices and for accounts. The invoice balance holds information about the grand total amount of a particular invoice, whereas the account balance sums up all balances of an account.

Label API Name Type Description
# Name AutoNumber
Account Account__c MasterDetail(Account) Specifies the account to which this balance is associated.
Amount Amount__c Currency(16, 2) Shows the balance sum. A positive amount is considered a debt, and a negative amount is considered a credit.
Conversion Rate ConversionRate__c Number(12, 6) The currency conversion rate for the original amount of the payment entry.
Date Date__c Date Shows the effective date of the balance.
Draft Draft__c Checkbox Draft balances are ignored in all business processes. Use the "Fix Balances" API to register them. This field should always be false and only set during a process.
Dunning Dunning__c Lookup(Dunning__c) Shows the related dunning in case of a dunning fee balance.
Invoice Is Finalized InvoiceIsFinalized__c Checkbox Signals wheter the linked invoice has been finalized.
Invoice Invoice__c Lookup(Invoice__c) Shows the invoice to which this balance is assigned. An invoice is considered paid/settled if the sum of all assigned balances is 0.
IsPrepaid IsPrepaid__c Checkbox Is set automatically if the balance was creating from PP-Fields during finalize
No Auto Assignment NoAutoAssignment__c Checkbox If checked, this balance is not automatically assigned to new invoices during the invoice run.
Original Amount OriginalAmount__c Number(13, 5) The original amount of the payment entry before the currency conversion.
Original Currency Code OriginalCurrencyCode__c Text(3) The original currency code of the payment entry before the currency conversion.
Payment Entry PaymentEntry__c Lookup(PaymentEntry__c) The Payment Entry which was used to create this Balance.
Payment Method PaymentMethod__c Picklist Specifies the payment method (like Credit Card, Direct Debit, Bank Transfer, Cash) for balance records that represent a payment or refund.
Payment Provider PaymentProvider__c Picklist Specifies the payment provider (like Paymill, Paypal, Wirecard) for balance records that represent a payment or refund.
Reference Reference__c Text(255) Specifies additional information related to the payment (like customer ID, transaction number) for a bank statement as well as for matching the payment entry with balances and invoices.
Related Balance RelatedBalance__c Lookup(Balance__c) Shows the related balance of a matching balance pair, like the original balance after a balance split.
Related Invoice RelatedInvoice__c Lookup(Invoice__c) Shows the related invoice for the settlement or the proforma invoice process.
Subscription Subscription__c Lookup(Subscription__c) If a subscription is set, the balance will only be assigned to invoices of this subscription.
Transaction No. TransactionNo__c Text(255) The transaction number as retrieved from the payment provider.
Type Type__c Picklist Specifies the type of the balance.