Skip to main content
Skip table of contents

How to update a transaction

Introduction

In the e-commerce context, it is common for some transactions to be canceled or refunded after their initial recording. These adjustments may result from defective products, order errors, or refund requests. Without a mechanism to reflect these changes in analytics reports, revenue data can become inaccurate, impacting analysis and decision-making.

This guide explains how to manage cancellations and refunds within Piano Analytics to ensure the accuracy of your reports.

How to manage canceled or refunded transactions

Piano Analytics allows you to retroactively adjust transactions using specific enrichment processes. These enrichments ensure that your reports provide an accurate representation of your e-commerce performance.

1. Understanding the adjustment process

Once an event has been collected, it is locked. However, you can modify the properties of an event using a reconciliation key. In the context of managing canceled or refunded transactions, the reconciliation key is the transaction ID. You can then update the transaction_status property to reflect the updated transaction status:

  • Charged: When a product is invoiced to the customer.

  • Returned: When a product is returned after receipt.

  • Refunded: In the case of financial compensation to the customer.

It is also possible to modify the transaction's revenue. This enables your reports to display an adjusted view of your revenue without requiring you to filter transactions based on a specific status.

Here are all the properties that can be modified in this Sales Insights enrichment flow.

Name

Type

Property_key

Transaction ID

STRING

transaction_id

Amount (excl. tax)

DECIMAL

cart_turnovertaxfree

Amount (incl. tax)

DECIMAL

cart_turnovertaxincluded

Payment method

STRING

payment_mode

Shipping cost (excl.tax)

DECIMAL

shipping_costtaxfree

Shipping cost (incl.tax)

DECIMAL

shipping_costtaxincluded

Shipping method

STRING

shipping_delivery

Transaction status

STRING

transaction_status

It is worth noting that you can add custom properties to this list via the menu available at the bottom of the default property list.

2. Importing data

To import data, please follow the steps detailed in the article on enrichment.

For any additional information, feel free to contact the support center or your account manager.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.