Skip to main content

Clearing supplement file fields

The Clearing supplement file contains transaction-level data that can be used for reconciliation, analytics, and integration into your internal systems.

The following fields are available in the file:

Field
Explanation
Purchase IdUnique identifier of the purchase. Called reference number in all communication with customers.
Running NoConsecutive number given to each item of a purchase.
Invoice IdInvoice no. of the invoice of the customer.
Invoice DayInvoice date of the invoice of the customer.
Reimbursement IdUnique identifier of a follow-up transaction for a purchase, for example, a refund or retrospective discount.
Purchase StatusStatus of the purchase at the time of generation of the clearing report. For descriptions of the values, see Purchase Status.
Purchase Status Notification IdPurchase status code as submitted in the element of the client notification. For details on what these codes stand for, see Purchase Status.
Report TypeType of the transaction. This is either a purchase or a reimbursement. A reimbursement is a follow-up transaction for a purchase.
Report DayFor purchases, the date on which the payment arrived. For reimbursements, the date on which the follow-up transaction occurred.
Report TimeFor purchases, the date and time when the payment arrived. For reimbursements, the date and time when the follow-up transaction occurred.
Payment Arrive TimeDate and time when the payment for a purchase arrived.
Reimbursement TimeDate and time when the follow-up transaction for a purchase occurred.
Customer Currency IdCurrency in which the customer purchased the product.
Subscription Interval NoIt is the serial number of the renewal activity for a subscription. It is equal to 0 for the signing of subscription and autoincrements +1 each time of renewing
Subscription Item Interval NoIt is the serial number of the renewal activity for a subscription item. It is equal to 0 for the signing of subscription and autoincrements +1 each time of renewing
Subscription IdIt is the unique identifier of subscription. Subscription is a product that is billed at regular intervals, such as monthly or yearly. Each subscription item should be related to the purchase item but not each purchase item should be related to the subscription item. If the deal is a one-time deal and does not set up renewal policy this is just purchase. So, in this case the fields related to subscription can be empty
Recurring IntervalIt is the value of days or months for the regular subscription interval.
Subscription Next Billing TimeIt is the date when the next payment is expected (renewal) for any active subscription items related to the subscription.
Payment TypePayment type of the purchase at the time of generation of the clearing report.
Card InstallmentsNumber of installments for card payments, if the selected payment method supports installments. Empty for single-charge payments.
Customer Language IdLanguage code according to ISO 639-1. This is the language selected by the customer on the checkout page.
Product IdUnique identifier of the product purchased by the customer.
Product NameName of the product purchased by the customer.
Product GroupGroup the product is assigned to for reporting purposes. You can create product groups in Commerce Assistant (CA) and use them for quick analysis of sales trends.
Internal Product IdInternal identifier of the product in your configuration, used for integration and reporting.
Internal Product NameInternal product name from your configuration, used for integration and reporting.
Reference Bundle Product IdUnique identifier of the bundle to which the product belongs. A bundle is a combination of two or more products sold together at a specific price.
Reference Bundle Running NoConsecutive number given to each product within a bundle.
Client IdUnique identifier of your client account, known as client account id.
Internal Product CategoryInternal identifier of the categorie of your product.
Internal Product SKU_EANUniversal Product Code (UPC) or European Article Number (EAN) for boxed products.
QuantityFor purchases, the quantity of items ordered. For reimbursements (follow-up transactions), the value depends on the type of reimbursement: 0 is always given for discounts or coupon codes applied retrospectively; the quantity ordered is given for return debits; the negative quantity ordered is given for all other reimbursements.
Customer CountryCountry associated with the customer’s billing profile used for tax, compliance, and reporting (for example, VAT determination).
Customer Vat PercentageVAT or sales tax percentage applied to the purchase.
Product Currency IdCurrency in which prices are fixed on the purchasing side for further calculations. Corresponds to the Customer Currency if you defined a price for this currency. Otherwise, it corresponds to the base currency for the product.
Billing CompanyCompany name of the billing contact.
Billing TitleTitle of the billing contact.
Billing Salutation IdSalutation of the billing contact.
Billing First NameFirst name of the billing contact.
Billing Last NameLast name of the billing contact.
Billing CityCity of the billing contact.
Billing StateU.S. state or Canadian province of the billing contact.
Billing CountryCountry of the billing contact.
Billing EmailEmail address of the billing contact.
Billing PhonePhone number of the billing contact.
Delivery CompanyCompany name of the delivery contact.
Delivery TitleTitle of the delivery contact.
Delivery Salutation IdSalutation of the delivery contact.
Delivery First NameFirst name of the delivery contact.
Delivery Last NameLast name of the delivery contact.
Delivery CityCity of the delivery contact.
Delivery StateU.S. state or Canadian province of the delivery contact.
Delivery CountryCountry of the delivery contact.
Delivery EmailEmail address of the delivery contact.
Taxation DayThe date that determines when a specific tax rule or tax consequence becomes applicable.
Licensee CompanyCompany name of the licensee contact.
Licensee TitleTitle of the licensee contact.
Licensee Salutation IdSalutation of the licensee contact.
Licensee First NameFirst name of the licensee contact.
Licensee Last NameLast name of the licensee contact.
Licensee Postal CodePostal code of the licensee contact.
Licensee CityCity of the licensee contact.
Licensee StateU.S. state or Canadian province of the licensee contact.
Licensee CountryCountry of the licensee contact.
Licensee EmailEmail address of the licensee contact.
RegionContinent of the delivery country.
X-ParametersAll x-parameters for this purchase. The key–value pairs are serialized as strings and separated by a comma. X-parameters are components of URLs used to pass information through the checkout process.
Customer TypeCustomer or reseller. Customers buy or subscribe to your products through Cleverbridge. Resellers purchase your products at a discount and then sell the products to their own customers at full price, often through a physical store.
Customer IdUnique identifier of the customer.
Partner UsernameUsername of the partner in the Partner Portal. A partner is another business that buys your products in a B2B model.
Partner CompanyName of the partner company.
Promotion IdUnique identifier of the promotion applied to the purchase.
Promotion NameName of the promotion applied to the purchase.
Coupon CodeCoupon code applied to the purchase. A coupon code is a promotional tool that gives customers a specified price discount for a product when the coupon is redeemed.
Cross Subscription Up Selling IdUnique identifier of the recommendation if the purchased product was a cross-sell, sub-sell, or up-sell. This is the recommendation ID.
Cross Subscription Up Selling NameName of the recommendation if the purchased product was a cross-sell, sub-sell, or up-sell.
Product GrossUndiscounted total gross amount for the line item. In the currency given in Product Currency Id. Relates to the selling side of the transaction.
Product VATVAT or sales tax for the undiscounted line item. In the currency given in Product Currency Id. Relates to the selling side of the transaction.
Product NetUndiscounted total net amount for the line item. In the currency given in Product Currency Id. Relates to the selling side of the transaction.
Product Margin VariablePercentage resale commission on the line item charged by Cleverbridge. In the currency given in Product Currency Id. Relates to the purchasing side of the transaction.
Product Margin FixFixed resale commission on the line item charged by Cleverbridge. In the currency given in Product Currency Id. Only applies to some purchases, for example, if the cart value is below a defined threshold. Relates to the purchasing side of the transaction.
Product Client NetYour net revenue on the purchase amount of the line item. In the currency given in Product Currency Id. Relates to the purchasing side of the transaction.
Product Client VATVAT or sales tax on the purchase amount of the line item that you must remit to the local tax authorities. In the currency given in Product Currency Id. Relates to the purchasing side of the transaction.
Product Client GrossYour gross revenue on the purchase amount of the line item. In the currency given in Product Currency Id. Relates to the purchasing side of the transaction.
Exchange RateExchange rate between Product Currency Id and Payout Currency Id.
Payout Currency IdThe payout and clearing currency set for your account in the Cleverbridge platform. This is the currency in which your credit note is generated.
Payout GrossDiscounted total gross amount for the line item. In the currency given in Payout Currency Id. Relates to the selling side of the transaction.
Payout VATVAT or sales tax for the discounted line item. In the currency given in Payout Currency Id. Relates to the selling side of the transaction.
Payout NetDiscounted total net amount for the line item. In the currency given in Payout Currency Id. Relates to the selling side of the transaction.
Payout Margin VariablePercentage resale commission on the line item charged by Cleverbridge. In the currency given in Payout Currency Id. Relates to the purchasing side of the transaction.
Payout Margin FixFixed resale commission on the line item charged by Cleverbridge. In the currency given in Payout Currency Id. Only applies to some purchases, for example, if the cart value is below a defined threshold. Relates to the purchasing side of the transaction.
Payout Client NetYour net revenue on the purchase amount of the line item. In the currency given in Payout Currency Id. Relates to the purchasing side of the transaction. The sum of these amounts is credited to your accounts for the clearing period. It is given in the credit note that is emailed to you as a PDF file.
Payout Client VATVAT or sales tax on the purchase amount of the line item that you must remit to the local tax authorities. In the currency given in Payout Currency Id. Relates to the purchasing side of the transaction.
Payout Client GrossYour gross revenue on the purchase amount of the line item. In the currency given in Payout Currency Id. Relates to the purchasing side of the transaction.

Did you find this doc useful?