Esquema:: Uso de Data Sharing

Exibição MARKETPLACE_LISTING_INVOICE_STATUS¶

A exibição MARKETPLACE_LISTING_INVOICE_STATUS no esquema Uso de Data Sharing permite que você consulte o histórico de faturas relacionadas a listagens pagas no Snowflake Marketplace.

Visível apenas para provedores de listagens pagas, esta exibição inclui o histórico de status de pagamento por fatura para listagens compradas.

Colunas¶


Nome da coluna	Tipo de dados	Descrição
STRIPE_DISPLAY_NUMBER	VARCHAR	O número da fatura ou exibição do Stripe.
INVOICE_DATE	DATE	Data da fatura.
USAGE_MONTH	VARCHAR	O primeiro mês em que uma fatura é gerada, no formato `YYYY-MM-01`. Por exemplo, se o consumidor comprar a listagem em 12-MAR-2024, a data neste campo será `2024-03-01`.
INVOICE_STATUS	VARCHAR	Status da fatura. Valores possíveis: `closed` Pago à Snowflake; pago aos provedores em até 30 dias. `open` Ainda não pago. `void` Cancelado. `rebilled` Indica que uma fatura anulada foi faturada novamente para fazer um ajuste. Se uma fatura for cancelada e faturada novamente, há duas linhas para esse número de fatura: um `void` e um `rebilled`; a fatura criada para faturar o consumidor novamente tem um novo número e é `open`.
PO_NUMBER	VARCHAR	Número da ordem de compra (PO) especificado pelo consumidor para comprar um listagem. O número da PO é inserido manualmente pelo consumidor.
CURRENCY	VARCHAR	Sempre USD (moedas alternativas não são compatíveis nesta exibição).
TOTAL_BILLED_AMOUNT	DECIMAL	Valor total faturado ao consumidor em USD. Este valor inclui impostos de consumo que se aplicam às taxas do consumidor e do provedor.
SALES_TAX_AMOUNT	DECIMAL	O imposto sobre vendas em USD é pago pelo consumidor. Este valor está incluso no valor da coluna `TOTAL_BILLED_AMOUNT`.
FEES	DECIMAL	Taxas do provedor. Este valor está incluso no valor da coluna `TOTAL_BILLED_AMOUNT`.
EXPECTED_PAYOUT_AMOUNT	DECIMAL	O pagamento total esperado ao provedor em USD. Este valor é calculado subtraindo `SALES_TAX_AMOUNT` e `FEES` de `TOTAL_BILLED_AMOUNT`.
LISTING_DISPLAY_NAME	VARCHAR	Nome de exibição da listagem.
LISTING_GLOBAL_NAME	VARCHAR	Nome global da listagem.
CONSUMER_ORGANIZATION_NAME	VARCHAR	Nome da organização do consumidor.
CONSUMER_ACCOUNT_NAME	VARCHAR	Nome da conta do consumidor.
CONSUMER_ACCOUNT_LOCATOR	VARCHAR	Localizador de conta do consumidor.
CONSUMER_COMPANY_NAME	VARCHAR	Nome da empresa do consumidor.
CONSUMER_BILLING_EMAIL_ADDRESS	VARCHAR	Endereço de e-mail associado ao faturamento do consumidor.

Notas de uso¶

A latência da exibição pode ser de até 48 horas (2 dias).
Os dados são retidos por 365 dias (1 ano).

Exemplos¶

Recupere informações de faturamento para exportação.

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;

Recupere detalhes de faturas não pagas pelo consumidor.

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;