From 9ce6a897a85c757523ebaf7c045cdfe2812c8b06 Mon Sep 17 00:00:00 2001 From: aweso Date: Fri, 9 Jan 2026 09:55:16 +0900 Subject: [PATCH] =?UTF-8?q?=EB=B0=94=EB=A1=9C=EB=B9=8C=20=EA=B8=B0?= =?UTF-8?q?=ED=9A=8D=EC=84=9C=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit πŸ€– Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 --- barobill/index.php | 1496 ++++++++++++++++++++++++++++++++++++++++++ barobill/planning.md | 64 ++ index.php | 3 + 3 files changed, 1563 insertions(+) create mode 100644 barobill/index.php create mode 100644 barobill/planning.md diff --git a/barobill/index.php b/barobill/index.php new file mode 100644 index 0000000..2e189f4 --- /dev/null +++ b/barobill/index.php @@ -0,0 +1,1496 @@ + + + + + + λ°”λ‘œλΉŒ API νšŒκ³„ μ†”λ£¨μ…˜ + + + + + + +
+
+
+
+ + 🏠 + +

λ°”λ‘œλΉŒ API νšŒκ³„ μ†”λ£¨μ…˜

+
+ +
+
+
+ + + + +
+ + + +
+ +
+

+ πŸ“‹ ν”„λ‘œμ νŠΈ κ°œμš” +

+

λ°”λ‘œλΉŒ(Barobill) APIλ₯Ό ν™œμš©ν•œ λ©€ν‹°ν…Œλ„Œμ‹œ ν™˜κ²½μ˜ νšŒκ³„ μžλ™ν™” μ‹œμŠ€ν…œ

+
+
+
🏒
+

νšŒμ›μ‚¬ 관리

+

API 기반 κ°€μž… 및 관리

+
+
+
πŸ”
+

μΈμ¦μ„œ 연동

+

κ³΅μΈμΈμ¦μ„œ ν”ŒλŸ¬κ·ΈμΈ

+
+
+
πŸ“„
+

μ „μžμ„ΈκΈˆκ³„μ‚°μ„œ

+

λ°œν–‰ 및 관리

+
+
+
πŸ’³
+

금육 데이터

+

μΉ΄λ“œ/κ³„μ’Œ μ‹€μ‹œκ°„ 쑰회

+
+
+
+ + +
+

+ πŸ”„ 톡합 μ›Œν¬ν”Œλ‘œμš° +

+
+

+ 1 + νšŒμ› μ˜¨λ³΄λ”© ν”„λ‘œμ„ΈμŠ€ +

+
+
+
+ πŸ“ + νšŒμ› κ°€μž… +
+

μ‚¬μ—…μž 정보 μž…λ ₯ β†’ RegistCorp API β†’ 연동킀 λ°œκΈ‰

+
+ +
+
+ πŸ”‘ + μΈμ¦μ„œ 등둝 +
+

ν”ŒλŸ¬κ·ΈμΈ 호좜 β†’ μΈμ¦μ„œ 선택 β†’ λ³΄μ•ˆ μ„œλ²„ 전솑

+
+ +
+
+ βœ… + 연동 확인 +
+

등둝 μ™„λ£Œ β†’ μƒνƒœ 'ν™œμ„±(Active)' λ³€κ²½

+
+
+
+
+

+ 2 + μ„œλΉ„μŠ€ 이용 ν”„λ‘œμ„ΈμŠ€ +

+
+
+
+ πŸ“„ + μ „μžμ„ΈκΈˆκ³„μ‚°μ„œ +
+

맀좜 데이터 β†’ RegistTaxInvoice β†’ κ΅­μ„Έμ²­ 전솑

+
+
+
+ πŸ’³ + μΉ΄λ“œ λ‚΄μ—­ +
+

μΉ΄λ“œ 등둝 β†’ GetCardLog β†’ μ§€μΆœ λ‚΄μ—­ μŠ€ν¬λž˜ν•‘

+
+
+
+ 🏦 + κ³„μ’Œ λ‚΄μ—­ +
+

κ³„μ’Œ μ—°κ²° β†’ GetBankAccountLog β†’ μž…μΆœκΈˆ 동기화

+
+
+
+
+ + +
+

+ πŸ—‚οΈ 메뉴 ꡬ쑰도 +

+
+
+
+ πŸ“Š λŒ€μ‹œλ³΄λ“œ +
+
    +
  • + + νšŒκ³„ μš”μ•½ +
    • +
  • + + μ•Œλ¦Ό +
    • +
+
+
+
+ πŸ’° 맀좜/λ§€μž… 관리 +
+
    +
  • + + μ „μžμ„ΈκΈˆκ³„μ‚°μ„œ λ°œν–‰/λͺ©λ‘ +
    • +
  • + + μΉ΄λ“œ 이용 λ‚΄μ—­ +
    • +
  • + + κ³„μ’Œ 거래 λ‚΄μ—­ +
    • +
+
+
+
+ βš™οΈ μ„€μ • 및 연동 +
+
    +
  • + + νšŒμ‚¬ 정보 관리 +
    • +
  • + + λ°”λ‘œλΉŒ 연동 μ„€μ • +
    • +
  • + + μ‚¬μš©μž κΆŒν•œ μ„€μ • +
    • +
+
+
+
+ + +
+

+ πŸ›‘οΈ λ©€ν‹°ν…Œλ„Œμ‹œ 데이터 관리 +

