# Interroger les données de frais

Utilisez Sigma ou Data Pipeline pour obtenir des informations sur les frais de transaction et les frais liés aux produits.

Cette page décrit les tables de données que vous pouvez récupérer à l’aide de [Sigma](https://docs.stripe.com/data/sigma.md) et de [Data Pipeline](https://docs.stripe.com/data/data-pipeline.md). Ce flux de travail n’est pas compatible avec [la synchronisation en temps réel vers Postgres](https://docs.stripe.com/data/data-pipeline/real-time-sync-to-postgres.md).

Utilisez la table `itemized_fees` pour obtenir une ventilation complète et granulaire de tous les frais facturés ou déduits de votre solde Stripe. Par exemple, si une transaction de solde indique des frais de 2 USD pour un paiement par carte bancaire, vous pouvez interroger cette transaction dans la table `itemized_fees` pour comprendre la ventilation. Vous pouvez également utiliser la table pour comprendre le total des frais payés à Stripe sur une période donnée.

La table `itemized_fees` peut comprendre les colonnes suivantes :

| Colonne | Description |
| --- | --- |
| `balance_transaction_created` | Heure (en UTC) à laquelle l’opération sur solde a affecté votre solde Stripe. |
| `balance_transaction_id` | ID de l’opération sur solde qui a débité les frais de votre solde. |
| `balance_transaction_description` | Description de l’opération sur solde contenant les frais. |
| `incurred_by` | ID de l’objet ayant donné lieu à ces frais, le cas échéant. Utilisez le champ `incurred_by_type` field pour déterminer le type de cet objet. |
| `incurred_by_type` | Type d’objet référencé par `incurred_by`. Correspond au champ de l’objet dans les API ([Charge](https://docs.stripe.com/api/charges.md), [Refund](https://docs.stripe.com/api/refunds.md), [Invoice](https://docs.stripe.com/api/invoices.md), etc). |
| `amount` | Frais facturés pour cette activité, exprimés dans l’unité principale de la devise. Le montant des taxes n’est pas inclus. |
| `tax` | Composante fiscale des frais payés, exprimée dans l’unité principale de la devise. |
| `currency` | [Code ISO de la devise](https://docs.stripe.com/currencies.md) dans laquelle le montant et la taxe sont exprimés. |
| `incurred_at` | Heure (en UTC) à laquelle les frais ont été facturés, en fonction de la date de l’événement qui en est à l’origine. |
| `activity_start_date` | Pour les frais calculés à partir d’une activité s’étendant sur une certaine période, il s’agit de la date de début de l’activité (en UTC). |
| `activity_end_date` | Pour les frais calculés à partir d’une activité s’étendant sur une certaine période, il s’agit de la date de fin de l’activité (en UTC). |
| `product_feature_description` | Produit ou fonctionnalité associé(e) aux frais. |

L’exemple suivant montre comment extraire des informations sur les cinq dernières transactions de frais :

```sql
select
  date_format(date_trunc('day', incurred_at), '%m-%d-%Y') as day,
  balance_transaction_id,
  amount,
  tax,
  product_feature_description
from
  itemized_fees
order by
  incurred_at desc
limit 5;
```

Pour obtenir une vue plus granulaire de votre activité, associez la table `itemized_fees` à d’autres tables du schéma. Par exemple, joignez la table `balance_transactions` à la table `itemized_fees` pour obtenir des informations sur les frais pour chaque opération sur solde.

Voici un exemple illustrant la manière d’associer ces tables pour obtenir les différents types de frais appliqués et les descriptions détaillées de ces frais :

```sql
select
  date_format(date_trunc('day', itemized_fees.balance_transaction_created), '%m-%d-%Y') as day,
  balance_transactions.id as balance_transaction_id,
  balance_transactions.reporting_category as reporting_category,
  itemized_fees.amount as fee_amount,
  itemized_fees.tax as tax_amount
from
  balance_transactions
inner join
  itemized_fees on balance_transactions.id = itemized_fees.balance_transaction_id
order by
  day desc
limit 5;
```

## Frais payés par les comptes connectés

Si vous avez un compte de plateforme avec Stripe Connect, utilisez la table `connected_account_itemized_fees` pour avoir un aperçu des frais payés par vos comptes connectés.

Comme la table `itemized_fees table`, la table `connected_account_itemized_fees` fournit un enregistrement granulaire des transactions de frais, mais du point de vue de vos comptes connectés. Ces jeux de données ont pour la plupart des attributs communs, bien que le jeu de données `connected_account_itemized_fees` comporte une colonne de `account` supplémentaire. Cette colonne `account` permet aux comptes de la plateforme de suivre les frais payés par chacun de leurs comptes connectés.

Pour identifier toutes les transactions de frais associées à un compte connecté spécifique sur une période donnée, utilisez la table `connected_account_itemized_fees`. Voici un exemple de requête permettant d’obtenir les 10 comptes connectés ayant payé le plus de frais au total :

```sql
select
  account,
  sum(amount) as total_fees
from
  connected_account_itemized_fees
where
  incurred_at between 'start_date' and 'end_date'
group by
  account
order by
  total_fees desc
limit 10;
```

Remplacez `start_date` et `end_date` par les dates spécifiques que vous souhaitez analyser dans le format `YYYY-MM-DD`. Cette requête additionne le total des frais payés par chaque compte connecté dans la plage de dates spécifiée et renvoie les 10 premiers comptes avec les frais totaux les plus élevés.