송영
V5 통합 가이드!
V5 Traceability와 고객 ERP 시스템 간의 전송 통합을 통해 전송 세부 정보, 전송 품목 및 일정 정보를 V5 Traceability로 전송할 수 있습니다. 이러한 전송은 V5 WMS 소프트웨어를 통해 전송 및 수신될 수 있으며, 그 후 전송 및 수신된 로트, 전송된 금액, 이 팔레트가 무엇인지 등과 같은 정보를 ERP로 다시 전송할 수 있습니다.
V5는 이 경우 데이터 마스터 역할도 할 수 있으며 시스템 내에서 생성된 전송을 ERP로 보낼 수 있습니다.
V5 Traceability의 전송 모듈 작동 방식에 대한 자세한 내용은 모듈 가이드를 참조하세요. 여기에서 확인하세요.
차례
1. 컨트롤 센터 레이아웃
우리가 어떻게 관계를 맺을 수 있는지에 관해서 ‘Transfers’ ‘Transfer Lines’ 제어 센터에서 볼 수 있듯이 여기 상단 패널은 사이트 간 이동, 외부 참조 번호 등을 모두 가져올 수 있는 전송용임을 알 수 있습니다.
왼쪽 하단 패널에는 전송에 필요한 상품 및 수량과 관련된 데이터를 보관하는 전송 라인을 추가할 수 있는 곳이 있습니다.
V5 Gateway를 사용하면 두 패널을 별도로 또는 함께 쉽게 채울 수 있습니다.
오른쪽 하단 패널에는 'from' 위치에서 전송 항목을 선택한 위치와 'to' 위치에서 받는 항목과 관련된 데이터가 있습니다. 이 데이터는 V5 Gateway에서 다시 받을 수 있는 내보내기의 일부를 구성합니다.
2. API 링크
3. 통합 템플릿
전송을 위한 통합 템플릿을 다운로드할 수 있습니다. 여기에서 확인하세요.
4. 환승 현장 가이드
4.1. 기본 키
기본 키는 V5 API 내의 각 테이블에 대한 고유 식별자입니다. 을 위한 Transfers, 이것은:
reference – 이체에 대한 고유 참조 번호입니다. 본질적으로 이전 주문 번호입니다.
럭셔리 TransferLines, 기본 키는 중:
reference + commodity.code – 양도할 상품과 함께 양도 참조/번호.
or
lineID – 동일한 상품이 여러 줄에 나타날 수 있는 고급 목적을 위해 이전 참조 및 상품 코드 대신 라인 ID를 고유 식별자로 지정할 수 있습니다. 이는 동일한 상품이 1라인 이상 전송되는 경우에 필요합니다.
4.2. 필수 입력 사항
제어 센터에 유효한 항목을 채우기 위해 SG가 요구하는 기타 필드는 다음과 같습니다.
럭셔리 TransferLines:
quantityOrdered – 주문되는 상품의 수량.
럭셔리 Transfers:
fromLocation.code - 전송이 전송될 위치.
toLocation.code - 전송이 전송될 위치.
4.3. 선호 분야
기본 필드는 전송에 더 많은 데이터를 추가하는 역할을 하며, 필수는 아니지만 V5 추적성 내 기능과 관련하여 유용합니다. 이것들은:
lineID - 위의 기본 키로 사용되지 않는 경우 이 필드가 포함되어야 합니다.
commodity.code – 위에서 기본 키로 사용되지 않는 경우 이 필드를 포함해야 합니다. 이전할 상품의 코드입니다.
transfer.reference - 위의 기본 키로 사용되지 않는 경우 이 필드가 포함되어야 합니다.
위 내용은 'transferLines'. 동일한 필드를 '에 적용할 수 있습니다.transfers' 추가하여 ‘transferLine’ 처음 2개 항목으로 이동하고 제거합니다. ‘transfer’ 마지막 것부터.
4.4. 추가 필드
다음과 같은 추가 필드도 포함될 수 있습니다. ‘transfer’:
comment – 전송에 대한 추가 의견.
fromAddress – 이체가 전송되는 주소입니다. 이들은 다음 위치에 채워져 있습니다. ‘Site Addresses‘.
toAddress – 송금을 받은 주소.
directTransfer – 이 전송이 다음과 같이 이루어져야 하는지 여부 직접 전송 아니면 않습니다.
위와 유사하게 'transferLine' 파일에 다음을 추가하여 간단히 전송 클래스로 이동할 수 있습니다. ‘transfer’ 위 매개변수의 시작 부분에.
5. 방법론
의 성격을 감안할 때 ‘Transfer’ ‘TransferLine’, 다음 두 가지 방법으로 데이터를 가져오도록 선택할 수 있습니다.
- 우리는 사용할 수 있습니다 ‘Transfer’ 전송을 가져오기 위한 엔드포인트를 만든 다음 아래에서 볼 수 있듯이 ‘TransferLine’ 클래스를 사용하여 구성요소 품목 항목을 모두 하나의 파일에 포함합니다. 이는 헤더 정보 1세트와 후속 항목만 필요하므로 전체 전송을 가져오는 가장 논리적인 방법입니다. 이는 전송에 대한 헤더 정보를 수정하는 데 사용할 수 있는 유일한 엔드포인트이기도 합니다.
- 우리는 사용할 수 있습니다 ‘TransferLine’ 환승이 생성되면 환승 라인을 수정하거나 추가하기 위한 엔드포인트입니다. 이는 전체 전송을 가져오는 데 계속 사용할 수 있지만 각 전송 개별 항목에는 전송 헤더에 대한 중첩된 참조(예: 참조)가 포함되어야 하므로 효율성이 떨어집니다. 위에 표시된 대로 이 끝점은 전송 헤더 정보(참조/대상 및 위치 등)를 변경하는 데 사용할 수 없습니다.
우리가 사용할 엔드포인트는 JSON 또는 CSV 가져오기를 사용하는지 여부에 따라 크게 달라집니다. 이제 아래에서 확인할 수 있습니다.
5.1. JSON – 가져오기
이전:
‘Transfer’ 끝점/URI 가져오기 –
http://host:port/V5-API/api/integrate/import/transfer
이 샘플 가져오기의 경우 ‘Transfer’ 엔드포인트를 사용하고 전송의 기본 가져오기 파일을 2줄로 구성하면 다음과 같이 보일 수 있습니다.
이 샘플 JSON 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.
우리는 왜 우리가 ‘Transfer’ 중첩된 데이터를 보유할 수 있는 JSON 파일의 기능이 주어지면 이 형식의 끝점을 통해 들여쓰기를 포함할 수 있습니다. ‘TransferLines’ 목록을 작성하고 그 이후에 ‘Commodity’ SG API 설명서를 사용하여 확인할 수 있는 가져오기의 데이터 포인트. 예를 들어, ‘commodity code’ datapoint는 API 설명서에서 다음 경로를 사용하여 찾을 수 있습니다.
유사한 경로 찾기 방법을 사용하여 필요한 나머지 데이터 포인트를 구축할 수 있습니다.
위 파일을 사용하면 제어 센터에 새 전송이 생성된 것을 확인할 수 있습니다.
환승 노선:
‘TransferLine’ 끝점/URI 가져오기 –
http://host:port/V5-API/api/integrate/import/transfer_line
위에서 논의한 것처럼 우리는 다음을 사용할 수 있습니다. ‘TransferLine’ 기존 전송의 라인을 추가하거나 편집하기 위한 엔드포인트입니다. 이 엔드포인트를 사용하여 전송을 추가할 수도 있지만, 전송 헤더는 다음을 통해서만 편집할 수 있다는 점을 기억하는 것이 중요합니다. ‘Transfer’ 위의 URI입니다. 또한 전송 정보는 각 전송 라인에 대해 여기에 중첩되어야 합니다.
우리는 a의 예를 볼 수 있습니다 ‘TransferLine’ 전송할 다른 줄을 추가할 아래 JSON 파일 ‘TR-1882’ 위에서 만든 것:
이 샘플 JSON 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.
이 요청이 게시되면 제어 센터로 돌아가서 이 전송에 세 번째 줄이 추가되었는지 확인할 수 있습니다.
5.2. JSON – 내보내기
V5 API에서 다시 전송과 관련된 파일 수신과 관련하여 다음의 메소드 요약을 확인하면 ‘IntegrationExport‘ 다음과 같은 몇 가지 다른 옵션이 있습니다.
이전 :
엔드포인트/URI 내보내기 –
http://host:port/V5-API/api/integrate/export/transfers
이 엔드포인트는 전송 데이터베이스 클래스를 사용하여 전체 전송 JSON 파일을 내보내고 시스템에서 아직 내보낸 것으로 표시되지 않았거나 처음 내보낸 이후 변경된 모든 전송을 포함합니다. 여기에는 재고 이동 데이터가 포함되지 않고 오히려 각 데이터 포인트에 대한 반품이 제공됩니다. ‘Transfer’ 클래스입니다.
이 유형의 JSON 파일의 예를 다운로드할 수 있습니다. 여기에서 확인하세요.
이전:
엔드포인트/URI 내보내기 –
http://host:port/V5-API/api/integrate/export/transfer/{referenceNumber}
이 엔드포인트는 전송 데이터베이스 클래스를 사용하여 전체 전송 JSON 파일을 내보냅니다. 단, 지정된 전송에 대해서만 그리고 이 전송이 아직 시스템에서 내보낸 것으로 표시되지 않은 경우에만 가능합니다. 위와 같이 여기에는 재고 이동 데이터가 포함되지 않지만 오히려 ‘Transfer’ 클래스입니다.
이 유형의 JSON 파일의 예를 다운로드할 수 있습니다. 여기에서 확인하세요.
우리는 또한 활용할 수 있습니다 트랜잭션 및 로그 엔드포인트 구매 주문서로 수령한 상품에 대한 더 많은 관련 정보를 검색합니다.
환승의 경우 1개가 있습니다. 시스템 로그 사용할 수 있는 엔드포인트:
시스템 로그 :
엔드포인트/URI 내보내기 –
http://host:port/V5-API/api/integrate/export/system_logs
이 끝점을 사용하면 이전에 내보낸 것으로 표시되지 않은 시스템 로그 이벤트의 전체 목록이 반환됩니다. 이 엔드포인트에 대한 추가 정보를 찾을 수 있습니다. 여기에서 확인하세요. 이러한 결과는 특정 전송을 찾기 위해 필터링될 수 있습니다. 설명자같은 ‘MOVED OUT/IN’, ‘PALLET MOVED OUT/IN’ ‘PALLET TRANSFER OUT/IN’.
이 유형의 JSON 파일의 예를 다운로드할 수 있습니다. 여기에서 확인하세요.
5.3. CSV – 가져오기
CSV 가져오기의 경우 일반적으로 ‘TransferLine’ 단일 csv 가져오기를 사용하여 전송 및 해당 항목을 생성할 수 있습니다.
헤더/열 정의 파일 이름: “transferLine.csvh”
완료된 헤더 파일은 다음 위치에 있어야 합니다. “<installdir>\SG Control Center\gateway\import\column_defs”
CSV 파일 이름 가져오기: “transferLine-datetime.csv”
가져올 CSV는 다음 위치에 있어야 합니다. “<installdir>\SG Control Center\gateway\import”
헤더 파일:
헤더 파일은 일반적으로 CSV 통합이 이루어지기 전에 SG Systems에서 컴파일되지만 아래에서 전송에 사용할 수 있는 기본 예를 볼 수 있습니다.
이러한 파일을 구성하는 방법에 대한 자세한 내용은 다음을 참조하십시오. 기본 통합 페이지. 이 샘플 헤더 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.
CSV 가져오기 파일:
그런 다음 헤더에서 정의된 데이터 요소 순서를 사용하여 가져오기 파일을 구조화할 수 있습니다. SG Systems는 이를 위한 템플릿 파일을 제공하여 목록을 채울 때 항목을 더 명확하게 하기 위해 각 열에 대한 데이터 포인트를 나열할 수 있습니다. 이 첫 번째 행은 제어 센터에서 무시할 수 있으므로 가져오기를 위해 제출할 때 파일에 보관할 수 있습니다.
여기서 우리는 JSON 방법론을 사용하여 생성한 것과 유사한 전송을 생성하는 것을 목표로 하고 있음을 알 수 있습니다. 이 샘플 가져오기 파일을 다운로드할 수 있습니다. 여기에서 확인하세요.
가져오기가 완료되면 필수 항목과 함께 이 전송이 제어 센터에 추가된 것을 확인할 수 있습니다. 다음과 같은 경우 ‘Created Date’ 데이터가 가져오기에 포함되지 않으면 배치된 날짜는 오늘 날짜를 참조합니다.
5.4. CSV – 내보내기
이 방법을 통해 전송 정보를 내보내려는 경우 이는 ‘SystemLog’ 내보내다. 이 끝점에 대한 클래스 정의를 볼 수 있습니다. 여기에서 확인하세요.
헤더/열 정의 파일 이름: “SystemLog.csvh”
완료된 헤더 파일은 다음 위치에 있어야 합니다. “<installdir>\SG Control Center\gateway\export\order”
내보내기 CSV 파일 이름: “SystemLog-datetime.csv”
내보내기용 CSV는 다음에서 생성됩니다. “<installdir>\SG Control Center\gateway\export”
이 엔드포인트는 연결된 사용 가능한 데이터 포인트를 탐색하여 다양한 데이터를 추출하는 데 사용될 수 있습니다.
머리글:
다음과 같은 데이터 포인트를 사용할 수 있습니다. ‘user’, ‘timestamp’ ‘quantity’ 이 위에 ‘System Log’ 레벨로 이동할 수 있지만 ‘TransferLine’ 전송 시 요청한 참조 번호, 상품 등의 필드를 추가하는 클래스입니다. ‘Stock’ 항목이 이동된 위치와 같은 정보를 검색하는 클래스입니다.
매우 기본적인 수준에서 전송을 처리하는 시스템 로그 헤더 부분은 다음과 같습니다.
이 샘플 헤더 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.
이 헤더가 있으면 내보내기를 선택했는지도 확인해야 합니다. ‘System Logs’ 제어 센터 게이트웨이의 내보내기 탭에 있습니다.
헤더가 제자리에 있고 내보내기가 활성화된 상태에서(게이트웨이의 변경 사항을 적용하려면 제어 센터를 다시 시작하는 것을 잊지 마십시오!) 이후에 이 전송에 대한 반환 파일을 받게 됩니다(이전에 내보내지 않은 다른 전송과 함께). 이것:
