현재 위치 :

홈
API
재고/재고 위치

재고/재고 위치

V5 통합 가이드!

V5 Traceability와 고객 ERP 시스템 간의 재고/재고 위치 통합을 통해 상품 로트 번호, 보유 수량, V5 Traceability로 전송될 위치 등의 재고 세부 정보입니다. 이러한 세부 정보를 통해 해당 상품을 생산/주문 등에 사용할 수 있습니다.

ERP 설정에 따라 재고/재고를 처리할 수 있는 몇 가지 방법이 있습니다.

재고 마스터로서의 ERP: 여기서 ERP는 재고 데이터를 V5에 공급하고 V5는 조정/소비/생산 등을 반환합니다. (가장 일반적) (입고, 로그아웃). 이는 두 가지 방법으로 수행할 수 있습니다. 로그에서 업데이트된 재고 가치(로트 2은 현재 123LB임) 또는 로그(Lot50 -123LBS)에서 조정 값을 확인할 수 있습니다. 첫 번째 옵션은 더 많은 동기화를 유지하지만 거래가 누락될 가능성이 더 높습니다.
V5를 스톡 마스터로 사용: V5는 재고 데이터를 ERP에 공급합니다. 그런 다음 ERP는 업데이트된 재고 수준을 정기적으로 피드백합니다. (품절, 재고 있음)
재고 마스터로서의 ERP: ERP는 V5 재고를 공급한 다음 V5는 정기적으로 재고 수준을 반환하고 ERP는 해당 수량을 업데이트합니다. 이는 ERP와 V5가 항상 동기화되기 때문에 유익합니다. 그러나 이는 동기화 시기와 빈도로 인해 문제가 될 수 있습니다. 특히 ERP 자체에서 재고를 공제할 수 있는 경우 이러한 조정된 수준은 다음 V5 동기화에서 덮어쓰여질 수 있습니다. 이 방법은 ERP/MRP가 재고를 직접 조정하지 않고 재무 데이터용으로만 보관하는 경우 유용할 수 있습니다. (입고, 품절)

귀하의 특정 ERP 설정에 가장 적합한 경로가 확실하지 않은 경우 SG Systems는 귀하의 시스템에 가장 적합한 방법론을 가장 잘 평가할 수 있도록 상담 세션을 마련할 수 있습니다.

1. 컨트롤 센터 레이아웃

재고/재고 위치 세부 정보를 제어 센터에 표시되는 내용과 연결하는 방법과 관련하여 주로 이 끝점을 사용하여 왼쪽 하단 패널을 채우고 기존 상품의 재고 수준/위치를 가져오고 내보낼 것입니다.

V5 게이트웨이를 사용하면 두 개의 엔드포인트를 사용하여 여기에 데이터를 쉽게 채울 수 있습니다. ‘Stock’ ‘StockLocation’.

2. API 링크

이러한 데이터베이스 클래스의 정의에 대해 자세히 알아보려면 다음 링크를 참조하십시오.

재고

재고 위치

3. 통합 템플릿

재고 위치에 대한 통합 템플릿을 다운로드할 수 있습니다. 여기를 클릭해 문의해주세요.

4. StockLocation 현장 가이드

4.1. 기본 키

기본 키는 V5 API 내의 각 테이블에 대한 고유 식별자입니다. 을 위한 StockLocation, 이것들은:

location.code – 고유 식별 코드 재고 위치.

stock.commodity.code – 고유 식별 코드 상품

stock.lotNo – 주식의 로트 번호입니다.

럭셔리 Stock, 기본 키는 다음과 같습니다.

lotNo – 주식의 로트 번호입니다.

commodity.code – 상품의 고유 식별 코드입니다.

로트 번호는 시스템에서 자동으로 생성되거나 수동으로 입력될 수 있습니다. 아래 설명된 필드를 사용하여 공급업체 로트 번호를 입력할 수 있습니다. 로트 번호는 전역적으로 생성되거나(2개의 로트 번호가 동일할 수 없음) 상품별로 생성될 수 있습니다.

4.2. 필수 입력 사항

V5 Control Center에서 유효한 상품 라인을 채우기 위해 SG에서 요구하는 기타 필드는 다음과 같습니다.

stock.expiry – 특정 로트의 만료일.

qty – 해당 로트에 포함된 상품의 수량입니다.

4.3. 선호 분야

