SamProject/sam-api
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: Phase 3.8 바로빌 세금계산서 연동 API 구현

Browse Source 
- 마이그레이션: barobill_settings, tax_invoices 테이블 생성
- 모델: BarobillSetting (인증서 암호화), TaxInvoice (상태/유형 상수)
- 서비스: BarobillService (API 연동), TaxInvoiceService (CRUD, 발행/취소)
- 컨트롤러: BarobillSettingController, TaxInvoiceController
- FormRequest: 6개 요청 검증 클래스
- Swagger: API 문서 완성 (BarobillSettingApi, TaxInvoiceApi)
This commit is contained in:
권혁성
2025-12-18 15:31:59 +09:00
parent 9b3dd2f4b8
commit 8ad4d7c0ce
17 changed files with 2425 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
app/Http/Requests/TaxInvoice/CancelTaxInvoiceRequest.php Normal file
View File

@@ -0,0 +1,27 @@
<?php
namespace App\Http\Requests\TaxInvoice;
use Illuminate\Foundation\Http\FormRequest;
class CancelTaxInvoiceRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'reason' => ['required', 'string', 'max:500'],
];
}
public function attributes(): array
{
return [
'reason' => __('validation.attributes.cancel_reason'),
];
}
}

78
app/Http/Requests/TaxInvoice/CreateTaxInvoiceRequest.php Normal file
View File

@@ -0,0 +1,78 @@
<?php
namespace App\Http\Requests\TaxInvoice;
use App\Models\Tenants\TaxInvoice;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;
class CreateTaxInvoiceRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'invoice_type' => ['required', 'string', Rule::in(TaxInvoice::INVOICE_TYPES)],
'issue_type' => ['required', 'string', Rule::in(TaxInvoice::ISSUE_TYPES)],
'direction' => ['required', 'string', Rule::in(TaxInvoice::DIRECTIONS)],
// 공급자 정보
'supplier_corp_num' => ['required', 'string', 'max:20'],
'supplier_corp_name' => ['required', 'string', 'max:100'],
'supplier_ceo_name' => ['nullable', 'string', 'max:50'],
'supplier_addr' => ['nullable', 'string', 'max:200'],
'supplier_biz_type' => ['nullable', 'string', 'max:100'],
'supplier_biz_class' => ['nullable', 'string', 'max:100'],
'supplier_contact_id' => ['nullable', 'string', 'email', 'max:100'],
// 공급받는자 정보
'buyer_corp_num' => ['required', 'string', 'max:20'],
'buyer_corp_name' => ['required', 'string', 'max:100'],
'buyer_ceo_name' => ['nullable', 'string', 'max:50'],
'buyer_addr' => ['nullable', 'string', 'max:200'],
'buyer_biz_type' => ['nullable', 'string', 'max:100'],
'buyer_biz_class' => ['nullable', 'string', 'max:100'],
'buyer_contact_id' => ['nullable', 'string', 'email', 'max:100'],
// 금액 정보
'issue_date' => ['required', 'date'],
'supply_amount' => ['required', 'numeric', 'min:0'],
'tax_amount' => ['required', 'numeric', 'min:0'],
// 품목 정보
'items' => ['nullable', 'array'],
'items.*.name' => ['required_with:items', 'string', 'max:100'],
'items.*.spec' => ['nullable', 'string', 'max:100'],
'items.*.qty' => ['nullable', 'numeric', 'min:0'],
'items.*.unit_price' => ['nullable', 'numeric', 'min:0'],
'items.*.supply_amt' => ['nullable', 'numeric', 'min:0'],
'items.*.tax_amt' => ['nullable', 'numeric', 'min:0'],
'items.*.remark' => ['nullable', 'string', 'max:200'],
// 참조 정보
'reference_type' => ['nullable', 'string', 'max:50'],
'reference_id' => ['nullable', 'integer'],
'description' => ['nullable', 'string', 'max:1000'],
];
}
public function attributes(): array
{
return [
'invoice_type' => __('validation.attributes.invoice_type'),
'issue_type' => __('validation.attributes.issue_type'),
'direction' => __('validation.attributes.direction'),
'supplier_corp_num' => __('validation.attributes.supplier_corp_num'),
'supplier_corp_name' => __('validation.attributes.supplier_corp_name'),
'buyer_corp_num' => __('validation.attributes.buyer_corp_num'),
'buyer_corp_name' => __('validation.attributes.buyer_corp_name'),
'issue_date' => __('validation.attributes.issue_date'),
'supply_amount' => __('validation.attributes.supply_amount'),
'tax_amount' => __('validation.attributes.tax_amount'),
];
}
}

