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

feat: [재무] 어음 V8 + 상품권 접대비 연동 + 일반전표/계정과목 API

Browse Source 
- Bill 확장 필드 (V8), Loan 상품권 카테고리/접대비 자동 연동
- GeneralJournalEntry CRUD, AccountSubject API
- 접대비/복리후생비 날짜 필터, 매출채권 soft delete 제외
- 바로빌 연동 API 엔드포인트 추가
- 부가세 상세 조회 API

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
권혁성
2026-03-07 02:58:55 +09:00
parent 3d12687a2d
commit 1df34b2fa9
36 changed files with 3579 additions and 378 deletions
Download Patch File Download Diff File Expand all files Collapse all files

163
app/Models/Tenants/Bill.php
View File

@@ -31,6 +31,58 @@ class Bill extends Model
'created_by',
'updated_by',
'deleted_by',
// V8 확장 필드
'instrument_type',
'medium',
'bill_category',
'electronic_bill_no',
'registration_org',
'drawee',
'acceptance_status',
'acceptance_date',
'acceptance_refusal_date',
'acceptance_refusal_reason',
'endorsement',
'endorsement_order',
'storage_place',
'issuer_bank',
'is_discounted',
'discount_date',
'discount_bank',
'discount_rate',
'discount_amount',
'endorsement_date',
'endorsee',
'endorsement_reason',
'collection_bank',
'collection_request_date',
'collection_fee',
'collection_complete_date',
'collection_result',
'collection_deposit_date',
'collection_deposit_amount',
'settlement_bank',
'payment_method',
'actual_payment_date',
'payment_place',
'payment_place_detail',
'renewal_date',
'renewal_new_bill_no',
'renewal_reason',
'recourse_date',
'recourse_amount',
'recourse_target',
'recourse_reason',
'buyback_date',
'buyback_amount',
'buyback_bank',
'dishonored_date',
'dishonored_reason',
'has_protest',
'protest_date',
'recourse_notice_date',
'recourse_notice_deadline',
'is_split',
];
protected $casts = [
@@ -41,21 +93,57 @@ class Bill extends Model
'bank_account_id' => 'integer',
'installment_count' => 'integer',
'is_electronic' => 'boolean',
// V8 확장 casts
'acceptance_date' => 'date',
'acceptance_refusal_date' => 'date',
'discount_date' => 'date',
'discount_rate' => 'decimal:2',
'discount_amount' => 'decimal:2',
'endorsement_date' => 'date',
'collection_request_date' => 'date',
'collection_fee' => 'decimal:2',
'collection_complete_date' => 'date',
'collection_deposit_date' => 'date',
'collection_deposit_amount' => 'decimal:2',
'actual_payment_date' => 'date',
'renewal_date' => 'date',
'recourse_date' => 'date',
'recourse_amount' => 'decimal:2',
'buyback_date' => 'date',
'buyback_amount' => 'decimal:2',
'dishonored_date' => 'date',
'protest_date' => 'date',
'recourse_notice_date' => 'date',
'recourse_notice_deadline' => 'date',
'is_discounted' => 'boolean',
'has_protest' => 'boolean',
'is_split' => 'boolean',
];
/**
* 배열/JSON 변환 시 날짜 형식 지정
*/
/**
* 날짜 cast 필드 목록 (toArray에서 Y-m-d 형식 변환용)
*/
private const DATE_FIELDS = [
'issue_date', 'maturity_date',
'acceptance_date', 'acceptance_refusal_date',
'discount_date', 'endorsement_date',
'collection_request_date', 'collection_complete_date', 'collection_deposit_date',
'actual_payment_date',
'renewal_date', 'recourse_date', 'buyback_date',
'dishonored_date', 'protest_date', 'recourse_notice_date', 'recourse_notice_deadline',
];
public function toArray(): array
{
$array = parent::toArray();
// 날짜 필드를 Y-m-d 형식으로 변환
if (isset($array['issue_date']) && $this->issue_date) {
$array['issue_date'] = $this->issue_date->format('Y-m-d');
}
if (isset($array['maturity_date']) && $this->maturity_date) {
$array['maturity_date'] = $this->maturity_date->format('Y-m-d');
foreach (self::DATE_FIELDS as $field) {
if (isset($array[$field]) && $this->{$field}) {
$array[$field] = $this->{$field}->format('Y-m-d');
}
}
return $array;
@@ -69,14 +157,42 @@ public function toArray(): array
'issued' => '발행',
];
/**
* 증권종류
*/
public const INSTRUMENT_TYPES = [
'promissory' => '약속어음',
'exchange' => '환어음',
'cashierCheck' => '자기앞수표',
'currentCheck' => '당좌수표',
];
/**
* 수취 어음 상태 목록
*/
public const RECEIVED_STATUSES = [
'stored' => '보관중',
'endorsed' => '배서양도',
'discounted' => '할인',
'collectionRequest' => '추심의뢰',
'collectionComplete' => '추심완료',
'maturityDeposit' => '만기입금',
'paymentComplete' => '결제완료',
'dishonored' => '부도',
'renewed' => '개서',
'buyback' => '환매',
// 하위호환
'maturityAlert' => '만기입금(7일전)',
'maturityResult' => '만기결과',
'paymentComplete' => '결제완료',
];
/**
* 수취 수표 상태 목록
*/
public const RECEIVED_CHECK_STATUSES = [
'stored' => '보관중',
'endorsed' => '배서양도',
'deposited' => '입금',
'dishonored' => '부도',
];
@@ -85,10 +201,25 @@ public function toArray(): array
*/
public const ISSUED_STATUSES = [
'stored' => '보관중',
'issued' => '지급대기',
'maturityPayment' => '만기결제',
'paymentComplete' => '결제완료',
'dishonored' => '부도',
'renewed' => '개서',
// 하위호환
'maturityAlert' => '만기입금(7일전)',
'collectionRequest' => '추심의뢰',
'collectionComplete' => '추심완료',
'suing' => '추소중',
];
/**
* 발행 수표 상태 목록
*/
public const ISSUED_CHECK_STATUSES = [
'stored' => '보관중',
'issued' => '지급대기',
'cashed' => '현금화',
'dishonored' => '부도',
];
@@ -149,11 +280,25 @@ public function getBillTypeLabelAttribute(): string
*/
public function getStatusLabelAttribute(): string
{
$isCheck = in_array($this->instrument_type, ['cashierCheck', 'currentCheck']);
if ($this->bill_type === 'received') {
return self::RECEIVED_STATUSES[$this->status] ?? $this->status;
$statuses = $isCheck ? self::RECEIVED_CHECK_STATUSES : self::RECEIVED_STATUSES;
return $statuses[$this->status] ?? self::RECEIVED_STATUSES[$this->status] ?? $this->status;
}
return self::ISSUED_STATUSES[$this->status] ?? $this->status;
$statuses = $isCheck ? self::ISSUED_CHECK_STATUSES : self::ISSUED_STATUSES;
return $statuses[$this->status] ?? self::ISSUED_STATUSES[$this->status] ?? $this->status;
}
/**
* 증권종류 라벨
*/
public function getInstrumentTypeLabelAttribute(): string
{
return self::INSTRUMENT_TYPES[$this->instrument_type] ?? $this->instrument_type ?? '약속어음';
}
/**