기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon Connect Customer Profiles의 표준 주문에 객체 유형 매핑
<a name="object-type-mapping-standard-order"></a>

이 섹션의 주제에서는 표준 주문 정의와 외부 애플리케이션에서 표준 주문으로의 객체 유형 매핑을 제공합니다.

**Topics**
+ [Amazon AppIntegrations 액세스 요구 사항](standard-order-appintegrations-requirements.md)
+ [Amazon EventBridge 액세스 요구 사항](standard-order-eventbridge-requirements.md)
+ [표준 주문 정의](standard-order-definition.md)
+ [Shopify 객체 매핑](mapping-shopify-objects-standard-order.html.md)

# Amazon AppIntegrations 액세스 요구 사항
<a name="standard-order-appintegrations-requirements"></a>

Amazon Connect Customer Profiles의 Shopify 통합을 생성하고 삭제하기 위해 다음의 Amazon AppIntegrations 액세스 요구 사항을 사용합니다.
+ app-integrations:GetEventIntegration
+ app-integrations:ListEventIntegrationAssociations
+ app-integrations:CreateEventIntegrationAssociation
+ app-integrations:DeleteEventIntegrationAssociation

# Amazon EventBridge 액세스 요구 사항
<a name="standard-order-eventbridge-requirements"></a>

Amazon Connect Customer Profiles의 Shopify 통합을 생성하고 삭제하기 위해 다음의 Amazon EventBridge 액세스 요구 사항을 사용합니다.
+ `events:ListTargetsByRule`
+ `events:PutRule`
+ `events:PutTargets`
+ `events:DeleteRule`
+ `events:RemoveTargets`

# Customer Profiles 표준 주문 객체 필드
<a name="standard-order-definition"></a>

다음 표에는 Customer Profiles 표준 주문 객체의 모든 필드가 나열되어 있습니다.


| 표준 주문 필드 | 데이터 유형 | 설명 | 
| --- | --- | --- | 
| OrderId | 문자열 | 표준 주문의 고유 식별자입니다. | 
| CustomerEmail | 문자열 | 고객의 이메일 주소입니다. | 
| CustomerPhone | 문자열 | 고객의 전화번호. | 
| CreatedDate | 문자열 | 주문 생성 날짜입니다. | 
| UpdatedDate | 문자열 | 주문 날짜가 업데이트되었습니다. | 
| ProcessedDate | 문자열 | 주문이 처리된 날짜입니다. | 
| ClosedDate | 문자열 | 주문 마감 날짜입니다. | 
| CancelledDate | 문자열 | 주문 날짜가 취소되었습니다. | 
| CancelReason | 문자열 | 주문의 취소 이유입니다. | 
| 이름 | 문자열 | 주문 이름입니다. | 
| AdditionalInformation | 문자열 | 주문과 관련된 모든 추가 정보입니다. | 
| Gateway | 문자열 | 주문의 결제 게이트웨이입니다. | 
| Status | 문자열 | 주문의 상태입니다. | 
| StatusCode | 문자열 | 주문의 상태 코드입니다. 유효한 값: 초안 \$1 활성화됨 | 
| StatusUrl | 문자열 | 주문의 상태 URL입니다. | 
| CreditCardNumber | 문자열 | 고객의 신용 카드 마지막 4자리입니다. | 
| CreditCardCompany | 문자열 | 고객의 신용 카드 회사입니다. | 
| FulfillmentStatus | 문자열 | 주문의 이행 상태입니다. | 
| TotalPrice | 문자열 | 주문의 총 가격입니다. | 
| TotalTax | 문자열 | 주문의 총 세금입니다. | 
| TotalDiscounts | 문자열 | 주문의 총 할인입니다. | 
| TotalItemsPrice | 문자열 | 주문의 총 항목 가격입니다. | 
| TotalShippingPrice | 문자열 | 주문의 총 배송 가격입니다. | 
| TotalTipReceived | 문자열 | 주문의 총 수신 팁입니다. | 
| 통화 | 문자열 | 주문의 통화입니다. | 
| TotalWeight | 문자열 | 주문의 총 무게입니다. | 
| BillingAddress | OrderAddress | 고객의 청구서 수신 주소입니다. | 
| ShippingAddress | OrderAddress | 고객의 배송 주소입니다. | 
| OrderItems | OrderItem 목록 | 주문한 항목입니다. | 
| 속성 | 문자열 간 맵 | 표준 사례의 키-값 속성 쌍입니다. | 

