django-barobill 0.1.0__tar.gz

django_barobill-0.1.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+recursive-include django_barobill/static *
+recursive-include django_barobill/templates *
+recursive-include django_barobill/migrations *

django_barobill-0.1.0/PKG-INFO

@@ -0,0 +1,31 @@
+Metadata-Version: 2.2
+Name: django-barobill
+Version: 0.1.0
+Summary: A reusable Django app for integration with BaroBill services.
+Home-page: https://github.com/cuhong/django-barobill
+Author: cuhong
+Author-email: hongcoilhouse@gmail.com
+License: MIT License
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.0
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: django>=4.0
+Requires-Dist: requests==2.32.3
+Requires-Dist: zeep==4.3.1
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

django_barobill-0.1.0/django_barobill/__init__.py

@@ -0,0 +1,2 @@
+# django_barobill/__init__.py
+__version__ = "0.1.0"

django_barobill-0.1.0/django_barobill/admin.py

@@ -0,0 +1,3 @@
+from django.contrib import admin
+
+# Register your models here.

django_barobill-0.1.0/django_barobill/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class DjangoBarobillConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'django_barobill'

django_barobill-0.1.0/django_barobill/choices.py

@@ -0,0 +1,39 @@
+from django.db import models
+
+class BankAccountCollectCycle(models.TextChoices):
+    MINUTE10 = 'MINUTE10', '10분'
+    MINUTE30 = 'MINUTE30', '30분'
+    HOUR1 = 'HOUR1', '1시간'
+    HOUR4 = 'HOUR4', '4시간'
+    DAY1 = 'DAY1', '1일'
+
+class BankAccountBank(models.TextChoices):
+    KB = 'KB', '국민은행'
+    SHINHAN = 'SHINHAN', '신한은행'
+    NH = 'NH', '농협은행'
+    HANA = 'HANA', '하나은행'
+    SC = 'SC', '제일은행'
+    WOORI = 'WOORI', '우리은행'
+    IBK = 'IBK', '기업은행'
+    KDB = 'KDB', '산업은행'
+    KFCC = 'KFCC', '새마을금고'
+    CITI = 'CITI', '씨티은행'
+    SUHYUP = 'SUHYUP', '수협은행'
+    CU = 'CU', '신협은행'
+    EPOST = 'EPOST', '우체국'
+    KJBANK = 'KJBANK', '광주은행'
+    JBBANK = 'JBBANK', '전북은행'
+    DGB = 'DGB', '대구은행'
+    BUSANBANK = 'BUSANBANK', '부산은행'
+    KNBANK = 'KNBANK', '경남은행'
+    EJEJUBANK = 'EJEJUBANK', '제주은행'
+    KBANK = 'KBANK', '케이뱅크'
+
+class BankAccountAccountType(models.TextChoices):
+    C = 'C', '법인계좌'
+    P = 'P', '개인계좌'
+
+class BankAccountTransactionDirection(models.TextChoices):
+    Deposit = 'D', '입금'
+    Withdraw = 'W', '출금'
+    ETC = 'E', '기타'

django_barobill-0.1.0/django_barobill/errors.py

