Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Fuente de datos de eventos de facturación
Esta fuente de datos proporciona información sobre eventos de facturación, incluidos facturación y desembolsos.
Por ejemplo, puede utilizar esta fuente de datos para saber cuándo y qué se factura a un comprador. También puede utilizar las [consultas de SQL de ejemplo](#data-feeds-billing-event-query-examples) para analizar los datos de esta fuente de datos.
Esta fuente de datos contiene información asociada con eventos de facturación para los que es el vendedor registrado. Para los acuerdos realizados a través de socios de canal, esta fuente de datos contiene información sobre eventos de facturación entre el fabricante y el vendedor de registro.
La fuente de datos de eventos de facturación se actualiza cada 24 horas, por lo que los nuevos datos están disponibles diariamente.
Los datos de eventos de facturación son inmutables.
En la tabla siguiente se incluyen los nombres y descripciones de las columnas de la fuente de datos.
| Nombre de la columna | Description (Descripción) |
| --- | --- |
| billing\$1event\$1id | Un identificador de un evento de facturación. Este ID es único en el entorno del vendedor. |
| from\$1account\$1id | La cuenta que inició el evento de facturación. Si `transaction_type` es `SELLER_REV_SHARE`, es la cuenta de pagador del comprador. Esta es una clave externa para la fuente de datos de la [cuenta](data-feed-account.md). Se puede usar para unirse a la fuente de datos de `Account` en el campo `account_id`. |
| to\$1account\$1id | La cuenta que recibe el importe de la transacción del producto. Esta es una clave externa para la fuente de datos de la cuenta.Se puede usar para unirse a la fuente de datos de `Account` en el campo `account_id`. |
| end\$1user\$1account\$1id | La cuenta que utiliza el producto. Esta cuenta puede ser diferente de las cuentas de comprador y pagador.Se puede usar para unirse a la fuente de datos `Account` en el campo `account_id`. |
| product\$1id | El identificador del producto. Esta es una clave externa para la fuente de datos del [producto](data-feed-product.md).Se puede usar para unirse a la fuente de datos de `Product` en el campo `product_id`. |
| acción | El tipo de acción de este evento. Los valores posibles son los siguientes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/marketplace/latest/userguide/data-feed-billing-event.html) |
| transaction\$1type | El tipo de transacción. Para ver ejemplos, consulte [Escenarios de impuestos](#data-feeds-billing-event-tax-examples). Los valores posibles son los siguientes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/marketplace/latest/userguide/data-feed-billing-event.html) |
| parent\$1billing\$1event\$1id | Cuando el valor de `broker_id` es `AWS_INC`, el valor de `action` es `DISBURSED` o `FORGIVEN` y el valor de `transaction_type` es `DISBURSEMENT`, el `parent_billing_event_id` se refiere al `billing_event_id` original que inició este evento de facturación. Si `action` tiene otro valor, este campo es nulo. Cuando el valor de `broker_id` es `AWS_EUROPE`, `parent_billing_event_id` se refiere al `billing_event_id` original que inició este evento de facturación en los siguientes escenarios: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/marketplace/latest/userguide/data-feed-billing-event.html) Si el valor de `broker_id` es `AWS_EUROPE`, `parent_billing_event_id` se refiere al `billing_event_id` original del anterior evento de facturación de desembolsos exitoso en el siguiente escenario: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/marketplace/latest/userguide/data-feed-billing-event.html) Si el valor de `broker_id` es `AWS_EUROPE`, este campo es nulo para todos los escenarios restantes. |
| disbursement\$1billing\$1event\$1id | El desembolso relacionado cuando el valor de `action` es `DISBURSED` y se cumple una de las siguientes condiciones: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/marketplace/latest/userguide/data-feed-billing-event.html) En todos los demás escenarios, este valor es nulo. |
| cantidad | El importe del evento de facturación. |
| divisa | El código de moneda ISO 639. |
| disbursement\$1amount | El importe del desembolso. En los escenarios de doble facturación, este campo contiene el importe del desembolso. En los escenarios de facturación unificada, este campo es nulo. |
| disbursement\$1currency | El código de divisa ISO 639 para el importe del desembolso. En los escenarios de doble facturación, este campo contiene el código de divisa del desembolso. En los escenarios de facturación unificada, este campo es nulo. |
| balance\$1impacting | Si el importe se tiene en cuenta al calcular los desembolsos del vendedor. Un valor de 0 indica que el importe se muestra con fines informativos y no tiene ningún efecto sobre el saldo. Un valor de 1 indica que este importe se tiene en cuenta al determinar los desembolsos del vendedor. |
| invoice\$1date | La fecha en que se creó la factura. |
| payment\$1due\$1date | Cuando el valor de `action` es `INVOICED`, la fecha de vencimiento de la factura. |
| usage\$1period\$1start\$1date | La fecha de inicio del periodo del registro. |
| usage\$1period\$1end\$1date | La fecha de finalización del periodo del registro. |
| invoice\$1id | El identificador de AWS la factura. |
| billing\$1address\$1id | La referencia de la dirección de facturación del pagador en la fuente de datos de la dirección.Se puede usar para unirse a la fuente de datos de `Address` en el campo `address_id`. |
| transaction\$1reference\$1id | Un identificador que le permite hacer referencias cruzadas a datos de los siguientes informes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/marketplace/latest/userguide/data-feed-billing-event.html) |
| bank\$1trace\$1id | En el caso de las transacciones de desembolso (`transaction_type` = es `DISBURSEMENT` y la acción es `DISBURSED`), el identificador de seguimiento es asignado por el banco. El identificador de seguimiento se puede utilizar para correlacionarlo con los informes proporcionados por el banco del vendedor. |
| broker\$1id | Un identificador de la entidad comercial que facilitó la transacción. Los valores posibles son los siguientes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/marketplace/latest/userguide/data-feed-billing-event.html) |
| buyer\$1transaction\$1reference\$1id | Un identificador que agrupa todos los registros relacionados de la fuente de facturación mediante `GROUP BY` o la construcción de funciones de ventana en SQL. Estos registros relacionados pueden incluir la factura del comprador, la factura del vendedor y el impuesto sobre el valor añadido (VATs) sobre la tarifa de publicación. |
| acción\$1fecha | La fecha en la que se produjo el evento de la transacción. La fecha específica depende del tipo de acción: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/marketplace/latest/userguide/data-feed-billing-event.html) |
| recipient\$1account\$1id | La cuenta del vendedor que recibe los datos de los ficheros. Se puede usar para unirse a la fuente de datos `Account` en el campo `account_id`. |
| offer\$1id | El identificador descriptivo de la oferta que está asociado a la línea de pedido de la factura del comprador.Se puede usar para unirse a la fuente de datos `Offer` en el campo `offer_id`. |
| fecha\$1factura\$1del comprador | La fecha de la factura del artículo de la factura del comprador asociado. |
| line\$1item\$1id | El identificador de la partida de la factura, según el nivel de detalle del desembolso. |
| buyer\$1line\$1item\$1id | El identificador de la partida de la factura del comprador según el nivel de detalle del desembolso. |
| charge\$1variant | Indica lo que se compra o vende. |
| charge\$1side | Indica si el vendedor compra o vende la variante de pago. |
## Escenarios de impuestos
El modelo fiscal vigente del país y del estado del comprador y el vendedor determina cómo se recaudan y remiten los impuestos. A continuación, se muestran los escenarios posibles:
+ Los impuestos son recaudados y remitidos por AWS. En estos casos, `transaction_type` es `AWS_TAX_SHARE`.
+ Los impuestos los recauda el vendedor AWS, los desembolsa y el vendedor los remite a las autoridades tributarias. En estos casos, `transaction_type` es `SELLER_TAX_SHARE`.
+ Los impuestos no los recauda. AWS El vendedor debe calcular los impuestos y remitirlos a las autoridades fiscales. En estos casos, AWS Marketplace no realiza cálculos de impuestos ni recibe información tributaria. El vendedor paga los impuestos de la parte de ingresos.
## Ejemplos de fuente de datos de eventos de facturación
En esta sección se muestran ejemplos del periodo de datos del evento de facturación en el momento de la facturación y un mes después. Tenga en cuenta lo siguiente para todas las tablas de esta sección:
+ En las fuentes de datos, los valores de `billing_event_id` son cadenas alfanuméricas de 40 caracteres. Se muestran aquí como cadenas de dos caracteres para facilitar la lectura.
+ En la fuente de datos, esta información se presenta en una sola tabla. Para facilitar la lectura, los datos se muestran aquí en varias tablas y no aparecen todas las columnas.
Para los ejemplos de esta sección, suponga lo siguiente:
+ Arnav es el comprador.
+ El ID de su cuenta es `737399998888`.
+ Está ubicado en Francia, que está sujeto a las leyes de facilitadores del mercado. Para obtener más información, consulte [Ayuda fiscal de Amazon Web Service](https://aws.amazon.com/tax-help/).
+ Compró `prod-o4grxfafcxxxx` y se le facturaron 120,60 dólares por el uso mensual de ese producto.
+ Pagó la factura dentro del mes.
+ Jane es la fabricante.
+ El ID de su cuenta es `111122223333`.
+ Paulo es el vendedor de registro.
+ El ID de su cuenta es `777788889999`.
+ Vive en Kansas, que no está sujeta a las leyes de facilitadores del mercado.
### Fuente de datos de eventos de facturación para el vendedor de registro
Como vendedor de registro, Paulo factura al comprador, Arnav.
En las siguientes tablas se muestra la información relevante en la fuente de datos de Paulo cuando factura a Arnav.
| billing\$1event\$1id | from\$1account\$1id | to\$1account\$1id | end\$1user\$1account\$1id | product\$1id | action | transaction\$1type |
| --- | --- | --- | --- | --- | --- | --- |
| I0 | 737399998888 | 777788889999 | 737399998888 | prod-o4grxfafcxxxx | FACTURADO | SELLER\$1REV\$1SHARE |
| I1 | 737399998888 | AWS | 737399998888 | prod-o4grxfafcxxxx | FACTURADO | AWS\$1TAX\$1COMPARTIR |
| I2 | 777788889999 | 111122223333 | 737399998888 | prod-o4grxfafcxxxx | FACTURADO | SELLER\$1REV\$1SHARE |
| I3 | 777788889999 | AWS | 737399998888 | prod-o4grxfafcxxxx | FACTURADO | AWS\$1REV\$1COMPARTIR |
| parent\$1billing\$1event\$1id | disbursement\$1billing\$1event\$1id | amount | divisa | invoice\$1date | invoice\$1id |
| --- | --- | --- | --- | --- | --- |
| | | 100 | USD | 2018-12-31T00:00:00Z | 781216640 |
| | | 20.6 | USD | 2018-12-31T00:00:00Z | 781216640 |
| | | -80 | USD | 2018-12-31T00:04:07Z | 788576665 |
| | | -0.2 | USD | 2018-12-31T00:04:07Z | 788576665 |
En las siguientes tablas se muestra la información relevante en la fuente de datos de Paulo al final del mes, después de que Arnav pague la factura.
| billing\$1event\$1id | from\$1account\$1id | to\$1account\$1id | end\$1user\$1account\$1id | product\$1id | action | transaction\$1type |
| --- | --- | --- | --- | --- | --- | --- |
| I10 | 737399998888 | 777788889999 | 737399998888 | | DESEMBOLSADO | SELLER\$1REV\$1SHARE |
| I12 | 777788889999 | 111122223333 | 737399998888 | | DESEMBOLSADO | SELLER\$1REV\$1SHARE |
| I13 | 777788889999 | AWS | 737399998888 | prod-o4grxfafcxxxx | DESEMBOLSADO | AWS\$1REV\$1COMPARTIR |
| I14 | AWS | 777788889999 | | | DESEMBOLSADO | ABONO |
| parent\$1billing\$1event\$1id | disbursement\$1billing\$1event\$1id | amount | divisa | invoice\$1date | invoice\$1id |
| --- | --- | --- | --- | --- | --- |
| I0 | I14 | -100 | USD | 2018-12-31T00:00:00Z | 781216640 |
| I2 | I14 | 80 | USD | 2018-12-31T00:04:07Z | 788576665 |
| I3 | I14 | 0.2 | USD | 2018-12-31T00:04:07Z | 788576665 |
| | | 19.8 | USD | | |
### Fuente de datos de eventos de facturación para el fabricante
En las siguientes tablas se muestra la información relevante en la fuente de datos de Jane cuando Paulo factura a Arnav.
| billing\$1event\$1id | from\$1account\$1id | to\$1account\$1id | end\$1user\$1account\$1id | product\$1id | action | transaction\$1type |
| --- | --- | --- | --- | --- | --- | --- |
| I5 | 777788889999 | 111122223333 | | prod-o4grxfafcxxxx | FACTURADO | SELLER\$1REV\$1SHARE |
| I6 | 777788889999 | 111122223333 | | prod-o4grxfafcxxxx | FACTURADO | SELLER\$1TAX\$1SHARE |
| I7 | 111122223333 | AWS | | prod-o4grxfafcxxxx | FACTURADO | AWS\$1REV\$1COMPARTIR |
| parent\$1billing\$1event\$1id | disbursement\$1billing\$1event\$1id | amount | divisa | 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 |
En las siguientes tablas se muestra la información relevante en la fuente de datos de Jane al final del mes, después de pagar la factura.
| billing\$1event\$1id | from\$1account\$1id | to\$1account\$1id | end\$1user\$1account\$1id | product\$1id | action | transaction\$1type |
| --- | --- | --- | --- | --- | --- | --- |
| I30 | 777788889999 | 111122223333 | | prod-o4grxfafcxxxx | DESEMBOLSADO | SELLER\$1REV\$1SHARE |
| I31 | 777788889999 | 111122223333 | | prod-o4grxfafcxxxx | DESEMBOLSADO | SELLER\$1TAX\$1SHARE |
| I32 | 111122223333 | AWS | | prod-o4grxfafcxxxx | DESEMBOLSADO | AWS\$1REV\$1COMPARTIR |
| I33 | AWS | 111122223333 | | | DESEMBOLSADO | ABONO |
| parent\$1billing\$1event\$1id | disbursement\$1billing\$1event\$1id | amount | divisa | invoice\$1date | invoice\$1id |
| --- | --- | --- | --- | --- | --- |
| I5 | I33 | -73.5 | USD | | |
| I6 | I33 | -6.5 | USD | | |
| I7 | I33 | 7.35 | USD | | |
| | | 72.65 | USD | | |
## Consultas de ejemplo
Como se describe en [Recopilación y análisis de datos con fuentes de datos](data-feed-using.md), puede utilizar [Athena](https://docs.aws.amazon.com/athena/latest/ug/what-is.html) para ejecutar consultas sobre los datos que se recopilan y almacenan como fuentes de datos en el bucket de Amazon S3 administrado. En esta sección se proporcionan algunos ejemplos de formas comunes de hacerlo. Todos los ejemplos suponen que se utiliza una moneda única.
## Ejemplo 1: Importe facturado, incluidos los impuestos
Para saber cuánto se facturó a los compradores, incluidos los impuestos, puede ejecutar una consulta como la que se muestra en el siguiente ejemplo.
```
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'
);
```
## Ejemplo 2: Importe facturado a los compradores en nombre del vendedor
Para saber cuántos compradores se facturaron en nombre de un vendedor, puede ejecutar una consulta como la que se muestra en el siguiente ejemplo.
```
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'
;
```
## Ejemplo 3: El importe AWS se puede recaudar en nombre del vendedor
Para saber cuánto se AWS puede cobrar en nombre de un vendedor, menos los reembolsos, los créditos y las cuentas condonadas, puedes realizar una consulta como se muestra en el siguiente ejemplo.
```
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')
;
```
## Ejemplo 4: Importe que el vendedor puede recaudar
Para saber cuánto pueden recaudar los vendedores, puede ejecutar una consulta como la que se muestra en el siguiente ejemplo. En este ejemplo, se eliminan las tasas de publicación y los impuestos que se AWS recaudan y se añaden los ajustes de saldo excepcionales.
```
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')
;
```
También puede utilizar la siguiente consulta para recopilar la misma información, como se muestra en el ejemplo siguiente.
```
SELECT sum(amount) FROM billing_event
WHERE
balance_impacting = 1
and action in ('INVOICED','FORGIVEN')
;
```
En el siguiente ejemplo se muestra la misma información, pero está restringida a las transacciones de 2018 y supone que todos los compradores pagaron sus facturas.
```
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')
;
```
## Ejemplo 5: Importe de los desembolsos
Para averiguar la cantidad que se ha desembolsado, puede ejecutar una consulta como la que se muestra en el siguiente ejemplo.
```
select sum(amount) FROM billing_event
WHERE
action ='DISBURSED'
and transaction_type like 'DISBURSEMENT%'
;
```
## Ejemplo 6: Importe pendiente de desembolso
Para averiguar el importe pendiente de desembolso, puede ejecutar una consulta como la que se muestra en el siguiente ejemplo. Esta consulta elimina los importes que ya se han desembolsado.
```
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
)
)
;
```
Otra forma de obtener la misma información es ejecutar una consulta como la que se muestra en el siguiente ejemplo para obtener el saldo del vendedor:
```
SELECT sum(amount) FROM billing_event
WHERE
balance_impacting = 1
;
```
En la siguiente consulta se amplía nuestro ejemplo. Restringe los resultados a las transacciones de 2018 y devuelve más detalles sobre las transacciones.
```
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
);
```
## Ejemplo 7: Saldo del conjunto de facturas
Para conocer la suma de un conjunto de facturas, puede ejecutar una consulta como la que se muestra en el siguiente ejemplo.
```
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;
```