S04 — 구매 Procure-to-Pay
학습 목표
- 업무 문서를 상태머신으로 설계한다.
- 분할입고에서 재고·발주잔량·회계 세 장부를 원자적으로 갱신한다.
1. 상태머신
DRAFT ──approve──▶ APPROVED ──receive(일부)──▶ PARTIAL ──receive(잔량)──▶ RECEIVED
└──────cancel───────┴──▶ CANCELLED (입고 이력 없을 때만)규칙은 "어떤 상태에서 어떤 행동이 허용되는가"입니다. 허용되지 않으면 상태를 바꾸지 말고 오류. 실무 ERP 버그의 큰 비중이 "승인 안 된 발주가 입고됐다", "취소된 문서에 입고됐다" 같은 상태 위반입니다.
2. 입고 한 번에 일어나는 일
for 각 입고 품목:
재고 +수량, +금액(발주단가) ← S03 post_move
po_lines.received_qty += 수량
분개: (차)1300 상품 공급가액 + (차)1400 부가세대급금 / (대)2100 외상매입금 합계 ← S02
발주 상태: 잔량 0 → RECEIVED, 아니면 PARTIAL중간 품목에서 "잔량 초과"가 나면 앞 품목의 재고 증가까지 모두 취소돼야 합니다 → 전체를 transaction으로.
3. LAB (workspace/erp/purchasing.py)
| 함수 | 요점 |
|---|---|
create_po | 공급사 확인(require_partner(...,'SUPPLIER')), 품목·수량·단가 검증 후 헤더+라인 |
approve_po | DRAFT만, approved_by 기록 |
receive_po | 상태·창고·품목·잔량 검증, 이동+잔량+분개+상태, 부가세 0이면 1400 줄 생략 |
cancel_po | DRAFT/APPROVED + 입고 0일 때만 |
4. 채점
python academy.py check S045. 심화 과제
- 매입 송장(Invoice)과 3-way match(발주·입고·송장 수량/단가 일치)를 구현하세요.
- 공급사 대금 지급
pay_supplier(code, amount): (차)2100 / (대)1100, 외상매입금보다 많이 지급 금지.