@@ -0,0 +1,67 @@
+error_dict = {
+    # 커스텀
+    901: "해지된 계좌 입니다",
+    902: "해지되지 않은 계좌 입니다",
+    # 기본 오류코드
+    -10000: "알 수 없는 오류 발생. API 호출 중 서버오류가 발생한 경우입니다. 바로빌로 문의바랍니다.",
+    -10003: "연동서비스가 점검 중입니다.",
+    -10004: "해당 기능은 더 이상 사용되지 않습니다.",
+    -10007: "해당 기능을 사용할 수 없습니다.",
+    -10005: "최대 100건까지만 사용하실 수 있습니다.",
+    -10006: "최대 1000건까지만 사용하실 수 있습니다.",
+    -10008: "날짜형식이 잘못되었습니다.",
+    -10148: "조회 기간이 잘못되었습니다.",
+    -40001: "파일을 찾을 수 없습니다.",
+    -40002: "빈 파일입니다(0byte).",
+    # 스크래핑 공통
+    -51001: "서비스가 신청되지 않았습니다.",
+    -51002: "이미 신청되어 있습니다.",
+    -51003: "이미 해지되었습니다.",
+    -51004: "해지 상태가 아닙니다.",
+    -51005: "해지 당월에만 해지 취소할 수 있습니다.",
+    -51006: "해지 당월에는 재신청 할 수 없습니다. 해지 취소로 진행해주세요.",
+    -51007: "테스트베드는 최대 2개까지만 등록할 수 있습니다.",
+    -51008: "이미 수집중입니다.",
+    # 연동정보 관련
+    -10002: "해당 인증키를 찾을 수 없습니다.",
+    -10001: "해당 인증키와 연결된 연계사가 아닙니다.",
+    -24005: "사업자번호와 아이디가 맞지 않습니다.",
+    -50001: "계좌를 찾을 수 없습니다.",
+    -50002: "계좌를 조회할 권한이 없습니다.",
+    -50004: "일일 즉시조회 횟수(10회)를 초과하였습니다.",
+    -50211: "수집주기가 잘못 입력되었습니다.",
+    -50212: "은행 코드가 잘못 입력되었습니다.",
+    -50213: "계좌유형이 잘못 입력되었습니다.",
+    -50214: "계좌번호가 잘못 입력되었습니다.",
+    -50215: "계좌 비밀번호가 잘못 입력되었습니다.",
+    -50216: "계좌 비밀번호를 입력하지 않아야하는 은행입니다.",
+    -50217: "빠른조회 아이디가 잘못 입력되었습니다.",
+    -50218: "빠른조회 아이디를 입력하지 않아야하는 은행입니다.",
+    -50219: "빠른조회 비밀번호가 잘못 입력되었습니다.",
+    -50220: "빠른조회 비밀번호를 입력하지 않아야하는 은행입니다.",
+    -50221: "사업자번호 또는 주민번호(앞6자리)가 잘못 입력되었습니다.",
+    -50222: "사업자번호 또는 주민번호(앞6자리)를 입력하지 않아야하는 은행입니다.",
+    -50223: "유효한 계좌정보가 아닙니다. 계좌정보를 확인해 주시기 바랍니다.",
+    -50224: "계좌정보 검증에 실패하였습니다. 잠시 후 다시 시도해 주시기 바랍니다.",
+    -50225: "이미 등록된 계좌번호입니다.",
+    -50226: "간편조회(빠른조회)서비스에 등록되지 않은 계좌입니다.",
+    -50251: "입출금내역 키(TransRefKey)가 잘못 입력되었습니다.",
+    -50252: "계좌 입출금내역을 찾을 수 없습니다."
+}
+
+
+class BarobillBaseError(Exception):
+    def __init__(self, code, message=None):
+        self.code = int(code)
+        self.message = message or error_dict.get(self.code, f"알 수 없는 오류 코드 : {self.code}")
+
+    def __str__(self):
+        return self.message
+
+
+class BarobillAPIError(BarobillBaseError):
+    pass
+
+
+class BarobillError(BarobillBaseError):
+    pass

django_barobill-0.1.0/django_barobill/migrations/0001_initial.py