선호하는 필드는 해당 상품에 대한 정보를 더 추가하는 역할을 하며 필수 필드는 아니지만 V5 Traceability 내에서 기능을 추가할 때 유용합니다.

stock.supplier.code - 상품 로트를 제공한 공급자의 코드입니다.

stock.cost - 상품의 비용(단위당)입니다.

stock.dateReceived - 로트가 재고로 예약된 날짜입니다.

stock.supplierLotNo - 공급자가 지정한 로트 번호입니다.

4.4. 추가 필드

다음과 같은 추가 필드도 포함될 수 있습니다.

stock.commodity.description - 상품에 대한 설명입니다.

stock.commodity.units.code - 상품의 기본 단위입니다.

stock.commodity.recordStock – 이 상품의 사용이 V5 추적성으로 추적되는지 여부.

이러한 추가 필드는 V5 Traceability에서 상품 항목을 생성하고 이에 대한 재고 위치 및 수량을 할당하는 데 사용될 수 있습니다. 사용할 때 CSV 방식 데이터 교환을 위해서는 제어 센터의 '게이트웨이'에서 '하위 엔터티 생성'이 선택되어 있는지 확인해야 합니다. 그러나 기존 상품은 업데이트할 수 없습니다. V5-API 이 끝점을 사용하는 대신 '원자재대신 ' 끝점.

5. 방법론

API 통합 목적에 따라 다음을 사용할 수 있습니다. ‘StockLocation’ or ‘Stock’ JSON 및 CSV 가져오기 및 내보내기를 위한 엔드포인트입니다. 이제 아래에서 이를 살펴볼 수 있습니다.

5.1. JSON – 가져오기

StockLocation:

우리는 다음을 활용할 수 있습니다. ‘StockLocation’ 수신/만료 날짜, 로트/공급업체 로트 번호 및 재고 위치와 관련된 정보가 포함된 상품(존재 여부에 관계없이)에 대한 재고 기록을 V5 추적성에 삽입하는 엔드포인트입니다.

‘StockLocation’ 끝점/URI 가져오기 –

http://host:port/V5-API/api/integrate/import/stock_location

엔드포인트 설명

이 샘플 가져오기의 경우 ‘StockLocation’ 엔드포인트를 사용하면 단일 로트에 대한 기본 가져오기 파일을 아래와 같이 구성할 수 있습니다.

이 샘플 JSON 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.

API 매뉴얼을 사용하면 여기서는 우리가 ‘qty’ 값 ‘StockLocation’ 클래스, 다른 모든 값은 다음 중 하나 아래에 중첩됩니다. ‘stock’ or ‘location’ 수업. 우리는 또한 ‘code’ ‘units’ 데이터 포인트는 아래에 추가로 중첩됩니다. ‘commodity’ 클래스입니다.

아래에서 이 데이터 흐름 프로세스의 요약을 볼 수 있습니다.

위의 JSON 파일을 실행하면 상품에 대한 로트가 표시됩니다. ‘I015’ (Jalepenos) 이제 이 로트를 제어 센터로 가져왔습니다.

그러나 우리가 할 수 없는 일은 ‘StockLocation’ 끝점은 공급업체 로트 번호 및 기존 재고의 만료 날짜와 같은 변경 값입니다. 이렇게 하려면 다음을 사용해야 합니다. ‘Stock’ 엔드 포인트.

주식 :

위에서 언급했듯이 ‘StockLocation’ 엔드포인트를 사용하여 재고 레코드 및 관련 위치를 삽입할 수 있습니다. 그러나 해당 로트에 대한 세부 정보를 업데이트하고 싶다면 ‘Stock’ 헤더를 사용해야 합니다. ‘Stock’ 끝점. 여기에는 공급업체 로트 번호, 만료 날짜, 수령된 중량 등의 세부 정보가 포함됩니다.

‘Stock’ 끝점/URI 가져오기 –

http://host:port/V5-API/api/integrate/import/stock

엔드포인트 설명

아주 기본적인 것에는 ‘Stock’ 위에서 생성한 로트의 만료 날짜와 공급업체 로트 번호를 업데이트하는 가져오기 파일을 사용하면 다음을 사용할 수 있습니다.

이 샘플 JSON 파일은 다운로드할 수 있습니다. 여기를 클릭해 문의해주세요.

결과적으로 V5 내에서 로트 정보가 업데이트됩니다.

5.2. JSON – 내보내기

