Schéma :: DATA_SHARING_USAGE

Vue MARKETPLACE_LISTING_INVOICE_STATUS¶

La vue MARKETPLACE_LISTING_INVOICE_STATUS du schéma DATA_SHARING_USAGE vous permet de consulter l’historique des factures liées aux annonces payantes dans le Snowflake Marketplace.

Uniquement visible par les fournisseurs d’annonces payantes, cette vue comprend l’historique des statuts de paiement par facture pour les annonces achetées.

Colonnes¶

Nom de la colonne	Type de données	Description
STRIPE_DISPLAY_NUMBER	VARCHAR	Le numéro de facture ou d’affichage Stripe.
INVOICE_DATE	DATE	Date de la facture.
USAGE_MONTH	VARCHAR	Le premier mois où une facture est générée, dans le format `YYYY-MM-01`. Par exemple, si le consommateur achète l’annonce le 12-MAR-2024, alors la date dans ce champ est `2024-03-01`.
INVOICE_STATUS	VARCHAR	Statut de la facture. Valeurs possibles : `closed` Payé à Snowflake ; payé aux fournisseurs dans les 30 jours. `open` Pas encore payé. `void` Annulé. `rebilled` Indique qu’une facture annulée a été refacturée pour effectuer un ajustement. Si une facture est annulée et refacturée, il y a deux lignes pour ce numéro de facture : une `void` et un `rebilled` ; la facture créée pour facturer à nouveau le consommateur a un nouveau numéro et est `open`.
PO_NUMBER	VARCHAR	Numéro de bon de commande (PO) spécifié par le consommateur pour acheter une annonce. Le numéro PO est saisi manuellement par le consommateur.
CURRENCY	VARCHAR	Toujours USD (les devises alternatives ne sont pas prises en charge dans cette vue).
TOTAL_BILLED_AMOUNT	DECIMAL	Montant total facturé au consommateur en USD. Ce montant comprend les taxes à la consommation qui s’appliquent aux frais du consommateur et du fournisseur.
SALES_TAX_AMOUNT	DECIMAL	La taxe de vente en USD à la charge du consommateur. Ce montant est inclus dans le montant de la colonne `TOTAL_BILLED_AMOUNT`.
FEES	DECIMAL	Frais du fournisseur. Ce montant est inclus dans le montant de la colonne `TOTAL_BILLED_AMOUNT`.
EXPECTED_PAYOUT_AMOUNT	DECIMAL	Le paiement total attendu au fournisseur en USD. Cette valeur est calculée en soustrayant `SALES_TAX_AMOUNT` et `FEES` depuis `TOTAL_BILLED_AMOUNT`.
LISTING_DISPLAY_NAME	VARCHAR	Nom d’affichage de l’annonce.
LISTING_GLOBAL_NAME	VARCHAR	Nom global de l’annonce.
CONSUMER_ORGANIZATION_NAME	VARCHAR	Nom de l’organisation du consommateur.
CONSUMER_ACCOUNT_NAME	VARCHAR	Nom du compte du consommateur.
CONSUMER_ACCOUNT_LOCATOR	VARCHAR	Localisateur du compte du consommateur.
CONSUMER_COMPANY_NAME	VARCHAR	Nom de l’entreprise du consommateur.
CONSUMER_BILLING_EMAIL_ADDRESS	VARCHAR	Adresse e-mail associée à la facturation du consommateur.

Notes sur l’utilisation¶

La latence pour la vue peut atteindre 48 heures (2 journées).
Les données sont conservées pendant 365 jours (1 an).

Exemples¶

Récupérer les informations de facturation pour l’exportation.

SELECT
  stripe_display_number AS snowflake_mp_invoice_number,
  invoice_date,
  usage_month AS first_billing_month,
  invoice_status,
  po_number,
  currency,
  total_billed_amount,
  listing_display_name,
  listing_global_name,
  consumer_organization_name,
  consumer_account_name,
  consumer_account_locator,
  consumer_company_name,
  consumer_billing_email_address
FROM snowflake.data_sharing_usage.marketplace_listing_invoice_status;

Copy

Récupérer les détails des factures impayées par consommateur.

SELECT
  consumer_account_name,
  consumer_account_locator,
  SUM( total_billed_amount ) AS total_outstanding
FROM snowflake.data_sharing_usage.marketplace_listing_invoice_status
WHERE invoice_status IN ('open')
GROUP BY ALL;

Copy