@@ -0,0 +1,78 @@
+# Generated by Django 5.1.4 on 2025-01-16 01:16
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Partner',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(max_length=255, unique=True, verbose_name='파트너사명')),
+                ('brn', models.CharField(max_length=10, unique=True, verbose_name='사업자등록번호')),
+                ('api_key', models.CharField(max_length=36, verbose_name='인증키')),
+                ('userid', models.CharField(max_length=256, verbose_name='파트너사 사용자 아이디')),
+                ('dev', models.BooleanField(default=False, verbose_name='테스트모드')),
+            ],
+            options={
+                'verbose_name': '파트너',
+                'verbose_name_plural': '파트너',
+            },
+        ),
+        migrations.CreateModel(
+            name='BankAccount',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('collect_cycle', models.CharField(choices=[('MINUTE10', '10분'), ('MINUTE30', '30분'), ('HOUR1', '1시간'), ('HOUR4', '4시간'), ('DAY1', '1일')], max_length=10, verbose_name='수집주기')),
+                ('bank', models.CharField(choices=[('KB', '국민은행'), ('SHINHAN', '신한은행'), ('NH', '농협은행'), ('HANA', '하나은행'), ('SC', '제일은행'), ('WOORI', '우리은행'), ('IBK', '기업은행'), ('KDB', '산업은행'), ('KFCC', '새마을금고'), ('CITI', '씨티은행'), ('SUHYUP', '수협은행'), ('CU', '신협은행'), ('EPOST', '우체국'), ('KJBANK', '광주은행'), ('JBBANK', '전북은행'), ('DGB', '대구은행'), ('BUSANBANK', '부산은행'), ('KNBANK', '경남은행'), ('EJEJUBANK', '제주은행'), ('KBANK', '케이뱅크')], max_length=10, verbose_name='은행')),
+                ('account_type', models.CharField(choices=[('C', '법인계좌'), ('P', '개인계좌')], max_length=1, verbose_name='계좌유형')),
+                ('account_no', models.CharField(max_length=50, verbose_name='계좌번호')),
+                ('alias', models.CharField(default=None, max_length=50, null=True, verbose_name='별칭')),
+                ('usage', models.CharField(default=None, max_length=50, null=True, verbose_name='용도')),
+                ('is_stop', models.BooleanField(default=False, verbose_name='해지')),
+                ('stop_date', models.DateField(default=None, null=True, verbose_name='해지일')),
+                ('partner', models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, to='django_barobill.partner', verbose_name='파트너')),
+            ],
+            options={
+                'verbose_name': '계좌',
+                'verbose_name_plural': '계좌',
+            },
+        ),
+        migrations.CreateModel(
+            name='BankAccountTransaction',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('trans_direction', models.CharField(choices=[('D', '입금'), ('W', '출금'), ('E', '기타')], max_length=1)),
+                ('deposit', models.BigIntegerField(default=None, null=True)),
+                ('withdraw', models.BigIntegerField(default=None, null=True)),
+                ('balance', models.BigIntegerField(default=0)),
+                ('trans_dt', models.DateTimeField()),
+                ('trans_type', models.CharField(default=None, max_length=50, null=True, verbose_name='입출금구분')),
+                ('trans_office', models.CharField(default=None, max_length=50, null=True, verbose_name='입출금취급점')),
+                ('trans_remark', models.CharField(default=None, max_length=50, null=True, verbose_name='입출금비고')),
+                ('mgt_remark_1', models.CharField(default=None, max_length=50, null=True, verbose_name='비고1')),
+                ('trans_ref_key', models.CharField(max_length=24, verbose_name='입출금내역 키')),
+                ('memo', models.CharField(default=None, max_length=100, null=True, verbose_name='입출금내역 키')),
+                ('meta', models.JSONField(default=None, null=True, verbose_name='추가 정보')),
+                ('bank_account', models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, to='django_barobill.bankaccount')),
+            ],
+            options={
+                'verbose_name': '입출금 기록',
+                'verbose_name_plural': '입출금 기록',
+                'ordering': ['-trans_dt', 'bank_account'],
+                'unique_together': {('bank_account', 'trans_ref_key')},
+            },
+        ),
+        migrations.AddConstraint(
+            model_name='bankaccount',
+            constraint=models.UniqueConstraint(fields=('partner', 'bank', 'account_no'), name='unique_partner_bank_account'),
+        ),
+    ]

django_barobill-0.1.0/django_barobill/models.py