+
+
+

+ πŸ”’ 데이터 격리 +

+
    +
  • + β€’ + λͺ¨λ“  ν…Œμ΄λΈ”μ— TenantID λΆ€μ—¬ +
    • +
  • + β€’ + νšŒμ›μ‚¬ κ°„ 데이터 ν˜Όμ„  방지 +
    • +
  • + β€’ + ν…Œλ„ŒνŠΈλ³„ 고유 연동킀 동적 맀핑 +
    • +
+
+
+

+ ⚠️ λ³΄μ•ˆ 및 μ˜ˆμ™Έ 처리 +

+
    +
  • + β€’ + HTTPS 톡신 및 토큰 기반 λ³΄μ•ˆ +
    • +
  • + β€’ + μΈμ¦μ„œ 만료/API ν•œλ„ 초과 μ•Œλ¦Ό +
    • +
  • + β€’ + API μš”μ²­/응닡 둜그 기둝 +
    • +
+
+
+
+
+ + + + +
+ +
+
+

+ πŸ”— λ°”λ‘œλΉŒ API 연동 μ„œλΉ„μŠ€ +

+ + κ°œλ°œμžμ„Όν„° λ°”λ‘œκ°€κΈ° β†’ + +
+

+ λ°”λ‘œλΉŒ κ°œλ°œμžμ„Όν„°λŠ” μ „μžμ„ΈκΈˆκ³„μ‚°μ„œ, μΉ΄λ“œ/κ³„μ’Œ 쑰회, ν™ˆνƒμŠ€ λ§€μž…λ§€μΆœ 연동 λ“± B2B API μ„œλΉ„μŠ€λ₯Ό μ œκ³΅ν•©λ‹ˆλ‹€. + Java, Python, PHP, .NET, Node.js λ“± HTTP 톡신이 κ°€λŠ₯ν•œ λͺ¨λ“  κ°œλ°œμ–Έμ–΄λ₯Ό μ§€μ›ν•©λ‹ˆλ‹€. +

+
+
+
πŸ“„
+
μ „μžμ„ΈκΈˆκ³„μ‚°μ„œ
+
+
+
πŸ’³
+
μΉ΄λ“œ μ‚¬μš©λ‚΄μ—­
+
+
+
🏦
+
κ³„μ’Œ μž…μΆœκΈˆ
+
+
+
πŸ“Š
+
ν™ˆνƒμŠ€ 연동
+
+
+
+ + +
+

+ πŸ“„ μ „μžμ„ΈκΈˆκ³„μ‚°μ„œ API +

+ + +
+

λ°œκΈ‰ μœ ν˜•

+
+
+
+ μ • + μ •λ°œν–‰ +
+

κ³΅κΈ‰μžκ°€ μ„ΈκΈˆκ³„μ‚°μ„œ μž‘μ„± ν›„ μΈμ¦μ„œλ‘œ μ „μžμ„œλͺ…ν•˜μ—¬ λ°œκΈ‰ν•˜κ³ , κ³΅κΈ‰λ°›λŠ”μžμ—κ²Œ μ΄λ©”μΌλ‘œ λ°œμ†‘

+
+
+
+ μ—­ + μ—­λ°œν–‰ +
+

κ³΅κΈ‰λ°›λŠ”μžκ°€ μ„ΈκΈˆκ³„μ‚°μ„œ μž‘μ„± ν›„ κ³΅κΈ‰μžμ—κ²Œ λ°œκΈ‰ μš”μ²­, κ³΅κΈ‰μžκ°€ 확인 ν›„ μ „μžμ„œλͺ…ν•˜μ—¬ λ°œκΈ‰

+
+
+
+ μœ„ + μœ„μˆ˜νƒλ°œν–‰ +
+

κ³΅κΈ‰μž(μœ„νƒμž)λ₯Ό λŒ€μ‹ ν•˜μ—¬ μˆ˜νƒμžκ°€ μ„ΈκΈˆκ³„μ‚°μ„œλ₯Ό μž‘μ„± 및 λ°œκΈ‰(μ „μžμ„œλͺ…)

+
+
+
+ + +
+

μ£Όμš” API λ©”μ†Œλ“œ

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
λ©”μ†Œλ“œλͺ…κΈ°λŠ₯λΉ„κ³ 
RegistTaxInvoiceμ„ΈκΈˆκ³„μ‚°μ„œ μž„μ‹œμ €μž₯λ°œκΈ‰ μ „ 데이터 μ €μž₯
IssueTaxInvoiceExμ„ΈκΈˆκ³„μ‚°μ„œ λ°œκΈ‰λ¬Έμž, μ²¨λΆ€νŒŒμΌ 지원
GetTaxInvoiceNKμ„ΈκΈˆκ³„μ‚°μ„œ λ‚΄μš© μ‘°νšŒκ΅­μ„Έμ²­μŠΉμΈλ²ˆν˜Έ μ‚¬μš©
GetTaxInvoiceStatesIKμ„ΈκΈˆκ³„μ‚°μ„œ μƒνƒœ μ‘°νšŒμ΅œλŒ€ 100건
GetTaxInvoiceSalesList맀좜 μ„ΈκΈˆκ³„μ‚°μ„œ λͺ©λ‘ μ‘°νšŒκ΅­μ„Έμ²­ μ „μ†‘μ™„λ£Œ 건
GetTaxInvoicePurchaseListλ§€μž… μ„ΈκΈˆκ³„μ‚°μ„œ λͺ©λ‘ μ‘°νšŒκ΅­μ„Έμ²­ μ „μ†‘μ™„λ£Œ 건
ProcTaxInvoiceμ„ΈκΈˆκ³„μ‚°μ„œ 승인/κ±°λΆ€/μ·¨μ†Œμ—­λ°œν–‰ 처리용
GetTaxInvoicesPrintURLμ„ΈκΈˆκ³„μ‚°μ„œ 인쇄 URLμ΅œλŒ€ 50건
+
+
+ + +
+

