2ab3534278
🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
434 lines
15 KiB
PHP
434 lines
15 KiB
PHP
<?php
|
|
require_once __DIR__ . '/../lib/DotEnv.php';
|
|
(new DotEnv(__DIR__ . '/../.env'))->load();
|
|
require_once(getenv('DOCUMENT_ROOT') . "/session.php");
|
|
?>
|
|
<!DOCTYPE html>
|
|
<html lang="ko">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<title>바로빌 API 정보</title>
|
|
<style>
|
|
* {
|
|
margin: 0;
|
|
padding: 0;
|
|
box-sizing: border-box;
|
|
}
|
|
|
|
body {
|
|
font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
|
|
background: linear-gradient(135deg, #43cea2 0%, #185a9d 100%);
|
|
min-height: 100vh;
|
|
padding: 20px;
|
|
}
|
|
|
|
.container {
|
|
max-width: 1200px;
|
|
margin: 0 auto;
|
|
background: white;
|
|
border-radius: 20px;
|
|
padding: 40px;
|
|
box-shadow: 0 20px 60px rgba(0, 0, 0, 0.3);
|
|
}
|
|
|
|
.header {
|
|
text-align: center;
|
|
margin-bottom: 40px;
|
|
padding-bottom: 20px;
|
|
border-bottom: 3px solid #43cea2;
|
|
}
|
|
|
|
.header h1 {
|
|
color: #185a9d;
|
|
font-size: 2.5em;
|
|
margin-bottom: 10px;
|
|
}
|
|
|
|
.header p {
|
|
color: #666;
|
|
font-size: 1.2em;
|
|
}
|
|
|
|
.section {
|
|
margin-bottom: 40px;
|
|
}
|
|
|
|
.section h2 {
|
|
color: #185a9d;
|
|
font-size: 1.8em;
|
|
margin-bottom: 20px;
|
|
padding-bottom: 10px;
|
|
border-bottom: 2px solid #43cea2;
|
|
}
|
|
|
|
.section h3 {
|
|
color: #43cea2;
|
|
font-size: 1.4em;
|
|
margin: 20px 0 15px 0;
|
|
}
|
|
|
|
.info-box {
|
|
background: #f8f9fa;
|
|
border-left: 4px solid #43cea2;
|
|
padding: 20px;
|
|
margin: 20px 0;
|
|
border-radius: 5px;
|
|
}
|
|
|
|
.info-box.warning {
|
|
border-left-color: #f5576c;
|
|
background: #fff5f5;
|
|
}
|
|
|
|
.info-box.success {
|
|
border-left-color: #43cea2;
|
|
background: #f0fdf4;
|
|
}
|
|
|
|
.api-endpoint {
|
|
background: #1e1e1e;
|
|
color: #d4d4d4;
|
|
padding: 15px;
|
|
border-radius: 5px;
|
|
margin: 10px 0;
|
|
font-family: 'Courier New', monospace;
|
|
overflow-x: auto;
|
|
}
|
|
|
|
.api-endpoint .method {
|
|
color: #4ec9b0;
|
|
font-weight: bold;
|
|
}
|
|
|
|
.api-endpoint .url {
|
|
color: #ce9178;
|
|
}
|
|
|
|
table {
|
|
width: 100%;
|
|
border-collapse: collapse;
|
|
margin: 20px 0;
|
|
}
|
|
|
|
table th,
|
|
table td {
|
|
padding: 12px;
|
|
text-align: left;
|
|
border-bottom: 1px solid #ddd;
|
|
}
|
|
|
|
table th {
|
|
background: #43cea2;
|
|
color: white;
|
|
font-weight: 600;
|
|
}
|
|
|
|
table tr:hover {
|
|
background: #f5f5f5;
|
|
}
|
|
|
|
.btn {
|
|
display: inline-block;
|
|
padding: 12px 30px;
|
|
background: linear-gradient(135deg, #43cea2 0%, #185a9d 100%);
|
|
color: white;
|
|
text-decoration: none;
|
|
border-radius: 25px;
|
|
font-weight: 600;
|
|
transition: all 0.3s ease;
|
|
margin: 10px 10px 10px 0;
|
|
}
|
|
|
|
.btn:hover {
|
|
transform: translateY(-2px);
|
|
box-shadow: 0 5px 15px rgba(0, 0, 0, 0.3);
|
|
}
|
|
|
|
.btn-secondary {
|
|
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
|
|
}
|
|
|
|
ul, ol {
|
|
margin-left: 30px;
|
|
line-height: 2;
|
|
}
|
|
|
|
li {
|
|
margin-bottom: 10px;
|
|
}
|
|
|
|
code {
|
|
background: #f4f4f4;
|
|
padding: 2px 6px;
|
|
border-radius: 3px;
|
|
font-family: 'Courier New', monospace;
|
|
color: #e83e8c;
|
|
}
|
|
|
|
.home-btn {
|
|
position: fixed;
|
|
top: 30px;
|
|
left: 30px;
|
|
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
|
|
color: white;
|
|
border: none;
|
|
padding: 12px 25px;
|
|
border-radius: 50px;
|
|
cursor: pointer;
|
|
font-size: 1em;
|
|
box-shadow: 0 5px 15px rgba(0, 0, 0, 0.3);
|
|
transition: all 0.3s ease;
|
|
z-index: 1000;
|
|
text-decoration: none;
|
|
display: inline-flex;
|
|
align-items: center;
|
|
gap: 8px;
|
|
font-weight: 600;
|
|
}
|
|
|
|
.home-btn:hover {
|
|
transform: translateY(-3px);
|
|
box-shadow: 0 8px 20px rgba(0, 0, 0, 0.4);
|
|
}
|
|
|
|
@media (max-width: 768px) {
|
|
.container {
|
|
padding: 20px;
|
|
}
|
|
|
|
.header h1 {
|
|
font-size: 1.8em;
|
|
}
|
|
|
|
.home-btn {
|
|
top: 15px;
|
|
left: 15px;
|
|
padding: 10px 20px;
|
|
font-size: 0.9em;
|
|
}
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<!-- Home Button -->
|
|
<a href="../index.php" class="home-btn">
|
|
<span>🏠</span>
|
|
<span>홈으로</span>
|
|
</a>
|
|
|
|
<div class="container">
|
|
<div class="header">
|
|
<h1>📋 바로빌 API 정보</h1>
|
|
<p>전자세금계산서 솔루션 개발을 위한 바로빌 API 가이드</p>
|
|
</div>
|
|
|
|
<!-- 바로빌 개요 -->
|
|
<div class="section">
|
|
<h2>1. 바로빌 개요</h2>
|
|
<div class="info-box success">
|
|
<p><strong>바로빌</strong>은 기업의 재무회계 디지털 전환을 지원하는 Fin-tech 플랫폼입니다.</p>
|
|
<p>다양한 전자문서 발행 및 관리 API를 제공하여 기업의 업무 자동화를 지원합니다.</p>
|
|
</div>
|
|
<p><strong>개발자센터 URL</strong>: <a href="https://dev.barobill.co.kr" target="_blank">https://dev.barobill.co.kr</a></p>
|
|
</div>
|
|
|
|
<!-- 주요 API 서비스 -->
|
|
<div class="section">
|
|
<h2>2. 주요 API 서비스</h2>
|
|
|
|
<h3>2.1 전자문서 API</h3>
|
|
<p>전자세금계산서, 거래명세서, 청구서, 견적서 등 다양한 전자문서의 발행 및 관리 기능을 제공합니다.</p>
|
|
<ul>
|
|
<li><strong>전자세금계산서 발행</strong>: 세금계산서 발행 및 국세청 전송</li>
|
|
<li><strong>전자세금계산서 취소</strong>: 발행된 세금계산서 취소</li>
|
|
<li><strong>전자세금계산서 조회</strong>: 발행 내역 및 상태 조회</li>
|
|
<li><strong>거래명세서 발행</strong>: 거래명세서 발행 및 관리</li>
|
|
<li><strong>청구서/견적서 발행</strong>: 다양한 전자문서 발행</li>
|
|
</ul>
|
|
<p><a href="https://dev.barobill.co.kr/services/edoc" target="_blank" class="btn">전자문서 API 상세보기</a></p>
|
|
|
|
<h3>2.2 메시징 API</h3>
|
|
<p>SMS, LMS, MMS 등 다양한 형태의 문자 전송 기능을 제공합니다.</p>
|
|
<ul>
|
|
<li>세금계산서 발행 알림</li>
|
|
<li>인증서 만료 알림</li>
|
|
<li>시스템 알림</li>
|
|
</ul>
|
|
<p><a href="https://dev.barobill.co.kr/services/message" target="_blank" class="btn">메시징 API 상세보기</a></p>
|
|
|
|
<h3>2.3 팩스 전송 API</h3>
|
|
<p>HWP, DOC, XLS, PDF 등 다양한 문서 파일의 팩스 전송 기능을 제공합니다.</p>
|
|
<p><a href="https://dev.barobill.co.kr/services/fax" target="_blank" class="btn">팩스 API 상세보기</a></p>
|
|
</div>
|
|
|
|
<!-- 전자세금계산서 API 상세 -->
|
|
<div class="section">
|
|
<h2>3. 전자세금계산서 API 상세</h2>
|
|
|
|
<h3>3.1 필수 요구사항</h3>
|
|
<div class="info-box warning">
|
|
<p><strong>⚠️ 중요:</strong> 전자세금계산서 발행을 위해서는 공동인증서 또는 금융인증서가 필요합니다.</p>
|
|
</div>
|
|
<ul>
|
|
<li>공동인증서 또는 금융인증서 등록</li>
|
|
<li>바로빌 개발자센터 회원가입</li>
|
|
<li>API 키 발급</li>
|
|
<li>인증서 등록 및 연동</li>
|
|
</ul>
|
|
|
|
<h3>3.2 주요 API 기능</h3>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>기능</th>
|
|
<th>설명</th>
|
|
<th>필수 정보</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><strong>세금계산서 발행</strong></td>
|
|
<td>전자세금계산서 발행 및 국세청 전송</td>
|
|
<td>공급자/수취자 정보, 품목 정보, 금액 정보</td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong>세금계산서 취소</strong></td>
|
|
<td>발행된 세금계산서 취소</td>
|
|
<td>발행 키, 취소 사유</td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong>세금계산서 조회</strong></td>
|
|
<td>발행 내역 및 상태 조회</td>
|
|
<td>발행 키 또는 검색 조건</td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong>국세청 전송</strong></td>
|
|
<td>발행된 세금계산서를 국세청으로 전송</td>
|
|
<td>발행 키</td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong>전송 상태 확인</strong></td>
|
|
<td>국세청 전송 상태 및 접수번호 확인</td>
|
|
<td>발행 키</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
<h3>3.3 API 요청 예시 (예상)</h3>
|
|
<div class="api-endpoint">
|
|
<span class="method">POST</span> <span class="url">/api/taxinvoice/issue</span>
|
|
</div>
|
|
<p><strong>Headers:</strong></p>
|
|
<div class="api-endpoint">
|
|
Authorization: Bearer {API_KEY}<br>
|
|
Content-Type: application/json
|
|
</div>
|
|
<p><strong>Request Body (예상):</strong></p>
|
|
<div class="api-endpoint">
|
|
{<br>
|
|
"certId": "인증서ID",<br>
|
|
"supplier": {<br>
|
|
"bizno": "사업자번호",<br>
|
|
"corpName": "상호",<br>
|
|
"ceo": "대표자명"<br>
|
|
},<br>
|
|
"recipient": { ... },<br>
|
|
"items": [ ... ],<br>
|
|
"writeDate": "2024-01-01",<br>
|
|
"supplyDate": "2024-01-01"<br>
|
|
}
|
|
</div>
|
|
</div>
|
|
|
|
<!-- 개발자 지원 -->
|
|
<div class="section">
|
|
<h2>4. 개발자 지원</h2>
|
|
<ul>
|
|
<li><strong>개발 가이드</strong>: 상세한 API 문서 및 가이드 제공</li>
|
|
<li><strong>샘플 코드</strong>: Java, Python, PHP, .NET 등 다양한 언어 지원</li>
|
|
<li><strong>테스트 환경</strong>: 실제 개발 환경과 동일한 테스트 환경 제공</li>
|
|
<li><strong>전담 엔지니어 지원</strong>: 개발 상담 및 기술 지원 제공</li>
|
|
</ul>
|
|
<p><a href="https://dev.barobill.co.kr" target="_blank" class="btn">개발자센터 바로가기</a></p>
|
|
</div>
|
|
|
|
<!-- 연동 절차 -->
|
|
<div class="section">
|
|
<h2>5. API 연동 절차</h2>
|
|
<ol>
|
|
<li><strong>회원가입</strong>: 바로빌 개발자센터에서 회원가입</li>
|
|
<li><strong>API 키 발급</strong>: 개발자센터에서 API 키 발급</li>
|
|
<li><strong>인증서 등록</strong>: 공동인증서 또는 금융인증서 등록</li>
|
|
<li><strong>테스트 환경 설정</strong>: 바로빌 테스트 환경에서 연동 테스트</li>
|
|
<li><strong>개발 및 연동</strong>: API 가이드를 참고하여 연동 및 개발 진행</li>
|
|
<li><strong>프로덕션 연동</strong>: 실제 운영 환경 구축 후 서비스 오픈</li>
|
|
</ol>
|
|
</div>
|
|
|
|
<!-- 요금 안내 -->
|
|
<div class="section">
|
|
<h2>6. 요금 안내</h2>
|
|
<div class="info-box">
|
|
<p>바로빌은 파트너 유형에 따라 할인형과 수익형으로 구분하여 연동 서비스를 제공합니다.</p>
|
|
<p>자세한 요금 안내는 바로빌 개발자센터의 파트너/요금 페이지를 참고하시기 바랍니다.</p>
|
|
</div>
|
|
<p><a href="https://dev.barobill.co.kr/partners/cost/partner" target="_blank" class="btn btn-secondary">요금 안내 보기</a></p>
|
|
</div>
|
|
|
|
<!-- 지원 언어 -->
|
|
<div class="section">
|
|
<h2>7. 지원 언어</h2>
|
|
<p>바로빌 API는 다음과 같은 개발 언어를 지원합니다:</p>
|
|
<ul>
|
|
<li>Java</li>
|
|
<li>Python</li>
|
|
<li>PHP</li>
|
|
<li>.NET (C#)</li>
|
|
<li>기타 REST API를 지원하는 모든 언어</li>
|
|
</ul>
|
|
</div>
|
|
|
|
<!-- 보안 고려사항 -->
|
|
<div class="section">
|
|
<h2>8. 보안 고려사항</h2>
|
|
<div class="info-box warning">
|
|
<p><strong>⚠️ 보안 주의사항:</strong></p>
|
|
<ul>
|
|
<li>API 키는 절대 공개되지 않도록 주의하세요.</li>
|
|
<li>인증서는 암호화하여 안전하게 저장하세요.</li>
|
|
<li>HTTPS를 통해서만 API를 호출하세요.</li>
|
|
<li>민감한 정보는 로그에 기록하지 마세요.</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- 유용한 링크 -->
|
|
<div class="section">
|
|
<h2>9. 유용한 링크</h2>
|
|
<ul>
|
|
<li><a href="https://dev.barobill.co.kr" target="_blank">바로빌 개발자센터</a></li>
|
|
<li><a href="https://dev.barobill.co.kr/services/edoc" target="_blank">전자문서 API</a></li>
|
|
<li><a href="https://dev.barobill.co.kr/services/message" target="_blank">메시징 API</a></li>
|
|
<li><a href="https://dev.barobill.co.kr/services/fax" target="_blank">팩스 API</a></li>
|
|
<li><a href="https://dev.barobill.co.kr/partners/cost/partner" target="_blank">파트너/요금 안내</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
<!-- 다음 단계 -->
|
|
<div class="section">
|
|
<h2>10. 다음 단계</h2>
|
|
<ol>
|
|
<li>바로빌 개발자센터 회원가입 및 API 키 발급</li>
|
|
<li>개발 가이드 및 샘플 코드 다운로드</li>
|
|
<li>테스트 환경에서 API 연동 테스트</li>
|
|
<li>인증서 등록 및 연동</li>
|
|
<li>실제 프로젝트에 통합</li>
|
|
</ol>
|
|
<p><a href="../strategy/electronicTaxInvoice_index.php" class="btn">전략 페이지로 돌아가기</a></p>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|
|
|