@@ -0,0 +1,387 @@
+import datetime
+from typing import Optional
+
+from django.db import models
+from django.utils import timezone
+from zeep import Client
+
+from django_barobill.choices import BankAccountCollectCycle, BankAccountBank, BankAccountAccountType, BankAccountTransactionDirection
+from django_barobill.errors import BarobillAPIError, BarobillError
+from django_barobill.parsers import bank_account_log_parser
+
+
+class BankHelper:
+    def __init__(self, partner):
+        self.partner = partner
+        self.client = self._get_client()
+
+    def _get_client(self):
+        if self.partner.dev:
+            endpoint = "https://testws.baroservice.com/BANKACCOUNT.asmx?wsdl"
+        else:
+            endpoint = "https://ws.baroservice.com/BANKACCOUNT.asmx?wsdl"
+        return Client(endpoint)
+
+    def get_bank_account_management_url(self):
+        return self.client.service.GetBankAccountManagementURL(
+            CERTKEY=self.partner.api_key,
+            CorpNum=self.partner.brn,
+            ID=self.partner.userid,
+            PWD=''
+        )
+
+    def get_bank_account_list(self, avail_only: bool):
+        response = self.client.service.GetBankAccountEx(
+            CERTKEY=self.partner.api_key,
+            CorpNum=self.partner.brn,
+            AvailOnly=1 if avail_only is True else 0,
+        )
+        if response is None:
+            return []
+        return response
+
+    def register_bank_account(
+            self,
+            alias: str,
+            collect_cycle: BankAccountCollectCycle,
+            bank: BankAccountBank,
+            account_type: BankAccountAccountType,
+            account_no: str,
+            password: str,
+            usage: Optional[str] = None,
+            web_id: Optional[str] = None,
+            web_pwd: Optional[str] = None,
+            identity_num: Optional[str] = None
+    ):
+        # need test
+        result = self.client.service.RegisterBankAccount(
+            CERTKEY=self.partner.api_key,
+            CorpNum=self.partner.brn,
+            CollectCycle=collect_cycle,
+            Bank=bank,
+            BankAccountType=account_type,
+            BankAccountNum=account_no,
+            BankAccountPwd=password,
+            WebId=web_id,
+            WebPwd=web_pwd,
+            IdentityNum=identity_num,
+            Alias=alias,
+            Usage=usage,
+        )
+        if result != 1:
+            raise BarobillAPIError(result)
+        account, created = BankAccount.objects.update_or_create(
+            partner=self.partner, account_no=account_no, defaults=dict(
+                collect_cycle=collect_cycle, bank=bank, account_type=account_type, alias=alias, usage=usage, is_delete=False
+            )
+        )
+        return account
+
+    def update_bank_accounts(self):
+        account_list = self.get_bank_account_list(avail_only=False)
+        account_no_list = [acc.BankAccountNum for acc in account_list]
+        self.partner.bankaccount_set.filter(
+            account_no__in=account_no_list
+        ).update(is_stop=False, stop_date=None, )
+        self.partner.bankaccount_set.exclude(
+            account_no__in=account_no_list
+        ).update(is_stop=True, stop_date=timezone.localdate())
+
+
+class Partner(models.Model):
+    class Meta:
+        verbose_name = '파트너'
+        verbose_name_plural = verbose_name
+
+    name = models.CharField(max_length=255, unique=True, verbose_name='파트너사명')
+    brn = models.CharField(max_length=10, unique=True, verbose_name='사업자등록번호')
+    api_key = models.CharField(max_length=36, verbose_name='인증키')
+    userid = models.CharField(max_length=256, verbose_name='파트너사 사용자 아이디')
+    dev = models.BooleanField(default=False, null=False, verbose_name='테스트모드')
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.bank = BankHelper(self)
+
+
+class BankAccount(models.Model):
+    class Meta:
+        verbose_name = '계좌'
+        verbose_name_plural = verbose_name
+        constraints = [
+            models.UniqueConstraint(fields=['partner', 'bank', 'account_no'], name='unique_partner_bank_account'),
+        ]
+
+    partner = models.ForeignKey(Partner, null=False, blank=False, verbose_name='파트너', on_delete=models.PROTECT)
+    collect_cycle = models.CharField(
+        max_length=10, null=False, blank=False, choices=BankAccountCollectCycle.choices, verbose_name='수집주기'
+    )
+    bank = models.CharField(
+        max_length=10, null=False, blank=False, choices=BankAccountBank.choices, verbose_name='은행'
+    )
+    account_type = models.CharField(
+        max_length=1, null=False, blank=False, choices=BankAccountAccountType.choices, verbose_name='계좌유형'
+    )
+    account_no = models.CharField(
+        max_length=50, null=False, blank=False, verbose_name='계좌번호'
+    )
+    alias = models.CharField(max_length=50, null=True, blank=False, default=None, verbose_name='별칭')
+    usage = models.CharField(max_length=50, null=True, blank=False, default=None, verbose_name='용도')
+    is_stop = models.BooleanField(default=False, null=False, verbose_name='해지')
+    stop_date = models.DateField(null=True, blank=False, default=None, verbose_name='해지일')
+
+    def update_bank_account(
+            self,
+            password: Optional[str] = None,
+            web_id: Optional[str] = None,
+            web_pwd: Optional[str] = None,
+            identity_num: Optional[str] = None,
+            alias: Optional[str] = None,
+            usage: Optional[str] = None
+    ):
+        request_data = dict(
+            CERTKEY=self.partner.api_key,
+            CorpNum=self.partner.brn,
+            BankAccountNum=self.account_no
+        )
+        if password:
+            request_data['BankAccountPwd'] = password
+        if web_id:
+            request_data['WebId'] = web_id
+        if web_pwd:
+            request_data['WebPwd'] = web_pwd
+        if identity_num:
+            request_data['IdentityNum'] = identity_num
+        if alias:
+            request_data['Alias'] = alias
+        if usage:
+            request_data['Usage'] = usage
+        result = self.partner.bank.client.service.UpdateBankAccount(**request_data)
+        if result != 1:
+            raise BarobillAPIError(result)
+        save_fields = []
+        if self.alias != alias and alias is not None:
+            self.alias = alias
+            save_fields.append('alias')
+        if self.usage != usage and usage is not None:
+            self.usage = usage
+            save_fields.append('usage')
+        if len(save_fields) != 0:
+            self.save(update_fields=save_fields)
+
+    def stop_bank_account(self):
+        if self.is_stop is True:
+            raise BarobillError(901)
+        request_data = dict(
+            CERTKEY=self.partner.api_key,
+            CorpNum=self.partner.brn,
+            BankAccountNum=self.account_no
+        )
+        result = self.partner.bank.client.service.StopBankAccount(**request_data)
+        if result != 1:
+            raise BarobillAPIError(result)
+        self.is_stop = True
+        self.stop_date = timezone.localdate()
+        self.save(update_fields=['is_stop', 'stop_date'])
+
+    def cancel_stop_bank(self):
+        if self.is_stop is False:
+            raise BarobillError(902)
+        request_data = dict(
+            CERTKEY=self.partner.api_key,
+            CorpNum=self.partner.brn,
+            BankAccountNum=self.account_no
+        )
+        result = self.partner.bank.client.service.CancelStopBankAccount(**request_data)
+        if result != 1:
+            raise BarobillAPIError(result)
+        self.is_stop = False
+        self.stop_date = None
+        self.save(update_fields=['is_stop', 'stop_date'])
+
+    def re_register_bank_account(self):
+        if self.is_stop is False:
+            raise BarobillError(902)
+        request_data = dict(
+            CERTKEY=self.partner.api_key,
+            CorpNum=self.partner.brn,
+            BankAccountNum=self.account_no
+        )
+        result = self.partner.bank.client.service.ReRegistBankAccount(**request_data)
+        if result != 1:
+            raise BarobillAPIError(result)
+        self.is_stop = False
+        self.stop_date = None
+        self.save(update_fields=['is_stop', 'stop_date'])
+
+    def __update_log(self, log_list):
+        """
+        BankAccountLogEx2 의 list 값을 거래 기록에 등록한다.
+        :param log_list: [BankAccountLogEx2]
+        :return:None
+        """
+        parsed_log_list = map(bank_account_log_parser, log_list)
+        transactions = BankAccountTransaction.objects.bulk_create(
+            [BankAccountTransaction(bank_account=self, **parsed_log) for parsed_log in parsed_log_list],
+            ignore_conflicts=True
+        )
+
+    def update_date_log(self, date_string: str):
+        """
+        지정한 날짜의 로그를 불러와 데이터베이스에 저장한다.
+        :param date_string: YYYYMMDD 형태의 한국 날짜 string
+        :return: None
+        """
+        page = 1
+        log_list = []
+        while True:
+            result = self.get_daily_log(date_string, page)
+            log_list += [] if result.BankAccountLogList is None else result.BankAccountLogList.BankAccountLogEx2
+            if result.MaxPageNum == page:
+                break
+            page += 1
+        self.__update_log(log_list)
+
+    def update_today_log(self):
+        """
+        오늘 거래 내역을 불러오고, 데이터베이스에 저장한다.
+        :return: None
+        """
+        date_string = timezone.localdate().strftime('%Y%m%d')
+        self.update_date_log(date_string)
+
+    def update_yesterday_log(self):
+        """
+        어제의 거래 내역을 불러오고, 데이터베이스에 저장한다.
+        :return: None
+        """
+        date_string = (timezone.localdate() - datetime.timedelta(days=1)).strftime('%Y%m%d')
+        self.update_date_log(date_string)
+
+    def get_log(
+            self,
+            start_date: str,
+            end_date: str,
+            page: int,
+            direction: int = 1,
+            per_page: int = 100,
+            order: int = 1
+    ):
+        """
+        주어진 기간에 대한 거래 내역을  불러온다.
+        https://dev.barobill.co.kr/docs/references/%EA%B3%84%EC%A2%8C%EC%A1%B0%ED%9A%8C-API#GetPeriodBankAccountLogEx2
+        :param start_date: 한국시간 YYYYMMDD 형태의 조회 시작일 string.
+        :param end_date: 한국시간 YYYYMMDD 형태의 조회 종료일 string.
+        :param page: 조회할 페이지 수
+        :param direction: 거래 유형. 1 전체, 2 입금, 3출금
+        :param per_page: 페이지 당 결과 표시 수(최대 100개)
+        :param order: 거래일시 정렬 순서. 1 오름차순, 2. 내림차순
+        :return: barobill API 결과를 그대로 반환한다.(https://dev.barobill.co.kr/docs/references/%EA%B3%84%EC%A2%8C%EC%A1%B0%ED%9A%8C-API#PagedBankAccountLogEx2)
+        """
+        request_data = dict(
+            CERTKEY=self.partner.api_key,
+            CorpNum=self.partner.brn,
+            ID=self.partner.userid,
+            BankAccountNum=self.account_no,
+            StartDate=start_date,
+            EndDate=end_date,
+            TransDirection=direction,
+            CountPerPage=per_page,
+            CurrentPage=page,
+            OrderDirection=order  # 1 오름차순, 2 내림차순
+        )
+        result = self.partner.bank.client.service.GetPeriodBankAccountLogEx2(**request_data)
+        if result.CurrentPage <= 0:
+            raise BarobillAPIError(result.CurrentPage)
+        return result
+
+    def get_daily_log(
+            self,
+            base_date: str,
+            page: int,
+            direction: int = 1,
+            per_page: int = 100,
+            order: int = 1
+    ):
+        """
+        주어진 일자의 거래 내역을 불러온다.
+        https://dev.barobill.co.kr/docs/references/%EA%B3%84%EC%A2%8C%EC%A1%B0%ED%9A%8C-API#GetDailyBankAccountLogEx2
+        :param base_date: 한국시간 YYYYMMDD 형태의 조회일 string.
+        :param page: 조회할 페이지 수
+        :param direction: 거래 유형. 1 전체, 2 입금, 3출금
+        :param per_page: 페이지 당 결과 표시 수(최대 100개)
+        :param order: 거래일시 정렬 순서. 1 오름차순, 2. 내림차순
+        :return: barobill API 결과를 그대로 반환한다.(https://dev.barobill.co.kr/docs/references/%EA%B3%84%EC%A2%8C%EC%A1%B0%ED%9A%8C-API#PagedBankAccountLogEx2)
+        """
+        request_data = dict(
+            CERTKEY=self.partner.api_key,
+            CorpNum=self.partner.brn,
+            ID=self.partner.userid,
+            BankAccountNum=self.account_no,
+            BaseDate=base_date,
+            TransDirection=direction,
+            CountPerPage=per_page,
+            CurrentPage=page,
+            OrderDirection=order  # 1 오름차순, 2 내림차순
+        )
+        result = self.partner.bank.client.service.GetDailyBankAccountLogEx2(**request_data)
+        if result.CurrentPage <= 0:
+            raise BarobillAPIError(result.CurrentPage)
+        return result
+
+
+    def get_monthly_log(
+            self,
+            base_month: str,
+            page: int,
+            direction: int = 1,
+            per_page: int = 100,
+            order: int = 1
+    ):
+        """
+        주어진 일자의 거래 내역을 불러온다.
+        https://dev.barobill.co.kr/docs/references/%EA%B3%84%EC%A2%8C%EC%A1%B0%ED%9A%8C-API#GetMonthlyBankAccountLogEx2
+        :param base_month: 한국시간 YYYYMM 형태의 조회월 string.
+        :param page: 조회할 페이지 수
+        :param direction: 거래 유형. 1 전체, 2 입금, 3출금
+        :param per_page: 페이지 당 결과 표시 수(최대 100개)
+        :param order: 거래일시 정렬 순서. 1 오름차순, 2. 내림차순
+        :return: barobill API 결과를 그대로 반환한다.(https://dev.barobill.co.kr/docs/references/%EA%B3%84%EC%A2%8C%EC%A1%B0%ED%9A%8C-API#PagedBankAccountLogEx2)
+        """
+        request_data = dict(
+            CERTKEY=self.partner.api_key,
+            CorpNum=self.partner.brn,
+            ID=self.partner.userid,
+            BankAccountNum=self.account_no,
+            BaseMonth=base_month,
+            TransDirection=direction,
+            CountPerPage=per_page,
+            CurrentPage=page,
+            OrderDirection=order  # 1 오름차순, 2 내림차순
+        )
+        result = self.partner.bank.client.service.GetDailyBankAccountLogEx2(**request_data)
+        if result.CurrentPage <= 0:
+            raise BarobillAPIError(result.CurrentPage)
+        return result
+
+
+class BankAccountTransaction(models.Model):
+    class Meta:
+        verbose_name = '입출금 기록'
+        verbose_name_plural = verbose_name
+        unique_together = ('bank_account', 'trans_ref_key')
+        ordering = ['-trans_dt', 'bank_account']
+
+    bank_account = models.ForeignKey(BankAccount, null=False, blank=False, on_delete=models.PROTECT)
+    trans_direction = models.CharField(max_length=1, null=False, blank=False, choices=BankAccountTransactionDirection.choices)
+    deposit = models.BigIntegerField(null=True, blank=False, default=None)
+    withdraw = models.BigIntegerField(null=True, blank=False, default=None)
+    balance = models.BigIntegerField(null=False, blank=False, default=0)
+    trans_dt = models.DateTimeField(null=False, blank=False)
+    trans_type = models.CharField(max_length=50, null=True, blank=False, default=None, verbose_name='입출금구분')
+    trans_office = models.CharField(max_length=50, null=True, blank=False, default=None, verbose_name='입출금취급점')
+    trans_remark = models.CharField(max_length=50, null=True, blank=False, default=None, verbose_name='입출금비고')
+    mgt_remark_1 = models.CharField(max_length=50, null=True, blank=False, default=None, verbose_name='비고1')
+    trans_ref_key = models.CharField(max_length=24, null=False, blank=False, verbose_name='입출금내역 키')
+    memo = models.CharField(max_length=100, null=True, blank=False, default=None, verbose_name='입출금내역 키')
+    meta = models.JSONField(null=True, blank=False, default=None, verbose_name='추가 정보')

