Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Feed di dati degli eventi di fatturazione
Questo feed di dati fornisce informazioni sugli eventi di fatturazione, tra cui fatturazione ed esborsi.
Ad esempio, puoi utilizzare questo feed di dati per sapere quando e cosa viene fatturata a un acquirente. Puoi anche utilizzare le [query SQL di esempio](#data-feeds-billing-event-query-examples) per analizzare i dati di questo data feed.
Questo feed di dati contiene informazioni associate agli eventi di fatturazione per i quali sei il venditore registrato. Per gli accordi stipulati tramite i partner di canale, questo feed di dati contiene informazioni sugli eventi di fatturazione tra il produttore e il venditore del disco.
Il feed di dati degli eventi di fatturazione viene aggiornato ogni 24 ore, quindi nuovi dati sono disponibili ogni giorno.
I dati degli eventi di fatturazione sono immutabili.
La tabella seguente spiega i nomi e le descrizioni delle colonne del data feed.
| Nome della colonna | Description |
| --- | --- |
| billing\$1event\$1id | Un identificatore per un evento di fatturazione. Questo ID è unico nell'ambiente del venditore. |
| from\$1account\$1id | L'account che ha avviato l'evento di fatturazione. In caso `transaction_type` `SELLER_REV_SHARE` affermativo, si tratta dell'account di pagamento dell'acquirente. Questa è una chiave esterna per il feed di dati [dell'account](data-feed-account.md). Può essere usato per unirsi al `Account` data feed sul `account_id` campo. |
| to\$1account\$1id | L'account che riceve l'importo della transazione per il prodotto. Questa è una chiave esterna per il feed di dati dell'account.Può essere usato per unirsi al `Account` data feed sul `account_id` campo. |
| end\$1user\$1account\$1id | L'account che utilizza il prodotto. Questo account può essere diverso dagli account dell'acquirente e del pagatore.Può essere usato per unirsi al `Account` data feed sul `account_id` campo. |
| product\$1id | L'identificatore del prodotto. Questa è una chiave esterna per il feed di dati [del prodotto](data-feed-product.md).Può essere usato per unirsi al `Product` data feed sul `product_id` campo. |
| operazione | Il tipo di azione per questo evento. I valori possibili sono i seguenti: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/marketplace/latest/userguide/data-feed-billing-event.html) |
| transaction\$1type | Il tipo di transazione. Per alcuni esempi, consulta [Scenari di tassazione](#data-feeds-billing-event-tax-examples). I valori possibili sono i seguenti: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/marketplace/latest/userguide/data-feed-billing-event.html) |
| parent\$1billing\$1event\$1id | Quando il valore di `broker_id` è`AWS_INC`, il valore di è `DISBURSED` o e il valore di `action` è`FORGIVEN`, `parent_billing_event_id` si riferisce all'originale che ha `DISBURSEMENT` avviato `transaction_type` questo evento di fatturazione. `billing_event_id` Se `action` ha un altro valore, questo campo è nullo. Quando il valore di `broker_id` è`AWS_EUROPE`, `parent_billing_event_id` si riferisce all'originale `billing_event_id` che ha avviato questo evento di fatturazione per i seguenti scenari: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/marketplace/latest/userguide/data-feed-billing-event.html) Quando il valore di `broker_id` è`AWS_EUROPE`, `parent_billing_event_id` si riferisce all'evento originale del precedente evento `billing_event_id` di fatturazione del pagamento andato a buon fine per lo scenario seguente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/marketplace/latest/userguide/data-feed-billing-event.html) Quando il valore di `broker_id` è`AWS_EUROPE`, questo campo è nullo per tutti gli scenari rimanenti. |
| disbursement\$1billing\$1event\$1id | Il relativo esborso quando il valore di è e una delle seguenti condizioni è vera: `action` `DISBURSED` [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/marketplace/latest/userguide/data-feed-billing-event.html) In tutti gli altri scenari, questo valore è nullo. |
| quantità | L'importo dell'evento di fatturazione. |
| currency | Il codice valuta ISO 639. |
| esbursement\$1amount | L'importo del pagamento. Per gli scenari di doppia fatturazione, questo campo contiene l'importo del pagamento. Per gli scenari di fatturazione unificata, questo campo è nullo. |
| valuta\$1di esborso | Il codice valuta ISO 639 per l'importo del pagamento. Per gli scenari di doppia fatturazione, questo campo contiene il codice della valuta di pagamento. Per gli scenari di fatturazione unificata, questo campo è nullo. |
| balance\$1impacting | Se l'importo viene preso in considerazione nel calcolo degli esborsi del venditore. Il valore di 0 indica che l'importo è indicato a scopo informativo e non ha alcun effetto sul saldo. Un valore di 1 indica che tale importo viene preso in considerazione nel determinare i pagamenti da parte del venditore. |
| data\$1fattura | La data di creazione della fattura. |
| payment\$1due\$1date | Quando il valore di `action` è`INVOICED`, la data di scadenza della fattura. |
| data\$1di\$1inizio\$1periodo di utilizzo | La data di inizio del periodo nel record. |
| usage\$1period\$1end\$1date | La data di fine del periodo nel record. |
| invoice\$1id | L' AWS ID della fattura. |
| id\$1indirizzo\$1di fatturazione | Il riferimento all'indirizzo di fatturazione del pagatore nel feed di dati degli indirizzi.Può essere usato per unirsi al feed di `Address` dati sul `address_id` campo. |
| transaction\$1reference\$1id | Un identificatore che consente di effettuare riferimenti incrociati ai dati dei seguenti report: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/marketplace/latest/userguide/data-feed-billing-event.html) |
| bank\$1trace\$1id | Per le transazioni di pagamento (`transaction_type`=is `DISBURSEMENT` e action is`DISBURSED`), l'ID di traccia assegnato dalla banca. L'ID di tracciamento può essere utilizzato per correlare i report forniti dalla banca venditrice e forniti dalla banca venditrice. |
| broker\$1id | Un identificatore dell'entità aziendale che ha facilitato la transazione. I valori possibili sono i seguenti: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/marketplace/latest/userguide/data-feed-billing-event.html) |
| buyer\$1transaction\$1reference\$1id | Un identificatore che raggruppa tutti i record correlati nel feed di fatturazione utilizzando o le funzioni della finestra costruite in SQL. `GROUP BY` Questi record correlati possono contenere la fattura dell'acquirente, la fattura del venditore e l'imposta sul valore aggiunto (VATs) sulla tariffa di inserzione. |
| data\$1azione | La data in cui si è verificato l'evento della transazione. La data specifica dipende dal tipo di azione: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/marketplace/latest/userguide/data-feed-billing-event.html) |
| recipient\$1account\$1id | L'account del venditore che riceve i dati nei feed. Può essere usato per unirsi al `Account` data feed sul `account_id` campo. |
| offer\$1id | L'ID descrittivo dell'offerta associato alla voce della fattura dell'acquirente.Può essere usato per unirsi al `Offer` data feed sul `offer_id` campo. |
| data\$1fattura\$1acquirente | La data della fattura relativa alla voce della fattura dell'acquirente associata. |
| line\$1item\$1id | L'ID della voce della fattura, in base alla granularità del pagamento. |
| buyer\$1line\$1item\$1id | L'ID dell'articolo della fattura dell'acquirente in base alla granularità del pagamento. |
| charge\$1variant | Indica cosa viene acquistato o venduto. |
| charge\$1side | Indica se il venditore sta acquistando o vendendo la variante di addebito. |
## Scenari di tassazione
Il modello di tassazione in vigore per il paese e lo stato dell'acquirente e del venditore determina il modo in cui le imposte vengono riscosse e versate. Di seguito sono riportati gli scenari possibili:
+ Le tasse vengono riscosse e versate da AWS. In questi casi, lo `transaction_type` è`AWS_TAX_SHARE`.
+ Le imposte vengono riscosse dal venditore AWS, versate al venditore e versate dal venditore alle autorità fiscali. In questi casi, lo è. `transaction_type` `SELLER_TAX_SHARE`
+ Le tasse non vengono riscosse da AWS. Il venditore deve calcolare le imposte e versarle alle autorità fiscali. In questi casi, Marketplace AWS non esegue calcoli fiscali né riceve informazioni fiscali. Il venditore paga le imposte sulla quota di compartecipazione alle entrate.
## Esempi di feed di dati sugli eventi di fatturazione
Questa sezione mostra esempi del periodo di dati dell'evento di fatturazione al momento della fatturazione e un mese dopo. Tieni presente quanto segue per tutte le tabelle di questa sezione:
+ Nei data feed, i `billing_event_id` valori sono stringhe alfanumeriche di 40 caratteri. Vengono mostrati qui come stringhe di due caratteri per una maggiore leggibilità.
+ Nel data feed, queste informazioni sono presentate in un'unica tabella. Per motivi di leggibilità, qui i dati vengono mostrati in più tabelle e non tutte le colonne.
Per gli esempi di questa sezione, si supponga quanto segue:
+ Arnav è l'acquirente.
+ L'ID del suo account è. `737399998888`
+ Vive in Francia, paese soggetto alle leggi sui facilitatori del mercato. Per ulteriori informazioni, consulta l'[assistenza fiscale di Amazon Web Service](https://aws.amazon.com/tax-help/).
+ Ha acquistato `prod-o4grxfafcxxxx` e gli sono stati fatturati 120,60 USD per l'utilizzo mensile di quel prodotto.
+ Ha pagato la fattura entro il mese.
+ Jane è la produttrice.
+ L'ID del suo account è`111122223333`.
+ Paulo è il venditore di dischi.
+ L'ID del suo account è`777788889999`.
+ Vive in Kansas, che non è soggetto alle leggi sull'agevolazione del mercato.
### Feed di dati sugli eventi di fatturazione per il venditore registrato
In qualità di venditore registrato, Paulo fattura all'acquirente, Arnav.
Le tabelle seguenti mostrano le informazioni pertinenti nel data feed di Paulo quando fattura ad Arnav.
| billing\$1event\$1id | da\$1account\$1id | to\$1account\$1id | id\$1user\$1account\$1finale | product\$1id | operazione | transaction\$1type |
| --- | --- | --- | --- | --- | --- | --- |
| I0 | 737399998888 | 777788889999 | 737399998888 | prod-o4grxfafcxxxx | FATTURATI | SELLER\$1REV\$1SHARE |
| I1 | 737399998888 | AWS | 737399998888 | prod-o4grxfafcxxxx | FATTURATI | AWS\$1TAX\$1CONDIVIDI |
| I2 | 777788889999 | 111122223333 | 737399998888 | prod-o4grxfafcxxxx | FATTURATI | SELLER\$1REV\$1SHARE |
| I3 | 777788889999 | AWS | 737399998888 | prod-o4grxfafcxxxx | FATTURATI | AWS\$1REV\$1CONDIVIDI |
| parent\$1billing\$1event\$1id | id\$1fatturazione\$1event\$1di\$1pagamento | quantità | currency | data\$1fattura | id\$1fattura |
| --- | --- | --- | --- | --- | --- |
| | | 100 | USD | 31/12/2018 ALLE 00:00:00 Z | 781216640 |
| | | 20,6 | USD | 2018-12-31 H 00:00:00 Z | 781216640 |
| | | -80 | USD | 2018-12-31T 00:04:07 Z | 788576665 |
| | | -0,2 | USD | 2018-12-31T 00:04:07 Z | 788576665 |
Le tabelle seguenti mostrano le informazioni pertinenti nel feed di dati di Paulo alla fine del mese, dopo il pagamento della fattura da parte di Arnav.
| billing\$1event\$1id | da\$1account\$1id | to\$1account\$1id | id\$1user\$1account\$1finale | product\$1id | operazione | transaction\$1type |
| --- | --- | --- | --- | --- | --- | --- |
| I10 | 737399998888 | 777788889999 | 737399998888 | | SBORSATO | SELLER\$1REV\$1SHARE |
| I12 | 777788889999 | 111122223333 | 737399998888 | | SBORSATO | SELLER\$1REV\$1SHARE |
| I13 | 777788889999 | AWS | 737399998888 | prod-o4grxfafcxxxx | SBORSATO | AWS\$1REV\$1CONDIVIDI |
| I14 | AWS | 777788889999 | | | SBORSATO | ESBORSO |
| parent\$1billing\$1event\$1id | id\$1fatturazione\$1event\$1di\$1pagamento | quantità | currency | data\$1fattura | id\$1fattura |
| --- | --- | --- | --- | --- | --- |
| I0 | I14 | -100 | USD | 2018-12-31H 00:00:00 Z | 781216640 |
| I2 | I14 | 80 | USD | 2018-12-31T 00:04:07 Z | 788576665 |
| I3 | I14 | 0.2 | USD | 2018-12-31T 00:04:07 Z | 788576665 |
| | | 19,8 | USD | | |
### Feed di dati sugli eventi di fatturazione per il produttore
Le tabelle seguenti mostrano le informazioni pertinenti nel data feed di Jane quando Paulo fattura ad Arnav.
| billing\$1event\$1id | da\$1account\$1id | to\$1account\$1id | id\$1user\$1account\$1finale | product\$1id | operazione | transaction\$1type |
| --- | --- | --- | --- | --- | --- | --- |
| I5 | 777788889999 | 111122223333 | | prod-o4grxfafcxxxx | FATTURATI | SELLER\$1REV\$1SHARE |
| I6 | 777788889999 | 111122223333 | | prod-o4grxfafcxxxx | FATTURATI | SELLER\$1TAX\$1SHARE |
| I7 | 111122223333 | AWS | | prod-o4grxfafcxxxx | FATTURATI | AWS\$1REV\$1CONDIVIDI |
| parent\$1billing\$1event\$1id | id\$1fatturazione\$1event\$1di\$1pagamento | quantità | currency | data\$1fattura | id\$1fattura |
| --- | --- | --- | --- | --- | --- |
| | | 73,5 | | 2018-12-31T 00:04:07 Z | 788576665 |
| | | 6,5 | | 2018-12-31T 00:04:07 Z | 788576665 |
| | | -7,35 | | 2018-12-31T 00:04:07 Z | 788576665 |
Le tabelle seguenti mostrano le informazioni pertinenti nel data feed di Jane alla fine del mese, dopo il pagamento della fattura.
| billing\$1event\$1id | da\$1account\$1id | to\$1account\$1id | id\$1user\$1account\$1finale | product\$1id | operazione | transaction\$1type |
| --- | --- | --- | --- | --- | --- | --- |
| I30 | 777788889999 | 111122223333 | | prod-o4grxfafcxxxx | SBORSATO | SELLER\$1REV\$1SHARE |
| I31 | 777788889999 | 111122223333 | | prod-o4grxfafcxxxx | SBORSATO | SELLER\$1TAX\$1SHARE |
| I32 | 111122223333 | AWS | | prod-o4grxfafcxxxx | SBORSATO | AWS\$1REV\$1CONDIVIDI |
| I33 | AWS | 111122223333 | | | SBORSATO | ESBORSO |
| parent\$1billing\$1event\$1id | id\$1fatturazione\$1event\$1di\$1pagamento | quantità | currency | data\$1fattura | id\$1fattura |
| --- | --- | --- | --- | --- | --- |
| I5 | I33 | -73,5 | USD | | |
| I6 | I33 | -6,5 | USD | | |
| I7 | I33 | 7,35 | USD | | |
| | | 72,65 | USD | | |
## Query di esempio
Come descritto in[Raccolta e analisi dei dati con i data feed](data-feed-using.md), puoi usare [Athena](https://docs.aws.amazon.com/athena/latest/ug/what-is.html) per eseguire query sui dati raccolti e archiviati come feed di dati nel tuo bucket Amazon S3 gestito. Questa sezione fornisce alcuni esempi di metodi comuni per eseguire questa operazione. Tutti gli esempi presuppongono che venga utilizzata un'unica valuta.
## Esempio 1: importo fatturato, tasse incluse
Per scoprire quanto è stato fatturato agli acquirenti, tasse incluse, puoi eseguire una query come illustrato nell'esempio seguente.
```
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'
);
```
## Esempio 2: importo fatturato agli acquirenti per conto del venditore
Per scoprire quanto è stato fatturato agli acquirenti per conto di un venditore, puoi eseguire una query come mostrato nell'esempio seguente.
```
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'
;
```
## Esempio 3: l'importo AWS può riscuotere per conto del venditore
Per scoprire quanto AWS può riscuotere per conto del venditore, al netto di eventuali rimborsi, crediti e account perdonati, puoi eseguire una query come mostrato nell'esempio seguente.
```
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')
;
```
## Esempio 4: importo che il venditore può riscuotere
Per scoprire quanto possono incassare i venditori, puoi eseguire una query come mostrato nell'esempio seguente. Questo esempio rimuove le commissioni di inserzione e le imposte AWS riscosse e aggiunge eventuali rettifiche eccezionali del saldo.
```
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')
;
```
Puoi anche utilizzare la seguente query per raccogliere le stesse informazioni, come illustrato nell'esempio seguente.
```
SELECT sum(amount) FROM billing_event
WHERE
balance_impacting = 1
and action in ('INVOICED','FORGIVEN')
;
```
L'esempio seguente mostra le stesse informazioni, ma è limitato alle transazioni del 2018 e presuppone che tutti gli acquirenti abbiano pagato le proprie fatture.
```
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')
;
```
## Esempio 5: importo degli esborsi
Per scoprire l'importo che è stato erogato, puoi eseguire una query come mostrato nell'esempio seguente.
```
select sum(amount) FROM billing_event
WHERE
action ='DISBURSED'
and transaction_type like 'DISBURSEMENT%'
;
```
## Esempio 6: importo in attesa di pagamento
Per scoprire l'importo in sospeso di pagamento, puoi eseguire una query come mostrato nell'esempio seguente. Questa query rimuove gli importi che sono già stati erogati.
```
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
)
)
;
```
Un altro modo per ottenere le stesse informazioni consiste nell'eseguire una query per ottenere il saldo del venditore, come illustrato nell'esempio seguente.
```
SELECT sum(amount) FROM billing_event
WHERE
balance_impacting = 1
;
```
La seguente query estende il nostro esempio. Limita i risultati alle transazioni del 2018 e restituisce dettagli aggiuntivi sulle transazioni.
```
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
);
```
## Esempio 7: Saldo del set di fatture
Per conoscere la somma di un set di fatture, è possibile eseguire una query come illustrato nell'esempio seguente.
```
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;
```