> ## Documentation Index > Fetch the complete documentation index at: https://docs.metronome.com/llms.txt > Use this file to discover all available pages before exploring further. # Référence de la base de données Cette page fournit une référence complète du schéma pour toutes les données exportées de Metronome vers votre data warehouse. Utilisez cette référence pour comprendre la structure et le contenu de chaque table disponible dans vos exports. Pour des exemples de requêtes SQL, voir le [cookbook SQL](/fr/guides/reporting-insights/data-export/cookbook). **COLONNES NULLABLES** En raison de notre méthodologie d'export, toutes les colonnes peuvent apparaître comme nullables dans le schéma de destination. ## Entités principales Types de données et entités fondamentaux utilisés à travers Metronome. ### `billable_metric` | Colonne | Type | Description | | ------------------ | ----------- | -------------------------------------------------------------------- | | `id` | `string` | ID de la billable metric | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `aggregate` | `string` | Le type d'agrégation | | `aggregate_keys` | `json` | Les clés utilisées pour l'agrégation | | `group_keys` | `json` | Les clés group by associées à cette billable metric | | `name` | `string` | Nom de la billable metric | | `created_at` | `timestamp` | Le timestamp (UTC) de la création de la billable\_metric | | `archived_at` | `timestamp` | Le timestamp (UTC) de l'archivage de la billable\_metric | | `updated_at` | `timestamp` | Le timestamp (UTC) de la dernière mise à jour de la billable\_metric | ### `credit_type` | Colonne | Type | Description | | ------------------------ | ----------- | ------------------------------------------------------------ | | `_metronome_metadata_id` | `string` | ID des métadonnées Metronome | | `id` | `string` | L'ID du credit type | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `name` | `string` | Le nom du credit type | | `is_currency` | `boolean` | Indique si le credit type est une monnaie, TRUE ou FALSE | | `updated_at` | `timestamp` | Le timestamp (UTC) de la dernière mise à jour de cette ligne | ### Events L'ensemble complet des événements bruts dédupliqués reçus par Metronome, qu'ils correspondent ou non à une billable metric. ### `events` | Colonne | Type | Description | | ------------------------ | ----------- | ------------------------------------------------------------ | | `transaction_id` | `string` | L'ID unique de l'événement | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `customer_id` | `string` | L'ID du client auquel l'événement s'applique | | `timestamp` | `timestamp` | Le timestamp (UTC) de l'événement | | `event_type` | `string` | Le type d'événement | | `properties` | `json` | Les propriétés de l'événement | | `_metronome_metadata_id` | `string` | ID des métadonnées Metronome | | `updated_at` | `timestamp` | Le timestamp (UTC) de la dernière mise à jour de cette ligne | ### Customers Inclut les métadonnées des clients stockées dans Metronome, y compris leurs ingest aliases, qui peuvent être joints à la table `events`. La colonne `archived_at` est utilisée pour déterminer si le client est actif. ### `customer` | Colonne | Type | Description | | ------------------------------ | ----------- | ----------------------------------------------------------- | | `id` | `string` | L'ID Metronome du client | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `name` | `string` | Le nom du client | | `ingest_aliases` | `json` | Les ingest aliases du client | | `salesforce_account_id` | `string` | L'ID du compte Salesforce pour le client | | `billing_provider_type` | `string` | Le billing provider connecté au client | | `billing_provider_customer_id` | `string` | L'ID du client chez le billing provider | | `custom_fields` | `json` | Custom fields attachés au client | | `created_at` | `timestamp` | Le timestamp (UTC) de la création du client | | `updated_at` | `timestamp` | Le timestamp (UTC) de la dernière mise à jour du client | | `archived_at` | `timestamp` | Le timestamp (UTC) de l'archivage du client, le cas échéant | ## Facturation Toutes les données liées à la facturation, y compris les factures finalisées, les brouillons et les ventilations détaillées. ### Factures finalisées Inclut toutes les factures clients qui ont été finalisées ou annulées. Aucune modification supplémentaire ne peut être apportée à ces factures ou à leurs line items correspondants. ### `invoice` | Colonne | Type | Description | | ------------------------------------------ | ----------- | ------------------------------------------------------------------------------------ | | `id` | `string` | L'ID de facture Metronome | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `status` | `string` | Le statut de facture Metronome : `FINALIZED` ou `VOID` | | `total` | `decimal` | Le total de la facture | | `credit_type_id` | `string` | L'ID du credit type pour la facture | | `credit_type_name` | `string` | Le nom du credit type associé à la facture | | `customer_id` | `string` | L'ID Metronome du client | | `plan_id` | `string` | Champ déprécié — attendez-vous à `NULL` | | `plan_name` | `string` | Champ déprécié — attendez-vous à `NULL` | | `contract_id` | `string` | L'ID de contrat associé à la facture | | `billing_provider_invoice_id` | `string` | L'ID de facture externe du billing provider (par exemple, Stripe) | | `billing_provider_type` | `string` | Le type de billing provider du système externe (par exemple, Stripe) | | `billing_provider_invoice_created_at` | `timestamp` | Le timestamp (UTC) de la création de la facture externe par Metronome | | `billing_provider_invoice_external_status` | `string` | Le statut de la facture dans le système externe (par exemple, Stripe) | | `invoice_label` | `string` | L'étiquette catégorielle de la facture | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference/#metadata) | | `start_timestamp` | `timestamp` | Début de la période d'utilisation que cette facture couvre (UTC) | | `end_timestamp` | `timestamp` | Fin de la période d'utilisation que cette facture couvre (UTC) | | `issued_at` | `timestamp` | Le timestamp (UTC) de l'émission de la facture | | `updated_at` | `timestamp` | Le timestamp (UTC) de la dernière mise à jour de cette ligne | ### `line_item` | Colonne | Type | Description | | ---------------------- | ----------- | ---------------------------------------------------------------------------------------------------- | | `id` | `string` | L'ID du line item | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `invoice_id` | `string` | L'ID de facture Metronome associé au line item | | `credit_grant_id` | `string` | Champ déprécié — attendez-vous à `NULL` | | `credit_type_id` | `string` | L'ID du credit type associé au line item | | `credit_type_name` | `string` | Le nom du credit type associé au line item | | `name` | `string` | La description du line item | | `quantity` | `decimal` | La quantité associée au line item ; ce sera toujours `1` pour les ajustements de facture | | `total` | `decimal` | Le total du line item | | `commit_id` | `string` | L'ID du commit associé au line item. Présent uniquement pour les Contract Invoices | | `product_id` | `string` | L'ID du produit associé au line item ; ce sera toujours `NULL` pour les ajustements de facture | | `group_key` | `string` | La group key associée au line item | | `group_value` | `string` | La group value associée au line item | | `unit_price` | `decimal` | Le prix associé au line item | | `pricing_group_values` | `json` | Tableau facultatif des pricing group values | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference/#metadata) | | `subscription_id` | `string` | L'ID de l'abonnement associé au line item. Présent uniquement pour les frais d'abonnement. | | `is_prorated` | `boolean` | Indique si la valeur est calculée au prorata sur la période. Pour les frais d'abonnement uniquement. | | `starting_at` | `timestamp` | Le timestamp (UTC) à partir duquel le line item est effectif (inclus) | | `ending_before` | `timestamp` | Le timestamp (UTC) jusqu'auquel le line item est effectif (exclus) | | `updated_at` | `timestamp` | Le timestamp (UTC) de la dernière mise à jour du line item | ### Factures brouillon Inclut toutes les factures clients qui sont à l'état brouillon. Ces tables sont des snapshots quotidiens de factures basés sur la configuration et l'utilisation de chaque client à un instant donné de la journée. La colonne `updated_at` est l'heure à laquelle la ligne de facture a été calculée tandis que `snapshot_time` correspond au début de la journée (UTC). Une ligne de facture sera renseignée une fois par jour tout au long d'une période de facturation jusqu'à ce qu'elle soit finalisée ou annulée. Si une facture est à l'état `DRAFT_INCOMPLETE`, cela signifie que Metronome n'a pas entièrement calculé la facture. Il n'y aura pas de line items ni de total sur la facture. L'export de ces factures vous permet de savoir que la facture existe, mais que Metronome n'a pas réussi à la calculer pour une raison quelconque. L'export des factures incomplètes permet à Metronome d'envoyer les données vers la destination spécifiée le plus rapidement possible. Nous nous attendons à ce que ces factures incomplètes soient hydratées dans les snapshots futurs. ### `draft_invoice` | Colonne | Type | Description | | ------------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------- | | `_metronome_metadata_id` | `string` | Identifiant unique pour chaque paire ID de facture brouillon + snapshot\_time | | `id` | `string` | L'ID de facture Metronome | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_time` | `timestamp` | Le timestamp (UTC) correspondant au début du snapshot | | `status` | `string` | Le statut de facture Metronome : `DRAFT` ou `DRAFT_INCOMPLETE` (voir la table `invoice` pour les factures `FINALIZED` et `VOID`) | | `total` | `decimal` | Le total de la facture | | `credit_type_id` | `string` | L'ID du credit type pour la facture | | `credit_type_name` | `string` | Le nom du credit type associé à la facture | | `customer_id` | `string` | L'ID Metronome du client | | `plan_id` | `string` | Champ déprécié — attendez-vous à `NULL` | | `plan_name` | `string` | Champ déprécié — attendez-vous à `NULL` | | `contract_id` | `string` | L'ID de contrat associé à la facture | | `billable_status` | `string` | Statut facturable de la facture, `BILLABLE` ou `UNBILLABLE` | | `billing_provider_invoice_id` | `string` | L'ID de facture externe du billing provider (par exemple, Stripe) | | `billing_provider_invoice_created_at` | `timestamp` | Le timestamp (UTC) de la création de la facture externe par Metronome | | `label` | `string` | L'étiquette catégorielle de la facture | | `start_timestamp` | `timestamp` | Début de la période d'utilisation que cette facture couvre (UTC) | | `end_timestamp` | `timestamp` | Fin de la période d'utilisation que cette facture couvre (UTC) | | `updated_at` | `timestamp` | Le timestamp (UTC) de la dernière mise à jour de cette ligne | ### `draft_line_item` | Colonne | Type | Description | | ------------------------ | ----------- | ---------------------------------------------------------------------------------------------------- | | `_metronome_metadata_id` | `string` | Identifiant unique opaque pour chaque ligne | | `id` | `string` | L'ID du line item | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_time` | `timestamp` | Le timestamp (UTC) correspondant au début du snapshot | | `invoice_id` | `string` | L'ID de facture Metronome associé au line item | | `credit_grant_id` | `string` | Champ déprécié — attendez-vous à `NULL` | | `credit_type_id` | `string` | L'ID du credit type associé au line item | | `credit_type_name` | `string` | Le nom du credit type associé au line item | | `name` | `string` | La description du line item | | `quantity` | `decimal` | La quantité associée au line item ; ce sera toujours `1` pour les ajustements de facture | | `total` | `decimal` | Le total du line item | | `commit_id` | `string` | L'ID du commit associé au line item. Présent uniquement pour les Contract Invoices | | `product_id` | `string` | L'ID du produit associé au line item ; ce sera toujours `NULL` pour les ajustements de facture | | `group_key` | `string` | La group key associée au line item | | `group_value` | `string` | La group value associée au line item | | `unit_price` | `decimal` | Le prix associé au line item | | `pricing_group_values` | `json` | Tableau facultatif des pricing group values | | `subscription_id` | `string` | L'ID de l'abonnement associé au line item. Présent uniquement pour les frais d'abonnement. | | `is_prorated` | `boolean` | Indique si la valeur est calculée au prorata sur la période. Pour les frais d'abonnement uniquement. | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference/#metadata) | | `starting_at` | `timestamp` | Le timestamp (UTC) à partir duquel le line item est effectif (inclus) | | `ending_before` | `timestamp` | Le timestamp (UTC) jusqu'auquel le line item est effectif (exclus) | | `updated_at` | `timestamp` | Le timestamp (UTC) de la dernière mise à jour du line item | ### Ventilations de factures Les ventilations de factures sont stockées dans quatre tables distinctes qui sont exportées quotidiennement vers votre destination warehouse. Les données de factures brouillon sont exportées en snapshots contenant toutes les périodes de breakdown du mois en cours jusqu'au timestamp du snapshot. Cela garantit que tout changement de pricing et packaging en milieu de période de facturation, ainsi que les données d'utilisation rétroactives, sont correctement reflétés dans le snapshot de breakdown de facture brouillon le plus récent. Les ventilations de factures finalisées sont exportées de manière incrémentale au fur et à mesure que les factures sont finalisées. **FILTRES DE VENTILATIONS DE FACTURES** Pour réduire le volume de données exportées vers votre destination data warehouse, vous pouvez filtrer les exports de ventilations de factures pour ignorer : * Toutes les factures et line items avec un total de 0 \$ et une quantité > 0 * Toutes les factures et line items avec un total de 0 \$ et une quantité de 0 Pour activer les filtres, contactez votre Solutions Architect Metronome. ### `breakdowns_invoices` | Colonne | Type | Description | | --------------------------- | ----------- | ---------------------------------------------------------------------------------------- | | `id` | `string` | L'ID de la ventilation de facture Metronome | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_timestamp` | `timestamp` | Le timestamp (UTC) correspondant au début du snapshot | | `invoice_id` | `string` | L'ID de facture Metronome associé à la ventilation | | `customer_id` | `string` | L'ID de client Metronome associé à la ventilation | | `transfer_id` | `string` | L'ID de transfert Metronome pour cette ventilation de facture | | `credit_type_id` | `string` | L'ID du credit type associé à la facture | | `net_payment_term_days` | `integer` | Le délai de paiement net en jours associé à la facture | | `credit_type_name` | `string` | Le nom du credit type associé à la facture | | `subtotal` | `decimal` | Champ déprécié — attendez-vous à `NULL` sauf si vous utilisez le modèle de données Plans | | `total` | `decimal` | Le total de la facture | | `type` | `string` | Le type de facture | | `external_invoice` | `json` | Les données de la facture externe | | `plan_id` | `string` | Champ déprécié — attendez-vous à `NULL` sauf si vous utilisez le modèle de données Plans | | `contract_id` | `string` | L'ID de contrat associé à la facture | | `amendment_id` | `string` | L'ID d'amendement associé à la facture | | `custom_fields` | `json` | Custom fields qui s'appliquent à la facture | | `billable_status` | `string` | Le statut facturable de la facture | | `window_size` | `string` | La taille de la fenêtre de breakdown — généralement `DAILY` | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference/#metadata) | | `issued_at` | `timestamp` | Le timestamp (UTC) de l'émission de cette facture | | `invoice_start_timestamp` | `timestamp` | Début de la période d'utilisation que cette facture couvre (UTC) (inclus) | | `invoice_end_timestamp` | `timestamp` | Fin de la période d'utilisation que cette facture couvre (UTC) (exclus) | | `breakdown_start_timestamp` | `timestamp` | Le timestamp correspondant au début de la fenêtre de breakdown (inclus) | | `breakdown_end_timestamp` | `timestamp` | Le timestamp correspondant à la fin de la fenêtre de breakdown (exclus) | | `updated_at` | `timestamp` | Le timestamp (UTC) de la dernière mise à jour de cette ligne | ### `breakdowns_line_items` | Colonne | Type | Description | | --------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------- | | `id` | `string` | L'ID de la ventilation de line item Metronome | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_timestamp` | `timestamp` | Le timestamp (UTC) correspondant au début du snapshot | | `watermark_timestamp` | `timestamp` | Le timestamp indiquant la dernière modification de cette ligne | | `invoice_breakdown_id` | `string` | L'ID de la ventilation de facture Metronome associé au line item | | `name` | `string` | Le nom du line item associé à la ventilation | | `transfer_id` | `string` | L'ID de transfert Metronome pour cette ventilation de line item | | `group_key` | `string` | La group key associée au line item | | `group_value` | `string` | La group value associée au line item | | `quantity` | `decimal` | La quantité de cette ligne de ventilation de line item — toujours 1 pour les ajustements de facture | | `total` | `decimal` | Le total de la ventilation de line item | | `unit_price` | `decimal` | Le prix unitaire du line item | | `product_id` | `string` | L'ID du produit pour le line item — toujours NULL pour les ajustements de facture | | `product_type` | `string` | Le type de produit pour la ventilation de line item | | `credit_type_id` | `string` | L'ID du credit type associé au line item | | `credit_type_name` | `string` | Le nom du credit type associé au line item | | `commit_id` | `string` | L'ID du commit associé à la ventilation de line item | | `commit_segment_id` | `string` | L'ID du commit segment associé à la ventilation de line item | | `commit_type` | `string` | Le type de commit associé à la ventilation de line item | | `subscription_id` | `string` | L'ID de l'abonnement associé à la ventilation de line item — présent uniquement pour les frais d'abonnement. | | `is_prorated` | `boolean` | Indique si la valeur est calculée au prorata sur la période. Pour les frais d'abonnement uniquement. | | `line_item_id` | `string` | L'id unique du line item qui peut être utilisé pour joindre avec des enregistrements de la table line\_item | | `line_item_type` | `string` | Le type unique de line item qui définit le type de revenu représenté dans le line item | | `custom_fields` | `json` | Custom fields qui s'appliquent à la ventilation | | `pricing_group_values` | `json` | Les pricing group values associées à la ventilation de line item | | `presentation_group_values` | `json` | Les presentation group values associées à la ventilation de line item | | `billable_metric_id` | `string` | L'ID de billable metric qui s'applique à la ventilation de line item | | `metadata` | `json` | Métadonnées supplémentaires au format JSON (voir [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference/#metadata)) | | `breakdown_start_timestamp` | `timestamp` | Le timestamp correspondant au début de la fenêtre de breakdown (inclus) | | `breakdown_end_timestamp` | `timestamp` | Le timestamp correspondant à la fin de la fenêtre de breakdown (exclus) | | `updated_at` | `timestamp` | Le timestamp (UTC) de la dernière mise à jour de cette ligne | ### `breakdowns_draft_invoices` | Colonne | Type | Description | | --------------------------- | ----------- | ---------------------------------------------------------------------------------------- | | `id` | `string` | L'ID de la ventilation de facture Metronome | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_timestamp` | `timestamp` | Le timestamp (UTC) correspondant au début du snapshot | | `invoice_id` | `string` | L'ID de facture Metronome associé à la ventilation | | `customer_id` | `string` | L'ID de client Metronome associé à la ventilation | | `transfer_id` | `string` | L'ID de transfert Metronome pour cette ventilation de facture | | `credit_type_id` | `string` | L'ID du credit type associé à la facture | | `net_payment_term_days` | `integer` | Le délai de paiement net en jours associé à la facture | | `credit_type_name` | `string` | Le nom du credit type associé à la facture | | `subtotal` | `decimal` | Champ déprécié — attendez-vous à `NULL` sauf si vous utilisez le modèle de données Plans | | `total` | `decimal` | Le total de la facture | | `type` | `string` | Le type de facture | | `external_invoice` | `json` | Les données de la facture externe | | `plan_id` | `string` | Champ déprécié — attendez-vous à `NULL` sauf si vous utilisez le modèle de données Plans | | `contract_id` | `string` | L'ID de contrat associé à la facture | | `amendment_id` | `string` | L'ID d'amendement associé à la facture | | `custom_fields` | `json` | Custom fields qui s'appliquent à la facture | | `billable_status` | `string` | Le statut facturable de la facture | | `window_size` | `string` | La taille de la fenêtre de breakdown — généralement `DAILY` | | `metadata` | `json` | Métadonnées supplémentaires au format JSON | | `issued_at` | `timestamp` | Le timestamp (UTC) de l'émission de cette facture | | `invoice_start_timestamp` | `timestamp` | Début de la période d'utilisation que cette facture couvre (UTC) (inclus) | | `invoice_end_timestamp` | `timestamp` | Fin de la période d'utilisation que cette facture couvre (UTC) (exclus) | | `breakdown_start_timestamp` | `timestamp` | Le timestamp correspondant au début de la fenêtre de breakdown (inclus) | | `breakdown_end_timestamp` | `timestamp` | Le timestamp correspondant à la fin de la fenêtre de breakdown (exclus) | | `updated_at` | `timestamp` | Le timestamp (UTC) de la dernière mise à jour de cette ligne | ### `breakdowns_draft_line_items` | Colonne | Type | Description | | --------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------- | | `id` | `string` | L'ID de la ventilation de line item Metronome | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_timestamp` | `timestamp` | Le timestamp (UTC) correspondant au début du snapshot | | `watermark_timestamp` | `timestamp` | Le timestamp indiquant la dernière modification de cette ligne | | `invoice_breakdown_id` | `string` | L'ID de la ventilation de facture Metronome associé au line item | | `name` | `string` | Le nom du line item associé à la ventilation | | `transfer_id` | `string` | L'ID de transfert Metronome pour cette ventilation de line item | | `group_key` | `string` | La group key associée au line item | | `group_value` | `string` | La group value associée au line item | | `quantity` | `decimal` | La quantité de cette ligne de ventilation de line item ; toujours 1 pour les ajustements de facture | | `total` | `decimal` | Le total de la ventilation de line item | | `unit_price` | `decimal` | Le prix unitaire du line item | | `product_id` | `string` | L'ID du produit pour le line item ; toujours NULL pour les ajustements de facture | | `product_type` | `string` | Le type de produit pour la ventilation de line item | | `credit_type_id` | `string` | L'ID du credit type associé au line item | | `credit_type_name` | `string` | Le nom du credit type associé au line item | | `commit_id` | `string` | L'ID du commit associé à la ventilation de line item | | `commit_segment_id` | `string` | L'ID du commit segment associé à la ventilation de line item | | `commit_type` | `string` | Le type de commit associé à la ventilation de line item | | `subscription_id` | `string` | L'ID de l'abonnement associé à la ventilation de line item ; présent uniquement pour les frais d'abonnement. | | `is_prorated` | `boolean` | Indique si la valeur est calculée au prorata sur la période. Pour les frais d'abonnement uniquement. | | `line_item_id` | `string` | L'id unique du line item qui peut être utilisé pour joindre avec des enregistrements de la table line\_item | | `line_item_type` | `string` | Le type unique de line item qui définit le type de revenu représenté dans le line item | | `custom_fields` | `json` | Custom fields qui s'appliquent à la ventilation | | `pricing_group_values` | `json` | Les pricing group values associées à la ventilation de line item | | `presentation_group_values` | `json` | Les presentation group values associées à la ventilation de line item | | `billable_metric_id` | `string` | L'ID de billable metric qui s'applique à la ventilation de line item | | `metadata` | `json` | Métadonnées supplémentaires au format JSON (voir [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference/#metadata)) | | `breakdown_start_timestamp` | `timestamp` | Le timestamp correspondant au début de la fenêtre de breakdown (inclus) | | `breakdown_end_timestamp` | `timestamp` | Le timestamp correspondant à la fin de la fenêtre de breakdown (exclus) | | `updated_at` | `timestamp` | Le timestamp (UTC) de la dernière mise à jour de cette ligne | ## Contrats Inclut les informations sur les contrats. La colonne `archived_at` définit si le contrat a été archivé ou non. ### `contracts_contracts` | Colonne | Type | Description | | ------------------------------------- | ------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | `string` | ID du contrat | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_id` | `string` | L'ID de snapshot pour la ligne de contrat | | `name` | `string` | Nom du contrat | | `customer_id` | `string` | L'ID client du contrat | | `package_id` | `string` | L'ID du package à partir duquel le contrat a été créé, le cas échéant. | | `rate_card_id` | `string` | L'ID de la rate card du contrat | | `starting_at` | `timestamp` | Le timestamp (UTC) de début du contrat | | `ending_before` | `timestamp` | Le timestamp (UTC) de fin du contrat. Ce timestamp est exclusif. | | `archived_at` | `timestamp` | Le timestamp (UTC) de l'archivage du contrat. | | `multiplier_override_prioritization` | `string` | La priorisation pour un multiplier override. Il existe deux options :
• Multiplicateur le plus bas (par défaut) : le multiplicateur le plus bas, c'est-à-dire la plus grande remise, est utilisé.
• Explicite : l'override avec la priorité la plus basse sera priorisé. | | `net_payment_terms_days` | `integer` | Le délai dont dispose un client pour payer un contrat. Par exemple, « net 30 » | | `usage_statement_schedule_frequency` | `string` | La fréquence de génération du relevé d'utilisation. Par exemple, « monthly » ou « quarterly ». | | `scheduled_charges_on_usage_invoices` | `string` | Les valeurs valides sont `ALL` si les factures programmées seront combinées avec les factures d'utilisation à la même date, sinon null. | | `metadata` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference/#metadata) | Objet encodé en JSON | | `created_at` | `timestamp` | Le timestamp (UTC) de la création du contrat | | `created_by` | `string` | L'entité par laquelle le contrat a été créé | | `updated_at` | `timestamp` | Le timestamp (UTC) auquel cette ligne a été exportée | ### `contracts_commits` La table commits n'inclut que les **commits** au niveau du contrat. Elle n'inclut pas les commits ou credits au niveau du client, ni les credits au niveau du contrat. | Colonne | Type | Description | | ------------------------------ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `id` | `string` | Le commit | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_id` | `string` | L'ID de snapshot de la ligne | | `contract_id` | `string` | L'ID de contrat du commit | | `amendment_id` | `string` | L'ID d'amendement associé au commit | | `type` | `string` | Le type de commit : `postpaid` ou `prepaid` | | `name` | `string` | Le nom du commit | | `priority` | `float` | La priorité qui définit l'ordre dans lequel les commits doivent être appliqués | | `description` | `string` | La description du commit | | `product_id` | `string` | L'ID du produit associé au commit | | `amount` | `float` | Déprécié (utilisez plutôt le montant des schedule items) | | `access_schedule` | `json` | [`AccessSchedule`](/fr/guides/reporting-insights/data-export/database-reference#contracts-commits-accessschedule) | | `invoice_schedule` | `json` | [`InvoiceSchedule`](/fr/guides/reporting-insights/data-export/database-reference#contracts-commits-invoiceschedule) L'`invoice_schedule` est toujours défini pour les commits « postpaid », parfois défini pour les commits « prepaid », et jamais pour « credit » | | `rollover_fraction` | `float` | La fraction du commit qui a été reportée | | `rate_type` | `string` | Soit `COMMIT_RATE` soit `LIST_RATE` | | `applicable_product_ids` | `json` | Liste encodée en JSON des IDs de produits applicables | | `applicable_product_tags` | `json` | Liste encodée en JSON des tags de produits applicables | | `specifiers` | `json` | [`CommitSpecifier[]`](/fr/guides/reporting-insights/data-export/database-reference#contracts-commits-commitspecifier) — Liste encodée en JSON de l'utilisation applicable | | `ledger` | `json` | [`CommitLedgerEntry[]`](/fr/guides/reporting-insights/data-export/database-reference#contracts-commits-commitledgerentry) | | `rolled_over_from_commit_id` | `string` | L'ID de commit à partir duquel le commit a été reporté | | `rolled_over_from_contract_id` | `string` | L'ID de contrat à partir duquel le commit a été reporté | | `recurring_commit_id` | `string` | L'ID de la configuration parent qui a créé ce commit (null si ce commit n'a pas été créé par un recurring commit) | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference#metadata) | | `balance` | `float` | Le solde actuel du commit. Ce solde reflète le montant du commit auquel le client a accès en ce moment. Les segments de commit expirés et à venir contribuent à hauteur de 0 au solde. Le solde correspond à la somme de toutes les entrées du registre, sauf lorsque la somme des entrées manuelles négatives du registre dépasse le montant positif restant sur le commit. Dans ce cas, le solde est 0. Toutes les entrées manuelles du registre associées à des segments de commit actifs sont incluses dans le solde, y compris les entrées manuelles du registre à date future. | | `updated_at` | `timestamp` | Le timestamp (UTC) de la dernière mise à jour du commit | #### `contracts_commits.AccessSchedule` ```typescript theme={null} interface AccessSchedule { credit_type_id: string; credit_type_name: string; schedule_items: Array<{ id: string; /** ISO-8601 formatted timestamp */ date: string; /** ISO-8601 formatted timestamp */ end_date: string | null; /** Float */ amount: number; }>; } ``` #### `contracts_commits.InvoiceSchedule` ```typescript theme={null} interface InvoiceSchedule { credit_type_id: string; credit_type_name: string; do_not_invoice: boolean; schedule_items: Array<{ id: string; /** ISO-8601 formatted timestamp */ date: string; /** Float */ amount: number; invoice_id: string | null; }>; recurring_schedule: { /** ISO-8601 formatted timestamp */ start_date: string; /** ISO-8601 formatted timestamp */ end_date: string; /** Float */ amount: number; amount_distribution: "divided" | "divided_rounded" | "each"; frequency: "annual" | "monthly" | "quarterly" | "semi_annual"; /** Float */ quantity?: number; /** Float */ unit_price?: number; } | null; } ``` #### `contracts_commits.CommitLedgerEntry` ```typescript theme={null} type LedgerEntry = | { /** * Represents the starting balance of a postpaid commit. */ type: "postpaid_initial_balance"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; } | { /** * Represents deductions from the remaining obligation of the * postpaid commit as the result of an invoice with usage that * applies to this commit. */ type: "postpaid_automated_invoice_deduction"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; invoice_id: string; } | { /** * Represents a true-up invoice that was issued for this commit to * cover usage that was not covered by automated usage invoices. */ type: "postpaid_trueup"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; invoice_id: string; } | { /** * Represents that a prepaid commit segment was started and the customer * now has access to the usage amount for that segment. These segments * are described in the access schedule of the prepaid commit. */ type: "prepaid_segment_start"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; segment_id: string; } | { /** * Represents deductions from the prepaid commit segment caused by a * usage invoice that included usage applicable to this commit. */ type: "prepaid_automated_invoice_deduction"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; segment_id: string; invoice_id: string; } | { /** * Represents unused usage from the prepaid commit which was rolled * over to a new contract. */ type: "prepaid_rollover"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; segment_id: string; new_contract_id: string; new_commit_id: string; } | { type: "prepaid_commit_canceled"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; segment_id: string; invoice_id: string; } | { type: "prepaid_commit_credited"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; segment_id: string; invoice_id: string; } | { /** * Represents commit amount that was unused and expired at the end of * a commit segment. Does not include usage that rolled over to a new * contract. */ type: "prepaid_segment_expiration"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; segment_id: string; } | { type: "prepaid_manual"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; segment_id: string; reason: string; } | { type: "postpaid_manual"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; }; ``` #### `contracts_commits.CommitSpecifier` ```typescript theme={null} type CommitSpecifier = { product_id?: string; product_tags?: string[]; presentation_group_values?: { [key: string]: string; }; pricing_group_values?: { [key: string]: string; }; } ``` ### `contracts_balances` | Colonne | Type | Description | | ------------------------------ | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | `string` | L'ID du solde | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_id` | `string` | L'ID de snapshot de la ligne | | `customer_id` | `string` | L'ID client du solde | | `contract_id` | `string` | L'ID de contrat du solde | | `amendment_id` | `string` | L'ID d'amendement du solde | | `type` | `string` | Soit `postpaid`, `prepaid` ou `credit` | | `name` | `string` | Le nom du solde | | `priority` | `float` | La priorité qui définit l'ordre d'application du solde | | `description` | `string` | La description du solde | | `product_id` | `string` | L'ID du produit associé au solde | | `access_schedule` | `json` | [`AccessSchedule`](/fr/guides/reporting-insights/data-export/database-reference#contracts-balances-accessschedule) | | `invoice_schedule` | `json` | [`InvoiceSchedule`](/fr/guides/reporting-insights/data-export/database-reference#contracts-balances-invoiceschedule) — L'`invoice_schedule` est toujours défini pour les commits « postpaid », parfois défini pour les commits « prepaid », et jamais pour « credit » | | `rollover_fraction` | `float` | La fraction du solde qui a été reportée | | `rate_type` | `string` | Soit `COMMIT_RATE` soit `LIST_RATE` | | `applicable_product_ids` | `json` | Liste encodée en JSON des IDs de produits applicables | | `applicable_product_tags` | `json` | Liste encodée en JSON des tags de produits applicables | | `specifiers` | `json` | [`CommitSpecifier[]`](/fr/guides/reporting-insights/data-export/database-reference#contracts-balances-commitspecifier) — Liste encodée en JSON de l'utilisation applicable | | `applicable_contract_ids` | `json` | Liste encodée en JSON des IDs de contrats applicables | | `invoice_contract_id` | `string` | L'ID de contrat de facturation associé au solde | | `ledger` | `json` | [`CommitLedgerEntry[]`](/fr/guides/reporting-insights/data-export/database-reference#contracts-balances-commitledgerentry) | | `rolled_over_from_commit_id` | `string` | L'ID de commit à partir duquel le solde a été reporté | | `rolled_over_from_contract_id` | `string` | L'ID de contrat à partir duquel le solde a été reporté | | `recurring_commit_id` | `string` | L'ID de la configuration parent qui a créé ce commit / credit (null si ce commit n'a pas été créé par un recurring commit / credit) | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference#metadata) | | `balance` | `float` | Le solde actuel du credit ou commit. Ce solde reflète le montant du credit ou du commit auquel le client a accès en ce moment. Les segments de credit ou commit expirés et à venir contribuent à hauteur de 0 au solde. Le solde correspond à la somme de toutes les entrées du registre, sauf lorsque la somme des entrées manuelles négatives du registre dépasse le montant positif restant sur le credit ou commit. Dans ce cas, le solde est 0. Toutes les entrées manuelles du registre associées à des segments de credit ou commit actifs sont incluses dans le solde, y compris les entrées manuelles du registre à date future. | | `updated_at` | `timestamp` | Le timestamp (UTC) auquel cette ligne a été exportée | #### `contracts_balances.AccessSchedule` ```typescript theme={null} interface AccessSchedule { credit_type_id: string; credit_type_name: string; schedule_items: Array<{ id: string; /** ISO-8601 formatted timestamp */ date: string; /** ISO-8601 formatted timestamp */ end_date: string | null; /** Float */ amount: number; }>; } ``` #### `contracts_balances.InvoiceSchedule` ```typescript theme={null} interface InvoiceSchedule { credit_type_id: string; credit_type_name: string; do_not_invoice: boolean; schedule_items: Array<{ id: string; /** ISO-8601 formatted timestamp */ date: string; /** Float */ amount: number; invoice_id: string | null; }>; recurring_schedule: { /** ISO-8601 formatted timestamp */ start_date: string; /** ISO-8601 formatted timestamp */ end_date: string; /** Float */ amount: number; amount_distribution: "divided" | "divided_rounded" | "each"; frequency: "annual" | "monthly" | "quarterly" | "semi_annual"; /** Float */ quantity?: number; /** Float */ unit_price?: number; } | null; } ``` #### `contracts_balances.CommitLedgerEntry` ```typescript theme={null} type LedgerEntry = | { /** * Represents the starting balance of a postpaid commit. */ type: "postpaid_initial_balance"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; } | { /** * Represents deductions from the remaining obligation of the * postpaid commit as the result of an invoice with usage that * applies to this commit. */ type: "postpaid_automated_invoice_deduction"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; invoice_id: string; } | { /** * Represents a true-up invoice that was issued for this commit to * cover usage that was not covered by automated usage invoices. */ type: "postpaid_trueup"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; invoice_id: string; } | { /** * Represents that a prepaid commit segment was started and the customer * now has access to the usage amount for that segment. These segments * are described in the access schedule of the prepaid commit. */ type: "prepaid_segment_start"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; segment_id: string; } | { /** * Represents deductions from the prepaid commit segment caused by a * usage invoice that included usage applicable to this commit. */ type: "prepaid_automated_invoice_deduction"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; segment_id: string; invoice_id: string; } | { /** * Represents unused usage from the prepaid commit which was rolled * over to a new contract. */ type: "prepaid_rollover"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; segment_id: string; new_contract_id: string; new_commit_id: string; } | { type: "prepaid_commit_canceled"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; segment_id: string; invoice_id: string; } | { type: "prepaid_commit_credited"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; segment_id: string; invoice_id: string; } | { /** * Represents commit amount that was unused and expired at the end of * a commit segment. Does not include usage that rolled over to a new * contract. */ type: "prepaid_segment_expiration"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; segment_id: string; } | { type: "prepaid_manual"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; segment_id: string; reason: string; } | { type: "postpaid_manual"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; } | { /** * Represents that a credit segment was started and the customer * now has access to the usage amount for that segment. These segments * are described in the access schedule of the credit. */ type: "credit_segment_start"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; segment_id: string; } | { /** * Represents deductions from the credit segment caused by a * usage invoice that included usage applicable to this credit. */ type: "credit_automated_invoice_deduction"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; segment_id: string; invoice_id: string; } | { type: "credit_commit_canceled"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; segment_id: string; invoice_id: string; } | { type: "credit_commit_credited"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; segment_id: string; invoice_id: string; } | { /** * Represents credit amount that was unused and expired at the end of * a credit segment. */ type: "credit_segment_expiration"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; segment_id: string; } | { type: "credit_manual"; /** ISO-8601 formatted timestamp */ timestamp: string; /** Float */ amount: number; segment_id: string; reason: string; }; ``` #### `contracts_balances.CommitSpecifier` ```typescript theme={null} type CommitSpecifier = { product_id?: string; product_tags?: string[]; presentation_group_values?: { [key: string]: string; }; pricing_group_values?: { [key: string]: string; }; } ``` Cela inclut tous les recurring commits et credits définis sur les contrats. ### `contracts_recurring_commits_and_credits` | Colonne | Type | Description | | ------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | `string` | L'ID unique du recurring commit/credit | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_id` | `string` | L'ID de snapshot de la ligne | | `contract_id` | `string` | L'ID de contrat du recurring commit/credit | | `customer_id` | `string` | L'ID client associé au recurring commit/credit | | `type` | `string` | Le type : `commit` ou `credit` | | `name` | `string` | Le nom transmis aux commits/credits créés | | `priority` | `float` | La priorité transmise aux commits/credits créés | | `description` | `string` | La description transmise aux commits/credits créés | | `product_id` | `string` | L'ID de produit transmis aux commits/credits créés | | `access_amount` | `json` | [`AccessAmount`](/fr/guides/reporting-insights/data-export/database-reference/#contracts_recurring_commits_and_credits-accessamount) | | `invoice_amount` | `json` | [`InvoiceAmount`](/fr/guides/reporting-insights/data-export/database-reference/#contracts_recurring_commits_and_credits-invoiceamount) — Non défini pour les recurring credits, mais optionnel pour les recurring commits | | `rollover_fraction` | `float` | Le montant de rollover transmis aux commits/credits créés. Notez que cela contrôle le rollover entre contrats lors d'une transition de contrat, et non le rollover d'une période à la suivante. | | `rate_type` | `string` | Le type de tarif transmis aux commits/credits créés | | `applicable_product_ids` | `json` | Les IDs de produits applicables transmis aux commits/credits créés | | `applicable_product_tags` | `json` | Les tags de produits applicables transmis aux commits/credits créés | | `specifiers` | `json` | [`CommitSpecifier[]`](/fr/guides/reporting-insights/data-export/database-reference/#contracts_recurring_commits_and_credits-commitspecifier) — Liste encodée en JSON de l'utilisation applicable | | `commit_duration` | `json` | [`CommitDuration`](/fr/guides/reporting-insights/data-export/database-reference/#contracts_recurring_commits_and_credits-commitduration) Combien de temps chaque commit créé est valide à partir de la date de début. Actuellement l'unité est toujours `PERIODS`, représentant la durée des périodes de facturation du contrat (par exemple mensuelle, trimestrielle ou annuelle) | | `proration` | `string` | Utilisé pour contrôler si les premières ou dernières périodes de facturation sont calculées au prorata. Les valeurs valides sont `NONE`, `FIRST`, `LAST` et `FIRST_AND_LAST`. La valeur par défaut est `FIRST_AND_LAST`. | | `proration_rounding` | `json` | [`ProrationRounding`](/fr/guides/reporting-insights/data-export/database-reference/#contracts_recurring_commits_and_credits-prorationrounding) — Configuration facultative pour une meilleure présentation des commits et factures. | | `recurrence_frequency` | `string` | Si défini, les commits ou credits sont créés en fonction de la fréquence spécifiée et commencent à se répéter à la date de début spécifiée sur la configuration du recurring commit ou credit. Les valeurs acceptées sont `MONTHLY`, `QUARTERLY` et `ANNUAL`. | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference/#metadata) | | `subscription_config` | `json` | [`SubscriptionConfig`](/fr/guides/reporting-insights/data-export/database-reference/#contracts_recurring_commits_and_credits-subscriptionconfig) — Configuration pour l'abonnement lié | | `starting_at` | `timestamp` | Le timestamp (UTC) du début du recurring credit ou commit (inclus) | | `ending_before` | `timestamp` | Le timestamp (UTC) de la fin du recurring credit ou commit (exclus) | | `updated_at` | `timestamp` | Le timestamp (UTC) de la dernière mise à jour du recurring commit / credit | #### `contracts_recurring_commits_and_credits.AccessAmount` ```typescript theme={null} interface AccessAmount { unit_price: number; quantity: number; credit_type_id: string; credit_type_name: string; } ``` #### `contracts_recurring_commits_and_credits.InvoiceAmount` ```typescript theme={null} interface InvoiceAmount { unit_price: number; quantity: number; credit_type_id: string; credit_type_name: string; } ``` #### `contracts_recurring_commits_and_credits.CommitSpecifier` ```typescript theme={null} type CommitSpecifier = { product_id?: string; product_tags?: string[]; presentation_group_values?: { [key: string]: string; }; pricing_group_values?: { [key: string]: string; }; } ``` #### `contracts_recurring_commits_and_credits.CommitDuration` ```typescript theme={null} enum CommitDurationUnit { PERIODS = "PERIODS", } interface CommitDuration { unit: CommitDurationUnit; value: number; } ``` #### `contracts_recurring_commits_and_credits.ProrationRounding` ```typescript theme={null} interface ProrationRounding { access: { rounding_method: "round_up" | "round_down" | "round_half_up"; decimal_places: number; }; invoice: { rounding_method: "round_up" | "round_down" | "round_half_up"; decimal_places: number; }; } ``` #### `contracts_recurring_commits_and_credits.SubscriptionConfig` ```typescript theme={null} enum SubscriptionAllocationForRecurringCommitEnum { POOLED = "pooled", INDIVIDUAL = "individual", } type SubscriptionConfig = { subscription_id: string; apply_seat_increase_config: { is_prorated: boolean; }; allocation: SubscriptionAllocationForRecurringCommitEnum; }; ``` Les usage filters changent au fil du temps, donc chaque ligne représente une version distincte d'un usage filter. Pour déterminer la version correcte d'un usage filter à un moment donné, filtrez la table par : * `contract_id` * `starting_at >= {TIME_PERIOD_START}` * `ending_before <= {TIME_PERIOD_END}` (Filtrez en combinant ces trois qualificateurs.) ### `contracts_usage_filter_schedule` | Colonne | Type | Description | | --------------- | ----------- | ----------------------------------------------------------------------------------------- | | `id` | `string` | L'ID Metronome de l'usage filter du contrat | | `contract_id` | `string` | L'ID du contrat associé à l'usage filter | | `starting_at` | `timestamp` | Le timestamp (UTC) du timestamp de début pendant lequel l'usage filter est actif (inclus) | | `ending_before` | `timestamp` | Le timestamp (UTC) du timestamp de fin pendant lequel l'usage filter est actif (inclus) | | `group_key` | `string` | La group key de l'usage filter | | `group_values` | `json` | Les group values pour cette ligne d'usage filter, stockées dans une liste encodée en JSON | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference/#metadata) | | `updated_at` | `timestamp` | Le timestamp (UTC) auquel cette ligne a été exportée | ### `contracts_usage_filters` Les usage filters changent au fil du temps, donc chaque ligne représente une version distincte d'un usage filter. Pour déterminer la version correcte d'un usage filter à un moment donné : * Filtrez la table par `contract_id` et `starting_at <= {TIME}` * Sélectionnez la ligne avec le plus grand `version` | Colonne | Type | Description | | ------------------ | ----------- | ----------------------------------------------------------------------------------------- | | `id` | `string` | L'ID Metronome de l'usage filter du contrat | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_id` | `string` | L'ID du snapshot pendant lequel cette ligne a été transférée | | `contract_id` | `string` | L'ID du contrat associé à l'usage filter | | `version` | `integer` | La version de l'usage filter | | `starting_at` | `timestamp` | Le timestamp (UTC) du timestamp de début pendant lequel l'usage filter est actif (inclus) | | `group_key` | `string` | La group key de l'usage filter | | `group_values` | `json` | Les group values pour cette ligne d'usage filter, stockées dans une liste encodée en JSON | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference/#metadata) | | `updated_at` | `timestamp` | Le timestamp (UTC) auquel cette ligne a été exportée | ### `contracts_prepaid_balance_threshold_configurations` | Colonne | Type | Description | | -------------------------------- | ----------- | ---------------------------------------------------------------------------------------- | | `id` | `string` | Identique à `contract_id` | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_id` | `string` | L'ID de snapshot pour la ligne | | `contract_id` | `string` | L'ID de contrat associé à la configuration de seuil de solde prépayé | | `enabled` | `boolean` | Indique si la facturation par seuil de solde prépayé est activée | | `threshold_amount` | `float` | Le seuil de solde prépayé déclenchant la création d'un threshold commit | | `recharge_to_amount` | `float` | Le montant auquel recharger le solde lorsque le seuil est atteint | | `commit_name` | `string` | Le nom à utiliser comme line item du threshold charge | | `commit_description` | `string` | La description utilisée dans le threshold commit | | `commit_product_id` | `string` | L'ID de produit fixe utilisé pour les threshold commits de solde prépayé | | `commit_applicable_product_ids` | `json` | Liste encodée en JSON des IDs de produits applicables pour le commit | | `commit_applicable_product_tags` | `json` | Liste encodée en JSON des tags de produits applicables pour le commit | | `payment_gate_type` | `string` | Le type de payment gate : `STRIPE`, `EXTERNAL` ou `NONE` | | `tax_type` | `string` | Le fournisseur de taxes utilisé : `STRIPE`, `ANROK`, `PRECALCULATED` ou `NONE` | | `stripe_payment_type` | `string` | Le type de paiement si vous utilisez Stripe payment gate : `PAYMENT_INTENT` ou `INVOICE` | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference/#metadata) | | `updated_at` | `timestamp` | Le timestamp (UTC) auquel cette ligne a été exportée | ### `contracts_spend_threshold_configurations` | Colonne | Type | Description | | --------------------- | ----------- | ---------------------------------------------------------------------------------------- | | `id` | `string` | Identique à `contract_id` | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_id` | `string` | L'ID de snapshot pour la ligne | | `contract_id` | `string` | L'ID de contrat associé à la configuration de seuil de dépense | | `enabled` | `boolean` | Indique si la facturation par seuil de dépense est activée | | `threshold_amount` | `float` | Le seuil de dépense déclenchant la création d'un threshold commit | | `commit_name` | `string` | Le nom à utiliser comme line item du threshold charge | | `commit_description` | `string` | La description utilisée dans le threshold commit | | `commit_product_id` | `string` | L'ID du produit fixe utilisé pour les threshold commits de dépense | | `payment_gate_type` | `string` | Le type de payment gate : `STRIPE`, `EXTERNAL` ou `NONE` | | `tax_type` | `string` | Le fournisseur de taxes utilisé : `STRIPE`, `ANROK`, `PRECALCULATED` ou `NONE` | | `stripe_payment_type` | `string` | Le type de paiement si vous utilisez Stripe payment gate : `PAYMENT_INTENT` ou `INVOICE` | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference/#metadata) | | `updated_at` | `timestamp` | Le timestamp (UTC) auquel cette ligne a été exportée | ### `contracts_subscriptions` | Colonne | Type | Description | | ---------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | `string` | L'ID de l'abonnement | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_id` | `string` | L'ID de snapshot pour la ligne | | `customer_id` | `string` | L'ID Metronome du client | | `contract_id` | `string` | L'ID du contrat actuel | | `product_id` | `string` | L'ID de produit de l'abonnement | | `name` | `string` | Le nom de l'abonnement | | `description` | `string` | La description de l'abonnement | | `billing_frequency` | `string` | La fréquence de facturation de l'abonnement | | `billing_cycle_config` | `json` | [`BillingCycleConfig`](/fr/guides/reporting-insights/data-export/database-reference/#contracts_subscriptions-billingcycleconfig) — Configuration pour la facturation et l'émission de factures d'abonnement | | `collection_schedule` | `string` | Le calendrier de collecte de l'abonnement | | `is_prorated` | `boolean` | Indique si l'abonnement est calculé au prorata | | `proration_rounding` | `json` | [`ProrationRounding`](/fr/guides/reporting-insights/data-export/database-reference/#contracts_subscriptions-prorationrounding) — Configuration facultative pour une meilleure présentation des factures. | | `invoice_behavior` | `string` | Le comportement de facturation de l'abonnement | | `quantity_schedule` | `json` | Le calendrier de quantité de l'abonnement | | `fiat_credit_type_id` | `string` | L'ID du fiat credit type utilisé par l'abonnement | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference/#metadata) | | `starting_at` | `timestamp` | Le timestamp (UTC) du début de l'abonnement | | `ending_before` | `timestamp` | Le timestamp (UTC) de la fin de l'abonnement | | `updated_at` | `timestamp` | Le timestamp (UTC) auquel cette ligne a été exportée | #### `contracts_subscriptions.BillingCycleConfig` ```typescript theme={null} enum SubscriptionInvoicePlacementEnum { ON_USAGE_INVOICE = "ON_USAGE_INVOICE", ON_SCHEDULED_INVOICE = "ON_SCHEDULED_INVOICE", } interface BillingCycleConfig { anchor_date: timestamp; invoice_placement: SubscriptionInvoicePlacementEnum; } ``` #### `contracts_subscriptions.ProrationRounding` ```typescript theme={null} interface ProrationRounding { rounding_method: "round_up" | "round_down" | "round_half_up"; decimal_places: number; } ``` ### `contracts_scheduled_charges` | Colonne | Type | Description | | ------------------ | ----------- | ---------------------------------------------------------------------------------------------------------------- | | `id` | `string` | L'ID du scheduled charge | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_id` | `string` | L'ID de snapshot pour la ligne | | `contract_id` | `string` | L'ID de contrat associé au scheduled charge | | `amendment_id` | `string` | L'ID d'amendement associé au scheduled charge | | `name` | `string` | Le nom du scheduled charge | | `description` | `string` | La description du scheduled charge | | `product_id` | `string` | L'ID de produit associé au scheduled charge | | `credit_type_id` | `string` | L'ID du credit type ou de la devise | | `credit_type_name` | `string` | Le nom du credit type ou de la devise | | `schedule` | `json` | [`Schedule`](/fr/guides/reporting-insights/data-export/database-reference/#contracts-scheduled-charges-schedule) | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference/#metadata) | | `updated_at` | `timestamp` | Le timestamp (UTC) auquel cette ligne a été exportée | #### `contracts_scheduled_charges.Schedule` ```typescript theme={null} interface Schedule { schedule_items: Array<{ id: string; /** ISO-8601 formatted timestamp */ date: string; /** Float */ amount: number; }>; recurring_schedule: { /** ISO-8601 formatted timestamp */ start_date: string; /** ISO-8601 formatted timestamp */ end_date: string; /** Float */ amount: number; amount_distribution: "divided" | "divided_rounded" | "each"; frequency: "annual" | "monthly" | "quarterly" | "semi_annual"; /** Float */ quantity?: number; /** Float */ unit_price?: number; } | null; } ``` ### `contract_hierarchy_configurations` | Colonne | Type | Description | | ---------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | `string` | Identique à `contract_id` | | `contract_id` | `string` | L'ID de contrat associé à la configuration de hiérarchie | | `parent_contract_id` | `string` | L'ID du contrat parent dans la hiérarchie. Renseigné uniquement pour les contrats enfants. | | `parent_customer_id` | `string` | L'ID du client parent dans la hiérarchie. Renseigné uniquement pour les contrats enfants. | | `child_info` | `json` | Tableau encodé en JSON des informations sur les contrats enfants (chacun contenant contract\_id et customer\_id). Renseigné uniquement pour les contrats parents. | | `updated_at` | `timestamp` | Le timestamp (UTC) de la dernière mise à jour de cette ligne | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference/#metadata) | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_id` | `string` | L'ID de snapshot pour la ligne | | `payer` | `string` | Le payeur associé au contrat. Renseigné uniquement pour les contrats enfants. | | `usage_statement_behavior` | `string` | La configuration de comportement du relevé d'utilisation. Renseigné uniquement pour les contrats enfants. | | `invoice_consolidation_type` | `string` | Le type de consolidation des factures configuré. Renseigné uniquement pour les contrats parents. | ### Modifications de contrats Inclut toutes les modifications des contrats. La table `contracts_overrides` contient tous les overrides au-dessus d'un contrat existant. Les tables `contracts_transitions` et `contracts_edits` contiennent des informations sur les contrats se terminant, se renouvelant ou changeant. ### `contracts_overrides` | Colonne | Type | Description | | ------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | `string` | L'ID de l'override | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_id` | `string` | L'ID de snapshot pour la ligne | | `contract_id` | `string` | L'ID de contrat de l'override | | `amendment_id` | `string` | L'ID d'amendement de l'override | | `product_id` | `string` | L'ID de produit de l'override | | `entitled` | `boolean` | Indique si l'override est entitled ou non | | `rate_type` | `string` | Soit `multiplier`, `overwrite_flat` ou `overwrite_percentage`. `NULL` si cela ne remplace pas le tarif | | `multiplier` | `float` | Le multiplicateur de l'override | | `priority` | `float` | Défini uniquement pour les contrats avec une priorisation EXPLICIT de multiplier override | | `new_rate` | `json` | [`Rate`](/fr/guides/reporting-insights/data-export/database-reference/#contracts-overrides-rate) | | `credit_type_id` | `string` | Défini uniquement pour les types de tarifs « overwrite\_flat », « overwrite\_tiered », « overwrite\_subscription » ou « overwrite\_custom » | | `credit_type_name` | `string` | Défini uniquement pour les types de tarifs « overwrite\_flat », « overwrite\_tiered », « overwrite\_subscription » ou « overwrite\_custom » | | `applicable_product_tags` | `json` | Liste de chaînes encodée en JSON | | `override_specifiers` | `json` | [`OverrideSpecifier[]`](/fr/guides/reporting-insights/data-export/database-reference/#contracts-overrides-overridespecifier) | | `target` | `string` | Soit `COMMIT_RATE` soit `LIST_RATE`. Indique à quel tarif l'override s'applique | | `is_commit_specific` | `boolean` | Indique si l'override est spécifique à un commit | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference/#metadata) | | `tiered_override` | `json` | Tarifs et paliers pour les tiered overrides | | `starting_at` | `timestamp` | Le timestamp (UTC) du début de l'override (inclus) | | `ending_before` | `timestamp` | Le timestamp (UTC) de la fin de l'override (exclus) | | `created_at` | `timestmap` | Le timestamp (UTC) de la création de l'override | | `updated_at` | `timestamp` | Le timestamp (UTC) auquel cette ligne a été exportée | #### `contracts_overrides.OverrideSpecifier` ```typescript theme={null} type OverrideSpecifier = { commit_ids?: string[]; product_id?: string; product_tags?: string[]; pricing_group_values?: Array<{ name: string; value: string; }>; presentation_group_values?: Array<{ name: string; value: string; }>; // If set, the override will only apply to usage that burns down commits / credits that were created by the specified recurring config recurring_commit_ids?: string[]; any_commit_or_credit_ids?: string[]; }; ``` #### `contracts_overrides.Rate` ```typescript theme={null} type Rate = | { type: "flat"; unit_price: number; } | { type: "percentage"; fraction: number; use_list_prices: boolean; } | { type: "subscription"; unit_price: number; quantity: number; }; ``` ### `contracts_transitions` | Colonne | Type | Description | | ------------------ | ----------- | ------------------------------------------------------------------------------------ | | `id` | `string` | L'ID de l'événement de transition | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_id` | `string` | L'ID de snapshot pour la ligne | | `type` | `string` | Soit « renewal » soit « supersede » | | `contract_id` | `string` | L'ID du contrat actuel | | `from_contract_id` | `string` | L'ID de contrat qui s'applique avant la transition | | `to_contract_id` | `string` | L'ID de contrat qui s'applique après la transition | | `date` | `timestamp` | Le timestamp (UTC) de la transition | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference/#metadata) | | `updated_at` | `timestamp` | Le timestamp (UTC) auquel cette ligne a été exportée | ### `contracts_edits` | Colonne | Type | Description | | ------------------ | ----------- | ------------------------------------------------------------------------------------ | | `id` | `string` | L'ID de l'édition de contrat | | `contract_id` | `string` | L'ID du contrat de l'édition | | `timestamp` | `timestamp` | Le timestamp (UTC) de l'édition | | `edits` | `json` | Détails des éditions effectuées | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference/#metadata) | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `created_by` | `string` | L'entité par laquelle l'édition de contrat a été créée | | `updated_at` | `timestamp` | Le timestamp (UTC) auquel cette ligne a été exportée | | `snapshot_id` | `string` | L'ID de snapshot pour la ligne | ### `contracts_amendments` | Colonne | Type | Description | | ------------------ | ----------- | ------------------------------------------------------------------------------------ | | `id` | `string` | L'ID de l'amendement de contrat | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_id` | `string` | L'ID de snapshot pour la ligne | | `contract_id` | `string` | L'ID de contrat de l'amendement | | `effective_at` | `timestamp` | Le timestamp (UTC) à partir duquel l'amendement de contrat est effectif | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference/#metadata) | | `created_at` | `timestamp` | Le timestamp (UTC) de la création de l'amendement de contrat | | `created_by` | `string` | L'entité par laquelle l'amendement de contrat a été créé | | `updated_at` | `timestamp` | Le timestamp (UTC) auquel cette ligne a été exportée | ### Tarification du contrat Inclut toutes les informations sur la tarification d'un contrat. ### `contracts_rate_cards` | Colonne | Type | Description | | ------------------------- | ----------- | ----------------------------------------------------------------------------------- | | `id` | `string` | L'ID Metronome de la rate card du contrat | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_id` | `string` | L'ID du snapshot pendant lequel cette ligne a été transférée | | `credit_type_conversions` | `json` | Les conversions de credit type associées à la ligne | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference#metadata) | | `aliases` | `json` | Liste des alias pour la rate card | | `fiat_credit_type_id` | `string` | L'ID du fiat credit type associé à la rate card | | `fiat_credit_type_name` | `string` | Le nom du fiat credit type associé à la rate card | | `description` | `string` | La description de la rate card | | `name` | `string` | Le nom de la rate card | | `created_by` | `string` | Le créateur de la rate card | | `created_at` | `timestamp` | Le timestamp (UTC) de la création de cette ligne | | `updated_at` | `timestamp` | Le timestamp (UTC) de la dernière mise à jour de cette ligne | | `archived_at` | `timestamp` | Le timestamp (UTC) de l'archivage de cette ligne, le cas échéant | ### `contracts_rate_card_entries` | Colonne | Type | Description | | ---------------------- | ----------- | ----------------------------------------------------------------------------------- | | `id` | `string` | L'ID Metronome de l'entrée de rate card du contrat | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `rate_card_id` | `string` | L'ID Metronome de la rate card associé à cette entrée | | `product_id` | `string` | L'ID de produit associé à cette entrée | | `version` | `integer` | La version de cette entrée de rate card | | `entitled` | `boolean` | Indique si l'entrée est entitled ou non | | `rate` | `string` | Le tarif qui s'applique à l'entrée | | `commit_rate` | `string` | Le commit rate qui s'applique à l'entrée (le cas échéant) | | `product_order` | `integer` | L'ordre du produit associé à l'entrée | | `pricing_group_values` | `json` | Les pricing group values qui s'appliquent à l'entrée | | `snapshot_id` | `string` | L'ID du snapshot pendant lequel cette ligne a été transférée | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference#metadata) | | `credit_type_id` | `string` | L'ID du credit type associé à la rate card | | `credit_type_name` | `string` | Le nom du credit type associé à la rate card | | `billing_frequency` | `string` | La fréquence de facturation associée à l'entrée. Pour les abonnements uniquement. | | `starting_at` | `timestamp` | Le timestamp (UTC) auquel l'entrée de rate card commence (inclus) | | `ending_before` | `timestamp` | Le timestamp (UTC) auquel l'entrée de rate card se termine (exclus) | | `updated_at` | `timestamp` | Le timestamp (UTC) de la dernière mise à jour de cette ligne | ### `contracts_product_list_item_versions` | Colonne | Type | Description | | ------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------- | | `id` | `string` | L'ID Metronome de la version du product list item | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_id` | `string` | L'ID du snapshot pendant lequel cette ligne a été transférée | | `product_list_item_id` | `string` | L'ID du product list item associé à la ligne | | `type` | `string` | Le type de la version du product list item | | `version` | `integer` | La version du product list item | | `name` | `string` | Le nom de la version du product list item | | `is_refundable` | `boolean` | Indique si la version du product list item est remboursable | | `billable_metric_id` | `string` | L'ID de billable metric associé à la version du product list item | | `composite_product_ids` | `json` | La liste des IDs de produits composites associés à la ligne | | `composite_scope` | `string` | Le scope du produit composite, `CONTRACT` ou `CUSTOMER` | | `tags` | `json` | La liste des tags associés à la ligne | | `composite_tags` | `json` | La liste des tags composites associés à la ligne | | `include_composite_spend` | `boolean` | Indique si le produit composite est autorisé à inclure des dépenses provenant d'autres produits composites | | `quantity_conversion` | `json` | La conversion de quantité pour la ligne | | `quantity_rounding` | `json` | L'arrondi de quantité pour la ligne | | `pricing_group_key` | `json` | La clé de pricing group pour la ligne | | `presentation_group_key` | `json` | La clé de presentation group pour la ligne | | `metadata` | `json` | [`Metadata`](/fr/guides/reporting-insights/data-export/database-reference/#metadata) | | `starting_at` | `timestamp` | Le timestamp (UTC) à partir duquel la version est active (inclus) | | `created_at` | `timestamp` | Le timestamp (UTC) de la création de cette ligne | | `created_by` | `string` | L'entité par laquelle cette ligne a été créée | | `updated_at` | `timestamp` | Le timestamp (UTC) de la dernière mise à jour de cette ligne | ## Packages Inclut les informations liées aux packages. ### `packages` | Colonne | Type | Description | | ------------------------------------- | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | `string` | ID du package | | `name` | `string` | Nom du package | | `rate_card_id` | `string` | L'ID de la rate card utilisée sur le package | | `duration_unit` | `string` | L'unité de durée du package. Les valeurs disponibles sont `DAYS`, `WEEKS`, `MONTHS`, `YEARS` | | `duration_value` | `integer` | La valeur de durée du package. `duration_unit` + `duration_value` représentent la durée du package | | `multiplier_override_prioritization` | `string` | La priorisation pour un multiplier override. Il existe deux options :
| | `net_payment_terms_days` | `integer` | Le délai dont dispose un client pour payer un contrat. Par exemple, « net 30 » | | `usage_statement_schedule_frequency` | `string` | La fréquence de génération du relevé d'utilisation. Par exemple, « monthly » ou « quarterly ». | | `scheduled_charges_on_usage_invoices` | `string` | Les valeurs valides sont `ALL` si les factures programmées seront combinées avec les factures d'utilisation à la même date, sinon null. | | `billing_provider` | `string` | Le billing provider utilisé sur un contrat créé à partir du package. | | `delivery_method` | `string` | La méthode de livraison utilisée sur un contrat créé à partir du package. | | `aliases` | `json` | Liste des alias planifiés pour le package | | `created_at` | `timestamp` | Le timestamp (UTC) de la création du package | | `created_by` | `string` | L'entité par laquelle le package a été créé | | `archived_at` | `timestamp` | Le timestamp (UTC) de l'archivage du package | | `updated_at` | `timestamp` | Le timestamp (UTC) auquel cette ligne a été exportée | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `snapshot_id` | `string` | L'ID de snapshot pour la ligne de contrat | | `metadata` | [`Metadata`](#metadata) | Objet encodé en JSON | ## Paiements **Bêta privée** La facturation Metronome est actuellement en bêta privée. Contactez votre représentant Metronome pour un accès anticipé. Informations de paiement lors de la facturation avec Metronome. ### `payment` | Colonne | Type | Description | | ------------------ | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | `string` | L'ID du paiement | | `invoice_id` | `string` | L'ID de facture associé au paiement | | `customer_id` | `string` | L'ID client associé au paiement | | `contract_id` | `string` | L'ID de contrat associé au paiement | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `amount` | `decimal` | Le montant total du paiement | | `amount_paid` | `decimal` | Le montant qui a été payé ; égal à `amount` si le statut est `PAID`, sinon `0` | | `credit_type_id` | `string` | L'ID du credit type (monnaie fiat) pour le paiement | | `credit_type_name` | `string` | Le nom du credit type associé au paiement | | `status` | `string` | Le statut du paiement | | `error_message` | `string` | Message d'erreur du fournisseur de paiement, le cas échéant | | `payment_gateway` | `json` | [`PaymentGateway`](/fr/guides/reporting-insights/data-export/database-reference/#payment-paymentgateway) — Détails de la passerelle de paiement (par exemple, informations sur le payment intent et la payment method Stripe) | | `created_at` | `timestamp` | Le timestamp (UTC) de la création du paiement | | `updated_at` | `timestamp` | Le timestamp (UTC) de la dernière mise à jour du paiement | #### `payment.PaymentGateway` ```typescript theme={null} type PaymentGateway = { type: "stripe"; stripe: { payment_intent_id: string; payment_method_id: string; error: string | null; }; } | null; ``` ## Alertes Inclut les alertes et l'historique des alertes client déclenchées. ### `alert` | Colonne | Type | Description | | ------------------ | ----------- | --------------------------------------------------------------------------------------------------------------- | | `id` | `string` | L'ID de l'alerte | | `name` | `string` | Le nom de l'alerte | | `alert_type` | `string` | Le type d'alerte | | `threshold` | `decimal` | Le seuil de déclenchement de l'alerte | | `webhooks_enabled` | `boolean` | Indique si l'alerte est configurée pour les webhooks | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `created_at` | `timestamp` | Le timestamp (UTC) de la création de l'alerte | | `disabled_at` | `timestamp` | Le timestamp (UTC) de la désactivation de l'alerte | | `updated_at` | `timestamp` | Le timestamp (UTC) de la dernière mise à jour de l'alerte | | `archived_at` | `timestamp` | Le timestamp (UTC) de l'archivage de l'alerte | | `group_values` | `json` | Les filtres de group value associés à l'alerte. Présent uniquement pour les alertes `spend_threshold_reached`. | | `seat_filter` | `json` | Le filtre de seat associé à l'alerte. Présent uniquement pour les alertes `low_remaining_seat_balance_reached`. | ### `customer_alert_history` | Colonne | Type | Description | | ------------------ | ----------- | ----------------------------------------------------------------------- | | `id` | `string` | L'ID Metronome de l'historique d'alerte client | | `environment_type` | `string` | L'environnement Metronome, `SANDBOX` ou `PRODUCTION` | | `customer_id` | `string` | Le nom du client associé à l'historique d'alerte | | `alert_id` | `string` | L'ID d'alerte associé à la ligne | | `alert_status` | `string` | Le statut d'alerte associé à la ligne | | `additional_data` | `json` | Données supplémentaires sur l'alerte | | `created_at` | `timestamp` | Timestamp (UTC) auquel l'alerte a été évaluée et que le statut a changé | ## Metadata De nombreuses tables de l'export de données incluent une colonne `metadata`. Les clients qui utilisent Metronome disposent de divers systèmes externes et ont besoin de stocker différentes métadonnées. Ces métadonnées sont spécifiques au client et sont stockées sous forme d'objet JSON dans la colonne `metadata` de la table.