V5 API에서 재고 재고 위치와 관련된 파일을 다시 수신하는 것과 관련하여 다음에서 메소드 요약을 확인하면 IntegrationExport 수업, 우리는 그렇게 생각할 수도 있습니다 ‘StockLocations’ (export/locations/stock) 우리가 찾고 있는 것이 바로 그것이다. 그러나 이 엔드포인트는 시스템 내에 존재하는 재고 위치(생산 위치 대비) 목록을 내보내므로 그렇지 않습니다.

당사 상품에 대한 위치 및 재고 수준 정보를 받으려면 다음을 사용할 수 있습니다.

개별 상품+로트 재고:

엔드포인트/URI 내보내기 –

http://host:port/V5-API/api/integrate/export/stock/{commodityCode}/{lotNumber}

엔드포인트 설명

이 엔드포인트는 지정된 단일 상품 로트에 대한 모든 관련 정보가 포함된 JSON 파일을 내보냅니다. 방금 가져온 로트 정보를 사용하여 이 요청을 실행하면 다음과 같은 파일이 생성됩니다.

이 유형의 샘플 JSON 파일을 다운로드할 수 있습니다. 여기에서 확인하세요.

모든 재고:

엔드포인트/URI 내보내기 –

http://host:port/V5-API/api/integrate/export/stock/{all}

엔드포인트 설명

이 엔드포인트는 {all} 필드의 값에 따라 시스템에 있는 모든 상품의 모든 로트에 대한 모든 관련 정보 목록을 포함하는 JSON 파일을 내보냅니다. 이것이라면 ‘true’ 그런 다음 모든 재고 로트를 가져옵니다. 반면에 ‘false’ 그런 다음 새로운 재고 품목(예: 이미 수출된 것으로 표시되지 않은 많은 상품)에 대한 반품만 받게 됩니다.

이 요청을 다음과 같이 실행하면 ‘true’ (그래서 http://host:port/V5-API/api/integrate/export/stock/true) , 우리는 다음과 같은 파일을 얻을 것입니다:

이 유형의 샘플 JSON 파일을 다운로드할 수 있습니다. 여기에서 확인하세요.

위 엔드포인트는 현재 재고 수준만 제공합니다. 하지만 생산이 진행되는 동안 재고 수준을 추적하고 싶다면 어떻게 해야 할까요? 여기에는 API를 사용하고 ERP 시스템과 통합하는 방법에 따라 몇 가지 다른 옵션이 있습니다.

우리는 또한 다양한 활용이 가능합니다 트랜잭션 및 로그 엔드포인트 재고 수준 변경에 대한 보다 관련성 있는 정보를 검색합니다.

럭셔리 시스템 로그 엔드포인트는 다음과 같습니다.

시스템 로그

소비/생산된 시스템 로그

조정 시스템 로그

럭셔리 트랜잭션/일반 엔드포인트는 다음과 같습니다.

5.3. CSV – 가져오기

헤더/열 정의 파일 이름: “stockLocation.csvh”

완료된 헤더 파일은 다음 위치에 있어야 합니다. “<installdir>\SG Control Center\gateway\import\column_defs”

CSV 파일 이름 가져오기: “stockLocation-datetime.csv”

가져올 CSV는 다음 위치에 있어야 합니다. “<installdir>\SG Control Center\gateway\import”

헤더 파일:

헤더 파일은 일반적으로 CSV 통합이 발생하기 전에 SG Systems에서 컴파일되지만 이전에 정의된 헤더 파일을 사용하여 재고/재고에 사용할 수 있는 기본 예를 볼 수 있습니다. 클래스 정의아래 :

이러한 파일을 구성하는 방법에 대한 자세한 내용은 다음을 참조하십시오. 기본 통합 페이지. 이 샘플 헤더 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.

CSV 가져오기 파일:

그런 다음 헤더에서 정의된 데이터 요소 순서를 사용하여 가져오기 파일을 구조화할 수 있습니다. SG Systems는 이를 위한 템플릿 파일을 제공하여 목록을 채울 때 항목을 더 명확하게 하기 위해 각 열에 대한 데이터 포인트를 나열할 수 있습니다. 이 첫 번째 행은 제어 센터에서 무시할 수 있으므로 가져오기를 위해 제출할 때 파일에 보관할 수 있습니다.

예제 csv 가져오기 파일은 다음과 같습니다.