kra-etims-sdk 0.1.2__py3-none-any.whl → 0.1.3__py3-none-any.whl

kra_etims_sdk/schemas.py

@@ -1,25 +1,33 @@
 from typing import List, Optional
 from typing_extensions import Annotated
-
 from pydantic import (
     BaseModel,
     Field,
     conint,
     condecimal,
     StringConstraints,
+    AfterValidator,
 )
+import re
+
 
 # =========================================================
-# COMMON CONSTRAINED TYPES (Pydantic v2 style)
+# COMMON CONSTRAINED TYPES (aligned with PHP)
 # =========================================================
 
 TIN = Annotated[str, StringConstraints(min_length=1, max_length=20)]
-BHF = Annotated[str, StringConstraints(min_length=1, max_length=20)]
+BHF_ID = Annotated[str, StringConstraints(min_length=1, max_length=10)]  # Fixed: was 20
+
+YN = Annotated[str, StringConstraints(pattern=r"^[YN]$")]
+
+# YYYYMMDDHHMMSS (exactly 14 digits)
+DT14 = Annotated[str, StringConstraints(pattern=r"^\d{14}$")]
 
-YN = Annotated[str, StringConstraints(pattern="^[YN]$")]
+# Flexible date: 8 to 14 digits (used in purchase/sales dates)
+FLEX_DATE = Annotated[str, StringConstraints(min_length=8, max_length=14)]
 
-DT14 = Annotated[str, StringConstraints(pattern=r"^\d{14}$")]  # YYYYMMDDHHmmss
-DT8 = Annotated[str, StringConstraints(pattern=r"^\d{8}$")]    # YYYYMMDD
+# Exactly 8-digit date (YYYYMMDD)
+DT8 = Annotated[str, StringConstraints(pattern=r"^\d{8}$")]
 
 
 # =========================================================
@@ -28,185 +36,273 @@ DT8 = Annotated[str, StringConstraints(pattern=r"^\d{8}$")]    # YYYYMMDD
 
 class Initialization(BaseModel):
     tin: TIN
-    bhfId: BHF
-    dvcSrlNo: Annotated[str, StringConstraints(min_length=1, max_length=50)]
+    bhfId: BHF_ID
+    dvcSrlNo: Annotated[str, StringConstraints(min_length=1)]  # no max in PHP
 
 
 # =========================================================
-# BASIC LIST REQUESTS
+# COMMON REQUESTS
 # =========================================================
 
-class CodeList(BaseModel):
-    tin: TIN
-    bhfId: BHF
+class LastReqOnly(BaseModel):
     lastReqDt: DT14
 
 
-class BhfList(BaseModel):
-    lastReqDt: DT14
-
-
-class NoticeList(BaseModel):
-    tin: TIN
-    bhfId: BHF
-    lastReqDt: DT14
-
-
-class TaxpayerInfo(BaseModel):
-    tin: TIN
-    bhfId: BHF
-    lastReqDt: DT14
-
-
-class CustomerList(BaseModel):
-    tin: TIN
-    bhfId: BHF
-    lastReqDt: DT14
+class CustSearchReq(BaseModel):
+    custmTin: TIN
 
 
 # =========================================================
 # BRANCH MANAGEMENT
 # =========================================================
 
-class BranchInsurance(BaseModel):
-    isrccCd: str
-    isrccNm: str
-    isrcRt: condecimal(ge=0)
+class BranchCustomer(BaseModel):
+    custNo: Annotated[str, StringConstraints(min_length=1)]
+    custTin: TIN
+    custNm: Annotated[str, StringConstraints(min_length=1)]
     useYn: YN
-    regrNm: str
-    regrId: str
+    regrId: Annotated[str, StringConstraints(min_length=1)]
+    regrNm: Annotated[str, StringConstraints(min_length=1)]
+    modrId: Optional[str] = None
+    modrNm: Optional[str] = None
 
 
-class BranchUserAccount(BaseModel):
-    userId: str
-    userNm: str
-    pwd: str
+class BranchUser(BaseModel):
+    userId: Annotated[str, StringConstraints(min_length=1)]
+    userNm: Annotated[str, StringConstraints(min_length=1)]
+    pwd: Annotated[str, StringConstraints(min_length=1)]
     useYn: YN