django_barobill-0.1.0/django_barobill/parsers.py

@@ -0,0 +1,29 @@
+import datetime
+
+from django_barobill.utils import KST
+
+
+def bank_account_log_parser(item):
+    """
+    BankAccountLogEx2를 데이터베이스에 적재할 수 있는 형태로 파싱한다.
+    :param item: BankAccountLogEx2를
+    :return: BankAccountTransaction
+    """
+    from django_barobill.choices import BankAccountTransactionDirection
+    return dict(
+        trans_direction={
+            "입금": BankAccountTransactionDirection.Deposit,
+            "출금": BankAccountTransactionDirection.Withdraw,
+            "기타": BankAccountTransactionDirection.ETC,
+        }.get(item.TransDirection),
+        deposit=int(item.Deposit),
+        withdraw=int(item.Withdraw),
+        balance=int(item.Balance),
+        trans_dt=KST.localize(datetime.datetime.strptime(item.TransDT, "%Y%m%d%H%M%S")),
+        trans_type=item.TransType,
+        trans_office=item.TransOffice,
+        trans_remark=item.TransRemark,
+        mgt_remark_1=item.MgtRemark1,
+        trans_ref_key=item.TransRefKey,
+        memo=item.Memo,
+    )

django_barobill-0.1.0/django_barobill/tests.py

