本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 帳單事件資料摘要
<a name="data-feed-billing-event"></a>

此資料摘要提供帳單事件的相關資訊，包括開立發票和支出。

例如，您可以使用此資料摘要來了解買方開立發票的時間和項目。您也可以使用[範例 SQL 查詢](#data-feeds-billing-event-query-examples)來分析來自此資料饋送的資料。

此資料摘要包含與您是記錄賣方的帳單事件相關的資訊。對於透過管道合作夥伴所簽訂的協議，此資料饋送包含製造商與記錄賣方之間帳單事件的相關資訊。

帳單事件資料饋送每 24 小時重新整理一次，因此新資料每天可用。

帳單事件資料不可變。

下表說明資料饋送資料欄的名稱和描述。


| 欄名稱  | Description  | 
| --- | --- | 
| billing\$1event\$1id | 帳單事件的識別符。此 ID 在賣方環境中是唯一的。 | 
| from\$1account\$1id |  啟動帳單事件的帳戶。如果 `transaction_type`是 `SELLER_REV_SHARE`，則它是買方的付款人帳戶。這是[帳戶](data-feed-account.md)資料饋送的外部金鑰。 可用於加入 `account_id` 欄位上的`Account`資料饋送。  | 
| to\$1account\$1id | 接收產品交易金額的帳戶。這是帳戶資料饋送的外部金鑰。可用於加入 `account_id` 欄位上的`Account`資料饋送。 | 
| end\$1user\$1account\$1id | 使用產品的 帳戶。此帳戶可能與買方和付款人帳戶不同。可用於加入 `account_id` 欄位上的`Account`資料饋送。 | 
| product\$1id | 產品的識別符。這是[產品](data-feed-product.md)資料饋送的外部金鑰。可用於加入 `product_id` 欄位上的`Product`資料饋送。 | 
| 動作 |  此事件的動作類型。可能的值如下： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/marketplace/latest/userguide/data-feed-billing-event.html)  | 
| transaction\$1type |  交易的類型。如需範例，請參閱 [稅務案例](#data-feeds-billing-event-tax-examples)。可能的值如下： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/marketplace/latest/userguide/data-feed-billing-event.html)  | 
| parent\$1billing\$1event\$1id |  當 的值`broker_id`為 時`AWS_INC`， 的值`action`為 `DISBURSED`或 `FORGIVEN`，而 的值`transaction_type`為 時`DISBURSEMENT`， `parent_billing_event_id`是指起始此帳單事件`billing_event_id`的原始 。如果 `action`有另一個值，則此欄位為 null。 當 的值`broker_id`為 時`AWS_EUROPE`， `parent_billing_event_id`是指在下列情況下`billing_event_id`啟動此帳單事件的原始 ： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/marketplace/latest/userguide/data-feed-billing-event.html) 當 的值`broker_id`為 時`AWS_EUROPE`， `parent_billing_event_id`是指下列情況下先前成功支付帳單事件`billing_event_id`的原始 ： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/marketplace/latest/userguide/data-feed-billing-event.html) 當 的值`broker_id`為 時`AWS_EUROPE`，此欄位在所有剩餘的案例中皆為 null。  | 
| disbursement\$1billing\$1event\$1id |  當 的值`action`為 `DISBURSED`且下列其中一項為 true 時，相關的支出： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/marketplace/latest/userguide/data-feed-billing-event.html) 在所有其他情況下，此值為 null。  | 
| amount | 帳單事件金額。 | 
| currency | ISO 639 貨幣代碼。 | 
| disbursement\$1amount | 支出金額。對於雙發票案例，此欄位包含支出金額。對於統一發票案例，此欄位為 null。 | 
| disbursement\$1currency | 支出金額的 ISO 639 貨幣代碼。對於雙發票案例，此欄位包含支出貨幣代碼。對於統一發票案例，此欄位為 null。 | 
| balance\$1impacting | 在計算賣方支出時，是否會考慮金額。值 0 表示金額僅供參考，對餘額沒有影響。值 1 表示此金額在決定賣方支出時已納入考量。 | 
| invoice\$1date | 發票建立的日期。 | 
| payment\$1due\$1date |  當 的值`action`為 時`INVOICED`，發票的到期日。  | 
| usage\$1period\$1start\$1date | 記錄中期間的開始日期。 | 
| usage\$1period\$1end\$1date | 記錄中期間的結束日期。 | 
| invoice\$1id |   AWS 發票 ID。  | 
| billing\$1address\$1id | 地址資料摘要中的付款人帳單地址參考。可用於加入 `address_id` 欄位上的`Address`資料饋送。 | 
| transaction\$1reference\$1id |  可讓您從下列報告交叉參考資料的識別符： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/marketplace/latest/userguide/data-feed-billing-event.html)  | 
| bank\$1trace\$1id |  對於支出交易 (`transaction_type` =is `DISBURSEMENT`且動作為 `DISBURSED`)，由銀行指派的追蹤 ID。追蹤 ID 可用來與賣方銀行提供的報告建立關聯。  | 
| broker\$1id |  促進交易之商業實體的識別符。可能的值如下： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/marketplace/latest/userguide/data-feed-billing-event.html)  | 
| buyer\$1transaction\$1reference\$1id |  使用 `GROUP BY`或 SQL 中的視窗函數建構，將帳單摘要中所有相關記錄分組在一起的識別符。這些相關記錄可包含買方發票、賣方發票，以及列出費用的增值稅 VATs)。  | 
| action\$1date |  交易事件發生的日期。特定日期取決於動作類型： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/marketplace/latest/userguide/data-feed-billing-event.html)  | 
| recipient\$1account\$1id | 接收摘要中資料的賣方帳戶。可用於加入 `account_id` 欄位上的`Account`資料饋送。 | 
| offer\$1id | 與買方發票明細項目相關聯的優惠的易記 ID。可用於加入 `offer_id` 欄位上的`Offer`資料饋送。 | 
| buyer\$1invoice\$1date | 相關聯買方發票明細項目的發票日期。 | 
| line\$1item\$1id | 發票明細項目 ID，以支付精細程度表示。 | 
| buyer\$1line\$1item\$1id | 支付精細度的買方發票明細項目 ID。 | 
| charge\$1variant | 指出正在購買或銷售的項目。 | 
| charge\$1side | 指出賣方是購買還是銷售費用變體。 | 

