구글시트 출고 자동화 방법: Apps Script 2편

const SHEET_INBOUND = 'INBOUND';      // → 입고 시트 이름
const SHEET_LOCATIONS = 'LOCATIONS';  // → 재고 시트 이름
const SHEET_OUTBOUND = 'OUTBOUND';    // → 출고 시트 이름
const SHEET_SETTINGS = 'SETTINGS';    // → 설정 시트 이름
const SHEET_FLOOR = 'FLOOR_MAP';      // → 로케이션 시트 이름

function getStockByLocation(location, model) {       // → 로케이션·모델 재고 조회
  const ss = SpreadsheetApp.getActive();            // → 현재 스프레드시트
  const sheet = ss.getSheetByName(SHEET_LOCATIONS); // → LOCATIONS 시트 선택
  const range = sheet.getDataRange();               // → 전체 데이터 범위
  const values = range.getValues();                 // → 2차원 배열로 읽기

  let total = 0;                                    // → 합계 변수

  for (let i = 1; i < values.length; i++) {         // → 헤더 제외 반복
    const row = values[i];                          // → 현재 행
    const rowLocation = row[0];                     // → A열: LOCATION
    const rowModel = row[1];                        // → B열: MODEL
    const qty = row[2];                             // → C열: QTY

    if (rowLocation === location && rowModel === model) { // → 조건 일치
      total += Number(qty) || 0;                    // → 수량 합산
    }
  }

  return total;                                     // → 현재 재고 반환
}

function testGetStock() {                            // → 편집기에서 실행할 테스트 함수
  const result = getStockByLocation('L-01', 'ABC123'); // → 본인 데이터에 맞게 수정
  Logger.log('현재고: ' + result);                    // → 실행 로그에 결과 출력
}

function savePicking(data) {                          // → 출고 저장 함수
  const location = String(data.location || '').trim();  // → 출고 로케이션
  const model    = String(data.model    || '').trim();  // → 출고 모델
  const orderNo  = String(data.orderNo  || '').trim();  // → 주문 번호
  const qty      = Number(data.qty);                    // → 출고 수량(숫자로 변환)

  if (!location || !model || !orderNo) {             // → 빈 값이 저장되는 사고 방지
    throw new Error('주문번호·로케이션·모델을 모두 입력해 주세요.');
  }
  if (!isFinite(qty) || qty <= 0) {                  // → 숫자가 아니거나 0 이하 차단
    throw new Error('출고 수량은 1 이상의 숫자여야 합니다.');
  }

  const lock = LockService.getScriptLock();          // → 동시 출고 충돌을 막는 잠금
  if (!lock.tryLock(10000)) {                        // → 최대 10초 대기
    throw new Error('다른 사용자가 처리 중입니다. 잠시 후 다시 시도해 주세요.');
  }

  try {                                              // → 잠금 안에서 읽기·쓰기를 함께 처리
    const ss = SpreadsheetApp.getActive();           // → 현재 스프레드시트
    const currentStock = getStockByLocation(location, model); // → 잠금 후 재고 조회

    if (qty > currentStock) {                        // → 재고 부족 검증
      throw new Error('재고가 부족합니다. 현재고: ' + currentStock);
    }

    const timestamp = new Date();                    // → 현재 시각
    ss.getSheetByName(SHEET_OUTBOUND).appendRow([    // → 출고 이력 추가
      orderNo,                                       // → 주문 번호
      location,                                      // → 로케이션
      model,                                         // → 모델
      qty,                                           // → 출고 수량
      timestamp                                      // → 시간
    ]);

    ss.getSheetByName(SHEET_LOCATIONS).appendRow([   // → 재고 차감 행 추가
      location,                                      // → 로케이션
      model,                                         // → 모델
      -qty,                                          // → 음수 수량
      'PICKING',                                     // → 입·출고 구분
      timestamp                                      // → 시간
    ]);

    SpreadsheetApp.flush();                          // → 시트에 즉시 반영

    return {                                         // → 결과 반환
      success: true,                                 // → 성공 여부
      remaining: currentStock - qty                  // → 출고 후 재고
    };
  } finally {
    lock.releaseLock();                              // → 성공·실패와 무관하게 잠금 해제
  }
}

<div id="picking-section">
  <h3>출고 처리</h3>

  <label>LOCATION</label>
  <input type="text" id="pickLocation">

  <label>MODEL</label>
  <input type="text" id="pickModel">

  <button type="button" onclick="onClickCheckStock()">현재고 조회</button>
  <div id="currentStockDisplay">현재고: -</div>

  <label>QTY</label>
  <input type="number" id="pickQty" min="1">

  <label>ORDER NO</label>
  <input type="text" id="pickOrderNo">

  <button type="button" onclick="onClickSavePicking()">출고 저장</button>
</div>

<script>
  function onClickCheckStock() {                                // → 현재고 조회 버튼
    const location = document.getElementById('pickLocation').value;
    const model = document.getElementById('pickModel').value;

    google.script.run
      .withSuccessHandler(function(stock) {                     // → 성공 시
        document.getElementById('currentStockDisplay').innerText =
          '현재고: ' + stock;                                   // → 표시 갱신
      })
      .withFailureHandler(function(err) {                       // → 실패 시
        alert('현재고 조회 오류: ' + err.message);              // → 안내
      })
      .getStockByLocation(location, model);                     // → Apps Script 호출
  }

  function onClickSavePicking() {                               // → 출고 저장 버튼
    const location = document.getElementById('pickLocation').value;
    const model = document.getElementById('pickModel').value;
    const qty = document.getElementById('pickQty').value;
    const orderNo = document.getElementById('pickOrderNo').value;

    const data = {                                              // → 전달 데이터
      location: location,
      model: model,
      qty: qty,
      orderNo: orderNo
    };

    google.script.run
      .withSuccessHandler(function(result) {                    // → 성공 시
        alert('출고가 저장되었습니다. 남은 재고: ' + result.remaining);
        document.getElementById('currentStockDisplay').innerText =
          '현재고: ' + result.remaining;                        // → 화면 재고 갱신
      })
      .withFailureHandler(function(err) {                       // → 실패 시
        alert('출고 중 오류: ' + err.message);                 // → 오류 안내
      })
      .savePicking(data);                                       // → Apps Script 호출
  }
</script>