@@ -0,0 +1,48 @@
+import datetime
+
+from django.test import TestCase
+from django.utils import timezone
+
+from django_barobill.choices import BankAccountBank, BankAccountCollectCycle, BankAccountAccountType
+from django_barobill.models import Partner, BankAccount
+from django_barobill.parsers import bank_account_log_parser
+
+
+# Create your tests here.
+class TestBankAccount(TestCase):
+    def setUp(self):
+        self.partner = Partner.objects.create(
+            name='지구하다ERP',
+            brn='2978601887',
+            api_key='0830C49B-71EA-44E0-81E0-DAAD883B3FC9',
+            userid='cuhong',
+            dev=True
+        )
+        self.bank = BankAccountBank.HANA
+        self.account_no = '26091002164604'
+        self.bank_account = BankAccount.objects.create(
+            partner=self.partner,
+            collect_cycle=BankAccountCollectCycle.MINUTE10,
+            bank=self.bank,
+            account_type=BankAccountAccountType.C,
+            account_no=self.account_no,
+        )
+
+    def test_get_yesterday_log(self):
+        date_string = (timezone.localdate() - datetime.timedelta(days=0)).strftime('%Y%m%d')
+        log_list = []
+        page = 1
+        while True:
+            result = self.bank_account.get_daily_log(date_string, page)
+            log_list += [] if result.BankAccountLogList is None else result.BankAccountLogList.BankAccountLogEx2
+            if result.MaxPageNum == page:
+                break
+            page += 1
+        for log in log_list:
+            print(bank_account_log_parser(log))
+
+    def test_update_today_log(self):
+        self.bank_account.update_today_log()
+
+ba = BankAccount.objects.first()
+ba.update_yesterday_log()