μ„ΈκΈˆκ³„μ‚°μ„œ 객체 ν•„λ“œ λͺ…μ„Έ

+
+ +
+
κΈ°λ³Έ 정보
+
+
writeDate[ν•„μˆ˜] μž‘μ„±μΌμž (yyyyMMdd)
+
issueType[ν•„μˆ˜] λ°œν–‰ν˜•νƒœ
+
purposeType[ν•„μˆ˜] 영수/청ꡬ ꡬ뢄
+
taxType[ν•„μˆ˜] κ³Όμ„Έν˜•νƒœ
+
chargeDirection[ν•„μˆ˜] 과금방ν–₯
+
+
+ +
+
κ³΅κΈ‰μž 정보
+
+
invoicerCorpNum[ν•„μˆ˜] μ‚¬μ—…μžλ²ˆν˜Έ (10자리)
+
invoicerCorpName[ν•„μˆ˜] μƒν˜Έ
+
invoicerMgtKey[ν•„μˆ˜] λ¬Έμ„œλ²ˆν˜Έ (1~24자리)
+
invoicerCEOName[ν•„μˆ˜] λŒ€ν‘œμž μ„±λͺ…
+
invoicerEmail[선택] λ‹΄λ‹Ήμž 이메일
+
+
+ +
+
κ³΅κΈ‰λ°›λŠ”μž 정보
+
+
invoiceeCorpNum[ν•„μˆ˜] μ‚¬μ—…μžλ²ˆν˜Έ
+
invoiceeCorpName[ν•„μˆ˜] μƒν˜Έ
+
invoiceeType[ν•„μˆ˜] ꡬ뢄 (μ‚¬μ—…μž/개인/외ꡭ인)
+
invoiceeCEOName[ν•„μˆ˜] λŒ€ν‘œμž μ„±λͺ…
+
invoiceeEmail1[선택] λ‹΄λ‹Ήμž 이메일
+
+
+ +
+
κΈˆμ•‘ 정보
+
+
supplyCostTotal[ν•„μˆ˜] 곡급가앑 합계
+
taxTotal[ν•„μˆ˜] μ„Έμ•‘ 합계
+
totalAmount[ν•„μˆ˜] ν•©κ³„κΈˆμ•‘
+
remark1~3[선택] λΉ„κ³ 
+
+
+
+
+
+ + +
+

+ πŸ’³ μΉ΄λ“œ μ‚¬μš©λ‚΄μ—­ 쑰회 API +

+ +
+ +
+

μ„œλΉ„μŠ€ κ°œμš”

+
+

+ 개인/λ²•μΈμΉ΄λ“œμ˜ μ‚¬μš©λ‚΄μ—­μ„ μžλ™μœΌλ‘œ μˆ˜μ§‘ν•˜μ—¬ μ‚¬μš©μΌμ‹œ, 승인번호, μŠΉμΈκ΅¬λΆ„, κ±°λž˜κΈˆμ•‘, κ³Όμ„Έμœ ν˜• 정보λ₯Ό μ œκ³΅ν•©λ‹ˆλ‹€. +

+
    +
  • ‒맀일 μžλ™ μ—…λ°μ΄νŠΈ
    • +
  • ‒기간별/μΉ΄λ“œλ³„ 쑰회 κ°€λŠ₯
    • +
  • ‒가맹점 κ³Όμ„Έμœ ν˜• 쑰회 지원
    • +
  • β€’λΆ€κ°€μ„Έ μ‹ κ³  자료 ν™œμš©
    • +
+
+ +

쑰회 κ°€λŠ₯ ν•„λ“œ

+
+
+
μ‚¬μš©μΌμ‹œ
+
승인번호
+
μΉ΄λ“œλ²ˆν˜Έ
+
κ±°λž˜κΈˆμ•‘
+
가맹점λͺ…
+
가맹점 μ‚¬μ—…μžλ²ˆν˜Έ
+
μŠΉμΈκ΅¬λΆ„
+
κ³Όμ„Έμœ ν˜•
+
+
+
+ + +
+

μ£Όμš” API λ©”μ†Œλ“œ

+
+
+ RegistCard +

μΉ΄λ“œ 정보 등둝 (μΉ΄λ“œλ²ˆν˜Έ, μœ νš¨κΈ°κ°„, λΉ„λ°€λ²ˆν˜Έ)

+
+
+ GetCardLog +

μΉ΄λ“œ μ‚¬μš©λ‚΄μ—­ 쑰회 (κΈ°κ°„, μΉ΄λ“œλ²ˆν˜Έ 지정)

+
+
+ GetCardList +

λ“±λ‘λœ μΉ΄λ“œ λͺ©λ‘ 쑰회

+
+
+ DeleteCard +

λ“±λ‘λœ μΉ΄λ“œ μ‚­μ œ

