현재 위치 :

홈
API
구매 주문서

구매 주문서

V5 통합 가이드!

V5 Traceability와 고객의 ERP 시스템 간의 구매 주문서 통합을 통해 주문 세부 정보, 주문 라인 항목 및 일정 정보를 V5 Traceability로 보낼 수 있습니다. 그런 다음 V5 WMS 소프트웨어를 통해 이러한 주문을 받을 수 있으며, 그 후에 받은 수량, 위치 및 컨테이너/팔레트 할당과 같은 정보를 다시 ERP로 보낼 수 있습니다.

V5 Traceability의 구매 주문 모듈 작동 방식에 대한 자세한 내용은 모듈 가이드를 참조하십시오. 여기에서 확인하세요.

1. 컨트롤 센터 레이아웃

구매 주문 및 구매 주문 라인을 제어 센터에 표시되는 것과 어떻게 관련시킬 수 있는지에 대해 여기 상단 패널이 구매 주문에 대한 것임을 알 수 있습니다. 여기서 공급자, 주문 및 배송 날짜, 외부 주문 참조 등은 모두 수입됩니다.

그러면 아래쪽 패널에서 주문 라인의 상품, 수량 및 비용과 관련된 데이터를 보유하는 구매 주문 라인을 추가할 수 있습니다.

V5 Gateway를 사용하면 두 패널을 별도로 또는 함께 쉽게 채울 수 있습니다.

오른쪽 아래 패널에는 PO가 처리될 때 PO의 항목이 선택되고 저장되는 위치와 관련된 데이터가 있습니다. 이 데이터는 게이트웨이에서 다시 받을 수 있는 내보낸 데이터의 일부를 구성합니다.

2. API 링크

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

Purchase Orders

Purchase Order Lines

3. 통합 템플릿

구매 주문에 대한 통합 템플릿을 다운로드할 수 있습니다. 여기에서 확인하세요.

4. 주문서 필드 가이드

4.1. 기본 키

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

purchaseOrder.orderNumber – PO 번호.

럭셔리 Purchase Order Lines, 기본 키는 중:

purchaseOrder.orderNumber + commodity.code – 주문할 상품과 함께 PO 번호

lineID – 동일한 상품이 여러 라인에 나타날 수 있는 고급 목적을 위해 주문 번호와 상품 코드 대신 라인 ID를 고유 식별자로 지정할 수 있습니다.

4.2. 필수 입력 사항

제어 센터에서 유효한 PO 라인을 채우기 위해 SG가 요구하는 다른 필드는 다음과 같습니다.

quantity – 주문되는 상품의 수량.

4.3. 선호 분야

기본 필드는 구매 주문서에 더 많은 데이터를 추가하는 역할을 하며 필수 필드는 아니지만 V5 Traceability 내 기능과 관련하여 유용합니다.

lineID - 위의 기본 키로 사용되지 않는 경우 이 필드가 포함되어야 합니다.

commodity.code – 위의 기본 키로 사용되지 않는 경우 이 필드가 포함되어야 합니다.

purchaseOrder.orderNumber – 위의 기본 키로 사용되지 않는 경우 이 필드가 포함되어야 합니다.

purchaseOrder.supplier.code – 공급자를 식별하는 데 사용되는 고유 코드.

구매주문.배치일 - 주문한 날짜.

purchaseOrder.deliveryDate – 주문에 대해 설정된 배송 날짜.

unit – 주문 중인 상품의 UOM.

4.4. 추가 필드

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

purchaseOrder.notes – PO에 대한 메모.

cost – 주문되는 상품의 비용(단위당).

5. 방법론

의 성격을 감안할 때 PurchaseOrder PurchaseOrderLine , 다음 두 가지 방법으로 데이터를 가져오도록 선택할 수 있습니다.

'PurchaseOrder' 엔드포인트를 사용하여 구매 주문서를 가져온 다음 아래에서 볼 수 있듯이 'PurchaseOrderLine' 클래스로 이동하여 구성 요소 품목을 모두 하나의 파일에 포함할 수 있습니다. 이는 헤더 정보 1세트와 후속 품목 항목만 필요하므로 전체 주문을 가져오는 가장 논리적인 방법입니다. 이는 구매 주문의 헤더 정보를 수정하는 데 사용할 수 있는 유일한 엔드포인트이기도 합니다.
주문이 생성되면 'PurchaseOrderLine' 엔드포인트를 사용하여 라인을 수정하거나 추가할 수 있습니다. 전체 주문을 가져오는 데에도 사용할 수 있지만 각 주문 라인 항목에는 구매 주문 헤더(예: 주문 번호)에 대한 중첩 참조가 포함되어야 하므로 효율성이 떨어집니다. 위에 표시된 대로 이 끝점은 주문 헤더 정보(주문 번호/배송 날짜 등)를 변경하는 데 사용할 수 없습니다.

우리가 사용할 엔드포인트는 JSON 또는 CSV 가져오기를 사용하는지 여부에 따라 크게 달라집니다. 이제 아래에서 확인할 수 있습니다.

5.1. JSON – 가져오기

Purchase Order:

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

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

엔드포인트 설명

이 샘플 가져오기의 경우 ‘PurchaseOrder’ 끝점 및 기본 가져오기 파일을 구조화하면 다음과 같이 표시될 수 있습니다.

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

우리는 왜 우리가 ‘PurchaseOrder’ 중첩된 데이터를 보유할 수 있는 JSON 파일의 기능이 주어지면 이 형식의 끝점을 통해 들여쓰기를 포함할 수 있습니다. ‘PurchaseOrderLine’, 그 후 ‘Commodity’ SG API 설명서를 사용하여 확인할 수 있는 가져오기의 데이터 포인트. 예를 들어, ‘commodity code’ datapoint는 API 설명서에서 다음 경로를 사용하여 찾을 수 있습니다.

