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 SQLconsultas de ejemplo 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.

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:

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:

Para los ejemplos de esta sección, suponga lo siguiente:

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.

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.

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.

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.

Consultas de ejemplo

Como se describe en Recopilación y análisis de datos con fuentes de datos, puede utilizar Athena 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;