

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# La mappatura del tipo di oggetto all’ordine standard in Amazon Connect Customer Profiles
<a name="object-type-mapping-standard-order"></a>

Gli argomenti di questa sezione forniscono la definizione standard degli ordini e la mappatura dei tipi di oggetti da applicazioni esterne all'ordine standard.

**Topics**
+ [Requisiti di AppIntegrations accesso ad Amazon](standard-order-appintegrations-requirements.md)
+ [Requisiti di EventBridge accesso ad Amazon](standard-order-eventbridge-requirements.md)
+ [Definizione dell'ordine standard](standard-order-definition.md)
+ [Mappatura degli oggetti Shopify](mapping-shopify-objects-standard-order.html.md)

# Requisiti di AppIntegrations accesso ad Amazon
<a name="standard-order-appintegrations-requirements"></a>

Utilizza i seguenti requisiti di AppIntegrations accesso ad Amazon per creare ed eliminare integrazioni Shopify con i profili cliente Amazon Connect:
+ integrazioni con app: GetEventIntegration
+ integrazioni con app: ListEventIntegrationAssociations
+ integrazioni con app: CreateEventIntegrationAssociation
+ integrazioni con app: DeleteEventIntegrationAssociation

# Requisiti di EventBridge accesso ad Amazon
<a name="standard-order-eventbridge-requirements"></a>

Utilizza i seguenti requisiti di EventBridge accesso ad Amazon per creare ed eliminare integrazioni Shopify con i profili cliente Amazon Connect:
+ `events:ListTargetsByRule`
+ `events:PutRule`
+ `events:PutTargets`
+ `events:DeleteRule`
+ `events:RemoveTargets`

# Campi dell’oggetto dell’ordine standard di Profili dei clienti.
<a name="standard-order-definition"></a>

La tabella seguente elenca tutti i campi dell'oggetto dell'ordine standard in Profili cliente.


| Campo dell’ordine standard | Tipo di dati | Descrizione | 
| --- | --- | --- | 
| OrderId | Stringa | L’identificativo univoco di un ordine standard. | 
| CustomerEmail | Stringa | L’indirizzo e-mail del cliente. | 
| CustomerPhone | Stringa | Il numero di telefono del cliente. | 
| CreatedDate | Stringa | La data di creazione dell’ordine. | 
| UpdatedDate | Stringa | La data di aggiornamento dell’ordine. | 
| ProcessedDate | Stringa | La data di elaborazione dell’ordine. | 
| ClosedDate | Stringa | La data di chiusura dell’ordine. | 
| CancelledDate | Stringa | La data dell’ordine è stata annullata. | 
| CancelReason | Stringa | Motivo dell’annullamento dell’ordine. | 
| Name | Stringa | Il nome dell’ordine. | 
| AdditionalInformation | Stringa | Qualsiasi informazione aggiuntiva pertinente all’ordine. | 
| Gateway | Stringa | Il gateway di pagamento dell’ordine. | 
| Status | Stringa | Lo stato dell’ordine. | 
| StatusCode | Stringa | Il codice di stato dell’ordine. Valori validi: DRAFT \$1 ACTIVATED | 
| StatusUrl | Stringa | L’URL di stato dell’ordine. | 
| CreditCardNumber | Stringa | Le ultime quattro cifre della carta di credito del cliente. | 
| CreditCardCompany | Stringa | La società emittente della carta di credito del cliente. | 
| FulfillmentStatus | Stringa | Lo stato di evasione dell’ordine. | 
| TotalPrice | Stringa | Il prezzo totale dell’ordine. | 
| TotalTax | Stringa | L’imposta totale dell’ordine. | 
| TotalDiscounts | Stringa | Gli sconti totali dell’ordine. | 
| TotalItemsPrice | Stringa | Il prezzo totale degli articoli dell’ordine. | 
| TotalShippingPrice | Stringa | Il prezzo di spedizione totale dell’ordine. | 
| TotalTipReceived | Stringa | La mancia totale dell’ordine ricevuta. | 
| Valuta | Stringa | La valuta dell’ordine. | 
| TotalWeight | Stringa | Il peso totale dell’ordine. | 
| BillingAddress | OrderAddress | L'indirizzo di fatturazione del cliente. | 
| ShippingAddress | OrderAddress | L'indirizzo di spedizione del cliente. | 
| OrderItems | OrderItem elenco | Gli articoli dell’ordine. | 
| Attributes | String-to-string mappa | Coppia di attributi chiave-valore di un caso standard. | 

Gli oggetti dell’ordine standard sono indicizzati in base alle chiavi riportate nella tabella seguente.


| Nome dell’indice standard | Campo dell’ordine standard | 
| --- | --- | 
| \$1orderId | OrderId | 

Ad esempio, puoi utilizzarlo `_orderId` come nome chiave con l'[SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) per trovare un profilo con un ordine che OrderId corrisponda al valore di ricerca. È possibile trovare gli oggetti di ordine standard associati a un profilo specifico utilizzando l'[ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) con `ProfileId` and `ObjectTypeName` set to`_order`.

## OrderAddress tipo di dati
<a name="orderaddress-data-type"></a>


| Campo dell’ordine standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Nome | Stringa | Il nome associato all’indirizzo di un ordine. | 
| Address1 | Stringa | La prima riga dell’indirizzo di un ordine. | 
| Address2 | Stringa | La seconda riga dell’indirizzo di un ordine. | 
| Address3 | Stringa | La terza riga dell’indirizzo di un ordine. | 
| Address4 | Stringa | La quarta riga dell’indirizzo di un ordine. | 
| City | Stringa | La città dell’indirizzo di un ordine. | 
| County | Stringa | La contea dell’indirizzo di un ordine. | 
| Stato | Stringa | Lo stato dell’indirizzo di un ordine. | 
| Province | Stringa | La provincia dell’indirizzo di un ordine. | 
| Paese | Stringa | Il paese dell’indirizzo di un ordine. | 
| PostalCode | Stringa | Il codice postale dell’indirizzo di un ordine. | 

## OrderItem tipo di dati
<a name="orderitem-data-type"></a>


| Campo dell’ordine standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Titolo | Stringa | Il titolo di un articolo dell’ordine. | 
| Prezzo | Stringa | Il prezzo di un articolo dell’ordine. | 
| Quantità | Stringa | La quantità di un articolo dell’ordine. | 

# Mappatura degli oggetti Shopify sull’ordine standard in Amazon Connect Customer Profiles
<a name="mapping-shopify-objects-standard-order.html"></a>

Questo argomento elenca i campi degli oggetti Shopify mappati ai campi dell'oggetto dell'ordine standard in Profili cliente.

## Oggetto Shopify DraftOrder
<a name="shopify-draftorder-object.html"></a>

Per un elenco di tutti i campi di un oggetto Shopify, consulta [L'DraftOrder DraftOrder oggetto](https://shopify.dev/api/admin-rest/2021-10/resources/draftorder#resource_object) nella documentazione di Shopify.

## Mappatura di un oggetto Shopify- a un ordine standard DraftOrder
<a name="shopify-draftorder-object-standardorder.html"></a>

Un sottoinsieme dei campi dell'oggetto Shopify viene mappato all'DraftOrder oggetto dell'ordine standard nei profili dei clienti.

La tabella seguente elenca quali campi possono essere mappati dall'oggetto Shopify all'ordine standard. DraftOrder 

 `StatusCode` è `ACTIVATED` se `order_status_url` esiste nell'origine. In caso contrario `StatusCode` è `DRAFT`.


|  Shopify- campo source DraftOrder  |  Campo di destinazione dell’ordine standard  | 
| --- | --- | 
| id | Attributi. ShopifyOrderId | 
| customer.id | Attributi. ShopifyCustomerId | 
| note | AdditionalInformation | 
| e-mail | CustomerEmail | 
| currency | Valuta | 
| created\$1at | CreatedDate | 
| updated\$1at | UpdatedDate | 
| nome | Name | 
| status | Status | 
| order\$1status\$1url | StatusCode | 
| billing\$1address.address1 | BillingAddress.Indirizzo 1 | 
| billing\$1address.address2 | BillingAddress.Indirizzo 2 | 
| billing\$1address.city | BillingAddress.Città | 
| billing\$1address.zip | BillingAddress.PostalCode | 
| billing\$1address.province | BillingAddress.Provincia | 
| billing\$1address.country | BillingAddress.Paese | 
| billing\$1address.name | BillingAddress.Nome | 
| shipping\$1address.address1 | ShippingAddress.Indirizzo 1 | 
| shipping\$1address.address2 | ShippingAddress.Indirizzo 2 | 
| shipping\$1address.city | ShippingAddress.Città | 
| shipping\$1address.zip | ShippingAddress.PostalCode | 
| shipping\$1address.province | ShippingAddress.Provincia | 
| shipping\$1address.country | ShippingAddress.Paese | 
| shipping\$1address.name | ShippingAddress.Nome | 
| invoice\$1url | StatusUrl | 
| total\$1price | TotalPrice | 
| total\$1tax | TotalTax | 
| line\$1items[].title | OrderItems[] .Titolo | 
| line\$1items[].price | OrderItems[] .Prezzo | 
| line\$1items[].quantity | OrderItems[] .Quantità | 

### Esempio
<a name="example-shopify-draftorder-object-standardorder.html"></a>

L'esempio seguente mostra come mappare un campo origine a un campo di destinazione.

```
"shopifyOrderId": {
    "Source": "_source.detail.event.detail.payload.id",
    "Target": "_order.Attributes.ShopifyOrderId"
}
```

I dati dei DraftOrder clienti Shopify dell'oggetto Shopify sono associati a un ordine standard Amazon Connect utilizzando il seguente indice.


| Nome dell'indice standard  | Shopify- campo source DraftOrder  | 
| --- | --- | 
| \$1shopifyOrderId | id | 

Ad esempio, puoi utilizzare `_shopifyOrderId` come strumento `ObjectFilter.KeyName` l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API per trovare un ordine standard. Puoi trovare gli DraftOrder oggetti Shopify- associati a un profilo specifico utilizzando l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con `ProfileId` and `ObjectTypeName` set to. `Shopify-DraftOrder`

## Oggetto Shopify-Order
<a name="shopify-order-object.html"></a>

Per un elenco di tutti i campi di un oggetto Shopify-Order, consulta [L'oggetto Ordine](https://shopify.dev/api/admin-rest/2021-10/resources/order#resource_object) nella documentazione di Shopify.

## Mappatura di un oggetto Shopify-Order su un ordine standard
<a name="mapping-shopify-order-object-standarorder.html"></a>

Un sottoinsieme dei campi dell'oggetto Shopify-Order viene mappato all'oggetto dell'ordine standard nei profili dei clienti.

La tabella seguente elenca quali campi possono essere mappati dall'oggetto Shopify-Order all'ordine standard.

`StatusCode` è `ACTIVATED` se `order_status_url` esiste nell'origine. In caso contrario `StatusCode` è `DRAFT`.


| Campo origine Shopify-Order | Campo di destinazione dell’ordine standard | 
| --- | --- | 
| id | Attributi. ShopifyOrderId | 
| customer.id | Attributi. ShopifyCustomerId | 
| cancelled\$1at | CancelledDate | 
| cancel\$1reason | CancelReason | 
| closed\$1at | ClosedDate | 
| created\$1at | CreatedDate | 
| currency | Valuta | 
| e-mail | CustomerEmail | 
| financial\$1status | Status | 
| order\$1status\$1url | StatusCode | 
| fulfillment\$1status | FulfillmentStatus | 
| gateway | Gateway | 
| nome | Name | 
| note | AdditionalInformation | 
| order\$1status\$1url | StatusUrl | 
| telefono | CustomerPhone | 
| processed\$1at | ProcessedDate | 
| total\$1discounts | TotalDiscounts | 
| total\$1line\$1items\$1price | TotalItemsPrice | 
| total\$1price | TotalPrice | 
| total\$1shipping\$1price\$1set.shop\$1money.amount | TotalShippingPrice | 
| total\$1tax | TotalTax | 
| total\$1tip\$1received | TotalTipReceived | 
| total\$1weight | TotalWeight | 
| updated\$1at | UpdatedDate | 
| billing\$1address.address1 | BillingAddress.Indirizzo 1 | 
| billing\$1address.address2 | BillingAddress.Indirizzo 2 | 
| billing\$1address.city | BillingAddress.Città | 
| billing\$1address.zip | BillingAddress.PostalCode | 
| billing\$1address.province | BillingAddress.Provincia | 
| billing\$1address.country | BillingAddress.Paese | 
| billing\$1address.name | BillingAddress.Nome | 
| payment\$1details.credit\$1card\$1number | CreditCardNumber | 
| payment\$1details.credit\$1card\$1company | CreditCardCompany | 
| shipping\$1address.address1 | ShippingAddress.Indirizzo 1 | 
| shipping\$1address.address2 | ShippingAddress.Indirizzo 2 | 
| shipping\$1address.city | ShippingAddress.Città | 
| shipping\$1address.zip | ShippingAddress.PostalCode | 
| shipping\$1address.province | ShippingAddress.Provincia | 
| shipping\$1address.country | ShippingAddress.Paese | 
| shipping\$1address.name | ShippingAddress.Nome | 
| line\$1items[].title | OrderItems[] .Titolo | 
| line\$1items[].price | OrderItems[] .Prezzo | 
| line\$1items[].quantity | OrderItems[] .Quantità | 

### Esempio
<a name="example-shopify-draftorder-object-standardorder.html"></a>

L'esempio seguente mostra come mappare un campo origine a un campo di destinazione.

```
"shopifyOrderId": {
    "Source": "_source.detail.event.detail.payload.id",
    "Target": "_order.Attributes.ShopifyOrderId"
}
```

I dati dei clienti Shopify-Order dall'oggetto Shopify sono associati a un ordine standard Amazon Connect utilizzando il seguente indice.


| Nome dell'indice standard | Campo origine Shopify-Order | 
| --- | --- | 
| \$1shopifyOrderId | id | 

Ad esempio, puoi utilizzare l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API in modalità `ObjectFilter.KeyName` «`_shopifyOrderId`as and» per trovare un ordine standard. Puoi trovare gli oggetti Shopify-Order associati a un profilo specifico utilizzando l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con and set to. `ProfileId` `ObjectTypeName` `Shopify-Order`