개요
Shopify의 데이터를 전송하는 설정 도움말 페이지입니다.
설정 항목
STEP1 기본 설정
| 품목명 | 필수 | 기본값 | 내용 |
|---|---|---|---|
| Shopify 연결 정보 | 예 | ----------------------------------------------------------------------------------------------. | 미리 등록되어 있는 접속 정보 중 이번 전송 설정에 필요한 권한을 가진 접속 정보를 선택합니다. 등록된 연결 정보가 없는 경우, 연결 정보 추가에서 연결 정보를 생성해 주세요. 접속 정보는 Shopify 관리자 화면에서 커스텀 앱을 생성하고 액세스 토큰을 생성하거나, 비공개 앱(비추천) 을 생성하고 API 키와 비밀번호를 생성해야 합니다. 상품관리, 주문관리, 고객관리 각각에 대한 읽기 접근 권한을 부여해 주시기 바랍니다. |
| 타겟 | 예 | ----------------------------------------------------------------------------------------------. | 아래에서 수집할 데이터 유형을 선택합니다. 주문(order) 고객(customer) 상품(product) 메타필드(metafield) 트랜잭션(transaction) 컬렉션(collection) 메타필드 또는 트랜잭션, 컬렉션을 선택하는 경우 Shopify 연결 정보에서 커스텀 앱을 이용한 연결 정보를 이용해야 합니다. 또한, 메타필드, 트랜잭션 미리보기 화면에서는 더미 데이터를 기반으로 한 결과가 표시됩니다. 구체적으로 취득할 수 있는 항목에 대해서는 아래 reference를 참고하시기 바랍니다. https://shopify.dev/docs/admin-api/rest/reference/ |
| 소유자 유형 | 예 | ----------------------------------------------------------------------------------------------. | 메타 필드만 지정 가능】메타 필드만 지정 가능 메타필드가 연결된 owner의 종류(주문, 고객, 상품)를 선택합니다. |
| 작성일 | No | ----------------------------------------------------------------------------------------------. | 검색 대상 데이터의 생성일에 대해 시작일과 종료일을 선택합니다. 형식은 (%Y-%m-%dT%H:%M:%S%z)입니다. |
| 업데이트 날짜 | No | ----------------------------------------------------------------------------------------------. | 검색 대상 데이터의 업데이트 날짜에 대해 시작일과 종료일을 선택합니다. 형식은 (%Y-%m-%dT%H:%M:%S%z)입니다. |
| 주문 현황 | 예 | ----------------------------------------------------------------------------------------------. | 주문 시에만 지정 가능 주문 상태를 지정합니다. 각 항목에 대한 설명은 여기 status 항목을 참고하세요. |
| 재무현황 | 예 | ----------------------------------------------------------------------------------------------. | 주문 시에만 지정 가능 재무 상태를 지정합니다. 각 항목에 대한 설명은 financial_status 항목을 참고하시기 바랍니다 . |
| 주문처리 현황 | No | ----------------------------------------------------------------------------------------------. | 주문 시에만 지정 가능 주문 처리 상태를 지정합니다. 각 항목에 대한 설명은 fulfillment_status 항목을 참고하세요 . |
| 공개일 | No | ----------------------------------------------------------------------------------------------. | 상품만 지정 가능 검색 대상 데이터의 공개일에 대해 시작일과 종료일을 선택합니다. 형식은 (%Y-%m-%dT%H:%M:%S%z)입니다. |
| 상품 현황 | No | ----------------------------------------------------------------------------------------------. | 상품만 지정 가능 상품 상태를 지정합니다. 각 항목에 대한 설명은 여기 status 항목을 참고하세요. |
| 공개 상태 | No | ----------------------------------------------------------------------------------------------. | 상품만 지정 가능 공개 상태를 지정합니다. 각 항목에 대한 설명은 published_status 항목을 참고하세요 . |
획득 가능한 데이터
메타필드
API 문서 : https://shopify.dev/api/admin-graphql/2024-01/objects/Metafield#fields
스키마
| 컬럼 | 型(형) | 설명 |
|---|---|---|
| id | long | Iadmin_graphql_api_id의 숫자 부분 |
| admin_graphql_api_id | string | ID(GraphQL용) |
| 네임스페이스 | string | 메타필드 그룹화를 위한 네임스페이스 |
| key | string | 각 네임스페이스마다 고유한 메타필드 식별자. |
| value | string | 메타 필드 값 |
| 설명 | string | 비고 |
| owner_type | string | 소유자 유형 메타필드가 연결된 객체의 종류(order / customer / product)에 대한 메타필드가 연결되어 있습니다. |
| 유형 | string | value의 데이터 타입( Metafield types ) |
| legacy_resource_id | long | ID(REST API용) |
| created_at | 타임스탬프 | 작성일시 |
| updated_at | 타임스탬프 | 업데이트 날짜 |
| owner_id | long | admin_graphql_api_owner_id의 숫자 부분 |
| admin_graphql_api_owner_id | string | 메타필드가 연결된 객체의 ID(GraphQL용) |
트랜잭션
API 문서 : https://shopify.dev/api/admin-graphql/2024-01/objects/OrderTransaction
스키마
| 컬럼 | 型(형) | 설명 |
|---|---|---|
| account_number | string | 앞 12자리가 마스킹된 결제 관련 계정 번호 |
| AMOUNT_SET_PRESENTMENT_MONEY_AMOUNT | double | 고객 표시 금액 |
| AMOUNT_SET_PRESENTMENT_MONEY_CURRENCY_CODE | string | 고객 표시 통화 |
| AMOUNT_SET_SHOP_MONEY_AMOUNT | double | 상점 결제 금액 |
| AMOUNT_SET_SHOP_MONEY_CURRENCY_CODE | string | 상점 결제 통화 |
| authorization_code | string | 인증 코드 |
| authorization_expires_at | 타임스탬프 | 인증 유효기간 (Shopify Plus 플랜만 사용 가능) |
| created_at | 타임스탬프 | 작성일시 |
| error_code | string | 오류 코드 |
| 수수료 | json | 수수료 |
| formatted_gateway | string | 결제 게이트웨이 (포맷된 표기) |
| gateway | string | 결제 게이트웨이 |
| id | long | ID(REST API용) |
| admin_api_graphql_id | string | ID(GraphQL용) |
| kind | string | 결제 종류 |
| manually_capturable | boolean | 수동 캡처 가능 여부 |
| MAXIMUM_REFUNDABLE_V2_AMOUNT | double | 환불 가능 금액 |
| MAXIMUM_REFUNDABLE_V2_CURRENCY_CODE | string | 환불 가능한 통화 |
| multi_capturable | boolean | 다중 캡처 가능 여부 |
| order_id | long | 트랜잭션이 연결된 주문 ID(REST API용) |
| admin_api_graphql_order_id | string | 트랜잭션이 연결된 주문 ID(GraphQL용) |
| parent_transaction_id | long | 부모 트랜잭션의 ID(REST API용) |
| admin_api_graphql_parent_transaction_id | string | 부모 트랜잭션의 ID(GraphQL용) |
| payment_icon_alt_text | string | 결제회사 |
| processed_at | 타임스탬프 | 처리일시 |
| 영수증 | json | 영수증 |
| settlement_currency | string | 결제 통화 |
| settlement_currency_rate | double | 결제율 |
| shopify_payment_set_extended_authorization_expires_at | 타임스탬프 | 연장 허가 기간 만료 |
| shopify_payment_set_standard_authorization_expires_at | 타임스탬프 | 오소리 기간 만료 |
| 상태 | string | 결제 현황 |
| test | boolean | 테스트 결제 플래그 |
| TOTAL_UNSETTLED_SET_PRESENTMENT_MONEY_AMOUNT | double | 고객 표시 금액으로 캡처 가능한 금액 |
| TOTAL_UNSETTLED_SET_PRESENTMENT_MONEY_CURRENCY_CODE | string | 고객 표시 통화로 캡처 가능한 통화 |
| TOTAL_UNSETTLED_SET_SHOP_MONEY_AMOUNT | double | 상점 결제 금액으로 캡처 가능한 금액 |
| TOTAL_UNSETTLED_SET_SHO_MONEY_CURRENCY_CODE | string | 상점 결제 통화로 캡처할 수 있는 통화 |
컬렉션
API 문서 : https://shopify.dev/docs/api/admin-graphql/2024-01/queries/collections
스키마
| 컬럼 | 型(형) | 설명 |
|---|---|---|
| 설명 | string | 비고 |
| description_html | string | 비고(HTML) |
| handle | string | 컬렉션마다 고유한 문자열 |
| id | string | ID(GRAPHQL API용) |
| legacy_resource_id | string | ID(REST API용) |
| products_count | long | 컬렉션에 포함된 프로덕션 수 |
| sort_order | string | 컬렉션에 포함된 프로덕션의 순서 |
| template_suffix | string | Liquidtemplate에 사용되는 컬렉션 접미사 접미사 |
| 제목 | string | 컬렉션명 |
| updated_at | 타임스탬프 | 업데이트 날짜 |