+
+
+
+
+
+ + +
+

+ 🏦 κ³„μ’Œ μž…μΆœκΈˆλ‚΄μ—­ 쑰회 API +

+ +
+ +
+

μ„œλΉ„μŠ€ κ°œμš”

+
+

+ 총 20개 λ±…ν‚Ήμ˜ κΈ°μ—…/개인 κ³„μ’Œ μž…μΆœκΈˆλ‚΄μ—­μ„ μˆ˜μ§‘ν•˜μ—¬ μž…μΆœκΈˆμΌμ‹œ, μž…μΆœκΈˆμ•‘, μž”μ•‘, 이체내역 λ“±μ˜ 정보λ₯Ό μ œκ³΅ν•©λ‹ˆλ‹€. +

+
    +
  • ‒은행 직접 접속 λΆˆν•„μš”
    • +
  • β€’λ‹€μˆ˜ 은행 톡합 쑰회
    • +
  • β€’λ‹€μ–‘ν•œ 쑰회 μ£ΌκΈ° μ„€μ •
    • +
  • β€’μžλ™ μˆ˜μ§‘ κΈ°λŠ₯
    • +
+
+ +

쑰회 κ°€λŠ₯ ν•„λ“œ

+
+
+
κ±°λž˜μΌμ‹œ
+
μž…κΈˆμ•‘
+
μΆœκΈˆμ•‘
+
μž”μ•‘
+
거래점
+
μ μš”
+
κ±°λž˜κ΅¬λΆ„
+
λ©”λͺ¨
+
+
+
+ + +
+

μ£Όμš” API λ©”μ†Œλ“œ

+
+
+ RegistBankAccount +

κ³„μ’Œ 정보 등둝 (μ€ν–‰μ½”λ“œ, κ³„μ’Œλ²ˆν˜Έ, λΉ„λ°€λ²ˆν˜Έ)

+
+
+ GetBankAccountLog +

κ³„μ’Œ μž…μΆœκΈˆλ‚΄μ—­ 쑰회 (κΈ°κ°„, κ³„μ’Œλ²ˆν˜Έ 지정)

+
+
+ GetBankAccountList +

λ“±λ‘λœ κ³„μ’Œ λͺ©λ‘ 쑰회

+
+
+ GetBankAccountBalance +

κ³„μ’Œ μž”μ•‘ 쑰회

+
+
+
+
+ + +
+

지원 κΈˆμœ΅κΈ°κ΄€ (20개)

+
+ '.$bank.''; + } + ?> +
+
+
+ + +
+

+ πŸ“Š ν™ˆνƒμŠ€ λ§€μž…λ§€μΆœμžλ£Œ 연동 API +

+ +
+

+ ν™ˆνƒμŠ€μ— μ‹ κ³ /μˆ˜μ§‘λœ μ„ΈκΈˆκ³„μ‚°μ„œ, ν˜„κΈˆμ˜μˆ˜μ¦, μ‹ μš©μΉ΄λ“œ λ§€μž…λ‚΄μ—­ 등을 API둜 μ‘°νšŒν•˜μ—¬ λΆ€κ°€μ„Έ μ‹ κ³  및 κ²°μ‚° 자료둜 ν™œμš©ν•  수 μžˆμŠ΅λ‹ˆλ‹€. +

+
+ +
+
+
+ πŸ“„ + μ„ΈκΈˆκ³„μ‚°μ„œ +
+
    +
  • β€’ 맀좜/λ§€μž… μ„ΈκΈˆκ³„μ‚°μ„œ 쑰회
    • +
  • β€’ κ΅­μ„Έμ²­ 전솑 μƒνƒœ 확인
    • +
  • β€’ μˆ˜μ •μ„ΈκΈˆκ³„μ‚°μ„œ 이λ ₯
    • +
+
+
+
+ 🧾 + ν˜„κΈˆμ˜μˆ˜μ¦ +
+
    +
  • β€’ λ°œκΈ‰/μ·¨μ†Œ λ‚΄μ—­ 쑰회
    • +
  • β€’ λ§€μž…μžλ£Œ μˆ˜μ§‘
    • +
  • β€’ 곡제/뢈곡제 ꡬ뢄
    • +
+
+
+
+ πŸ’³ + μ‹ μš©μΉ΄λ“œ λ§€μž… +
+
    +
  • β€’ λ§€μž…μ„Έμ•‘ 곡제 자료
    • +
  • β€’ 가맹점별 λ‚΄μ—­ 쑰회
    • +
  • β€’ κ³Όμ„Έμœ ν˜• μžλ™ λΆ„λ₯˜
    • +
+
+
+
+
+ + + + +
+
+

+ βš™οΈ μ„€μ • 및 연동 관리 +

+

λ°”λ‘œλΉŒ API 연동을 μœ„ν•œ νšŒμ‚¬ 정보, μΈμ¦μ„œ, μ‚¬μš©μž κΆŒν•œμ„ κ΄€λ¦¬ν•©λ‹ˆλ‹€.

+ +
+
+
+ 🏒 +
+

νšŒμ‚¬ 정보 관리

+

μ‚¬μ—…μžλ“±λ‘λ²ˆν˜Έ, μƒν˜Έ, λŒ€ν‘œμž, μ—…νƒœ/μ’…λͺ© λ“± κΈ°λ³Έ 정보 관리

+ +
+
+
+ πŸ” +
+

