상품
V5 통합 가이드!
V5 Traceability와 고객의 ERP 시스템 간의 상품(성분/포장/원료/SKU) 통합을 통해 비용, 단위, 기본 만료 시간 등과 같은 상품 세부 정보를 V5 Traceability로 보낼 수 있습니다.
차례
1. 컨트롤 센터 레이아웃
상품을 우리가 보는 것과 어떻게 연관시킬 수 있는지에 관해서 제어 센터, 여기에 채울 패널이 하나뿐인 기본 상품 창만 있음을 알 수 있습니다.
V5 게이트웨이를 사용하면 단일 엔드포인트를 사용하여 여기에 데이터를 쉽게 채울 수 있습니다.
2. API 링크
이러한 데이터베이스 클래스의 정의에 대해 자세히 알아보려면 다음 링크를 참조하십시오.
3. 통합 템플릿
에 대한 통합 템플릿 Commodities 다운로드 가능 여기에서 확인하세요.
4. 상품 필드 가이드
4.1. 기본 키
기본 키는 V5 API 내의 각 테이블에 대한 고유 식별자입니다. 을 위한 Commodities, 이것은:
code – 각 상품의 고유 식별 코드.
4.2. 필수 입력 사항
제어 센터에서 유효한 상품 라인을 채우기 위해 SG가 요구하는 다른 필드는 다음과 같습니다.
units.code - 상품의 기본 재고 단위입니다.
type - 상품 유형(성분(0), 공식(1) 또는 포장(2)).
recordStock - 이 상품의 사용을 V5 Traceability로 추적해야 하는지 여부(기록되지 않음(0) 또는 기록됨(1)).
4.3. 선호 분야
선호하는 필드는 해당 상품에 대한 정보를 더 추가하는 역할을 하며 필수 필드는 아니지만 V5 Traceability 내에서 기능을 추가할 때 유용합니다.
description - 상품에 대한 설명입니다.
bulkUnit - 벌크 유닛 상품(예: '가방' 또는 '상자').
bulkQuantity - 상품의 기본 단위(units.code)의 양은 위의 벌크 단위로 들어갑니다(예: '20'은 '1', 벌크 단위에는 'Bag' 입력, 기본 단위 'lb'는 20 Bag of 이 상품은 XNUMXlbs입니다).
4.4. 추가 필드
다음과 같은 추가 필드도 포함될 수 있습니다.
cost – 상품의 기본 비용(단위당)입니다.
defExpiryDays – 이 상품 유형의 재고 항목이 만료되도록 설정되는 수령 후 기본 일수
gtin – 상품의 GTIN.
5. 방법론
이 개체 클래스에 대해 단일 끝점만 사용하고 있다는 점을 감안할 때 JSON 및 CSV 가져오기 및 내보내기 모두에 대해 '상품' 끝점을 사용할 수 있습니다. 이제 아래에서 확인할 수 있습니다.
5.1. JSON – 가져오기
Commodity:
‘Commodity’ 끝점/URI 가져오기 –
http://host:port/V5-API/api/integrate/import/commodity
이 샘플 가져오기의 경우 ‘Commodity’ 끝점 및 단일 상품에 대한 기본 가져오기 파일을 구성하면 다음과 같이 표시될 수 있습니다.
이 샘플 JSON 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.
여기에서 다음과 관련된 중첩 클래스를 사용하는 예를 볼 수 있습니다. ‘Commodity’ 끝점. 이 경우 들여쓰기를 포함했습니다. ‘units’ ‘bulkUnit’ 상품의 기본 단위와 벌크 단위를 정의할 수 있습니다. 이 두 가지 모두를 사용하기 때문에 ‘WeightUnit’ 클래스에서 V5 API 설명서를 사용하여 다음 경로를 사용하여 이러한 데이터 포인트로 안내할 수 있습니다.
다음과 같은 추가 클래스로 이동하기 위해 유사한 경로 찾기 방법을 사용하여 나머지 필수 데이터 포인트를 구축할 수 있습니다. ‘Location’ or ‘Container’ 필요에 따라.
위의 예제 파일을 가져오면 제어 센터에서 상품을 가져온 것을 볼 수 있습니다.
5.2. JSON – 내보내기
V5 API에서 상품과 관련된 파일을 다시 수신하는 것과 관련하여 메서드 요약을 확인하면 IntegrationExport 클래스에는 두 가지 옵션이 있습니다.
Commodity:
엔드포인트/URI 내보내기 –
http://host:port/V5-API/api/integrate/export/commodity/{code}
이 끝점은 특정 상품에 대한 모든 관련 정보가 포함된 JSON 파일을 내보냅니다. 방금 가져온 상품을 사용하여 이 요청을 실행하면 다음과 같은 파일을 얻게 됩니다.
예제 JSON 파일을 다운로드할 수 있습니다. 여기에서 확인하세요.
Commodities:
엔드포인트/URI 내보내기 –
http://host:port/V5-API/api/integrate/export/commodites/{all}
이 엔드포인트는 {all} 필드. 만약 이것이 ‘true’ 그러면 우리는 모든 상품을 가져올 것입니다. ‘false’ 그러면 우리는 새로운 상품에 대한 수익을 얻을 것입니다(즉, 이미 내보낸 것으로 표시됨).
이 요청을 다음과 같이 실행하면 true , 우리는 다음과 같은 파일을 얻을 것입니다:
예제 JSON 파일을 다운로드할 수 있습니다. 여기에서 확인하세요.
5.3. CSV – 가져오기
헤더/열 정의 파일 이름: “commodity.csvh”
완료된 헤더 파일은 다음 위치에 있어야 합니다. “<installdir>\SG Control Center\gateway\import\column_defs”
CSV 파일 이름 가져오기: “commodity-datetime.csv”
가져올 CSV는 다음 위치에 있어야 합니다. “<installdir>\SG Control Center\gateway\import”
헤더 파일:
헤더 파일은 일반적으로 CSV 통합이 발생하기 전에 SG Systems에서 컴파일되지만 아래에서 상품에 사용할 수 있는 기본 예를 볼 수 있습니다.
이러한 파일을 구성하는 방법에 대한 자세한 내용은 다음을 참조하십시오. 기본 통합 페이지. 이 샘플 헤더 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.
CSV 가져오기 파일:
그런 다음 헤더에서 정의된 데이터 요소 순서를 사용하여 가져오기 파일을 구조화할 수 있습니다. SG Systems는 이를 위한 템플릿 파일을 제공하여 목록을 채울 때 항목을 더 명확하게 하기 위해 각 열에 대한 데이터 포인트를 나열할 수 있습니다. 이 첫 번째 행은 제어 센터에서 무시할 수 있으므로 가져오기를 위해 제출할 때 파일에 보관할 수 있습니다.
위의 헤더를 사용하는 csv 가져오기 파일의 예는 다음과 같습니다.
이 샘플 가져오기 파일을 다운로드할 수 있습니다. 여기에서 확인하세요.
가져오기가 완료되면 이러한 상품이 제어 센터에 추가되었음을 알 수 있습니다.
5.4. CSV – 내보내기
이 방법을 사용하여 상품을 수출할 때 우리는 수입에 대해 했던 것과 동일한 클래스 정의를 사용할 것입니다. 여기에서 확인하세요.
헤더/열 정의 파일 이름: “commodity.csvh”
완료된 헤더 파일은 다음 위치에 있어야 합니다. “<installdir>\SG Control Center\gateway\export\order”
내보내기 CSV 파일 이름: “Commodity-datetime.csv”
내보내기용 CSV는 다음에서 생성됩니다. “<installdir>\SG Control Center\gateway\export”
이 내보내기는 제어 센터의 게이트웨이 섹션에서도 활성화해야 합니다. 여기에서 내보내기만 선택할 수 있습니다. ‘Ingredients’ (성분/포장), 공식, 또는 둘 다. 여기서는 내보내기만 살펴보겠습니다. ‘Ingredients’ :
헤더 파일:
여기서부터는 시스템에서 다시 수신하려는 정보에 맞게 내보내기 헤더 파일을 구조화하는 간단한 경우가 될 것입니다.
가져오기 헤더를 구성한 방식과 매우 유사한 방식으로 구성할 수 있습니다.
이 샘플 헤더 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.
CSV 내보내기 파일:
위 헤더가 있으면 최근 가져오기에 대해 다음과 같은 반환 csv를 받게 됩니다.
이 샘플 내보내기 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.
