架构：: DATA_SHARING_USAGE

MARKETPLACE_LISTING_INVOICE_STATUS 视图¶

您可以通过 DATA_SHARING_USAGE 架构中的 MARKETPLACE_LISTING_INVOICE_STATUS 视图查询 Snowflake Marketplace 中付费列表的相关发票的历史记录。

仅对付费列表的提供商可见，此视图包括已购买列表的每个发票的付款状态历史。

列¶

列名称	数据类型	描述
STRIPE_DISPLAY_NUMBER	VARCHAR	Stripe 发票或显示号码。
INVOICE_DATE	DATE	发票日期。
USAGE_MONTH	VARCHAR	以 `YYYY-MM-01` 格式生成发票的第一个月。例如，如果使用者在 2024 年 MAR 月 12 日购买列表，则此字段中的日期为 `2024-03-01`。
INVOICE_STATUS	VARCHAR	发票状态。可能的值：`closed` 支付给 Snowflake；在 30 天内支付给提供商。`open` 尚未支付。`void` 已取消。`rebilled` 表示已重新开票以进行调整的无效发票。如果取消发票并重新开票，则该发票编号有两行：`void` 和 `rebilled`；为再次向使用者开票而创建的发票具有新编号，并且是 `open`。
PO_NUMBER	VARCHAR	由使用者指定的购买列表的采购订单 (PO) 编号。PO 编号由使用者手动输入。
CURRENCY	VARCHAR	始终为 USD（此视图中不支持替代货币）。
TOTAL_BILLED_AMOUNT	DECIMAL	以 USD 为单位向使用者开出的账单总额。此金额包括适用于使用者和提供商费用的使用者税款。
SALES_TAX_AMOUNT	DECIMAL	使用者应付的销售税（以 USD 为单位）。此金额包含在 `TOTAL_BILLED_AMOUNT` 列金额中。
FEES	DECIMAL	提供商费用。此金额包含在 `TOTAL_BILLED_AMOUNT` 列金额中。
EXPECTED_PAYOUT_AMOUNT	DECIMAL	预期支付给提供商的总金额（以 USD 为单位）。此值的计算方式是：从 `TOTAL_BILLED_AMOUNT` 中减去 `SALES_TAX_AMOUNT` 和 `FEES`。
LISTING_DISPLAY_NAME	VARCHAR	列表的显示名称。
LISTING_GLOBAL_NAME	VARCHAR	列表的全局名称。
CONSUMER_ORGANIZATION_NAME	VARCHAR	使用者的组织名称。
CONSUMER_ACCOUNT_NAME	VARCHAR	使用者的账户名称。
CONSUMER_ACCOUNT_LOCATOR	VARCHAR	使用者的账户定位器。
CONSUMER_COMPANY_NAME	VARCHAR	使用者的公司名称。
CONSUMER_BILLING_EMAIL_ADDRESS	VARCHAR	与使用者的账单关联的电子邮件地址。

使用说明¶

视图的延迟时间最长可达 48 小时（2 天）。
数据会保留 365 天（1 年）。

示例¶

检索要导出的账单信息。

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

按使用者检索未付发票的详细信息。

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