DocumentaciónCommerceGuía de Payment Services

Elementos de línea de Payment Services

Last update: Thu Feb 26 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Usuario

Los elementos de línea de Payment Services son los elementos incluidos en un pedido. Estos elementos de línea proporcionan información como:

  • Detalles del producto
  • Cantidad
  • Precio (incluidos impuestos, descuentos y otra información relevante)

Esta información es útil para el servicio al cliente, la gestión de pedidos y la facturación adecuada.

Configurar elementos de línea

Los elementos de línea están habilitados de manera predeterminada para Payment Services. Para configurar:

  1. En la barra lateral Admin, vaya a Stores > Settings>Configuration.

  2. Vaya a Sales y seleccione Payment Methods.

  3. Expanda la sección FEATURED ADOBE PAYMENT SOLUTION.

  4. En la sección Payment Services, expanda la sección​Line Items.

  5. Para Line Items Enabled, seleccione Yes para habilitar (predeterminado) o No para deshabilitar elementos de línea.

  6. Haga clic en Save Config para guardar los cambios.

IMPORTANT
Si tiene extensiones de terceros que agregan tarifas personalizadas (como tarifas de manejo) a sus pedidos, es posible que tenga que deshabilitar los elementos de línea. Payment Services calcula los artículos de línea en función de los componentes de pedido estándar de Commerce (artículos, impuestos, envíos y descuentos). Las tarifas de terceros que no son reconocidas por Payment Services pueden causar una discrepancia entre el total del artículo de línea y el total del pedido, lo que puede impedir que se complete el cierre de compra.

Ver elementos de línea

Para consultar artículos de línea:

  1. Vaya a su panel de comerciantes de PayPal.

  2. Haga clic en Actividad > Todas las transacciones.

  3. Seleccione el pedido deseado y consulte sus artículos de línea:

    Ejemplo de elementos de línea en la vista del panel del comprador

    Vista de elementos de línea {width="500" modal="regular"}

Atributos de artículos de línea

Los artículos de línea se generan cuando el pedido se realiza a través de Adobe Commerce y la información se envía a PayPal, con los atributos siguientes:

Atributo
Tipo de datos
Descripción
name
¡String!
El nombre del elemento. Si un artículo tiene más de una línea debido a varias cantidades o a un problema de redondeo de impuestos, el nombre del artículo sigue siendo el mismo para todas las líneas, pero el precio mostrado puede variar ligeramente debido al redondeo.
unit_amount
Objeto.
El precio o tarifa del artículo por unidad. Incluye los atributos siguientes: currency_code y value.
tax
Objeto
El impuesto de artículo de cada unidad. Incluye los atributos siguientes: currency_code y value.
quantity
¡String!
La cantidad del artículo. Será un número entero.
description
Cadena
La descripción detallada del artículo.
sku
Cadena
La unidad de stock (o SKU) del artículo.
url
Cadena
El URL al artículo que se está comprando. Visible para el comprador y utilizado en las experiencias del comprador.
upc
Objeto
El código de producto universal (o UPC) del artículo.
category
Cadena
El tipo de categoría de artículo.

unit_amount atributos

El objeto unit_amount contiene los atributos siguientes:

Atributo
Tipo de datos
Descripción
currency_code
¡String!
El código de moneda ISO-4217 de tres caracteres que identifica la moneda.
value
¡String!
Indica el valor del elemento. currency_code determina el número de decimales necesario, si lo hay.

tax atributos

El objeto tax contiene los atributos siguientes:

Atributo
Tipo de datos
Descripción
currency_code
¡String!
El código de moneda ISO-4217 de tres caracteres que identifica la moneda.
value
¡String!
Indica el valor del elemento. Depende de cada currency_code para el número requerido de decimales.

upc atributos

El objeto upc contiene los atributos siguientes:

Atributo
Tipo de datos
Descripción
type
¡string!
El tipo UPC.
code
¡string!
El código de producto UPC del artículo.
Ejemplo de elementos de línea
code language-json 
{
    "name": "Crown Summit Backpack - 1",
    "unit_amount": {
        "currency_code": "USD",
        "value": "38.50"
    },
    "tax": {
        "currency_code": "USD"
        "value": "3.13"
    },
    "quantity": "1",
    "description": "The Crown Summit Backpack is equally at home in a gym locker, study cube or a pup tent, so be sure yours is packed with books,",
    "sku": "24-MB03",
    "url": "https://magento.test/crown-summit-backpack.html",
    "upc": {
        "type": "UPC-A",
        "code": "000003"
    },
    "category": "PHYSICAL_GOODS"
},
{
    "name": "Crown Summit Backpack - 2",
    "unit_amount": {
        "currency_code": "USD",
        "value": "38.50"
    },
    "tax": {
        "currency_code": "USD",
        "value": "3.14"
    },
    "quantity": "1",
    "description": "The Crown Summit Backpack is equally at home in a gym locker, study cube or a pup tent, so be sure yours is packed with books,",
    "sku": "24-MB03",
    "url": "https://magento.test/crown-summit-backpack.html",
    "upc": {
        "type": "UPC-A",
        "code": "000003"
    },
    "category": "PHYSICAL_GOODS"
}

Consulta Documentación para desarrolladores de PayPal sobre artículos de línea para obtener más información sobre estos campos y sus limitaciones.

Administrar elementos de línea

Adobe Commerce calcula los impuestos en función del importe total de cada fila, lo que puede causar problemas de redondeo si se solicitan varias cantidades del mismo artículo o si se muestran precios que incluyen impuestos en el catálogo. En estos casos, la cantidad total puede dividirse en dos líneas, pero la cantidad equivale al total de artículos pedidos.

Ejemplo de artículos de línea con problemas de redondeo en la vista del panel de comerciantes

Vista de elementos de línea {width="600" modal="regular"}

Cálculo de Adobe Commerce de un problema de redondeo en elementos de línea

Los elementos de línea de Payment Services equilibran este problema de redondeo de modo que el valor de unit_amount o unit_tax corresponda con el importe total del pedido. Un artículo se puede dividir en dos líneas para resolver este problema de redondeo:

  • Cuando el problema de redondeo aparece en unit_amount, el comerciante debería ver una diferencia en el precio de esta línea adicional.
  • Cuando el problema de redondeo aparece en unit_tax, no se observará ninguna diferencia en los elementos de línea individuales porque tax no se muestra en la cuadrícula, sino únicamente como un total en la parte inferior.
recommendation-more-help
00b8a45a-5862-4817-8e1e-074170ebb953