위치:
B2C Commerce의 주문 오브젝트 가져오기 및 내보내기
외부 시스템과 통합하고 테스트 데이터와 작동하는 데 사용하기 위해 B2C Commerce에서 주문 데이터를 XML로 내보내고 가져올 수 있습니다.
주문 가져오기
Business Manager에서 주문을 가져오려면 를 클릭합니다. 비-Production 인스턴스에 있거나 Production 인스턴스에서 라이브가 아닌 사이트로 주문을 가져올 수 있습니다. 존재하지 않는 주문을 Production 인스턴스의 라이브 사이트로 가져오려면 Salesforce 지원 센터에 문의하십시오.
주문 XML 데이터 형식의 세부 정보는 order.xsd 스키마 파일을 참조하십시오.
등록되지 않은 고객의 주문을 가져오면 경우에 따라 고객 번호가 중복될 수 있습니다. 이 문제를 방지하기 위해 주문 XML의 Customer 요소에 부울 guest 요소가 포함되어 있습니다.
guest가 true이면 주문 데이터의 고객 번호를 시스템의 고객 번호와 비교하여 확인합니다. 고객 번호가 기존 고객 번호와 일치하지 않으면 해당 번호를 가져옵니다. 그렇지 않으면 건너뜁니다.guest가 false이면 주문 데이터의 고객 번호를 시스템의 고객 번호와 비교하여 확인합니다. 고객 번호가 기존 고객 번호와 일치하면 해당 번호를 가져옵니다. 그렇지 않으면 건너뜁니다.- (주문 XML 버전 19.2 이상)
guest가 없으면 오류를 로깅하고 주문을 건너뜁니다. 다른 주문은 영향을 받지 않습니다.
고객 번호 확인을 정확하게 수행할 수 있도록 주문을 가져오기 전에 고객 데이터를 가져오십시오.
주문 내보내기
order.xsd 스키마 파일을 사용하여 주문 정보를 내보냅니다.
주문을 내보낼 때 다음 정보를 고려하십시오.
- Business Manager 또는 맞춤형 애플리케이션에서의 주문 상태
- 신용카드 데이터 처리 방법
- 고급 검색을 수행한 후 .csv 파일에 주문을 내보내는 경우 처음 10,000개의 주문만 내보냅니다.
주문 내보내기 버전 설정
Salesforce B2C Commerce에서는 XML 기반 주문 내보내기의 단순한 버전화를 지원합니다. 이 버전을 사용하면 조직에서 주문 XML의 변경 사항을 채택할 수 없는 경우 고정 버전으로 남아 있을 수 있습니다.
버전을 지정하려면선택하고 버전을 선택한 다음적용을 클릭합니다.
내보내기 중에 무시된 주문
주문을 내보낼 때 CREATED 및 FAILED 주문은 무시됩니다. CREATED 상태는 내보낼 준비가 되지 않은 처리 중인 주문을 나타내며, FAILED 상태는 내보내기에 적합하지 않은 주문을 표시합니다.
주문 내보내기 및 주문 중 재고
제품 X의 단일 품목 주문을 제출하면 B2C Commerce에서 해당 항목을 내보내기 전임에도 매출 수량을 하나로 표시합니다. 할당을 업데이트하면 매출 수량을 0으로 재설정하므로 초과 판매 상황을 초래할 수 있습니다.
이 상황을 방지하려면 주문 중인 재고 활성화 설정을 변경하십시오. 으로 이동하여 재고 목록의 ID를 클릭하고주문 중인 재고 활성화옵션을 선택하고적용을 클릭합니다.
주문 중인 재고 활성화가 선택되면 아직 내보내지 않은 주문에 주문 중인 수량이 있습니다. 주문을 내보내고 나면 제품은 완료로 표시됩니다. 설정이 선택되지 않으면 아직 내보내지 않은 주문에는 주문 중인 수량이 없습니다. 주문을 내보내고 나면 제품은 완료로 표시됩니다.
Business Manager를 사용하여 주문 내보내기 사본을 생성하는 경우 주문 내보내기가 아직 승인되지 않았으므로 작업 상태를 변경하지 않고 내보내기 작업을 실행할 수 있습니다. 또는 주문 중인 재고 활성화를 선택하고 주문 내보내기 상태가 내보냄으로 변경되면 주문 재고 트랜잭션에 있는 모든 관련 항목이 최종 재고 트랜잭션으로 전환됩니다. 이 설정을 사용하면 프로세스의 이 부분을 제어할 수 있습니다.
ExportOrders 파이플릿에 영향을 미치지 않습니다.신용카드 번호와 함께 주문 내보내기
기본적으로 주문을 내보낼 때(Business Manager 또는 ExportOrders 파이플릿) 마스킹된 신용카드 데이터만 포함됩니다. 예를 들어 다음과 같습니다.
<credit-card>
<card-type>VISA</card-type>
<card-number>XXXX-XXXX-XXXX-1111</card-number>
<card-holder>John Doe</card-holder>
<expiration-month>1</expiration-month>
<expiration-year>2010</expiration-year>
</credit-card>
외부 시스템에 신용카드 데이터를 보내야 하는 경우 ExportOrders 파이플릿을 사용하여 암호화된 신용카드 번호를 피드에 포함합니다. 즉, Studio에서 ExportOrders 파이플릿을 열고 파이플릿에 다음 매개변수를 추가합니다.
- 암호화 키: X.509 형식으로 된 공용 키의 base64 인코딩 문자열 표시(SubjectPublicKeyInfo 파트)
- EncryptionMethod: 암호화에 사용할 암호화 알고리즘 및 매개변수를 지정하는 문자열.
현재, 다음 표현식을 사용하여 파이플릿에 지정할 수 있는 한 방법만 지원됩니다(RSA).
dw.order.PaymentInstrument.ENCRYPTION_METHOD_RSA
RSA 공개 키를 사용하여 신용카드 번호를 암호화합니다. 내부적으로 B2C Commerce에서는 (비밀이 아닌) 공개 키를 사용하여 신용카드 번호를 암호화합니다. 그런 다음 피드를 외부 시스템에 보내면 (비밀) 개인 키를 사용하여 번호를 해독합니다. 주문의 신용카드 번호는 암호화된 데이터의 base64 표시로 내보냅니다. 해당 표시는 일반적으로 신용카드 번호보다 깁니다(예: 2048비트 키를 사용하는 16자리 카드 번호의 경우 348자).
UTF-8 문자를 포함하는 주문 내보내기
일부 UTF-8 문자를 잘못 코딩하지 않게 하려면로 이동하고내보내기 중에 잘못된 XML 문자 필터링설정을 선택하여 내보낸 데이터에서 잘못된 XML 문자를 제거합니다.
REPLACE 모드 및 주문
비어 있는 요소 내보내기
스키마에 minOccurs="0"으로 정의된 비어 있는 요소나 특성은 내보내지 않습니다. 요소에 공백이나 다른 문자가 포함되어 있으면 비어 있는 것으로 간주됩니다.
내보내기 상태 변경을 확약하거나 롤백하는 기능
주문 내보내기 프로세스가 진행됨에 따라 주문을 EXPORTED(Order.exportStatus == Order.EXPORT_STATUS_EXPORTED)로 표시합니다. 명시적 트랜잭션(파이프라인의 전환에 정의됨)에 내보내기 파이플릿을 포함하여 내보내기 상태 변경을 모두 확약하거나 롤백할 수 있습니다.
주문에 배송(품목 그룹)에 할당되지 않은 서비스 품목이 포함되어 있으면 주문 내보내기가 작동합니다. 이 경우 해당 항목의 내보내기 파일에 <shipment_id> 요소가 생성되지 않습니다. 주문에 문서 번호가 비어 있는 품목 그룹(배송)이 포함되어 있으면 FullOrderExport의 주문 내보내기만 성공합니다. 이 문제점을 정정하기 위해 해당 유형의 배송에 서비스 품목이 할당된 경우 <shipment_id>invalid<shipment_id> 요소가 생성됩니다.
<shipment_id> 요소가 없으면 품목이 기본 주문 배송에 할당됩니다. 서비스 품목의 <shipment_id> 요소가 없으면 품목이 배송에 할당되지 않습니다.위치 특성
주문 내보내기 xml의 각 제품 품목 요소에는 위치 특성이 있습니다. 이 기능은 XML 파일을 구문 분석할 때 XML 태그의 주문을 보장할 수 없는 시스템에 사용합니다. 위치 특성에서는 주문을 제공합니다.
REPLACE 모드로 카탈로그를 가져오면 내부 식별자가 변경됩니다. 그러나 제품 품목과 쿠폰 품목은 내부 식별자가 아니라 시맨틱 ID를 사용하여 주문에 링크됩니다. 즉, 제품 SKU가 변경되지 않는 한 제품 품목이 주문에 연결된 상태로 남아 있습니다. 링크는 고유 식별자가 아니라 시맨틱 ID를 통해 설정되므로 가져오기에서 이 링크를 끊을 수 없습니다.
파이플릿
ExportOrders
스키마 요소
이 섹션에서는 order.xsd의 요소와 해당 요소의 값을 생성할 때 고려할 사항을 설명합니다.
요소:
주문과 연결된 위도와 경도의 위치 정보를 내보낼 수 있습니다.
* geoLatitude
* geoLongitude