표준 주문 객체는 다음 표의 키로 인덱싱됩니다.


| 표준 인덱스 이름 | 표준 주문 필드 | 
| --- | --- | 
| \$1orderId | OrderId | 

예를 들어, [SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)에서 키 이름으로 `_orderId`를 사용하여 OrderID가 검색 값과 일치하는 주문이 있는 프로필을 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `_order`로 설정된 [ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)를 사용하여 특정 프로필과 연결된 표준 주문 객체를 찾을 수 있습니다.

## OrderAddress 데이터 유형
<a name="orderaddress-data-type"></a>


| 표준 주문 필드 | 데이터 유형 | 설명 | 
| --- | --- | --- | 
| 이름 | 문자열 | 주문 주소와 연결된 이름입니다. | 
| Address1 | 문자열 | 주문 주소의 첫 번째 줄입니다. | 
| Address2 | 문자열 | 주문 주소의 두 번째 줄입니다. | 
| Address3 | 문자열 | 주문 주소의 세 번째 줄입니다. | 
| Address4 | 문자열 | 주문 주소의 네 번째 줄입니다. | 
| City | 문자열 | 주문 주소의 도시입니다. | 
| County | 문자열 | 주문 주소의 주입니다. | 
| State | 문자열 | 주문 주소의 상태입니다. | 
| Province | 문자열 | 주문 주소의 도입니다. | 
| 국가 | 문자열 | 주문 주소의 국가입니다. | 
| PostalCode | 문자열 | 주문 주소의 우편 번호입니다. | 

## OrderItem 데이터 유형
<a name="orderitem-data-type"></a>


| 표준 주문 필드 | 데이터 유형 | 설명 | 
| --- | --- | --- | 
| 제목 | 문자열 | 주문 항목의 제목입니다. | 
| 가격 | 문자열 | 주문 항목의 가격입니다. | 
| 수량 | 문자열 | 주문 항목의 수량입니다. | 

# Amazon Connect Customer Profiles의 표준 주문에 Shopify 객체 매핑
<a name="mapping-shopify-objects-standard-order.html"></a>

이 주제에는 Shopify 객체에서 Customer Profiles 표준 주문 객체의 필드에 매핑되는 필드의 목록이 나열되어 있습니다.

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

