판매 주문
V5 통합 가이드!
V5 Traceability와 고객의 ERP 시스템 간의 판매 주문(SO)을 통합하면 주문 세부 정보, 주문 라인 항목 및 일정 정보를 V5 Traceability로 보낼 수 있습니다. V5는 이 경우 데이터 마스터 역할을 할 수도 있으며 시스템 내에서 생성된 주문을 ERP로 보낼 수도 있습니다.
이러한 주문은 V5 WMS 소프트웨어를 통해 수신될 수 있으며, 그 후 선택 및 배송 수량, 위치, 컨테이너/팔레트 할당과 같은 정보를 ERP로 다시 보낼 수 있습니다.
V5 Traceability의 판매 주문 모듈 작동 방식에 대한 자세한 내용은 모듈 가이드를 참조하세요. 여기에서 확인하세요.
차례
1. 컨트롤 센터 레이아웃
우리가 어떻게 관계를 맺을 수 있는지에 관해서 ‘Sales Orders’ ‘Sales Order Lines’ 제어 센터에서 볼 수 있듯이 여기 상단 패널은 고객, 주문 및 배송 날짜, 외부 참조 번호 등을 모두 가져올 수 있는 판매 주문용임을 알 수 있습니다.
아래쪽 패널에는 판매 주문 라인을 추가할 수 있으며, 주문 라인 항목의 상품, 수량 및 비용과 관련된 데이터가 들어 있습니다.
V5 Gateway를 사용하면 두 패널을 별도로 또는 함께 쉽게 채울 수 있습니다.
오른쪽 아래 패널에는 SO가 처리될 때 SO의 항목이 선택되는 위치와 관련된 데이터가 포함됩니다. 이 데이터는 V5 Gateway에서 다시 받을 수 있는 내보낸 데이터의 일부를 구성합니다.
2. API 링크
3. 통합 템플릿
판매 주문에 대한 통합 템플릿을 다운로드할 수 있습니다. 여기에서 확인하세요.
4. 판매주문 현장가이드
4.1. 기본 키
기본 키는 V5 API 내의 각 테이블에 대한 고유 식별자입니다. 을 위한 SalesOrders, 이것은:
salesOrder.orderNumber – SO 번호.
럭셔리 SalesOrderLines, 기본 키는 중:
salesOrder.orderNumber + commodity.code – 주문할 상품과 함께 SO 번호
or
lineID – 동일한 상품이 여러 줄에 나타날 수 있는 고급 목적을 위해 주문 번호와 상품 코드 대신 라인 ID를 고유 식별자로 지정할 수 있습니다. 동일한 상품이 1라인 이상 주문된 경우 필수입니다.
4.2. 필수 입력 사항
유효한 항목을 채우기 위해 SG에서 요구하는 기타 필드 ‘SalesOrderLine’ 제어 센터에는 다음이 있습니다.
quantity – 판매되는 해당 상품/제품의 수량.
4.3. 선호 분야
기본 필드는 판매 주문에 더 많은 데이터를 추가하는 역할을 하며, 필수는 아니지만 V5 추적성 내 기능과 관련하여 유용합니다. 사용하는 경우 ‘SalesOrderLine’ 우리가 이상적으로 추가할 엔드포인트는 다음과 같습니다.
lineID - 위의 기본 키로 사용되지 않는 경우 이 필드가 포함되어야 합니다.
commodity.code – 위의 기본 키로 사용되지 않는 경우 이 필드가 포함되어야 합니다.
salesOrder.orderNumber – 위의 기본 키로 사용되지 않는 경우 이 필드가 포함되어야 합니다.
salesOrder.customer.code – 고객을 식별하는 데 사용되는 고유 코드입니다.
salesOrder.placedDate - 주문한 날짜.
salesOrder.deliveryDate – 주문의 예상 배송일.
이 지점 중 마지막 4개 지점에 대해서는 ‘SalesOrder’ 수업에서 ‘SalesOrderLine’. 대신에 ‘SalesOrder’ 간단히 제거할 수 있는 클래스 ‘salesOrder’ 위의 4개 항목 중에서.
4.4. 추가 필드
다음과 같은 추가 필드도 포함될 수 있습니다. ‘SalesOrderLine’:
salesOrder.referenceNumber – SO와 관련된 추가 메모/참조.
5. 방법론
의 성격을 감안할 때 ‘SalesOrder’ ‘SalesOrderLine’, 다음과 같은 몇 가지 방법으로 데이터를 가져오고 관리하도록 선택할 수 있습니다.
- 우리는 사용할 수 있습니다 ‘SalesOrder’ 판매 주문을 가져오기 위한 끝점을 지정한 다음 아래에서 볼 수 있듯이 ‘SalesOrderLine’ 클래스를 사용하여 구성요소 품목 항목을 모두 하나의 파일에 포함합니다. 이는 헤더 정보 1세트와 후속 품목 항목만 필요하므로 전체 주문을 가져오는 가장 논리적인 방법입니다. 이는 판매 주문에 대한 헤더 정보를 수정하는 데 사용할 수 있는 유일한 끝점이기도 합니다.
- 우리는 사용할 수 있습니다 ‘SalesOrderLine’ 주문이 생성되면 라인을 수정하거나 추가할 수 있는 엔드포인트입니다. 전체 주문을 가져오는 데 계속 사용할 수 있지만 각 주문 개별 항목에 판매 주문 헤더(예: 주문 번호)에 대한 중첩된 참조가 포함되어야 하므로 효율성이 떨어집니다. 위에 표시된 대로 이 끝점은 주문 헤더 정보(주문 번호/배송 날짜 등)를 변경하는 데 사용할 수 없습니다.
5.1. JSON – 가져오기
판매 주문:
‘SalesOrder’ 끝점/URI 가져오기 –
http://host:port/V5-API/api/integrate/import/sales
이 샘플 가져오기의 경우 ‘SalesOrder’ 끝점 및 기본 가져오기 파일을 구조화하면 다음과 같이 표시될 수 있습니다.
이 샘플 JSON 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.
우리는 왜 우리가 ‘SalesOrder’ 중첩된 데이터를 보유할 수 있는 JSON 파일의 기능이 주어지면 이 형식의 끝점을 통해 들여쓰기를 포함할 수 있습니다. ‘SalesOrderLine’ 목록을 작성하고 그 이후에 ‘Commodity’ SG API 설명서를 사용하여 확인할 수 있는 가져오기의 데이터 포인트. 예를 들어, ‘commodity code’ datapoint는 API 설명서에서 다음 경로를 사용하여 찾을 수 있습니다.
유사한 경로 찾기 방법을 사용하여 필요한 나머지 데이터 포인트를 구축할 수 있습니다.
판매 주문 라인:
‘SalesOrderLine’ 끝점/URI 가져오기 –
http://host:port/V5-API/api/integrate/import/sales_line
우리는 또한 ‘SalesOrderLine’ 기존 주문의 라인을 추가하거나 편집하는 엔드포인트입니다. 이 끝점을 사용하여 판매 주문을 추가할 수도 있지만 판매 주문 헤더는 다음을 통해서만 편집할 수 있다는 점을 기억하는 것이 중요합니다. ‘SalesOrder’ URI. 또한 SO 정보는 각 SO 라인에 대해 여기에 중첩되어야 합니다.
우리는 a의 예를 볼 수 있습니다 ‘SalesOrderLine’ 아래 JSON 파일, 주문할 또 다른 주문 라인을 추가합니다. ‘SO-8471’ 위에서 만든 것:
이 샘플 JSON 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.
그런 다음 제어 센터에서 방금 추가한 추가 라인과 함께 주문을 가져온 것을 확인할 수 있습니다. 배치/배송 날짜 및 참조 번호와 같은 정보는 원본에서 가져왔습니다. ‘SalesOrder’ 파일.
5.2. JSON – 내보내기
V5 API로부터 판매주문 관련 파일을 다시 받는 경우, '' 아래 메소드 요약을 확인하면통합내보내기' 서비스를 선택하면 여기에 몇 가지 다른 옵션이 있습니다.
판매 주문:
엔드포인트/URI 내보내기 –
http://host:port/V5-API/api/integrate/export/sales_orders
이 엔드포인트는 판매 주문 데이터베이스 클래스를 사용하여 전체 판매 주문 JSON 파일을 내보내고 시스템에서 아직 내보낸 것으로 표시되지 않은 모든 판매 주문을 포함합니다. 이는 다음의 각 데이터 포인트에 대한 반환을 제공합니다. ‘SalesOrder’ 클래스 및 배송된 품목에 대한 피킹 정보도 포함됩니다.
이 유형의 예제 JSON 파일을 다운로드할 수 있습니다. 여기에서 확인하세요.
판매 주문:
엔드포인트/URI 내보내기 –
http://host:port/V5-API/api/integrate/export/sales_order/{ordernumber}
이 엔드포인트는 판매 주문 데이터베이스 클래스를 사용하여 전체 판매 주문 JSON 파일을 내보냅니다. 단, 지정된 주문에 대해서만 그리고 이 주문이 아직 시스템에서 내보낸 것으로 표시되지 않은 경우에만 해당됩니다. 위와 같이 이는 다음의 각 데이터 포인트에 대한 반환을 제공합니다. ‘SalesOrder’ 클래스 및 배송된 품목에 대한 피킹 정보도 포함됩니다.
아래에서 이 유형의 예제 내보내기 시작을 볼 수 있습니다.
이 예제 JSON 파일을 다운로드할 수 있습니다. 여기에서 확인하세요.
판매 주문 로그:
엔드포인트/URI 내보내기 –
http://host:port/V5-API/api/integrate/export/sales_logs
이 엔드포인트는 판매 주문 배송 중에 발생하는 이벤트와 관련된 판매 주문 로그 목록을 검색하는 데 사용할 수 있습니다. 이는 다음을 활용합니다. ‘SystemLog’ 시스템 설명자와 같은 트랜잭션 데이터를 제공하는 데이터 클래스입니다. 엔드포인트는 내보낸 것으로 표시되지 않은 완료된 주문에 대해서만 이 데이터를 제공합니다.
이 유형의 예제 JSON 파일을 다운로드할 수 있습니다. 여기에서 확인하세요.
판매 주문 로그:
엔드포인트/URI 내보내기 –
http://host:port/V5-API/api/integrate/export/sales_log/{id}
이 엔드포인트는 위의 '판매 주문 로그'와 동일한 방식으로 작동하지만 V5 시스템에서 정의한 대로 특정 로그 번호에 대한 정보를 반환하는 데 사용될 수 있습니다. 이전과 마찬가지로 이것은 ‘SystemLog’ 시스템 설명자와 같은 트랜잭션 데이터를 제공하는 데이터 클래스입니다. 엔드포인트는 이미 내보낸 것으로 표시되지 않은 완료된 주문의 로그에 대해서만 이 데이터를 제공합니다.
아래에서 이 유형의 예제 내보내기 시작을 볼 수 있습니다.
우리는 또한 트랜잭션 및 로그 엔드포인트 판매 주문으로 판매된 상품 및 제품에 대한 보다 관련성 높은 정보를 검색합니다.
우리는 하나 트랜잭션/일반 여기서 사용할 수 있는 엔드포인트는 다음과 같습니다.
5.3. CSV – 가져오기
CSV 가져오기의 경우 일반적으로 ‘SalesOrderLine’ 단일 csv 가져오기를 사용하여 판매 주문과 해당 품목을 생성할 수 있습니다.
헤더/열 정의 파일 이름: “salesOrderLine.csvh”
완료된 헤더 파일은 다음 위치에 있어야 합니다. “<installdir>\SG Control Center\gateway\import\column_defs”
CSV 파일 이름 가져오기: “salesOrderLine-datetime.csv”
가져올 CSV는 다음 위치에 있어야 합니다. “<installdir>\SG Control Center\gateway\import”
헤더 파일:
헤더 파일은 일반적으로 CSV 통합이 이루어지기 전에 SG Systems에서 컴파일되지만 아래에서는 판매 주문에 사용할 수 있는 기본 예를 볼 수 있습니다.
이러한 파일을 구성하는 방법에 대한 자세한 내용은 다음을 참조하십시오. 기본 통합 페이지. 이 샘플 헤더 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.
CSV 가져오기 파일:
그런 다음 헤더에서 정의된 데이터 요소 순서를 사용하여 가져오기 파일을 구조화할 수 있습니다. SG Systems는 이를 위한 템플릿 파일을 제공하여 목록을 채울 때 항목을 더 명확하게 하기 위해 각 열에 대한 데이터 포인트를 나열할 수 있습니다. 이 첫 번째 행은 제어 센터에서 무시할 수 있으므로 가져오기를 위해 제출할 때 파일에 보관할 수 있습니다.
여기서 우리는 JSON 방법론을 사용하여 생성한 것과 유사한 주문을 생성하는 것을 목표로 하고 있음을 알 수 있습니다. 이 샘플 가져오기 파일을 다운로드할 수 있습니다. 여기에서 확인하세요.
가져오기가 완료되면 필수 품목과 함께 이 주문이 제어 센터에 추가된 것을 확인할 수 있습니다. 다음과 같은 경우 ‘Date Placed’ 데이터가 가져오기에 포함되지 않으면 배치된 날짜는 오늘 날짜를 참조합니다.
5.4. CSV – 내보내기
이 방법을 통해 판매 주문 정보를 내보내려는 경우 이는 ‘SalesLog’ 내보내다. 이 끝점에 대한 클래스 정의를 볼 수 있습니다. 여기에서 확인하세요.
헤더/열 정의 파일 이름: “SalesLog.csvh”
완료된 헤더 파일은 다음 위치에 있어야 합니다. “<installdir>\SG Control Center\gateway\export\order”
내보내기 CSV 파일 이름: “SalesLog-datetime.csv”
내보내기용 CSV는 다음에서 생성됩니다. “<installdir>\SG Control Center\gateway\export”
이 내보내기는 제어 센터의 게이트웨이 섹션에서도 활성화되어야 합니다. 이것은 단지 확인하는 경우 일 것입니다 ‘Sales Order’ 상자를 클릭하고 설정을 적용하고 제어 센터를 다시 시작하십시오.
헤더 파일:
다음과 같은 데이터 포인트를 사용할 수 있습니다. ‘user’, ‘timestamp’ ‘quantity’ 이 위에 ‘Sales Log’, 수준이지만 판매 주문 및 판매 주문 라인 페이지를 사용하여 주문 번호, 판매된 품목, 해당 품목이 선택된 위치 등 필요한 정보를 추가로 구성할 수도 있습니다. 여기서는 ‘SalesOrder’ 클래스는 다음을 통해 액세스해야 합니다. ‘Line’ 클래스는 아래 예시와 같이
매우 기본적인 수준에서 우리의 역할은 ‘Sales Log’ 판매 주문을 처리하는 헤더는 다음과 같습니다.
이 샘플 헤더 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.
CSV 내보내기 파일:
헤더가 제자리에 있고 내보내기가 활성화되면 다음과 같은 이 주문(이전에 내보내지 않은 다른 주문과 함께)에 대한 반환 파일을 받게 됩니다.
이 샘플 내보내기 파일은 다운로드할 수 있습니다. 여기에서 확인하세요.