λ°”λ‘œλΉŒ 연동 μ„€μ •

+

API 연동킀, κ³΅μΈμΈμ¦μ„œ 등둝, 연동 μƒνƒœ 확인

+ +
+
+
+ πŸ‘₯ +
+

μ‚¬μš©μž κΆŒν•œ μ„€μ •

+

λ‹΄λ‹Ήμžλ³„ μ ‘κ·Ό κΆŒν•œ, λ°œκΈ‰ κΆŒν•œ, 쑰회 λ²”μœ„ μ„€μ •

+ +
+
+
+ + +
+

+ πŸ“– 연동 κ°€μ΄λ“œ +

+ +
+
+ 1 +
+

λ°”λ‘œλΉŒ κ°œλ°œμžμ„Όν„° νšŒμ›κ°€μž…

+

dev.barobill.co.krμ—μ„œ νšŒμ›κ°€μž… ν›„ ν…ŒμŠ€νŠΈ API ν‚€λ₯Ό λ°œκΈ‰λ°›μŠ΅λ‹ˆλ‹€.

+
+
+
+ 2 +
+

νšŒμ›μ‚¬ 등둝 (RegistCorp)

+

μ‚¬μ—…μž 정보λ₯Ό μž…λ ₯ν•˜κ³  RegistCorp APIλ₯Ό ν˜ΈμΆœν•˜μ—¬ 연동킀λ₯Ό λ°œκΈ‰λ°›μŠ΅λ‹ˆλ‹€.

+
+
+
+ 3 +
+

κ³΅μΈμΈμ¦μ„œ 등둝

+

λ°”λ‘œλΉŒ μ „μš© ν”ŒλŸ¬κ·ΈμΈμ„ 톡해 μ„ΈκΈˆκ³„μ‚°μ„œ λ°œκΈ‰μš© κ³΅μΈμΈμ¦μ„œλ₯Ό λ“±λ‘ν•©λ‹ˆλ‹€.

+
+
+
+ 4 +
+

ν…ŒμŠ€νŠΈ 및 운영 μ „ν™˜

+

ν…ŒμŠ€νŠΈλ² λ“œμ—μ„œ API 연동을 κ²€μ¦ν•œ ν›„, 운영 ν™˜κ²½μœΌλ‘œ μ „ν™˜ν•©λ‹ˆλ‹€.

+
+
+
+
+
+ + + + +
+ +
+
+

+ 🏒 μ½”λ“œλΈŒλ¦Ώμ§€μ—‘μŠ€ νŒŒνŠΈλ„ˆ μ„œλΉ„μŠ€ +

+ μˆ˜μ΅ν˜• νŒŒνŠΈλ„ˆ +
+
+

+ μ½”λ“œλΈŒλ¦Ώμ§€μ—‘μŠ€λŠ” λ°”λ‘œλΉŒ 곡식 μˆ˜μ΅ν˜• νŒŒνŠΈλ„ˆλ‘œμ„œ, λ©€ν‹°ν…Œλ„Œμ‹œ ν™˜κ²½μ—μ„œ νšŒμ›μ‚¬μ—κ²Œ μ „μžμ„ΈκΈˆκ³„μ‚°μ„œ, μΉ΄λ“œ/κ³„μ’Œ 쑰회 λ“± + νšŒκ³„ μžλ™ν™” μ„œλΉ„μŠ€λ₯Ό μž¬νŒλ§€ν•©λ‹ˆλ‹€. +

+
+ λ°”λ‘œλΉŒ 곡식 νŒŒνŠΈλ„ˆ + λ©€ν‹°ν…Œλ„Œμ‹œ 지원 + μ’…λŸ‰μ œ 과금 + κΈ°μˆ μ§€μ› 포함 +
+
+
+
+
0원
+
초기 λ„μž…λΉ„
+
+
+
0원
+
μ›” μœ μ§€λΉ„
+
+
+
μ’…λŸ‰μ œ
+
μ‚¬μš©ν•œ 만큼만
+
+
+
+ + +
+

+ πŸ”— νŒŒνŠΈλ„ˆ 연동 ꡬ쑰 +

+
+
+
πŸ›οΈ
+
λ°”λ‘œλΉŒ
+
API μ œκ³΅μ‚¬
+
+
β†’
+
+
πŸ’Ό
+
μ½”λ“œλΈŒλ¦Ώμ§€μ—‘μŠ€
+
μˆ˜μ΅ν˜• νŒŒνŠΈλ„ˆ
+
+
β†’
+
+
🏒
+
νšŒμ›μ‚¬
+
μ„œλΉ„μŠ€ 이용 κΈ°μ—…
+
+
+
+

μˆ˜μ΅ν˜• νŒŒνŠΈλ„ˆ ꡬ쑰

+
    +
  • β€’μ½”λ“œλΈŒλ¦Ώμ§€μ—‘μŠ€λŠ” λ°”λ‘œλΉŒκ³Ό κ³„μ•½ν•œ νŒŒνŠΈλ„ˆ λ‹¨κ°€λ‘œ μ„œλΉ„μŠ€λ₯Ό μ΄μš©ν•©λ‹ˆλ‹€.
    • +
  • β€’νšŒμ›μ‚¬μ—κ²ŒλŠ” νŒŒνŠΈλ„ˆ 단가에 판맀 λ§ˆμ§„μ„ λ”ν•œ κΈˆμ•‘μœΌλ‘œ μ„œλΉ„μŠ€λ₯Ό μ œκ³΅ν•©λ‹ˆλ‹€.
    • +
  • β€’νšŒμ›μ‚¬λŠ” μ½”λ“œλΈŒλ¦Ώμ§€μ—‘μŠ€μ˜ μ†”λ£¨μ…˜μ„ 톡해 λ°”λ‘œλΉŒ API μ„œλΉ„μŠ€λ₯Ό μ΄μš©ν•©λ‹ˆλ‹€.
    • +
