@@ -201,6 +201,10 @@
data-url="/inout/orders/{{ order.id }}/receipts/{{ r.id }}/mail" data-title="입고 요청 메일 · {{ ymd(r.receipt_date) }} 입고 {{ n(r.total) }}개">
{% if r.mails %}다시 보내기{% else %}보내기{% endif %}
{% elif not r.mails %}-{% endif %}
+ {% if perms.can_order or perms.can_receive %}
+ 사방넷 입고 파일
+ {% endif %}
{% if photo_admin %}
| {% endblock %}
+{% block head_extra %}{% endblock %}
{% block content %}
diff --git a/app/modules/inout/templates/inout/pending.html b/app/modules/inout/templates/inout/pending.html
index 833d28b..70e5cea 100644
--- a/app/modules/inout/templates/inout/pending.html
+++ b/app/modules/inout/templates/inout/pending.html
@@ -1,6 +1,6 @@
{% extends "erp_base.html" %}
{% from "inout/_macros.html" import due, n, ymd %}
-{% block head_extra %}{% endblock %}
+{% block head_extra %}{% endblock %}
{% block content %}
diff --git a/app/static/inout.css b/app/static/inout.css
index 2fe1088..c081803 100644
--- a/app/static/inout.css
+++ b/app/static/inout.css
@@ -294,3 +294,4 @@
.io-logi-field { display: grid; gap: 4px; }
.io-logi-field > span { font-weight: 600; }
.io-logi-field small { font-weight: 400; color: var(--color-midtone-gray, #777); }
+.io-rmail-cell .io-sabang-btn { margin-top: 4px; display: inline-flex; }
diff --git a/docs/INOUT_MODULE.md b/docs/INOUT_MODULE.md
index f92687e..69058e6 100644
--- a/docs/INOUT_MODULE.md
+++ b/docs/INOUT_MODULE.md
@@ -182,6 +182,15 @@ cupang·malaysia 와 같은 DSN). 화면에서 코드·이름으로 검색(`GET
- **권한**: 미리보기·발송 = 입고 담당(관리자 포함). 발주 담당만인 사람은 403.
- **005 미적용**: 미리보기·발송은 되고(받는 사람은 직접 입력, 참조는 기본값), 보낸 기록·옵션 저장만 안 됨(창에 안내).
+## 6-5. 사방넷 입고 파일(2026-10-19, 마이그레이션 없음)
+
+- 입고 기록 표 **입고 요청 메일 · 사방넷** 칸의 **[사방넷 입고 파일]**(발주 담당·입고 담당) → 그 입고 1건의 엑셀(`GET …/receipts/{rid}/sabangnet.xlsx`).
+- 시트 1행 = 제목 **상품코드 · 가용수량 · 불용수량**(굵게·회색 바탕), 2행부터 입고 품목마다
+ A = 코드표(itemcode_db `single_items.sabangnet_code`, `itemcode.SingleItemReader.sabangnet_codes`) 사방넷 코드,
+ B = 입고 수량, **C = 상품 이름**(사용자 요청 — 불용수량 칸이지만 수량이 아니라 이름). A·C 는 글자 서식(`@`, 앞자리 0 보존), 열 너비는 내용 길이로.
+- 사방넷 코드가 빈 단품이 하나라도 있으면 파일을 만들지 않고 발주서로 돌아가 "코드표에 사방넷 코드가 없는 상품: …"(빈 상품코드로 사방넷에 올리는 실수 방지),
+ 코드표 연결이 안 되면 그 이유를 안내. 파일 이름 `사방넷_입고_YYYYMMDD_{발주번호}.xlsx`(입고일). `store.sabangnet_rows·sabangnet_xlsx·sabangnet_filename`.
+
## 7. 테스트
```bash
diff --git a/tests/test_inout_receipt_mail.py b/tests/test_inout_receipt_mail.py
index 7202d95..eeb216d 100644
--- a/tests/test_inout_receipt_mail.py
+++ b/tests/test_inout_receipt_mail.py
@@ -228,3 +228,73 @@ class ReceiptMailApiTests(unittest.TestCase):
if __name__ == "__main__":
unittest.main()
+
+
+class SabangnetFileTests(unittest.TestCase):
+ """사방넷 입고 파일 — 1행 제목 상품코드·가용수량·불용수량, A=사방넷 코드, B=입고 수량, C=상품 이름."""
+
+ def test_rows_and_xlsx(self):
+ from openpyxl import load_workbook
+
+ rows, missing = s.sabangnet_rows(_receipt(), {"MW-0320": "0012345", "MW-0950": "SB-950"})
+ self.assertEqual(missing, [])
+ self.assertEqual(rows, [["0012345", 2000, "미라클 통 황토 320ml"], ["SB-950", 500, "950ml"]])
+ ws = load_workbook(io.BytesIO(s.sabangnet_xlsx(rows))).active
+ got = [[c.value for c in r] for r in ws.iter_rows()]
+ self.assertEqual(got[0], ["상품코드", "가용수량", "불용수량"])
+ self.assertEqual(got[1:], [["0012345", 2000, "미라클 통 황토 320ml"], ["SB-950", 500, "950ml"]]) # 앞자리 0 보존
+ self.assertEqual(ws["A2"].number_format, "@")
+ _rows, missing = s.sabangnet_rows(_receipt(), {"MW-0320": "0012345", "MW-0950": ""})
+ self.assertEqual(missing, ["MW-0950 950ml"])
+ self.assertEqual(s.sabangnet_filename(_order(), _receipt()), "사방넷_입고_20261019_PO-261019-01.xlsx")
+
+
+class SabangnetApiTests(ReceiptMailApiTests):
+ def setUp(self):
+ super().setUp()
+ p = patch.object(self.api, "_page_user", lambda request: self.user)
+ p.start()
+ self.addCleanup(p.stop)
+
+ class Reader:
+ enabled, reason, last_error = True, "", ""
+ codes = {"MW-0320": "0012345", "MW-0950": "SB-950"}
+
+ def sabangnet_codes(self, codes):
+ return None if self.codes is None else {c.upper(): self.codes.get(c.upper(), "") for c in codes}
+
+ self.reader = Reader()
+ self.c.app.state.inout_items = self.reader
+
+ def test_download(self):
+ from urllib.parse import unquote
+
+ from openpyxl import load_workbook
+
+ r = self.c.get("/inout/orders/7/receipts/3/sabangnet.xlsx", follow_redirects=False)
+ self.assertEqual(r.status_code, 200, r.text[:200])
+ self.assertIn("spreadsheetml", r.headers["content-type"])
+ self.assertIn("사방넷_입고_20261019_PO-261019-01.xlsx", unquote(r.headers["content-disposition"]))
+ ws = load_workbook(io.BytesIO(r.content)).active
+ self.assertEqual([[c.value for c in row] for row in ws.iter_rows()],
+ [["상품코드", "가용수량", "불용수량"], ["0012345", 2000, "미라클 통 황토 320ml"], ["SB-950", 500, "950ml"]])
+
+ def test_missing_code_or_reader_down_redirects_with_message(self):
+ from urllib.parse import unquote_plus as unquote
+
+ self.reader.codes = {"MW-0320": "0012345"}
+ r = self.c.get("/inout/orders/7/receipts/3/sabangnet.xlsx", follow_redirects=False)
+ self.assertEqual(r.status_code, 303)
+ self.assertIn("사방넷 코드가 없는 상품", unquote(r.headers["location"])) and self.assertIn("MW-0950", r.headers["location"])
+ self.reader.codes = None
+ r = self.c.get("/inout/orders/7/receipts/3/sabangnet.xlsx", follow_redirects=False)
+ self.assertIn("코드표(itemcode_db)를 읽지 못해", unquote(r.headers["location"]))
+ self.assertEqual(self.c.get("/inout/orders/7/receipts/99/sabangnet.xlsx").status_code, 404)
+
+ def test_viewer_cannot_download(self):
+ self.st.roles_of = lambda email: set()
+ self.assertEqual(self.c.get("/inout/orders/7/receipts/3/sabangnet.xlsx").status_code, 403)
+
+ # 부모 클래스 테스트를 여기서 다시 돌리지 않는다
+ test_preview_defaults_and_photos_inline = test_send_records_and_resend_guard = None
+ test_order_role_cannot_send_receipt_mail = test_receive_role_may_connect_gmail = None
|