## 稅務案例
<a name="data-feeds-billing-event-tax-examples"></a>

適用於買方和賣方國家和州的稅務模型會決定如何收集和匯出稅金。以下是可能的情況：
+ 稅金由 收取和傳送 AWS。在這些情況下， `transaction_type`是 `AWS_TAX_SHARE`。
+ 稅務由賣方收取 AWS、支付給賣方，並由賣方向稅務機關提交。在這些情況下， `transaction_type`是 `SELLER_TAX_SHARE`。
+ 稅金不會由 收取 AWS。賣方必須計算稅金並將其匯給稅務機關。在這些情況下， AWS Marketplace 不會執行稅務計算或接收稅務資訊。賣方會支付收入份額的稅金。

## 帳單事件資料饋送的範例
<a name="data-feed-billing-event-sample-scenario"></a>

本節顯示開立發票時和一個月後帳單事件資料期間的範例。請注意本節中所有資料表的下列項目：
+ 在資料饋送中，`billing_event_id`值為 40 個字元的英數字串。此處顯示為兩個字元字串，以供讀取。
+ 在資料饋送中，此資訊會以單一資料表顯示。為了便於閱讀，資料會顯示在此處的多個資料表中，而且不會顯示所有資料欄。

如需本節中的範例，請假設下列事項：
+ Arnav 是買方。
  + 他的帳戶 ID 是 `737399998888`。
  + 他位於法國，受到市場協調人員法律的約束。如需詳細資訊，請參閱 [Amazon Web Service Tax Help](https://aws.amazon.com/tax-help/)。
  + 他購買`prod-o4grxfafcxxxx`該產品，並按每月用量開立 120.60 美元的發票。
  + 他在該月內支付了發票。
+ Jane 是製造商。
  + 她的帳戶 ID 是 `111122223333`。
+ Paulo 是記錄的賣方。
  + 他的帳戶 ID 是 `777788889999`。
  + 他住在堪薩斯，不受市場促進者法律的約束。

### 記錄賣方的帳單事件資料摘要
<a name="billing-event-example-seller-of-record"></a>

身為記錄賣方，Paulo 會向買方 Arnav 開立發票。

下表顯示 Paulo 在開立 Arnav 發票時，資料摘要中的相關資訊。


| billing\$1event\$1id  | from\$1account\$1id  | to\$1account\$1id  | end\$1user\$1account\$1id | product\$1id | 動作 | transaction\$1type | 
| --- | --- | --- | --- | --- | --- | --- | 
| I0 | 737399998888 | 777788889999 | 737399998888 | prod-o4grxfafcxxxx | 已開立發票 | SELLER\$1REV\$1SHARE | 
| I1 | 737399998888 | AWS | 737399998888 | prod-o4grxfafcxxxx | 已開立發票 | AWS\$1TAX\$1SHARE | 
| I2 | 777788889999 | 111122223333 | 737399998888 | prod-o4grxfafcxxxx | 已開立發票 | SELLER\$1REV\$1SHARE | 
| I3 | 777788889999 | AWS | 737399998888 | prod-o4grxfafcxxxx | 已開立發票 | AWS\$1REV\$1SHARE | 




| parent\$1billing\$1event\$1id | disbursement\$1billing\$1event\$1id | amount | currency | invoice\$1date | invoice\$1id | 
| --- | --- | --- | --- | --- | --- | 
|  |  | 100 | 美元 | 2018-12-31T00：00：00Z | 781216640 | 
|  |  | 20.6 | 美元 | 2018-12-31T00：00：00Z | 781216640 | 
|  |  | -80 | 美元 | 2018-12-31T00：04：07Z | 788576665 | 
|  |  | -0.2 | 美元 | 2018-12-31T00：04：07Z | 788576665 | 

下表顯示在 Arnav 支付發票之後，月底 Paulo 資料饋送中的相關資訊。


| billing\$1event\$1id  | from\$1account\$1id  | to\$1account\$1id  | end\$1user\$1account\$1id | product\$1id | 動作 | transaction\$1type | 
| --- | --- | --- | --- | --- | --- | --- | 
| I10 | 737399998888 | 777788889999 | 737399998888 |  | 分發 | SELLER\$1REV\$1SHARE | 
| I12 | 777788889999 | 111122223333 | 737399998888 |  | 分發 | SELLER\$1REV\$1SHARE | 
| I13 | 777788889999 | AWS | 737399998888 | prod-o4grxfafcxxxx | 分發 | AWS\$1REV\$1SHARE | 
| I14 | AWS | 777788889999 |  |  | 分發 | 支出 | 




| parent\$1billing\$1event\$1id | disbursement\$1billing\$1event\$1id | amount | currency | invoice\$1date | invoice\$1id | 
| --- | --- | --- | --- | --- | --- | 
| I0 | I14 | -100 | 美元 | 2018-12-31T00：00：00Z | 781216640 | 
| I2 | I14 | 80 | 美元 | 2018-12-31T00：04：07Z | 788576665 | 
| I3 | I14 | 0.2 | 美元 | 2018-12-31T00：04：07Z | 788576665 | 
|  |  | 19.8 | 美元 |  |  | 

### 製造商的帳單事件資料摘要
<a name="billing-event-example-manufacturer"></a>

下表顯示 Paulo 發票 Arnav 時 Jane 資料饋送中的相關資訊。


| billing\$1event\$1id  | from\$1account\$1id  | to\$1account\$1id  | end\$1user\$1account\$1id | product\$1id | 動作 | transaction\$1type | 
| --- | --- | --- | --- | --- | --- | --- | 
| I5 | 777788889999 | 111122223333 |  | prod-o4grxfafcxxxx | 已開立發票 | SELLER\$1REV\$1SHARE | 
| I6 | 777788889999 | 111122223333 |  | prod-o4grxfafcxxxx | 已開立發票 | SELLER\$1TAX\$1SHARE | 
| I7 | 111122223333 | AWS |  | prod-o4grxfafcxxxx | 已開立發票 | AWS\$1REV\$1SHARE | 




| parent\$1billing\$1event\$1id | disbursement\$1billing\$1event\$1id | amount | currency | invoice\$1date | invoice\$1id | 
| --- | --- | --- | --- | --- | --- | 
|  |  | 73.5 |  | 2018-12-31T00：04：07Z | 788576665 | 
|  |  | 6.5 |  | 2018-12-31T00：04：07Z | 788576665 | 
|  |  | -7.35 |  | 2018-12-31T00：04：07Z | 788576665 | 

下表顯示在支付發票後，月底 Jane 資料饋送中的相關資訊。


| billing\$1event\$1id  | from\$1account\$1id  | to\$1account\$1id  | end\$1user\$1account\$1id | product\$1id | 動作 | transaction\$1type | 
| --- | --- | --- | --- | --- | --- | --- | 
| I30 | 777788889999 | 111122223333 |  | prod-o4grxfafcxxxx | 分發 | SELLER\$1REV\$1SHARE | 
| I31 | 777788889999 | 111122223333 |  | prod-o4grxfafcxxxx | 分發 | SELLER\$1TAX\$1SHARE | 
| I32 | 111122223333 | AWS |  | prod-o4grxfafcxxxx | 分發 | AWS\$1REV\$1SHARE | 
| I33 | AWS | 111122223333 |  |  | 分發 | 支出 | 




| parent\$1billing\$1event\$1id | disbursement\$1billing\$1event\$1id | amount | currency | invoice\$1date | invoice\$1id | 
| --- | --- | --- | --- | --- | --- | 
| I5 | I33 | -73.5 | 美元 |  |  | 
| I6 | I33 | -6.5 | 美元 |  |  | 
| I7 | I33 | 7.35 | 美元 |  |  | 
|  |  | 72.65 | 美元 |  |  | 

## 查詢範例
<a name="data-feeds-billing-event-query-examples"></a>

如 中所述[使用資料饋送收集和分析資料](data-feed-using.md)，您可以使用 [ Athena](https://docs.aws.amazon.com/athena/latest/ug/what-is.html) 對在受管 Amazon S3 儲存貯體中收集並儲存為資料饋送的資料執行查詢。本節提供一些您可能這麼做的常見方式範例。所有範例都假設使用單一貨幣。

## 範例 1：發票金額，包括稅金
<a name="data-feed-example-query-tax-invoice"></a>

若要了解已開立多少買方發票，包括稅金，您可以執行查詢，如下列範例所示。

```
SELECT sum(amount) FROM billing_event 
WHERE 
  action = 'INVOICED'
  AND
  (
    (transaction_type in ('SELLER_REV_SHARE', 'SELLER_TAX_SHARE')
      -- to discard SELLER_REV_SHARE from Manufacturer to Channel Partner, aka cost of goods
      AND to_account_id='seller-account-id'
    )
  OR transaction_type= 'AWS_TAX_SHARE'
  );
```

## 範例 2：代表賣方向買方開立發票的金額
<a name="data-feed-example-query-invoice-for-seller"></a>

若要了解代表賣方開立多少買方發票，您可以執行查詢，如下列範例所示。

```
SELECT sum(amount) FROM billing_event 
WHERE
  action = 'INVOICED'
  AND transaction_type in ('SELLER_REV_SHARE', 'SELLER_TAX_SHARE')
  AND to_account_id='seller-account-id'
;
```

## 範例 3： AWS 可以代表賣方收取的金額
<a name="data-feed-example-query-aws-collect"></a>

若要了解 AWS 可以代表賣方收取多少金額，減去任何退款、抵用金和寬容帳戶，您可以執行查詢，如下列範例所示。

```
SELECT sum(amount) FROM billing_event 
WHERE
  -- what is invoiced on behalf of SELLER, incl. refunds/ credits and cost of goods
  transaction_type like 'SELLER_%' 
  -- FORGIVEN action records will "negate" related INVOICED
  and action in ('INVOICED','FORGIVEN') 
;
```

## 範例 4：賣方可以收集的金額
<a name="data-feed-example-query-seller-collect"></a>

若要了解賣方可以收集多少，您可以執行查詢，如下列範例所示。此範例會移除 AWS 收集的清單費用和稅金，並新增任何例外餘額調整。

```
SELECT sum(amount) FROM billing_event
WHERE
  (transaction_type like 'SELLER_%' -- what is invoiced on behalf of SELLER
  or transaction_type like 'AWS_REV_%' -- what is owed to AWS
  or transaction_type = 'BALANCE_ADJUSTMENT' -- exceptionnal case
  )
  and action in ('INVOICED','FORGIVEN')
;
```

您也可以使用下列查詢來收集相同的資訊，如下列範例所示。

```
SELECT sum(amount) FROM billing_event
WHERE
  balance_impacting = 1
  and action in ('INVOICED','FORGIVEN')
;
```

下列範例顯示相同的資訊，但僅限於 2018 年交易，並假設所有買方都已支付其發票。

```
SELECT sum(amount) FROM billing_event
WHERE
  invoice_date between '2018-01-01' and '2018-12-31'
  and balance_impacting = 1
  and action in ('INVOICED','FORGIVEN')
;
```

## 範例 5：支出金額
<a name="data-feed-example-query-disbursements"></a>

若要了解已分配的金額，您可以執行查詢，如下列範例所示。

```
select sum(amount) FROM billing_event
WHERE
  action ='DISBURSED'
  and transaction_type like 'DISBURSEMENT%'
;
```

## 範例 6：待支付的金額
<a name="data-feed-example-query-pending-disbursement"></a>

若要了解待支付的金額，您可以執行查詢，如下列範例所示。此查詢會移除已分配的金額。

```
SELECT sum(amount) FROM billing_event targeted 
WHERE
   (transaction_type like 'SELLER_%'  -- what is invoiced on behalf of SELLER
    or transaction_type like 'AWS_REV_%'  -- what is owed to AWS
    or transaction_type = 'BALANCE_ADJUSTMENT' -- exceptionnal case
   ) 
  -- DISBURSEMENT action records will "negate" 'INVOICED'
  -- but do not take into account failed disbursements
   AND 
    (not exists
      (select 1 
        from billing_event disbursement
          join billing_event failed_disbursement
           on disbursement.billing_event_id=failed_disbursement.parent_billing_event_id
        where
         disbursement.transaction_type='DISBURSEMENT'
         and failed_disbursement.transaction_type='DISBURSEMENT_FAILURE'
         and targeted.disbursement_billing_event_id=disbursement.billing_event_id
      )
    ) 
;
```

取得相同資訊的另一個方法是執行查詢以取得賣方的餘額，如下列範例所示。

```
SELECT sum(amount) FROM billing_event
WHERE
 balance_impacting = 1
;
```

下列查詢延伸了我們的範例。它會將結果限制為 2018 年交易，並傳回交易的其他詳細資訊。

```
select sum(residual_amount_per_transaction)
from
 (SELECT
    max(billed_invoices.amount) invoiced_amount,
    sum(nvl(disbursed_invoices.amount,0)) disbursed_amount,
    -- Exercise left to the reader:
    -- use transaction_type to distinguish listing fee vs seller-owed money
    -- still pending collection
    max(transaction_type) transaction_type,
    max(billed_invoices.amount) 
      + sum(nvl(disbursed_invoices.amount,0)) residual_amount_per_transaction
  FROM billing_event billed_invoices
    -- find related disbursements
    left join billing_event disbursed_invoices
      on disbursed_invoices.action='DISBURSED'
      and disbursed_invoices.parent_billing_event_id=billed_invoices.billing_event_id
  WHERE
    billed_invoices.invoice_date between '2018-01-01' and '2018-12-31'
    and billed_invoices.transaction_type like 'SELLER_%' -- invoiced on behalf of SELLER
    and billed_invoices.action in ('INVOICED','FORGIVEN')
    -- do not take into account failed disbursements
    AND not exists
      (select 1 from billing_event failed_disbursement
       where disbursed_invoices.disbursement_billing_event_id = failed_disbursement.parent_billing_event_id
      )
   GROUP BY billed_invoices.billing_event_id
);
```

## 範例 7：發票集的餘額
<a name="data-feed-example-query-balance-invoice-set"></a>

若要了解一組發票的總和，您可以執行查詢，如下列範例所示。

```
SELECT invoice_id, sum(amount) FROM billing_event targeted
WHERE
  -- invoice_id is only not null for invoiced records AND disbursed records 
  -- linking them to related disbursement -> no need to filter more precisely
  invoice_id in ('XXX','YYY') 
  -- filter out failed disbursements 
  AND not exists
      (select 1 
        from billing_event disbursement
          join billing_event failed_disbursement
           on disbursement.billing_event_id=failed_disbursement.parent_billing_event_id
        where
         disbursement.transaction_type='DISBURSEMENT'
         and failed_disbursement.transaction_type='DISBURSEMENT_FAILURE'
         and targeted.disbursement_billing_event_id=disbursement.billing_event_id
      ) 
  group by invoice_id;
```