+
+
+ + +
+

+ πŸ’° μ„œλΉ„μŠ€λ³„ 이용 μš”κΈˆ +

+

μ„ λΆˆ 포인트 차감 λ°©μ‹μœΌλ‘œ, μ„œλΉ„μŠ€ 이용 μ‹œ 건당 단가가 μ°¨κ°λ©λ‹ˆλ‹€.

+ + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
μ„œλΉ„μŠ€κΈ°λ³Έ λ‹¨κ°€νšŒμ›μ‚¬ 단가비고
μ „μžλ¬Έμ„œ μ„œλΉ„μŠ€
+
+ πŸ“„ + μ „μžμ„ΈκΈˆκ³„μ‚°μ„œ λ°œκΈ‰ +
+ 		100원80원ꡭ세청 전솑 포함
+
+ πŸ“„ + μ „μžκ³„μ‚°μ„œ λ°œκΈ‰ (λ©΄μ„Έ) +
+ 		100원80원면세 μ‚¬μ—…μžμš©
+
+ 🧾 + ν˜„κΈˆμ˜μˆ˜μ¦ λ°œκΈ‰ +
+ 		0μ›λ¬΄λ£Œλ°œκΈ‰ 건수 λ¬΄μ œν•œ
금육 데이터 μˆ˜μ§‘
+
+ πŸ’³ + μΉ΄λ“œ μ‚¬μš©λ‚΄μ—­ 쑰회 +
+ 		500원400μ›μΉ΄λ“œλ‹Ή μ›” 1회 μˆ˜μ§‘
+
+ 🏦 + κ³„μ’Œ μž…μΆœκΈˆλ‚΄μ—­ 쑰회 +
+ 		500원400μ›κ³„μ’Œλ‹Ή μ›” 1회 μˆ˜μ§‘
ν™ˆνƒμŠ€ 연동
+
+ πŸ“Š + ν™ˆνƒμŠ€ λ§€μž…λ§€μΆœ 쑰회 +
+ 		300원250원건당 과금
+
+ πŸ” + μ‚¬μ—…μž νœ΄νμ—… 쑰회 +
+ 		0μ›λ¬΄λ£Œμ‘°νšŒ 건수 λ¬΄μ œν•œ
+
+ +
+

+ πŸ’‘ μš”κΈˆ μ•ˆλ‚΄ +

+
    +
  • β€’ μœ„ μš”κΈˆμ€ μ½”λ“œλΈŒλ¦Ώμ§€μ—‘μŠ€ νšŒμ›μ‚¬ κΈ°μ€€ λ‹¨κ°€μž…λ‹ˆλ‹€.
    • +
  • β€’ λŒ€λŸ‰ μ‚¬μš© μ‹œ λ³Όλ₯¨ λ””μŠ€μΉ΄μš΄νŠΈκ°€ 적용될 수 μžˆμŠ΅λ‹ˆλ‹€.
    • +
  • β€’ μ΅œμ†Œ μΆ©μ „ κΈˆμ•‘: 10,000원 / 결제 μˆ˜λ‹¨: μΉ΄λ“œ, κ³„μ’Œμ΄μ²΄, κ°€μƒκ³„μ’Œ
    • +
+
+
+ + +
+

+ πŸ“‹ νšŒμ›μ‚¬ κ°€μž… ν”„λ‘œμ„ΈμŠ€ +

+

μ½”λ“œλΈŒλ¦Ώμ§€μ—‘μŠ€ μ†”λ£¨μ…˜μ„ 톡해 λ°”λ‘œλΉŒ API μ„œλΉ„μŠ€λ₯Ό μ΄μš©ν•˜λ €λ©΄ μ•„λž˜ 절차λ₯Ό λ”°λ₯΄μ„Έμš”.

+ +
+
+
+
1
+
πŸ“
+

νšŒμ›μ‚¬ 등둝

+

μ‚¬μ—…μž 정보 μž…λ ₯ 및 μ΄μš©μ•½κ΄€ λ™μ˜

+
+
+
+
+
2
+
πŸ”‘
+

연동킀 λ°œκΈ‰

+

RegistCorp API둜 νšŒμ›μ‚¬ 고유 연동킀 생성

+
+
+
+
+
3
+
πŸ”
+

μΈμ¦μ„œ 등둝

+

μ„ΈκΈˆκ³„μ‚°μ„œ λ°œκΈ‰μš© κ³΅μΈμΈμ¦μ„œ 등둝

+
+
+
+
+
4
+
πŸ’³
+

포인트 μΆ©μ „

+

μ„ λΆˆ 포인트 μΆ©μ „ ν›„ μ„œλΉ„μŠ€ 이용 μ‹œμž‘

+
+
+
+
+ + +
+

+ βš™οΈ 과금 방식 상세 +

+ +
+ +
+

+ πŸ’Ž + 포인트 μ‹œμŠ€ν…œ +