django_barobill-0.1.0/django_barobill/utils.py

@@ -0,0 +1,9 @@
+import pytz
+from zeep import Client
+
+KST = pytz.timezone('Asia/Seoul')
+
+class ServiceWrapper:
+    def __init__(self, endpoint):
+        self.endpoint = endpoint
+        self.client = Client(endpoint)

django_barobill-0.1.0/django_barobill/views.py

@@ -0,0 +1,3 @@
+from django.shortcuts import render
+
+# Create your views here.

django_barobill-0.1.0/django_barobill.egg-info/PKG-INFO

@@ -0,0 +1,31 @@
+Metadata-Version: 2.2
+Name: django-barobill
+Version: 0.1.0
+Summary: A reusable Django app for integration with BaroBill services.
+Home-page: https://github.com/cuhong/django-barobill
+Author: cuhong
+Author-email: hongcoilhouse@gmail.com
+License: MIT License
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.0
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: django>=4.0
+Requires-Dist: requests==2.32.3
+Requires-Dist: zeep==4.3.1
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

django_barobill-0.1.0/django_barobill.egg-info/SOURCES.txt

@@ -0,0 +1,23 @@
+LICENSE
+MANIFEST.in
+README.md
+setup.cfg
+setup.py
+django_barobill/__init__.py
+django_barobill/admin.py
+django_barobill/apps.py
+django_barobill/choices.py
+django_barobill/errors.py
+django_barobill/models.py
+django_barobill/parsers.py
+django_barobill/tests.py
+django_barobill/utils.py
+django_barobill/views.py
+django_barobill.egg-info/PKG-INFO
+django_barobill.egg-info/SOURCES.txt
+django_barobill.egg-info/dependency_links.txt
+django_barobill.egg-info/requires.txt
+django_barobill.egg-info/top_level.txt
+django_barobill/migrations/0001_initial.py
+django_barobill/migrations/__init__.py
+tests/test_app.py