-    regrNm: str
-    regrId: str
+    regrId: Annotated[str, StringConstraints(min_length=1)]
+    regrNm: Annotated[str, StringConstraints(min_length=1)]
+    modrId: Optional[str] = None
+    modrNm: Optional[str] = None
 
 
-class CustomerInfo(BaseModel):
-    custNo: str
-    custTin: str
-    custNm: str
+class BranchInsurance(BaseModel):
+    isrccCd: Annotated[str, StringConstraints(min_length=1)]
+    isrccNm: Annotated[str, StringConstraints(min_length=1)]
+    isrcRt: condecimal(ge=0)
     useYn: YN
-    regrNm: str
-    regrId: str
+    regrId: Annotated[str, StringConstraints(min_length=1)]
+    regrNm: Annotated[str, StringConstraints(min_length=1)]
+    modrId: Optional[str] = None
+    modrNm: Optional[str] = None
 
 
 # =========================================================
-# PURCHASE
+# ITEM
 # =========================================================
 
-class PurchaseTrns(BaseModel):
-    tin: TIN
-    bhfId: BHF
-    lastReqDt: DT14
-
-
-class PurchaseItem(BaseModel):
-    itemSeq: conint(ge=1)
-    itemCd: str
-    itemNm: str
-    qty: condecimal(gt=0)
-    prc: condecimal(ge=0)
-    splyAmt: condecimal(ge=0)
-    taxTyCd: Annotated[str, StringConstraints(pattern="^[A-E]$")]
-    taxblAmt: condecimal(ge=0)
-    taxAmt: condecimal(ge=0)
-    totAmt: condecimal(ge=0)
+class SaveItem(BaseModel):
+    itemCd: Annotated[str, StringConstraints(min_length=1)]
+    itemClsCd: Annotated[str, StringConstraints(min_length=1)]
+    itemTyCd: Annotated[str, StringConstraints(min_length=1)]
+    itemNm: Annotated[str, StringConstraints(min_length=1)]
+    itemStdNm: Optional[Annotated[str, ...]] = None  # string or null
+    orgnNatCd: Annotated[str, StringConstraints(min_length=2, max_length=5)]
+    pkgUnitCd: Annotated[str, StringConstraints(min_length=1)]
+    qtyUnitCd: Annotated[str, StringConstraints(min_length=1)]
+    taxTyCd: Annotated[str, StringConstraints(min_length=1)]
+    dftPrc: condecimal(ge=0)
+    grpPrcL1: Optional[condecimal()] = None
+    grpPrcL2: Optional[condecimal()] = None
+    grpPrcL3: Optional[condecimal()] = None
+    grpPrcL4: Optional[condecimal()] = None
+    grpPrcL5: Optional[condecimal()] = None
+    btchNo: Optional[Annotated[str, ...]] = None  # string or null
+    bcd: Optional[Annotated[str, ...]] = None     # string or null
+    addInfo: Optional[Annotated[str, ...]] = None # string or null
+    sftyQty: Optional[condecimal()] = None
+    isrcAplcbYn: YN
+    useYn: YN
+    regrId: Annotated[str, StringConstraints(min_length=1)]
+    regrNm: Annotated[str, StringConstraints(min_length=1)]
+    modrId: Annotated[str, StringConstraints(min_length=1)]  # REQUIRED in PHP
+    modrNm: Annotated[str, StringConstraints(min_length=1)]  # REQUIRED in PHP
 
 
-class PurchaseTransaction(BaseModel):
-    invcNo: conint(ge=1)
-    spplrTin: str
-    spplrNm: str
-    pchsDt: DT8
-    totItemCnt: conint(ge=1)
-    totTaxblAmt: condecimal(ge=0)
-    totTaxAmt: condecimal(ge=0)
-    totAmt: condecimal(ge=0)
-    regrId: str
-    regrNm: str
-    itemList: List[PurchaseItem]
+class ItemComposition(BaseModel):
+    itemCd: Annotated[str, StringConstraints(min_length=1)]
+    cpstItemCd: Annotated[str, StringConstraints(min_length=1)]
+    cpstQty: condecimal(gt=0)  # min(0.001) → gt=0 covers it
+    regrId: Annotated[str, StringConstraints(min_length=1)]
+    regrNm: Annotated[str, StringConstraints(min_length=1)]
+    modrId: Optional[str] = None
+    modrNm: Optional[str] = None
 
 
 # =========================================================