유사한 경로 찾기 방법을 사용하여 필요한 나머지 데이터 포인트를 구축할 수 있습니다.

Purchase Order Lines:

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

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

엔드포인트 설명

우리는 또한 ‘PurchaseOrderLine’ 기존 주문의 라인을 추가하거나 편집하기 위한 끝점. 이 끝점을 사용하여 구매 주문서를 추가할 수도 있지만 다음을 사용해야만 구매 주문서를 편집할 수 있습니다. ‘PurchaseOrder’ URI.

우리는 a의 예를 볼 수 있습니다 ‘PurcahseOrderLine’ 위에서 생성한 'PO-8471' 주문에 다른 주문 라인을 추가할 아래 JSON 파일:

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

그런 다음 제어 센터에서 방금 추가한 행과 함께 PO를 가져왔음을 확인할 수 있습니다.

5.2. JSON – 내보내기

V5 API에서 구매 주문 관련 파일을 다시 수신하는 것과 관련하여 메서드 요약을 확인하면 IntegrationExport 다음과 같은 몇 가지 다른 옵션이 있습니다.

Purchase Orders:

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

http://host:port/V5-API/api/integrate/export/purchase_orders

엔드포인트 설명

이 끝점은 구매 주문 데이터베이스 클래스를 사용하여 전체 구매 주문 JSON 파일을 내보내고 시스템에서 아직 내보낸 것으로 표시되지 않은 모든 구매 주문을 포함합니다. 여기에는 수신 데이터가 포함되지 않고 오히려 각 데이터 포인트에 대한 반환을 제공합니다. ‘PurchaseOrder’ 클래스입니다.

아래에서 이 유형의 예제 내보내기 시작을 볼 수 있습니다.

예제 JSON 파일을 다운로드할 수 있습니다. 여기에서 확인하세요.

Purchase Order:

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

http://host:port/V5-API/api/integrate/export/purchase_order/{ordernumber}

엔드포인트 설명

이 엔드포인트는 구매 주문 데이터베이스 클래스를 사용하여 전체 구매 주문 JSON 파일을 내보냅니다. 단, 지정된 주문에 대해서만 해당 주문이 시스템에서 아직 내보낸 것으로 표시되지 않은 경우에만 가능합니다. 위와 같이 여기에는 수신 데이터가 포함되지 않고 오히려 각 데이터 포인트에 대한 반환을 제공합니다. ‘PurchaseOrder’ 클래스입니다.

Purchase Order Logs:

엔드포인트/URI 내보내기 – http://host:port/V5-API/api/integrate/export/po_logs

엔드포인트 설명

이 끝점은 구매 주문 접수 중에 발생하는 이벤트와 관련된 구매 주문 로그 목록을 검색하는 데 사용할 수 있으며, 위 유형과 달리 수신한 항목, 수량, 저장 위치 등과 같은 정보를 검색하는 데 사용할 수 있습니다. 이것은 ‘SystemLog’ 시스템 설명자와 같은 추가 트랜잭션 데이터를 제공하는 데이터 클래스입니다. 엔드포인트는 이전에 내보낸 것으로 표시되지 않은 경우 완료된 주문에 대해서만 이 데이터를 제공합니다.

아래에서 이 유형의 예제 내보내기 시작을 볼 수 있습니다.

예제 JSON 파일을 다운로드할 수 있습니다. 여기에서 확인하세요.

Purchase Order Transactions:

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

http://host:port/V5-API/api/integrate/export/po_transactions

엔드포인트 설명

이 끝점은 다음과 같은 방식으로 작동합니다. ‘Purchase Order Logs’ 단, 이 엔드포인트는 아직 완료되지 않은 주문(즉, 진행 중인 주문)의 데이터도 제공합니다.

우리는 또한 트랜잭션 및 로그 엔드포인트 구매 주문서로 수령한 상품에 대한 더 많은 관련 정보를 검색합니다.

우리는 하나 트랜잭션/일반 여기서 사용할 수 있는 엔드포인트는 다음과 같습니다.

구매 거래

5.3. CSV – 가져오기

CSV 가져오기의 경우 일반적으로 ‘PurchaseOrderLine’ 단일 csv 파일을 사용하여 구매 주문 및 해당 라인 항목을 생성할 수 있습니다.

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

완료된 헤더 파일은 다음 위치에 있어야 합니다. “ \SG 제어 센터\게이트웨이\가져오기\column_defs”

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

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

헤더 파일:

헤더 파일은 일반적으로 CSV 통합이 발생하기 전에 SG Systems에서 컴파일하지만 아래에서 구매 주문에 사용할 수 있는 기본 예를 볼 수 있습니다.

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

CSV 가져오기 파일:

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

여기서 우리는 2개의 서로 다른 주문을 가져오고 있음을 알 수 있습니다. 하나는 2개의 품목이 있고 다른 하나는 1개입니다. 이 샘플 가져오기 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.

가져오기가 완료되면 해당 라인 항목과 함께 이러한 주문이 제어 센터에 추가된 것을 볼 수 있습니다. 가져오기에 '배치된 날짜' 데이터가 포함되지 않은 경우 배치된 날짜는 오늘 날짜를 참조합니다.

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’ 수준이지만 다음을 사용할 수도 있습니다. ‘Purchase Order ‘Purchase Order Line’ PO 번호, 구매한 상품, 보관 장소 등과 같이 당사가 필요로 하는 정보를 추가로 작성하기 위한 페이지입니다.

매우 기본적인 수준에서 구매 주문을 처리하는 시스템 로그 헤더 부분은 다음과 같을 수 있습니다.