+
    +
  • + β€’ +
    μ„ λΆˆ μΆ©μ „: 포인트λ₯Ό 미리 μΆ©μ „ν•œ ν›„ μ„œλΉ„μŠ€ 이용 μ‹œ 차감
    +
    • +
  • + β€’ +
    μžλ™ μ•Œλ¦Ό: μž”μ•‘ λΆ€μ‘± μ‹œ 이메일/SMS μ•Œλ¦Ό λ°œμ†‘
    +
    • +
  • + β€’ +
    μ‚¬μš© λ‚΄μ—­: μ‹€μ‹œκ°„ 포인트 μ‚¬μš© λ‚΄μ—­ 쑰회 κ°€λŠ₯
    +
    • +
  • + β€’ +
    μœ νš¨κΈ°κ°„: μΆ©μ „μΌλ‘œλΆ€ν„° 5λ…„κ°„ 유효
    +
    • +
+
+ + +
+

+ πŸ“Š + μ •μ‚° 및 결제 +

+
    +
  • + β€’ +
    결제 μˆ˜λ‹¨: μ‹ μš©μΉ΄λ“œ, μ‹€μ‹œκ°„ κ³„μ’Œμ΄μ²΄, κ°€μƒκ³„μ’Œ
    +
    • +
  • + β€’ +
    μ„ΈκΈˆκ³„μ‚°μ„œ: μΆ©μ „ κΈˆμ•‘μ— λŒ€ν•΄ μ „μžμ„ΈκΈˆκ³„μ‚°μ„œ λ°œκΈ‰
    +
    • +
  • + β€’ +
    μ •μ‚° μ£ΌκΈ°: 월별 μ‚¬μš© λ‚΄μ—­ 리포트 제곡
    +
    • +
  • + β€’ +
    λŒ€λŸ‰ 할인: μ›” μ‚¬μš©λŸ‰μ— λ”°λ₯Έ λ³Όλ₯¨ λ””μŠ€μΉ΄μš΄νŠΈ
    +
    • +
+
+
+ + +
+

νšŒμ›μ‚¬ 포인트 쑰회 API

+
+
// νšŒμ›μ‚¬ 포인트 μž”μ•‘ 쑰회
+
$balance = $barobill->GetBalance(
+
"CERT_KEY", // νŒŒνŠΈλ„ˆ 인증킀
+
"1234567890" // νšŒμ›μ‚¬ μ‚¬μ—…μžλ²ˆν˜Έ
+
);
+
// λ°˜ν™˜κ°’: ν˜„μž¬ μž”μ•‘ (원)
+
+
+ + +
+
+
+

과금 μ •μ±… 문의

+

λŒ€λŸ‰ μ‚¬μš©, 맞좀 μš”κΈˆμ œ λ“± λ¬Έμ˜μ‚¬ν•­μ΄ μžˆμœΌμ‹œλ©΄ μ—°λ½μ£Όμ„Έμš”.

+
+
+ + πŸ“ž 070-4040-5617 + + + 🌐 κ°œλ°œμžμ„Όν„° + +
+
+
+
+
+
+ + + + + + + + + +
+
+

λ°”λ‘œλΉŒ API 기반 λ©€ν‹°ν…Œλ„Œμ‹œ νšŒκ³„ 지원 μ†”λ£¨μ…˜

+

Β© SAM | API Reference: dev.barobill.co.kr