-# SALES
+# IMPORTED ITEM
 # =========================================================
 
-class SalesItem(BaseModel):
+class ImportItemUpdate(BaseModel):
+    taskCd: Annotated[str, StringConstraints(min_length=1)]
+    dclDe: Annotated[str, StringConstraints(min_length=8, max_length=14)]
     itemSeq: conint(ge=1)
-    itemCd: str
-    itemClsCd: str
-    itemNm: str
-    qty: condecimal(gt=0)
-    prc: condecimal(ge=0)
-    splyAmt: condecimal(ge=0)
-    taxTyCd: Annotated[str, StringConstraints(pattern="^[A-E]$")]
-    taxblAmt: condecimal(ge=0)
-    taxAmt: condecimal(ge=0)
-    totAmt: condecimal(ge=0)
-
-
-class SalesTrns(BaseModel):
-    tin: TIN
-    bhfId: BHF
-    lastReqDt: DT14
-
-
-class SelectSalesTrns(BaseModel):
-    tin: TIN
-    bhfId: BHF
-    lastReqDt: DT14
+    hsCd: Annotated[str, StringConstraints(min_length=1, max_length=17)]
+    itemClsCd: Annotated[str, StringConstraints(min_length=1, max_length=10)]
+    itemCd: Annotated[str, StringConstraints(min_length=1, max_length=20)]
+    imptItemSttsCd: Annotated[str, StringConstraints(min_length=1)]
+    modrId: Annotated[str, StringConstraints(min_length=1)]
+    modrNm: Annotated[str, StringConstraints(min_length=1)]
+    remark: Optional[str] = None
 
 
-class SalesTransaction(BaseModel):
-    invcNo: conint(ge=1)
-    custTin: str
-    custNm: str
-
-    salesTyCd: Annotated[str, StringConstraints(pattern="^[NR]$")]
-    rcptTyCd: Annotated[str, StringConstraints(pattern="^[RPC]$")]
-    pmtTyCd: Annotated[str, StringConstraints(pattern=r"^\d{2}$")]
-    salesSttsCd: Annotated[str, StringConstraints(pattern="^(01|02|03)$")]
-
-    cfmDt: DT14
-    salesDt: DT8
+# =========================================================
+# STOCK
+# =========================================================
 
-    totItemCnt: conint(ge=1)
-    totTaxblAmt: condecimal(ge=0)
-    totTaxAmt: condecimal(ge=0)
-    totAmt: condecimal(ge=0)
+class StockMaster(BaseModel):
+    itemCd: Annotated[str, StringConstraints(min_length=1, max_length=20)]
+    rsdQty: condecimal(ge=0)  # Remaining quantity
+    regrId: Annotated[str, StringConstraints(min_length=1, max_length=20)]
+    regrNm: Annotated[str, StringConstraints(min_length=1, max_length=60)]
+    modrId: Annotated[str, StringConstraints(min_length=1, max_length=20)]
+    modrNm: Annotated[str, StringConstraints(min_length=1, max_length=60)]
 
-    regrId: str
-    regrNm: str
 