django_barobill-0.1.0/django_barobill.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

django_barobill-0.1.0/django_barobill.egg-info/requires.txt

@@ -0,0 +1,3 @@
+django>=4.0
+requests==2.32.3
+zeep==4.3.1

django_barobill-0.1.0/django_barobill.egg-info/top_level.txt

@@ -0,0 +1 @@
+django_barobill

django_barobill-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

django_barobill-0.1.0/setup.py

@@ -0,0 +1,31 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="django-barobill",  # 패키지 이름 (PyPI에 등록될 이름)
+    version="0.1.0",  # 초기 버전
+    packages=find_packages(exclude=["tests*", "docs*"]),  # 'django_barobill' 폴더 포함
+    include_package_data=True,  # MANIFEST.in 파일에 포함된 파일도 추가
+    license="MIT License",  # 라이선스
+    description="A reusable Django app for integration with BaroBill services.",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",  # README의 마크다운 형식 지원
+    url="https://github.com/cuhong/django-barobill",  # 깃허브 등의 URL
+    author="cuhong",
+    author_email="hongcoilhouse@gmail.com",
+    classifiers=[
+        "Environment :: Web Environment",
+        "Framework :: Django",
+        "Framework :: Django :: 4.0",  # 해당 Django 버전
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 3.8",  # 최소 파이썬 버전
+        "Topic :: Software Development :: Libraries :: Python Modules",
+    ],
+    python_requires=">=3.8",  # 지원 파이썬 버전
+    install_requires=[
+        "django>=4.0",  # Django 패키지 요구사항
+        "requests==2.32.3",
+        "zeep==4.3.1"
+    ],
+)

django_barobill-0.1.0/tests/test_app.py

@@ -0,0 +1,7 @@
+import unittest
+from django_barobill.apps import DjangoBarobillConfig
+
+
+class TestDjangoBarobill(unittest.TestCase):
+    def test_app_name(self):
+        self.assertEqual(DjangoBarobillConfig.name, "django_barobill")