31
app/Http/Requests/TaxInvoice/TaxInvoiceListRequest.php Normal file
View File

@@ -0,0 +1,31 @@
<?php
namespace App\Http\Requests\TaxInvoice;
use App\Models\Tenants\TaxInvoice;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;
class TaxInvoiceListRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'per_page' => ['nullable', 'integer', 'min:1', 'max:100'],
'direction' => ['nullable', 'string', Rule::in(TaxInvoice::DIRECTIONS)],
'status' => ['nullable', 'string', Rule::in(TaxInvoice::STATUSES)],
'invoice_type' => ['nullable', 'string', Rule::in(TaxInvoice::INVOICE_TYPES)],
'issue_type' => ['nullable', 'string', Rule::in(TaxInvoice::ISSUE_TYPES)],
'issue_date_from' => ['nullable', 'date'],
'issue_date_to' => ['nullable', 'date', 'after_or_equal:issue_date_from'],
'corp_num' => ['nullable', 'string', 'max:20'],
'corp_name' => ['nullable', 'string', 'max:100'],
'nts_confirm_num' => ['nullable', 'string', 'max:24'],
];
}
}

21
app/Http/Requests/TaxInvoice/TaxInvoiceSummaryRequest.php Normal file
View File

@@ -0,0 +1,21 @@
<?php
namespace App\Http\Requests\TaxInvoice;
use Illuminate\Foundation\Http\FormRequest;
class TaxInvoiceSummaryRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'issue_date_from' => ['nullable', 'date'],
'issue_date_to' => ['nullable', 'date', 'after_or_equal:issue_date_from'],
];
}
}

62
app/Http/Requests/TaxInvoice/UpdateTaxInvoiceRequest.php Normal file
View File

@@ -0,0 +1,62 @@
<?php
namespace App\Http\Requests\TaxInvoice;
use App\Models\Tenants\TaxInvoice;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;
class UpdateTaxInvoiceRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'invoice_type' => ['sometimes', 'string', Rule::in(TaxInvoice::INVOICE_TYPES)],
'issue_type' => ['sometimes', 'string', Rule::in(TaxInvoice::ISSUE_TYPES)],
'direction' => ['sometimes', 'string', Rule::in(TaxInvoice::DIRECTIONS)],
// 공급자 정보
'supplier_corp_num' => ['sometimes', 'string', 'max:20'],
'supplier_corp_name' => ['sometimes', 'string', 'max:100'],
'supplier_ceo_name' => ['nullable', 'string', 'max:50'],
'supplier_addr' => ['nullable', 'string', 'max:200'],
'supplier_biz_type' => ['nullable', 'string', 'max:100'],
'supplier_biz_class' => ['nullable', 'string', 'max:100'],
'supplier_contact_id' => ['nullable', 'string', 'email', 'max:100'],
// 공급받는자 정보
'buyer_corp_num' => ['sometimes', 'string', 'max:20'],
'buyer_corp_name' => ['sometimes', 'string', 'max:100'],
'buyer_ceo_name' => ['nullable', 'string', 'max:50'],
'buyer_addr' => ['nullable', 'string', 'max:200'],
'buyer_biz_type' => ['nullable', 'string', 'max:100'],
'buyer_biz_class' => ['nullable', 'string', 'max:100'],
'buyer_contact_id' => ['nullable', 'string', 'email', 'max:100'],
// 금액 정보
'issue_date' => ['sometimes', 'date'],
'supply_amount' => ['sometimes', 'numeric', 'min:0'],
'tax_amount' => ['sometimes', 'numeric', 'min:0'],
// 품목 정보
'items' => ['nullable', 'array'],
'items.*.name' => ['required_with:items', 'string', 'max:100'],
'items.*.spec' => ['nullable', 'string', 'max:100'],
'items.*.qty' => ['nullable', 'numeric', 'min:0'],
'items.*.unit_price' => ['nullable', 'numeric', 'min:0'],
'items.*.supply_amt' => ['nullable', 'numeric', 'min:0'],
'items.*.tax_amt' => ['nullable', 'numeric', 'min:0'],
'items.*.remark' => ['nullable', 'string', 'max:200'],
// 참조 정보
'reference_type' => ['nullable', 'string', 'max:50'],
'reference_id' => ['nullable', 'integer'],
'description' => ['nullable', 'string', 'max:1000'],
];
}
}