Propiedades del JSON de los datos de factura

Comply puede guardar automáticamente los datos de las facturas como metaobjetos dentro de Shopify. Esto permite integraciones posteriores con automatizaciones o apps externas utilizando el webhook metaobjects/create.

Consulta cómo configurar los metaobjetos de facturas en este artículo (solo para Shopify Plus).

Objeto principal: Invoice

Propiedad	Tipo	Descripción
`invoiceNumber`	String	Número único de la factura. Formato: año-locationId-caja-tipo-secuencia
`issuedAt`	String (ISO 8601)	Fecha y hora de emisión con zona horaria
`invoiceType`	String	Tipo de factura: `F1` (completa), `F2` (simplificada), `R4` (rectificativa otros), `R5` (rectificativa simplificada)
`seriesId`	String	Identificador de la serie de facturación
`lineItems`	Array<LineItem> / Null	Líneas de productos. Presente en facturas y devoluciones, null en exchanges
`lineItemsAdded`	Array<LineItem> / Null	Artículos añadidos. Solo presente en exchanges, null en otros casos
`lineItemsRemoved`	Array<LineItem> / Null	Artículos eliminados. Solo presente en exchanges, null en otros casos
`paymentMethods`	Array<PaymentMethod>	Métodos de pago utilizados
`taxBreakdown`	Array<TaxBreakdown>	Desglose de impuestos por tasa
`grandTotalAmount`	Number	Importe total de la factura. Negativo en devoluciones
`currency`	String	Moneda de la factura
`shopifyOrderId`	Number	ID del pedido en Shopify
`rectifiedInvoice`	RectifiedInvoice / Null	Datos de la factura rectificada. Presente solo en facturas rectificativas
`shopifyReturnId`	Number / Null	ID de la devolución en Shopify. Presente en devoluciones y exchanges
`shopifyExchangeId`	Number / Null	ID del exchange en Shopify. Presente solo en exchanges

Objeto: LineItem

Propiedad	Tipo	Descripción
`uuid`	String (UUID)	Identificador único del artículo de línea. En ventas, Shopify notifica el UUID del carrito. En devoluciones y cambios, el line item ID
`quantity`	Number	Cantidad de unidades del producto
`title`	String	Nombre o descripción del producto
`price`	Number	Precio unitario del producto
`taxable`	Boolean	Indica si el producto está sujeto a impuestos
`taxLines`	Array<TaxLine>	Líneas de impuestos aplicados al producto
`variantId`	Number	ID de la variante del producto en Shopify
`isGiftCard`	Boolean	Indica si el producto es una tarjeta regalo
`discountAllocations`	Array<DiscountAllocation>	Asignaciones de descuentos distribuidos
`properties`	Object	Propiedades personalizadas del producto
`attributeUserId`	String / Null	ID del usuario atribuido. Null si no aplica
`productId`	Number	ID del producto en Shopify
`requiresSellingPlan`	Boolean	Indica si requiere plan de venta o suscripción
`hasSellingPlanGroups`	Boolean	Indica si tiene grupos de planes de venta
`components`	Array	Componentes del producto en caso de bundles

Objeto: TaxLine

Propiedad	Tipo	Descripción
`price`	Price	Objeto con el importe y moneda del impuesto
`title`	String	Nombre del impuesto (por ejemplo: "ES IVA")
`uuid`	String (UUID)	Identificador único de la línea de impuesto
`rate`	Number	Tasa del impuesto en formato decimal (por ejemplo: 0.1 = 10%)
`enabled`	Boolean	Indica si el impuesto está habilitado

Objeto: Price

Propiedad	Tipo	Descripción
`amount`	Number	Importe del precio o impuesto
`currency`	String	Moneda (por ejemplo: "EUR")

Objeto: DiscountAllocation

Propiedad	Tipo	Descripción
`allocatedAmount`	AllocatedAmount	Importe asignado del descuento

Objeto: AllocatedAmount

Propiedad	Tipo	Descripción
`amount`	String	Importe del descuento asignado
`currencyCode`	String	Código de moneda del descuento

Objeto: PaymentMethod

Propiedad	Tipo	Descripción
`type`	String	Tipo de método de pago (por ejemplo: "Cash")
`amount`	Number	Importe pagado con este método. Puede ser negativo en devoluciones
`currency`	String	Moneda del pago

Objeto: TaxBreakdown

Propiedad	Tipo	Descripción
`taxRate`	Number	Tasa del impuesto en formato decimal
`taxAmountCharged`	Number	Importe total de impuesto cobrado
`taxableBaseAmount`	Number	Base imponible para este impuesto

Notas importantes

En facturas normales: lineItems contiene los productos. lineItemsAdded y lineItemsRemoved son null.
En devoluciones: shopifyReturnId está presente. lineItems contiene los productos devueltos.
En exchanges: shopifyReturnId y shopifyExchangeId están presentes. lineItems es null, lineItemsAdded contiene los productos nuevos y lineItemsRemoved los devueltos.
Las facturas rectificativas incluyen el objeto rectifiedInvoice con los datos de la factura original.