-    itemList: List[SalesItem]
+# Purchase Transaction Item (for insertTrnsPurchase)
+class InsertTrnsPurchaseItem(BaseModel):
+    itemSeq: conint(ge=1)
+    itemCd: Annotated[str, StringConstraints(min_length=1, max_length=20)]
+    itemClsCd: Annotated[str, StringConstraints(min_length=1, max_length=10)]
+    itemNm: Annotated[str, StringConstraints(min_length=1, max_length=200)]
+    bcd: Optional[Annotated[str, StringConstraints(max_length=20)]] = None
+    spplrItemClsCd: Optional[Annotated[str, StringConstraints(max_length=10)]] = None
+    spplrItemCd: Optional[Annotated[str, StringConstraints(max_length=20)]] = None
+    spplrItemNm: Optional[Annotated[str, StringConstraints(max_length=200)]] = None
+    pkgUnitCd: Annotated[str, StringConstraints(max_length=5)]
+    pkg: condecimal()
+    qtyUnitCd: Annotated[str, StringConstraints(max_length=5)]
+    qty: condecimal()
+    prc: condecimal()
+    splyAmt: condecimal()
+    dcRt: condecimal()
+    dcAmt: condecimal()
+    taxblAmt: condecimal()
+    taxTyCd: Annotated[str, StringConstraints(max_length=5)]
+    taxAmt: condecimal()
+    totAmt: condecimal()
+    itemExprDt: Optional[FLEX_DATE] = None  # 8–14 digits
+
+
+class InsertTrnsPurchase(BaseModel):
+    spplrTin: Optional[Annotated[str, StringConstraints(min_length=11, max_length=11)]] = None
+    invcNo: conint(ge=0)
+    orgInvcNo: conint(ge=0)
+    spplrBhfId: Optional[Annotated[str, StringConstraints(min_length=2, max_length=2)]] = None
+    spplrNm: Optional[Annotated[str, StringConstraints(max_length=60)]] = None
+    spplrInvcNo: Optional[conint(ge=0)] = None
+    regTyCd: Annotated[str, StringConstraints(min_length=1, max_length=5)]
+    pchsTyCd: Annotated[str, StringConstraints(min_length=1, max_length=5)]
+    rcptTyCd: Annotated[str, StringConstraints(min_length=1, max_length=5)]
+    pmtTyCd: Annotated[str, StringConstraints(min_length=1, max_length=5)]
+    pchsSttsCd: Annotated[str, StringConstraints(min_length=1, max_length=5)]
+    cfmDt: Optional[FLEX_DATE] = None
+    wrhsDt: Optional[FLEX_DATE] = None
+    cnclReqDt: Optional[FLEX_DATE] = None
+    cnclDt: Optional[FLEX_DATE] = None
+    rfdDt: Optional[FLEX_DATE] = None
+    pchsDt: Optional[FLEX_DATE] = None
+    totItemCnt: conint(ge=0)
+    taxblAmtA: condecimal()
+    taxblAmtB: condecimal()
+    taxblAmtC: condecimal()
+    taxblAmtD: condecimal()
+    taxblAmtE: condecimal()
+    taxRtA: condecimal()
+    taxRtB: condecimal()
+    taxRtC: condecimal()
+    taxRtD: condecimal()
+    taxRtE: condecimal()
+    taxAmtA: condecimal()
+    taxAmtB: condecimal()
+    taxAmtC: condecimal()
+    taxAmtD: condecimal()
+    taxAmtE: condecimal()
+    totTaxblAmt: condecimal()
+    totTaxAmt: condecimal()
+    totAmt: condecimal()
+    remark: Optional[Annotated[str, StringConstraints(max_length=400)]] = None
+    regrId: Annotated[str, StringConstraints(max_length=20)]
+    regrNm: Annotated[str, StringConstraints(max_length=60)]
+    modrId: Annotated[str, StringConstraints(max_length=20)]
+    modrNm: Annotated[str, StringConstraints(max_length=60)]
+    itemList: List[InsertTrnsPurchaseItem]
+
+
+# Stock IO Item
+class SaveStockIOItem(BaseModel):
+    itemSeq: conint(ge=1)
+    itemCd: Annotated[str, StringConstraints(min_length=1, max_length=20)]
+    itemClsCd: Annotated[str, StringConstraints(min_length=1, max_length=10)]
+    itemNm: Annotated[str, StringConstraints(min_length=1, max_length=200)]
+    bcd: Optional[Annotated[str, StringConstraints(max_length=20)]] = None
+    pkgUnitCd: Annotated[str, StringConstraints(max_length=5)]
+    pkg: condecimal()
+    qtyUnitCd: Annotated[str, StringConstraints(max_length=5)]
+    qty: condecimal()
+    itemExprDt: Optional[DT8] = None  # YYYYMMDD only
+    prc: condecimal()
+    splyAmt: condecimal()
+    totDcAmt: condecimal()
+    taxblAmt: condecimal()
+    taxTyCd: Annotated[str, StringConstraints(max_length=5)]
+    taxAmt: condecimal()
+    totAmt: condecimal()
+
+
+class SaveStockIO(BaseModel):
+    tin: Annotated[str, StringConstraints(min_length=11, max_length=11)]
+    bhfId: Annotated[str, StringConstraints(min_length=2, max_length=2)]
+    sarNo: conint(ge=0)
+    orgSarNo: conint(ge=0)
+    regTyCd: Annotated[str, StringConstraints(min_length=1, max_length=5)]
+    custTin: Optional[Annotated[str, StringConstraints(min_length=11, max_length=11)]] = None
+    custNm: Optional[Annotated[str, StringConstraints(max_length=100)]] = None
+    custBhfId: Optional[Annotated[str, StringConstraints(min_length=2, max_length=2)]] = None
+    sarTyCd: Annotated[str, StringConstraints(min_length=1, max_length=5)]
+    ocrnDt: DT8  # YYYYMMDD
+    totItemCnt: conint(ge=0)
+    totTaxblAmt: condecimal()
+    totTaxAmt: condecimal()
+    totAmt: condecimal()
+    remark: Optional[Annotated[str, StringConstraints(max_length=400)]] = None
+    regrId: Annotated[str, StringConstraints(max_length=20)]
+    regrNm: Annotated[str, StringConstraints(max_length=60)]
+    modrId: Annotated[str, StringConstraints(max_length=20)]
+    modrNm: Annotated[str, StringConstraints(max_length=60)]
+    itemList: List[SaveStockIOItem]
 
 
 # =========================================================
