DocumentazioneCommerceGuida Payment Services

Elementi riga per Payment Services

Last update: Thu May 08 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Utente

Gli elementi riga per Payment Services sono gli elementi inclusi in un ordine. Queste voci forniscono informazioni quali:

  • Dettagli prodotto
  • Quantità
  • Prezzo (comprese tasse, sconti e altre informazioni rilevanti)

Queste informazioni sono utili per il servizio clienti, la gestione degli ordini e la fatturazione corretta.

Questa funzionalità è attivata per impostazione predefinita per Payment Services. Per visualizzare gli elementi riga:

  1. Passa alla dashboard esercente PayPal.

  2. Fai clic su Attività > Tutte le transazioni.

  3. Seleziona l’ordine desiderato e visualizzane gli elementi:

    Esempio di elementi riga nella vista del dashboard acquirente

    Visualizzazione elementi riga {width="500" modal="regular"}

Attributi degli elementi riga

Le voci vengono generate quando l'ordine viene effettuato tramite Adobe Commerce e le informazioni vengono inviate a PayPal, con i seguenti attributi:

Attributo
Tipo di dati
Descrizione
name
Stringa!
Il nome dell'elemento. Se un articolo ha più di una linea a causa di quantità multiple o di un problema di arrotondamento delle imposte, il nome dell'articolo rimane invariato per tutte le linee, ma il prezzo visualizzato può variare leggermente a causa dell'arrotondamento.
unit_amount
Oggetto!
Il prezzo o il tasso unitario dell'articolo. Include i seguenti attributi: currency_code e value.
tax
Oggetto
Imposta sull'articolo per ogni unità. Include i seguenti attributi: currency_code e value.
quantity
Stringa!
Quantità dell'articolo. Sarà un numero intero.
description
Stringa
Descrizione dettagliata dell'articolo.
sku
Stringa
L'unità di gestione delle scorte (o SKU) dell'articolo.
url
Stringa
URL per l'elemento da acquistare. Visibile all'acquirente e utilizzato nelle esperienze dell'acquirente.
upc
Oggetto
Codice universale del prodotto (o UPC) dell’articolo.
category
Stringa
Tipo di categoria dell'articolo.

Attributi unit_amount

L'oggetto unit_amount contiene i seguenti attributi:

Attributo
Tipo di dati
Descrizione
currency_code
Stringa!
Codice valuta ISO-4217 di tre caratteri che identifica la valuta.
value
Stringa!
Indica il valore dell'elemento. currency_code determina il numero richiesto di cifre decimali, se presenti.

Attributi tax

L'oggetto tax contiene i seguenti attributi:

Attributo
Tipo di dati
Descrizione
currency_code
Stringa!
Codice valuta ISO-4217 di tre caratteri che identifica la valuta.
value
Stringa!
Indica il valore dell'elemento. Dipende da ogni currency_code per il numero richiesto di cifre decimali.

Attributi upc

L'oggetto upc contiene i seguenti attributi:

Attributo
Tipo di dati
Descrizione
type
stringa!
Il tipo di UPC.
code
stringa!
Il codice prodotto UPC dell’articolo.
Esempio di elementi Line
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"
}

Per ulteriori informazioni su questi campi e sulle relative limitazioni, consulta la documentazione per gli sviluppatori di PayPal sulle righe.

Gestisci righe

Adobe Commerce calcola l'imposta in base all'importo totale per ogni riga. Ciò può causare problemi di arrotondamento se vengono ordinate più quantità dello stesso articolo o se nel catalogo vengono visualizzati prezzi comprensivi di imposte. In questi casi, la quantità totale può essere divisa in due righe, ma la quantità sarà uguale al totale degli articoli ordinati.

Esempio di elementi riga con problemi di arrotondamento nella vista dashboard esercente

Visualizzazione elementi riga {width="600" modal="regular"}

Come Adobe Commerce calcola un problema di arrotondamento nelle righe

Gli elementi riga per Payment Services bilanciano questo problema di arrotondamento in modo che il valore unit_amount o unit_tax corrisponda all'importo totale per l'ordine. Per risolvere il problema di arrotondamento, un elemento può essere diviso in due righe:

  • Quando il problema di arrotondamento viene visualizzato su unit_amount, l'esercente dovrebbe notare una differenza nel prezzo di questa linea aggiuntiva.
  • Quando il problema di arrotondamento viene visualizzato su unit_tax, non verrà visualizzata alcuna differenza sui singoli elementi di riga perché tax non è visualizzato nella griglia, ma solo come totale nella parte inferiore.
recommendation-more-help
00b8a45a-5862-4817-8e1e-074170ebb953