Shopify-DraftOrder 객체의 모든 필드 목록은 Shopify 설명서의 [DraftOrder 객체](https://shopify.dev/api/admin-rest/2021-10/resources/draftorder#resource_object)를 참조하세요.

## Shopify-DraftOrder 객체를 표준 주문에 매핑
<a name="shopify-draftorder-object-standardorder.html"></a>

Shopify-DraftOrder 객체에서 Customer Profiles의 표준 주문 객체에 매핑되는 필드의 하위 목록입니다.

다음 표에는 Shopify-DraftOrder 객체에서 표준 주문으로 매핑될 수 있는 필드가 나열되어 있습니다.

 소스에 `order_status_url`이 있는 경우 `StatusCode`는 `ACTIVATED`입니다. 그렇지 않으면 `StatusCode`는 `DRAFT`입니다.


|  Shopify-DraftOrder source field  |  표준 주문 대상 필드  | 
| --- | --- | 
| id | Attributes.ShopifyOrderId | 
| customer.id | Attributes.ShopifyCustomerId | 
| note | AdditionalInformation | 
| 이메일 | CustomerEmail | 
| currency | Currency | 
| created\$1at | CreatedDate | 
| updated\$1at | UpdatedDate | 
| 이름 | 이름 | 
| status | Status | 
| order\$1status\$1url | StatusCode | 
| billing\$1address.address1 | BillingAddress.Address1 | 
| billing\$1address.address2 | BillingAddress.Address2 | 
| billing\$1address.city | BillingAddress.City | 
| billing\$1address.zip | BillingAddress.PostalCode | 
| billing\$1address.province | BillingAddress.Province | 
| billing\$1address.country | BillingAddress.Country | 
| billing\$1address.name | BillingAddress.Name | 
| shipping\$1address.address1 | ShippingAddress.Address1 | 
| shipping\$1address.address2 | ShippingAddress.Address2 | 
| shipping\$1address.city | ShippingAddress.City | 
| shipping\$1address.zip | ShippingAddress.PostalCode | 
| shipping\$1address.province | ShippingAddress.Province | 
| shipping\$1address.country | ShippingAddress.Country | 
| shipping\$1address.name | ShippingAddress.Name | 
| invoice\$1url | StatusUrl | 
| total\$1price | TotalPrice | 
| total\$1tax | TotalTax | 
| line\$1items[].title | OrderItems[].Title | 
| line\$1items[].price | OrderItems[].Price | 
| line\$1items[].quantity | OrderItems[].Quantity | 

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

다음 예시는 소스 필드와 대상 필드를 매핑하는 방법을 보여 줍니다.

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

Shopify 객체의 Shopify-DraftOrder 고객 데이터는 다음 인덱스를 사용하여 Amazon Connect 표준 주문과 연결됩니다.


| 표준 인덱스 이름  | Shopify-DraftOrder source field  | 
| --- | --- | 
| \$1shopifyOrderId | id | 

예를 들어 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API에서 `ObjectFilter.KeyName`으로 `_shopifyOrderId`를 사용하여 표준 주문을 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `Shopify-DraftOrder`로 설정된 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API를 사용하여 특정 프로필과 연결된 Shopify-DraftOrder 객체를 찾을 수 있습니다.

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

Shopify-Order 객체의 모든 필드 목록은 Shopify 설명서의 [Order 객체](https://shopify.dev/api/admin-rest/2021-10/resources/order#resource_object)를 참조하세요.

## Shopify-Order 객체를 표준 주문에 매핑
<a name="mapping-shopify-order-object-standarorder.html"></a>

Shopify-Order 객체에서 Customer Profiles의 표준 주문 객체에 매핑되는 필드의 하위 목록입니다.

다음 표에는 Shopify-Order 객체에서 표준 주문으로 매핑될 수 있는 필드가 나열되어 있습니다.

소스에 `order_status_url`이 있는 경우 `StatusCode`는 `ACTIVATED`입니다. 그렇지 않으면 `StatusCode`는 `DRAFT`입니다.


| Shopify-Order source field | 표준 주문 대상 필드 | 
| --- | --- | 
| id | Attributes.ShopifyOrderId | 
| customer.id | Attributes.ShopifyCustomerId | 
| Cancel\$1at | CancelledDate | 
| cancel\$1reason | CancelReason | 
| closed\$1at | ClosedDate | 
| created\$1at | CreatedDate | 
| currency | Currency | 
| 이메일 | CustomerEmail | 
| financial\$1status | Status | 
| order\$1status\$1url | StatusCode | 
| fulfillment\$1status | FulfillmentStatus | 
| 게이트웨이 | Gateway | 
| 이름 | 이름 | 
| note | AdditionalInformation | 
| order\$1status\$1url | StatusUrl | 
| phone | CustomerPhone | 
| 에서 처리됨 | 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.Address1 | 
| billing\$1address.address2 | BillingAddress.Address2 | 
| billing\$1address.city | BillingAddress.City | 
| billing\$1address.zip | BillingAddress.PostalCode | 
| billing\$1address.province | BillingAddress.Province | 
| billing\$1address.country | BillingAddress.Country | 
| billing\$1address.name | BillingAddress.Name | 
| payment\$1details.credit\$1card\$1number | CreditCardNumber | 
| payment\$1details.credit\$1card\$1company | CreditCardCompany | 
| shipping\$1address.address1 | ShippingAddress.Address1 | 
| shipping\$1address.address2 | ShippingAddress.Address2 | 
| shipping\$1address.city | ShippingAddress.City | 
| shipping\$1address.zip | ShippingAddress.PostalCode | 
| shipping\$1address.province | ShippingAddress.Province | 
| shipping\$1address.country | ShippingAddress.Country | 
| shipping\$1address.name | ShippingAddress.Name | 
| line\$1items[].title | OrderItems[].Title | 
| line\$1items[].price | OrderItems[].Price | 
| line\$1items[].quantity | OrderItems[].Quantity | 

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

다음 예시는 소스 필드와 대상 필드를 매핑하는 방법을 보여 줍니다.

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

Shopify 객체의 Shopify-Order 고객 데이터는 다음 인덱스를 사용하여 Amazon Connect 표준 주문과 연결됩니다.


| 표준 인덱스 이름 | Shopify-Order source field | 
| --- | --- | 
| \$1shopifyOrderId | id | 

예를 들어 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API에서 `ObjectFilter.KeyName`으로 `_shopifyOrderId`를 사용하여 표준 주문을 찾을 수 있습니다. `ProfileId` 및 `ObjectTypeName`이 `Shopify-Order`로 설정된 [ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) API를 사용하여 특정 프로필과 연결된 Shopify-Order 객체를 찾을 수 있습니다.