Campo

Tipo

Descripción

Ejemplo

event_type

string

Tipo de evento

"invoice-finalize"

date

number (timestamp)

Marca de tiempo de cuándo se activó el evento

1762246989

data

Object

Detalles sobre el evento y la factura (ver a continuación).

-

data.date

"2025-11-04T09:03:11.653072Z"

data.object.id

string (uuid)

Identificador único de la factura

"923e2c97-8228-4d42-8a44-1783c70c50a1"

data.object.object

string

Tipo de objeto (siempre invoice).

"invoice"

data.object.status

string

Estado de la factura (open, paid, refunded, voided).

"open"

data.object.date_created

string (date-time)

Cuándo se creó la factura (UTC).

"2025-11-04T09:03:06.515219Z"

data.object.date_created

string (date-time)

Cuándo se creó la factura (UTC).

"2025-11-04T09:03:06.515219Z"

data.object.date_issued

string (date-time)

Cuándo se emitió la factura (UTC).

"2025-11-04T09:03:08.225042Z"

data.object.date_due

string (date-time)

Fecha de vencimiento del pago (UTC).

"2025-11-04T09:03:07.292000Z"

data.object.date_cancelled

string (date-time) | null

Cuándo se canceló la factura (si corresponde).

null

data.object.currency

string

Divisa de la factura (código ISO 4217).

"eur"

data.object.total

number (cents)

Importe total de la factura en la unidad más pequeña (p. ej., céntimos).

36665

data.object.amount_due

number (cents)

Importe pendiente en la unidad más pequeña (p. ej., céntimos).

36665

data.object.amount_paid

number (cents)

Importe ya pagado en la unidad más pequeña (p. ej., céntimos).

0

data.object.company

object

Empresa que emite la factura.

{ ... }

data.object.company.id

number

ID único de la empresa. Para conocer el ID de tu empresa, visita esta página del backoffice.

85329

data.object.company.name

string

Nombre de la empresa.

"SaudeViva Portugal"

data.object.company.country

string

Código de país.

"PT"

data.object.company.city

string

Ciudad.

"Lisbon"

data.object.company.address

string

Dirección.

"Rua do Ouro 115"

data.object.company.postal_code

string

Código postal.

"1100-062"

data.object.customer

object | null

Cliente al que se factura (puede ser null para facturas de punto de venta anónimas).

{ ... }

data.object.customer.id

number

ID único del cliente o miembro.

7644312

data.object.customer.type

string

Tipo de cliente (siempre individual aquí).

"individual"

data.object.customer.name

string

Nombre completo.

"Maria Oliveira"

data.object.customer.first_name

string

Nombre.

"Maria"

data.object.customer.last_name

string

Apellido.

"Oliveira"

data.object.customer.email

string

Correo de contacto.

"maria.oliveira77@example.com"

data.object.customer.phone

string

Número de teléfono.

"+351 912 345 678"

data.object.customer.official_document_id

string

Documento de identidad oficial o nacional (puede ser NIF o identificación fiscal).

"PT-19847765"

data.object.customer.address

object

Dirección del cliente.

{ ... }

data.object.customer.address.line1

string

Dirección postal.

"Avenida da Liberdade 202"

data.object.customer.address.line2

string (optional)

Información adicional de la dirección.

"4º Esq."

data.object.customer.address.city

string

Ciudad.

"Lisbon"

data.object.customer.address.postal_code

string

Código postal.

"1250-147"

data.object.customer.address.state

string

Provincia o región.

"Lisboa"

data.object.customer.address.country

string

Código de país.

"PT"

data.object.line_items

object

Contenedor de líneas de factura.

{ ... }

data.object.line_items.line_count

number

Número de líneas de factura.

6

data.object.line_items.data

array<object>

Array de líneas de factura.

[{ ... }, { ... }]

data.object.line_items.data[].id

number

Identificador único de la línea de factura.

2153

data.object.line_items.data[].description

string

Nombre o etiqueta del producto o servicio.

"£100 General Gift Voucher"

data.object.line_items.data[].quantity

number

Número de unidades compradas.

1

data.object.line_items.data[].tax_included_unit_amount

number (cents)

Precio unitario con impuestos incluidos, en céntimos.

10000

data.object.line_items.data[].tax_included_amount

number (cents)

Precio total con impuestos incluidos antes del descuento (quantity * unit_amount).

10000

data.object.line_items.data[].voucher_applied

number (cents)

Descuento o vale aplicado a esta línea, en céntimos.

0

data.object.line_items.data[].line_total

number (cents)

Importe final de la línea tras el descuento, en céntimos.

10000

data.object.line_items.data[].tax_breakdown

object

Detalles del cálculo de impuestos.

{ ... }

data.object.line_items.data[].tax_breakdown.rate

number (%)

Porcentaje del tipo impositivo (p. ej., 20 = 20%).

0

data.object.line_items.data[].tax_breakdown.total_tax

number (cents)

Total de impuestos incluidos en esta línea, en céntimos.

0

data.object.line_items.data[].tax_breakdown.unit_tax

number (cents)

Impuesto incluido por unidad, en céntimos.

0

data.object.line_items.data[].item_type

string

Tipo de artículo de bsport (shop-product, pass, private_pass, consumer_giftcard, refund).

"consumer_giftcard"

data.object.invoice_pdf

string (url)

Enlace al PDF de la factura.

"https://assets.staging.bsport.io/.../invoice-24092226.pdf"

data.object.receipt_pdf

string (url) | null

Enlace al PDF del recibo de pago (si corresponde).

null

data.object.invoice_type

number

Tipo de factura: 0=normal, 1=inversa, 2=nota de crédito, 3=migración.

0

data.object.source_invoice_id

string (uuid) | null

UUID de la factura original cancelada a través de esta (si corresponde).

null