-# STOCK
+# VALIDATOR MAP
 # =========================================================
 
-class MoveList(BaseModel):
-    tin: TIN
-    bhfId: BHF
-    lastReqDt: DT14
+from .exceptions import ValidationException
 
+SCHEMAS = {
+    # INITIALIZATION
+    "initialization": Initialization,
 
-class StockMaster(BaseModel):
-    itemCd: str
-    itemNm: str
-    useYn: YN
-    regrId: str
-    regrNm: str
+    # COMMON
+    "lastReqOnly": LastReqOnly,
+    "custSearchReq": CustSearchReq,
+
+    # BRANCH
+    "branchCustomer": BranchCustomer,
+    "branchUser": BranchUser,
+    "branchInsurance": BranchInsurance,
+
+    # ITEM
+    "saveItem": SaveItem,
+    "itemComposition": ItemComposition,
 
+    # IMPORTED ITEM
+    "importItemUpdate": ImportItemUpdate,
 
-class StockIO(BaseModel):
-    itemCd: str
-    qty: condecimal(gt=0)
-    ioTyCd: Annotated[str, StringConstraints(pattern="^[IO]$")]
-    regrId: str
-    regrNm: str
+    # STOCK
+    "stockMaster": StockMaster,
+    "insertTrnsPurchase": InsertTrnsPurchase,
+    "saveStockIO": SaveStockIO,
+}

kra_etims_sdk/validator.py

@@ -1,47 +1,21 @@
+from typing import Dict, Any
 from pydantic import ValidationError
-from .schemas import *
+from .schemas import SCHEMAS
 from .exceptions import ValidationException
 
 
-SCHEMAS = {
-    # INIT
-    "initialization": Initialization,
-
-    # BASIC DATA
-    "codeList": CodeList,
-    "itemClsList": CodeList,
-    "bhfList": BhfList,
-    "noticeList": NoticeList,
-    "taxpayerInfo": TaxpayerInfo,
-    "customerList": CustomerList,
-
-    # PURCHASE
-    "purchaseTrns": PurchaseTrns,
-    "purchaseTransaction": PurchaseTransaction,
-
-    # SALES
-    "salesTrns": SalesTrns,
-    "selectSalesTrns": SelectSalesTrns,
-    "salesTransaction": SalesTransaction,
-
-    # STOCK
-    "moveList": MoveList,
-    "stockMaster": StockMaster,
-    "stockIO": StockIO,
-
-    # BRANCH
-    "branchInsurance": BranchInsurance,
-    "branchUserAccount": BranchUserAccount,
-    "customerInfo": CustomerInfo,
-}
-
-
 class Validator:
-    def validate(self, data: dict, schema: str) -> dict:
+    def validate(self, data: Dict[str, Any], schema: str) -> Dict[str, Any]:
         if schema not in SCHEMAS:
             raise ValueError(f"Validation schema '{schema}' not defined")
 
         try:
-            return SCHEMAS[schema](**data).dict()
+            validated = SCHEMAS[schema](**data)
+            return validated.model_dump(mode='json')  # Converts Decimals to floats
         except ValidationError as e:
-            raise ValidationException("Validation failed", e.errors())
+            # Convert Pydantic errors to field:message dict like PHP
+            messages = {}
+            for error in e.errors():
+                field = ".".join(str(loc) for loc in error["loc"])
+                messages[field] = error["msg"]
+            raise ValidationException("Validation failed", messages)