+
+
+ + + + diff --git a/barobill/planning.md b/barobill/planning.md new file mode 100644 index 0000000..23e3758 --- /dev/null +++ b/barobill/planning.md @@ -0,0 +1,64 @@ +# [κΈ°νšμ„œ] λ°”λ‘œλΉŒ API 기반 λ©€ν‹°ν…Œλ„Œμ‹œ νšŒκ³„ 지원 μ†”λ£¨μ…˜ + +## 1. ν”„λ‘œμ νŠΈ κ°œμš” + +- **λͺ©μ **: λ°”λ‘œλΉŒ(Barobill) APIλ₯Ό ν™œμš©ν•œ λ©€ν‹°ν…Œλ„Œμ‹œ ν™˜κ²½μ˜ νšŒκ³„ μžλ™ν™” μ‹œμŠ€ν…œ ꡬ좕 +- **μ£Όμš” κΈ°λŠ₯**: + - API 기반 νšŒμ›μ‚¬ κ°€μž… 및 관리 + - κ³΅μΈμΈμ¦μ„œ ν”ŒλŸ¬κ·ΈμΈ 연동 + - μ „μžμ„ΈκΈˆκ³„μ‚°μ„œ λ°œν–‰ 및 관리 + - μΉ΄λ“œ λ‚΄μ—­ 및 κ³„μ’Œ 거래 λ‚΄μ—­ μ‹€μ‹œκ°„ 쑰회 + +--- + +## 2. 톡합 μ›Œν¬ν”Œλ‘œμš° (Workflow) + +### 2.1 νšŒμ› μ˜¨λ³΄λ”© ν”„λ‘œμ„ΈμŠ€ + +1. **νšŒμ› κ°€μž…**: μ†”λ£¨μ…˜ λ‚΄μ—μ„œ μ‚¬μ—…μž 정보 μž…λ ₯ -> λ°”λ‘œλΉŒ `RegistCorp` API 호좜 -> 연동킀 λ°œκΈ‰ 및 DB μ €μž₯. +2. **μΈμ¦μ„œ 등둝**: λ°”λ‘œλΉŒ μ „μš© ν”ŒλŸ¬κ·ΈμΈ 호좜 -> μ‚¬μš©μž μΈμ¦μ„œ 선택 및 μ„œλͺ… -> λ°”λ‘œλΉŒ λ³΄μ•ˆ μ„œλ²„λ‘œ μΈμ¦μ„œ 전솑. +3. **연동 확인**: 등둝 μ™„λ£Œ ν›„ μ†”λ£¨μ…˜ λ‚΄μ—μ„œ 연동 μƒνƒœ 'ν™œμ„±(Active)'으둜 λ³€κ²½. + +### 2.2 μ„œλΉ„μŠ€ 이용 ν”„λ‘œμ„ΈμŠ€ + +- **μ „μžμ„ΈκΈˆκ³„μ‚°μ„œ**: 맀좜 데이터 생성 -> `RegistTaxInvoice` 호좜 -> κ΅­μ„Έμ²­ 전솑 및 μƒνƒœ λͺ¨λ‹ˆν„°λ§. +- **금육 데이터 μˆ˜μ§‘**: + - **μΉ΄λ“œ**: μΉ΄λ“œ 정보 등둝 -> `GetCardLog` 호좜 -> μ§€μΆœ λ‚΄μ—­ μŠ€ν¬λž˜ν•‘ 및 μž₯λΆ€ 기둝. + - **κ³„μ’Œ**: κ³„μ’Œ μ—°κ²° -> `GetBankAccountLog` 호좜 -> μž…μΆœκΈˆ λ‚΄μ—­ 동기화 및 미수금 λŒ€μ‘°. + +--- + +## 3. 메뉴 ꡬ쑰도 (Information Architecture) + +- **λŒ€λ©”λ‰΄ 1: λŒ€μ‹œλ³΄λ“œ** (νšŒκ³„ μš”μ•½, μ•Œλ¦Ό) +- **λŒ€λ©”λ‰΄ 2: 맀좜/λ§€μž… 관리** + - μ „μžμ„ΈκΈˆκ³„μ‚°μ„œ λ°œν–‰/λͺ©λ‘ + - μΉ΄λ“œ 이용 λ‚΄μ—­ + - κ³„μ’Œ 거래 λ‚΄μ—­ +- **λŒ€λ©”λ‰΄ 3: μ„€μ • 및 연동** + - νšŒμ‚¬ 정보 관리 + - λ°”λ‘œλΉŒ 연동 μ„€μ • (μΈμ¦μ„œ 관리) + - μ‚¬μš©μž κΆŒν•œ μ„€μ • + +--- + +## 4. λ©€ν‹°ν…Œλ„Œμ‹œ 데이터 관리 μ „λž΅ + +### 4.1 데이터 격리 (Data Isolation) + +- λͺ¨λ“  ν…Œμ΄λΈ”μ— `TenantID` λ˜λŠ” `PartnerBarobillID`λ₯Ό λΆ€μ—¬ν•˜μ—¬ νšŒμ›μ‚¬ κ°„ 데이터 ν˜Όμ„  방지. +- API 호좜 μ‹œ ν•΄λ‹Ή ν…Œλ„ŒνŠΈμ˜ 고유 연동킀λ₯Ό λ™μ μœΌλ‘œ 맀핑. + +### 4.2 λ³΄μ•ˆ 및 μ˜ˆμ™Έ 처리 + +- **인증 λ³΄μ•ˆ**: HTTPS 톡신 및 λ°”λ‘œλΉŒ 인증 토큰 기반 λ³΄μ•ˆ κ°•ν™”. +- **였λ₯˜ λŒ€μ‘**: μΈμ¦μ„œ 만료, API 호좜 ν•œλ„ 초과 등에 λŒ€ν•œ μ‚¬μš©μž μ•Œλ¦Ό 둜직 κ΅¬ν˜„. +- **둜그 관리**: API μš”μ²­ 및 응닡 전문을 둜그둜 κΈ°λ‘ν•˜μ—¬ 이슈 λ°œμƒ μ‹œ 좔적 κ°€λŠ₯ν•˜λ„λ‘ 섀계. + +--- + +## 5. ν–₯ν›„ 상세 섀계 ν•­λͺ© (Next Steps) + +1. **ν™”λ©΄ μ„€κ³„μ„œ(Wireframe)**: 각 단계별 UI λ ˆμ΄μ•„μ›ƒ ν™•μ •. +2. **API 맀핑 상세**: μ†”λ£¨μ…˜ ν•„λ“œμ™€ λ°”λ‘œλΉŒ νŒŒλΌλ―Έν„° 1:1 맀칭 ν…Œμ΄λΈ” μž‘μ„±. +3. **DB μŠ€ν‚€λ§ˆ 섀계**: ν…Œλ„ŒνŠΈ 및 금육 데이터 μ €μž₯을 μœ„ν•œ ERD μž‘μ„±. diff --git a/index.php b/index.php index 849bd11..a7ee0ed 100644 --- a/index.php +++ b/index.php @@ -201,6 +201,9 @@ 경정청ꡬ μ†Œκ°œ + + λ°”λ‘œλΉŒ API ν†΅ν•©κΈ°νšμ„œ + 기업뢄석 ν•œκ΅­ν‰κ°€λ°μ΄ν„° (kodata)