ebarimt-pos-sdk 0.0.1b2__py3-none-any.whl

ebarimt_pos_sdk/__init__.py

@@ -0,0 +1,41 @@
+from .client import PosApiClient
+from .resources.receipt import (
+    BarCodeType,
+    CreateReceiptRequest,
+    CreateReceiptResponse,
+    DeleteReceiptRequest,
+    DeleteReceiptResponse,
+    Item,
+    Payment,
+    PaymentCardData,
+    PaymentCode,
+    PaymentStatus,
+    Receipt,
+    ReceiptCreateStatus,
+    ReceiptItemData,
+    ReceiptItemResponse,
+    ReceiptType,
+    TaxType,
+)
+from .settings import PosApiSettings
+
+__all__ = [
+    "PosApiClient",
+    "PosApiSettings",
+    "BarCodeType",
+    "CreateReceiptRequest",
+    "CreateReceiptResponse",
+    "DeleteReceiptRequest",
+    "DeleteReceiptResponse",
+    "Item",
+    "Payment",
+    "PaymentCardData",
+    "PaymentCode",
+    "PaymentStatus",
+    "Receipt",
+    "ReceiptCreateStatus",
+    "ReceiptItemData",
+    "ReceiptItemResponse",
+    "ReceiptType",
+    "TaxType",
+]

ebarimt_pos_sdk/client.py

@@ -0,0 +1,104 @@
+from __future__ import annotations
+
+from types import TracebackType
+
+import httpx
+
+from .resources import BankAccountsResource, InfoResource, ReceiptResource, SendDataResource
+from .settings import PosApiSettings
+from .transport import AsyncTransport, HeaderTypes, SyncTransport
+
+
+class PosApiClient:
+    """
+    Dual sync/async client.
+
+    Usage:
+        client = PosApiClient(PosApiSettings(...))
+        resp = client.receipt.create({...})
+
+        async with PosApiClient(...) as client:
+            resp = await client.receipt.acreate({...})
+    """
+
+    def __init__(
+        self,
+        settings: PosApiSettings,
+        *,
+        sync_client: httpx.Client | None = None,
+        async_client: httpx.AsyncClient | None = None,
+        headers: HeaderTypes | None = None,
+    ) -> None:
+        self._settings = settings
+        self._headers = headers
+
+        self._owns_sync = sync_client is None
+        self._owns_async = async_client is None
+
+        self._base_url = self._settings.base_url
+
+        self._sync_client = sync_client or httpx.Client(
+            base_url=self._base_url,
+            timeout=settings.timeout_s,
+            verify=settings.verify_tls,
+        )
+        self._async_client = async_client or httpx.AsyncClient(
+            base_url=self._base_url,
+            timeout=settings.timeout_s,
+            verify=settings.verify_tls,
+        )
+
+        self._sync_transport = SyncTransport(self._sync_client)
+        self._async_transport = AsyncTransport(self._async_client)
+
+        # Resources
+        self.receipt = ReceiptResource(
+            sync=self._sync_transport,
+            async_=self._async_transport,
+            headers=self._headers,
+        )
+        self.info = InfoResource(
+            sync=self._sync_transport,
+            async_=self._async_transport,
+            headers=self._headers,
+        )
+        self.send_data = SendDataResource(
+            sync=self._sync_transport,
+            async_=self._async_transport,
+            headers=self._headers,
+        )
+        self.bank_accounts = BankAccountsResource(
+            sync=self._sync_transport,
+            async_=self._async_transport,
+            headers=self._headers,
+        )
+
+    def close(self) -> None:
+        if self._owns_sync:
+            self._sync_client.close()
+
+    async def aclose(self) -> None:
+        if self._owns_async:
+            await self._async_client.aclose()
+
+    async def __aenter__(self) -> PosApiClient:
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc: BaseException | None,
+        tb: TracebackType | None,
+    ) -> None:
+        await self.aclose()
+
+    def __enter__(self) -> PosApiClient:
+        return self
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc: BaseException | None,
+        tb: TracebackType | None,
+    ) -> None:
+        self.close()

ebarimt_pos_sdk/errors.py

@@ -0,0 +1,65 @@
+"""Ebarimt Pos API sdk errors."""
+
+from __future__ import annotations
+
+import httpx
+
+
+class PosApiError(Exception):
+    """Base error for the SDK."""
+
+    def __init__(
+        self,
+        message: str,
+        *,
+        request: httpx.Request | None = None,
+        response: httpx.Response | None = None,
+    ) -> None:
+        super().__init__(message)
+        self.request = request
+        self.response = response
+
+
+class PosApiTransportError(PosApiError):
+    """Network / timeout / DNS / TLS errors."""
+
+
+class PosApiDecodeError(PosApiError):
+    """Response body was not valid JSON when JSON was expected."""
+
+
+class PosApiValidationError(PosApiError):
+    """Pydantic validation errors (request or response)."""
+
+
+class PosApiHttpError(PosApiError):
+    """Non-2xx response from server."""
+
+    def __init__(
+        self,
+        message: str,
+        *,
+        request: httpx.Request,
+        response: httpx.Response,
+    ) -> None:
+        super().__init__(message, request=request, response=response)
+
+
+class PosApiBusinessError(PosApiError):
+    """
+    2xx HTTP but domain-level failure indicated by payload fields
+    (e.g. {"status":"ERROR", "message":"..."}).
+    """
+
+    def __init__(
+        self,
+        message: str,
+        *,
+        status: str | None = None,
+        code: str | int | None = None,
+        request: httpx.Request | None = None,
+        response: httpx.Response | None = None,
+    ) -> None:
+        super().__init__(message, request=request, response=response)
+        self.status = status
+        self.code = code

ebarimt_pos_sdk/resources/__init__.py

@@ -0,0 +1,6 @@
+from .bank_accounts.bank_accounts import BankAccountsResource
+from .info.info import InfoResource
+from .receipt.receipt import ReceiptResource
+from .send_data.send_data import SendDataResource
+
+__all__ = ["InfoResource", "ReceiptResource", "SendDataResource", "BankAccountsResource"]

ebarimt_pos_sdk/resources/bank_accounts/bank_accounts.py

@@ -0,0 +1,54 @@
+import httpx
+
+from ..resource import BaseResource, HeaderTypes, _build_headers, _ensure_http_success
+from .schema import BankAccount
+
+
+class BankAccountsResource(BaseResource):
+    @property
+    def _path(self) -> str:
+        return "/rest/bankAccounts"
+
+    def read(
+        self,
+        tin: str,
+        *,
+        headers: HeaderTypes | None = None,
+    ) -> list[BankAccount]:
+        result = self._sync.send(
+            "GET",
+            self._path,
+            params=httpx.QueryParams({"tin": tin}),
+            headers=_build_headers(self._headers, headers),
+        )
+
+        success_response = _ensure_http_success(result.response)
+
+        output: list[BankAccount] = []
+
+        for data in success_response.json():
+            output.append(BankAccount.model_validate(data))
+
+        return output
+
+    async def aread(
+        self,
+        tin: str,
+        *,
+        headers: HeaderTypes | None = None,
+    ) -> list[BankAccount]:
+        result = await self._async.send(
+            "GET",
+            self._path,
+            params=httpx.QueryParams({"tin": tin}),
+            headers=_build_headers(self._headers, headers),
+        )
+
+        success_response = _ensure_http_success(result.response)
+
+        output: list[BankAccount] = []
+
+        for data in success_response.json():
+            output.append(BankAccount.model_validate(data))
+
+        return output

ebarimt_pos_sdk/resources/bank_accounts/schema.py

@@ -0,0 +1,48 @@
+from __future__ import annotations
+
+from typing import Any
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class SDKModel(BaseModel):
+    """
+    Base model for the SDK:
+    - Allows forward/backward-compatible payload changes (extra keys allowed)
+    - Clean developer ergonomics (aliases supported)
+    """
+
+    model_config = ConfigDict(
+        extra="allow",
+        populate_by_name=True,
+        validate_assignment=False,
+        str_strip_whitespace=True,
+    )
+
+
+class BankAccount(SDKModel):
+    """
+    Bank account record returned by GET /rest/bankAccounts.
+
+    Note:
+    - OpenAPI lists `iBan` as required, but some examples omit it.
+      We keep it optional to avoid brittle SDK behavior.
+    """
+
+    id: int = Field(..., description="System-registered bank account ID.")
+    tin: str = Field(..., description="Taxpayer identification number (TIN) of the account owner.")
+
+    bank_account_no: str = Field(..., alias="bankAccountNo", description="Bank account number.")
+    bank_account_name: str = Field(..., alias="bankAccountName", description="Bank account name.")
+
+    bank_id: int = Field(..., alias="bankId", description="Bank ID.")
+    bank_name: str = Field(..., alias="bankName", description="Bank name.")
+
+    iban: str = Field(
+        alias="iBan",
+        description="International Bank Account Number (IBAN) / international account numbering.",
+        examples=["100100015121212121111"],
+    )
+
+    # If the API sometimes returns a nested blob like `data: {}`, we keep it explicitly.
+    data: dict[str, Any] | None = Field(default=None, description="Optional extra data payload.")

ebarimt_pos_sdk/resources/info/info.py

@@ -0,0 +1,30 @@
+from ..resource import BaseResource, HeaderTypes, _build_headers, _ensure_http_success
+from .schema import ReadInfoResponse
+
+
+class InfoResource(BaseResource):
+    @property
+    def _path(self) -> str:
+        return "/rest/info"
+
+    def read(self, *, headers: HeaderTypes | None = None) -> ReadInfoResponse:
+        result = self._sync.send(
+            "GET",
+            self._path,
+            headers=_build_headers(self._headers, headers),
+        )
+
+        _ensure_http_success(result.response)
+
+        return ReadInfoResponse.model_validate(result.response.json())
+
+    async def aread(self, *, headers: HeaderTypes | None = None) -> ReadInfoResponse:
+        result = await self._async.send(
+            "GET",
+            self._path,
+            headers=_build_headers(self._headers, headers),
+        )
+
+        _ensure_http_success(result.response)
+
+        return ReadInfoResponse.model_validate(result.response.json())

ebarimt_pos_sdk/resources/info/schema.py

@@ -0,0 +1,61 @@
+from __future__ import annotations
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class AppInfo(BaseModel):
+    """
+    PosAPI-н ерөнхий мэдээлэл.
+    """
+
+    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+
+    application_dir: str = Field(alias="applicationDir", description="Файл байршиж буй хавтас")
+    current_dir: str = Field(alias="currentDir", description="Файл байршиж буй хавтас")
+    database: str = Field(description="Баазын driver /Qt5 тохиргоогоор/")
+    database_host: str = Field(
+        alias="database-host", description="Баазын хаяг /sqlite бол файлын зам/"
+    )
+    work_dir: str = Field(alias="workDir", description="Ажиллаж буй хавтас")
+
+
+class RestInfoCustomer(BaseModel):
+    """
+    Үйлчлүүлэгч ААН.
+    """
+
+    name: str = Field(description="ААН-нэр")
+    tin: str = Field(description="ААН-н ТТД")
+    vat_payer: bool = Field(
+        alias="vatPayer",
+        description="НӨАТ суутган төлөгч мөн эсэх\ntrue: НӨАТ суутган төлөгч мөн\nfalse: НӨАТ суутган төлөгч биш",
+    )
+
+
+class Merchant(BaseModel):
+    """
+    PosAPI-д бүртгэлтэй ААН.
+    """
+
+    name: str = Field(description="ААН-нэр")
+    tin: str = Field(description="ААН-н ТТД")
+    customers: list[RestInfoCustomer] = Field(description="Үйлчлүүлэгч ААН-н жагсаалт")
+
+
+class ReadInfoResponse(BaseModel):
+    """
+    GET /rest/info (200 OK) response schema.
+    """
+
+    operator_name: str = Field(alias="operatorName", description="Оператор байгууллагын нэр")
+    operator_tin: str = Field(alias="operatorTIN", description="Оператор байгууллагын ТТД")
+    pos_id: float = Field(alias="posId", description="PosAPI-н систем дэх бүртгэлийн Id")
+    pos_no: str = Field(alias="posNo", description="PosAPI-н систем дэх бүртгэлийн дугаар")
+    last_sent_date: str = Field(
+        alias="lastSentDate", description="Баримт илгээсэн огноо /Сүүлийн байдлаар/"
+    )
+    left_lotteries: int = Field(alias="leftLotteries", description="Нийт үлдсэн сугалаа")
+    app_info: AppInfo = Field(alias="appInfo", description="PosAPI-н ерөнхий мэдээлэл")
+    merchants: list[Merchant] = Field(description="PosAPI-д бүртгэлтэй ААН-н жагсаалт")
+
+    model_config = ConfigDict(populate_by_name=True)

ebarimt_pos_sdk/resources/receipt/__init__.py

@@ -0,0 +1,37 @@
+from .schema import (
+    BarCodeType,
+    CreateReceiptRequest,
+    CreateReceiptResponse,
+    DeleteReceiptRequest,
+    DeleteReceiptResponse,
+    Item,
+    Payment,
+    PaymentCardData,
+    PaymentCode,
+    PaymentStatus,
+    Receipt,
+    ReceiptCreateStatus,
+    ReceiptItemData,
+    ReceiptItemResponse,
+    ReceiptType,
+    TaxType,
+)
+
+__all__ = [
+    "CreateReceiptRequest",
+    "CreateReceiptResponse",
+    "DeleteReceiptRequest",
+    "DeleteReceiptResponse",
+    "ReceiptItemResponse",
+    "Item",
+    "Payment",
+    "PaymentCardData",
+    "PaymentCode",
+    "PaymentStatus",
+    "Receipt",
+    "ReceiptCreateStatus",
+    "ReceiptItemData",
+    "BarCodeType",
+    "ReceiptType",
+    "TaxType",
+]

ebarimt_pos_sdk/resources/receipt/receipt.py

@@ -0,0 +1,95 @@
+from __future__ import annotations
+
+from typing import Any
+
+from ..resource import (
+    BaseResource,
+    HeaderTypes,
+    _build_headers,
+    _ensure_http_success,
+    _validate_payload,
+)
+from .schema import (
+    CreateReceiptRequest,
+    CreateReceiptResponse,
+    DeleteReceiptRequest,
+    DeleteReceiptResponse,
+)
+
+_DEFAULT_HEADERS = {"Accept": "application/json"}
+
+
+class ReceiptResource(BaseResource):
+    @property
+    def _path(self) -> str:
+        return "/rest/receipt"
+
+    def create(
+        self,
+        payload: CreateReceiptRequest | dict[str, Any],
+        *,
+        headers: HeaderTypes | None = None,
+    ) -> CreateReceiptResponse:
+        payload = _validate_payload(model=CreateReceiptRequest, payload=payload)
+
+        result = self._sync.send(
+            "POST",
+            self._path,
+            headers=_build_headers(self._headers, headers),
+            payload=payload.model_dump(mode="json", by_alias=True, exclude_none=True),
+        )
+
+        _ensure_http_success(result.response)
+
+        return CreateReceiptResponse.model_validate(result.response.json())
+
+    async def acreate(
+        self,
+        payload: CreateReceiptRequest | dict[str, Any],
+        *,
+        headers: HeaderTypes | None = None,
+    ) -> CreateReceiptResponse:
+        payload = _validate_payload(model=CreateReceiptRequest, payload=payload)
+
+        result = await self._async.send(
+            "POST",
+            self._path,
+            headers=_build_headers(self._headers, headers),
+            payload=payload.model_dump(mode="json", by_alias=True, exclude_none=True),
+        )
+
+        _ensure_http_success(result.response)
+
+        return CreateReceiptResponse.model_validate(result.response.json())
+
+    def delete(
+        self, payload: DeleteReceiptRequest | dict[str, Any], *, headers: HeaderTypes | None = None
+    ) -> DeleteReceiptResponse:
+        payload = _validate_payload(model=DeleteReceiptRequest, payload=payload)
+
+        result = self._sync.send(
+            "POST",
+            self._path,
+            headers=_build_headers(self._headers, headers),
+            payload=payload.model_dump(mode="json", by_alias=True, exclude_none=True),
+        )
+
+        _ensure_http_success(result.response)
+
+        return DeleteReceiptResponse.model_validate(result.response.json())
+
+    async def adelete(
+        self, payload: DeleteReceiptRequest | dict[str, Any], *, headers: HeaderTypes | None = None
+    ) -> DeleteReceiptResponse:
+        payload = _validate_payload(model=DeleteReceiptRequest, payload=payload)
+
+        result = await self._async.send(
+            "POST",
+            self._path,
+            headers=_build_headers(self._headers, headers),
+            payload=payload.model_dump(mode="json", by_alias=True, exclude_none=True),
+        )
+
+        _ensure_http_success(result.response)
+
+        return DeleteReceiptResponse.model_validate(result.response.json())

ebarimt_pos_sdk/resources/receipt/schema.py

@@ -0,0 +1,181 @@
+from __future__ import annotations
+
+from datetime import datetime
+from decimal import Decimal
+from enum import Enum
+from typing import Any
+
+from pydantic import BaseModel, ConfigDict
+
+# Json building block types
+Number = Decimal | int | float
+
+
+class ReceiptType(str, Enum):
+    B2C_RECEIPT = "B2C_RECEIPT"
+    B2B_RECEIPT = "B2B_RECEIPT"
+    B2C_INVOICE = "B2C_INVOICE"
+    B2B_INVOICE = "B2B_INVOICE"
+
+
+class TaxType(str, Enum):
+    VAT_ABLE = "VAT_ABLE"
+    VAT_FREE = "VAT_FREE"
+    VAT_ZERO = "VAT_ZERO"
+    NOT_VAT = "NOT_VAT"
+
+
+class BarCodeType(str, Enum):
+    UNDEFINED = "UNDEFINED"
+    GS1 = "GS1"
+    ISBN = "ISBN"
+
+
+class PaymentCode(str, Enum):
+    CASH = "CASH"
+    PAYMENT_CARD = "PAYMENT_CARD"
+
+
+class PaymentStatus(str, Enum):
+    PAID = "PAID"
+    PAY = "PAY"
+    REVERSED = "REVERSED"
+    ERROR = "ERROR"
+
+
+class ReceiptCreateStatus(str, Enum):
+    SUCCESS = "SUCCESS"
+    ERROR = "ERROR"
+    PAYMENT = "PAYMENT"
+
+
+class ReceiptItemData(BaseModel):
+    """
+    items[].data
+    Note: docs show lotNo + stockQR, but examples also show nested "data": {"stockQR":[...]} sometimes.
+    This model follows the schema: lotNo, stockQR directly under data.
+    """
+
+    model_config = ConfigDict(extra="ignore")
+
+    lotNo: str | None = None
+    stockQR: list[str] | None = None
+
+
+class Item(BaseModel):
+    model_config = ConfigDict(extra="ignore")
+
+    name: str
+    barCode: str
+    measureUnit: str
+    qty: Number
+    unitPrice: Number
+    totalAmount: Number
+
+    barCodeType: BarCodeType | str | None = None
+    classificationCode: str | None = None
+    taxProductCode: str | None = None
+    totalVAT: Number | None = None
+    totalCityTax: Number | None = None
+    data: ReceiptItemData | None = None
+
+
+class Receipt(BaseModel):
+    model_config = ConfigDict(extra="ignore")
+
+    totalAmount: Number
+    taxType: TaxType | str
+    merchantTin: str
+    items: list[Item]
+
+    totalVAT: Number | None = None
+    totalCityTax: Number | None = None
+    customerTin: str | None = None
+
+    bankAccountNo: str | None = None
+    iBan: str | None = None
+    invoiceId: str | None = None
+    data: dict[str, Any] | None = None
+
+
+class PaymentCardData(BaseModel):
+    """
+    payments[].data when code=PAYMENT_CARD
+    """
+
+    model_config = ConfigDict(extra="ignore")
+
+    terminalID: str
+    rrn: str
+    maskedCardNumber: str
+    easy: bool
+    bankCode: str | None = None
+
+
+class Payment(BaseModel):
+    model_config = ConfigDict(extra="ignore")
+
+    code: PaymentCode | str
+    status: PaymentStatus | str
+    paidAmount: Number
+
+    exchangeCode: str | None = None
+    data: PaymentCardData | None = None  # Only when code is PAYMENT_CARD
+
+
+class CreateReceiptRequest(BaseModel):
+    model_config = ConfigDict(extra="ignore")
+
+    branchNo: str
+    totalAmount: Number
+    merchantTin: str
+    posNo: str
+    type: ReceiptType | str
+    billIdSuffix: str
+    receipts: list[Receipt]
+
+    totalVAT: Number | None = None
+    totalCityTax: Number | None = None
+    districtCode: str | None = None
+    customerTin: str | None = None
+    consumerNo: str | None = None
+    inactiveId: str | None = None
+    invoiceId: str | None = None
+    reportMonth: str | None = None
+    data: dict[str, Any] | None = None
+
+    payments: list[Payment] | None = None
+
+
+class ReceiptItemResponse(BaseModel):
+    model_config = ConfigDict(extra="ignore")
+
+    id: str
+    bankAccountId: int
+
+
+class CreateReceiptResponse(BaseModel):
+    model_config = ConfigDict(extra="ignore")
+
+    id: str
+    posId: int
+    status: ReceiptCreateStatus | str
+    message: str
+    qrDate: str
+    lottery: str
+    date: datetime
+    easy: bool
+    receipts: list[ReceiptItemResponse]
+
+
+class DeleteReceiptRequest(BaseModel):
+    model_config = ConfigDict(extra="ignore")
+
+    id: str
+    date: datetime
+
+
+class DeleteReceiptResponse(BaseModel):
+    model_config = ConfigDict(extra="ignore")
+
+    # TODO

ebarimt_pos_sdk/resources/resource.py

@@ -0,0 +1,66 @@
+# src/ebarimt_pos_sdk/resources/receipt.py
+from __future__ import annotations
+
+from abc import abstractmethod
+from typing import Any, TypeVar
+
+import httpx
+from pydantic import BaseModel
+
+from ..errors import PosApiHttpError
+from ..transport import AsyncTransport, HeaderTypes, SyncTransport
+
+T = TypeVar("T", bound=BaseModel)
+
+
+class BaseResource:
+    def __init__(
+        self,
+        *,
+        sync: SyncTransport,
+        async_: AsyncTransport,
+        headers: HeaderTypes | None = None,
+    ) -> None:
+        self._sync = sync
+        self._async = async_
+        self._headers = headers
+
+    @property
+    @abstractmethod
+    def _path(self) -> str: ...
+
+
+def _ensure_http_success(response: httpx.Response) -> httpx.Response:
+    try:
+        response.raise_for_status()
+    except httpx.HTTPStatusError as exc:
+        raise PosApiHttpError(
+            f"HTTP {exc.response.status_code}",
+            request=exc.request,
+            response=exc.response,
+        ) from exc
+    return response
+
+
+def _validate_payload(model: type[T], payload: T | dict[str, Any]) -> T:
+    if isinstance(payload, model):
+        return payload
+    return model.model_validate(payload)
+
+
+def _build_headers(*headers: HeaderTypes | None) -> httpx.Headers:
+    """Merges headers and returns one header.
+
+    Note:
+        Highest priority header should be the last.
+
+    Returns:
+        httpx.Headers: Merged header.
+    """
+    out = httpx.Headers()
+    for header in headers:
+        out.update(header)
+    return out
+
+
+__all__ = ["_ensure_http_success", "_validate_payload", "_build_headers"]

ebarimt_pos_sdk/resources/send_data/send_data.py

@@ -0,0 +1,30 @@
+
+from ..resource import BaseResource, HeaderTypes, _build_headers, _ensure_http_success
+
+
+class SendDataResource(BaseResource):
+    @property
+    def _path(self) -> str:
+        return "/rest/sendData"
+
+    def send(self, headers: HeaderTypes | None = None) -> None:
+        result = self._sync.send(
+            "GET",
+            self._path,
+            headers=_build_headers(self._headers, headers),
+        )
+
+        _ensure_http_success(result.response)
+
+        return None
+
+    async def asend(self, headers: HeaderTypes | None = None) -> None:
+        result = await self._async.send(
+            "GET",
+            self._path,
+            headers=_build_headers(self._headers, headers),
+        )
+
+        _ensure_http_success(result.response)
+
+        return None

ebarimt_pos_sdk/settings.py

@@ -0,0 +1,32 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from .transport import HeaderTypes
+
+
+@dataclass(frozen=True)
+class PosApiSettings:
+    """
+    SDK runtime settings.
+
+    Notes:
+        POS API usually runs on localhost or private network.
+        `base_url` may be http://localhost:7080 or an internal hostname behind VPN.
+    """
+
+    base_url: str = "http://localhost:7080"
+    timeout_s: float = 10.0
+    verify_tls: bool = True
+
+    # auth is intentionally flexible until spec is clearer:
+    # e.g. {"Authorization": "Bearer ..."} or {"X-API-KEY": "..."}
+    default_headers: HeaderTypes | None = None
+
+    def normalized_base_url(self) -> str:
+        """Normalizes base_url for clients to use.
+
+        Returns:
+            str: Normalized base_url.
+        """
+        return self.base_url.strip().rstrip("/")

ebarimt_pos_sdk/transport/__init__.py

@@ -0,0 +1,20 @@
+"""
+This is the transport layer. It concerns with:
+* send request
+* handle network errors
+* handle non-2xx HTTP errors
+* decode JSON (or 204/empty)
+* produce structured context (request/response + metadata)
+"""
+
+from .async_transport import AsyncTransport
+from .http import HeaderTypes, HttpRequestResponse, QueryParamTypes
+from .sync_transport import SyncTransport
+
+__all__ = [
+    "AsyncTransport",
+    "SyncTransport",
+    "HttpRequestResponse",
+    "HeaderTypes",
+    "QueryParamTypes",
+]

ebarimt_pos_sdk/transport/async_transport.py

@@ -0,0 +1,48 @@
+from typing import Any
+
+import httpx
+
+from .http import (
+    HeaderTypes,
+    HttpMethod,
+    HttpRequestResponse,
+    QueryParamTypes,
+    build_transport_error,
+)
+
+
+class AsyncTransport:
+    """Async request/response transport layer."""
+
+    def __init__(self, client: httpx.AsyncClient) -> None:
+        self._client = client
+
+    async def send(
+        self,
+        method: HttpMethod,
+        url: httpx.URL | str,
+        *,
+        params: QueryParamTypes | None = None,
+        headers: HeaderTypes | None = None,
+        payload: dict[str, Any] | None = None,
+        **kwargs: Any,
+    ) -> HttpRequestResponse:
+        # build http request context
+        request = self._client.build_request(
+            method=method,
+            url=url,
+            params=params,
+            headers=headers,
+            json=payload,
+            **kwargs,
+        )
+
+        try:
+            response = await self._client.send(request)
+        except httpx.HTTPError as exc:
+            raise build_transport_error(request, exc) from exc
+
+        return HttpRequestResponse(
+            request=request,
+            response=response,
+        )

ebarimt_pos_sdk/transport/http.py

@@ -0,0 +1,51 @@
+from __future__ import annotations
+
+from collections.abc import Mapping, Sequence
+from dataclasses import dataclass
+from typing import Literal, TypeAlias
+
+import httpx
+
+from ..errors import (
+    PosApiTransportError,
+)
+
+HttpMethod = Literal["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]
+
+
+@dataclass(frozen=True)
+class HttpRequestResponse:
+    request: httpx.Request
+    response: httpx.Response
+
+    def as_tuple(self) -> tuple[httpx.Request, httpx.Response]:
+        return (self.request, self.response)
+
+
+def build_transport_error(
+    request: httpx.Request,
+    exc: httpx.HTTPError,
+) -> PosApiTransportError:
+    """Build Pos Api Transport layer error."""
+    return PosApiTransportError(
+        f"Transport error for {request.method} {request.url}: {exc}",
+        request=request,
+    )
+
+
+PrimitiveData = str | int | float | bool | None
+
+QueryParamTypes: TypeAlias = (
+    httpx.QueryParams
+    | Mapping[str, PrimitiveData | Sequence[PrimitiveData]]
+    | list[tuple[str, PrimitiveData]]
+    | tuple[tuple[str, PrimitiveData], ...]
+    | str
+)
+HeaderTypes: TypeAlias = (
+    httpx.Headers
+    | Mapping[str, str]
+    | Mapping[bytes, bytes]
+    | Sequence[tuple[str, str]]
+    | Sequence[tuple[bytes, bytes]]
+)

ebarimt_pos_sdk/transport/sync_transport.py

@@ -0,0 +1,39 @@
+from typing import Any
+
+import httpx
+
+from .http import HttpMethod, HttpRequestResponse, QueryParamTypes, build_transport_error
+
+
+class SyncTransport:
+    def __init__(self, client: httpx.Client) -> None:
+        self._client = client
+
+    def send(
+        self,
+        method: HttpMethod,
+        url: httpx.URL | str,
+        *,
+        params: QueryParamTypes | None = None,
+        headers: httpx.Headers | None = None,
+        payload: dict[str, Any] | None = None,
+        **kwargs: Any,
+    ) -> HttpRequestResponse:
+        request = self._client.build_request(
+            method=method,
+            url=url,
+            params=params,
+            headers=headers,
+            json=payload,
+            **kwargs,
+        )
+
+        try:
+            response = self._client.send(request)
+        except httpx.HTTPError as exc:
+            raise build_transport_error(request, exc) from exc
+
+        return HttpRequestResponse(
+            request=request,
+            response=response,
+        )

ebarimt_pos_sdk-0.0.1b2.dist-info/METADATA

@@ -0,0 +1,68 @@
+Metadata-Version: 2.3
+Name: ebarimt-pos-sdk
+Version: 0.0.1b2
+Summary: Python SDK for Ebarimt POS API 3.0
+Author: SenergyTech
+License: MIT
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.7.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# ebarimt-pos-sdk
+
+[![codecov](https://codecov.io/gh/Amraa1/ebarimt-pos-sdk/graph/badge.svg?token=EZ18HFDG46)](https://codecov.io/gh/Amraa1/ebarimt-pos-sdk)
+
+Modern async-first Python SDK for Ebarimt Pos API 3.0.
+
+> Ebarimt Pos API 3.0 [documentation](https://developer.itc.gov.mn/docs/ebarimt-api/inbishdm2zj3x-pos-api-3-0-sistemijn-api-holbolt-zaavruud)
+
+## Development setup
+
+```bash
+uv sync --dev
+uv run pytest
+```
+
+# PosAPI тохируулах:
+
+PosAPI нь суусны дараа анхны байдлаар тохируулах шаардлагатай. “posapi.ini”
+файлд тухайн PosAPI-н үндсэн тохиргоо байрлах ба “P101.poi, P102.poi” файлуудад
+ажиллагааны тохиргоо байрлах ба нууцлагдсан байна.
+
+### Үндсэн тохиргооны тайлбар /posapi.ini файл/
+
+| Нэр              | Тайлбар                                                        |
+| ---------------- | -------------------------------------------------------------- |
+| authUrl          |                                                                |
+| authRealm        | Тухайн PosAPI-н нэгдсэн нэвтрэлттэй холбогдох тохиргоо         |
+| authClientId     | Өөрчлөх шаардлагагүй.                                          |
+| authClientSecret |                                                                |
+| ebarimtUrl       | Ebarimt системтэй холбогдох хаяг Өөрчлөх шаардлагагүй          |
+| db               | Өгөгдлийн сангийн driver                                       |
+| dbHost           | Өгөгдлийн сангийн хаяг Хэрэв QSQLITE бол файлын зам байна      |
+| dbPort           | Өгөгдлийн сангийн port Хэрэв QSQLITE бол бөглөхгүй             |
+| dbUser           | Өгөгдлийн сангийн хэрэглэгчийн нэр Хэрэв QSQLITE бол бөглөхгүй |
+| dbPass           | Өгөгдлийн сангийн нууц үг хэрэв QSQLITE бол бөглөхгүй          |
+| dbName           | Өгөгдлийн сангийн баазын нэр Хэрэв QSQLITE бол бөглөхгүй       |
+| dbOptions        | Өгөгдлийн сангийн нэмэлт тохиргоо Хэрэв QSQLITE бол бөглөхгүй  |
+| workDir          | PosAPI-н ажиллагааны хавтас                                    |
+| webServiceHost   | PosAPI-н ажиллах сүлжээний IP address                          |
+| webServicePort   | PosAPI-н ажиллах сүлжээний port                                |
+
+**WorkDir** хавтсанд ажиллагааны тохиргоо байрлах ба уг тохиргооны файлуудын агуулга
+нь тогтмол өөрчлөгдөж байх тул PosAPI ажиллуулж буй хэрэглэгч нь унших, бичих
+эрхтэй байхыг анхаарана уу. Мөн уг хавтсыг ямар ч нөхцөлд **FREEZE хийх ёсгүй**
+гэдгийг анхаарна уу.
+
+### PosAPI-н дэмжиж ажиллах өгөгдлийн сангууд ба driver-ууд
+
+| Нэр     | Тайлбар                       |
+| ------- | ----------------------------- |
+| QMYSQL  | MySQL эсвэл MariaDB           |
+| QPSQL   | PostgreSQL                    |
+| QODBC   | ODBC for Microsoft SQL Server |
+| QSQLITE | SQLite version 3              |
+
+PosAPI нь ачааллах үедээ өгөгдлийн сангийн table-г автоматаар өөрөө үүсгэдэг тул
+тухайн хэрэглэгч нь table үүсгэх эрх бүхий хэрэглэгч байх шаардлагатайг анхаарна уу

ebarimt_pos_sdk-0.0.1b2.dist-info/RECORD

@@ -0,0 +1,24 @@
+ebarimt_pos_sdk/__init__.py,sha256=sQPlSH_IE69ZnZiup0Uvks1vcz_gImCD_R4mGE9Nwc0,828
+ebarimt_pos_sdk/client.py,sha256=aua7ruFgS1DoUzNAonpR47O_lzAh9PrTU8mlSdCff24,2930
+ebarimt_pos_sdk/errors.py,sha256=faDkMH9yr9KvjrRgS0pyUnvO8l3vEpKCLr3sHyDf8fQ,1565
+ebarimt_pos_sdk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ebarimt_pos_sdk/resources/__init__.py,sha256=YPnEmw-RhCK7zFFt59tqjjzNulR2t08SPVv4D9F-qZ4,284
+ebarimt_pos_sdk/resources/bank_accounts/bank_accounts.py,sha256=k5PkBdyLlfXZaVqcYpWvaE0r-0QtMPM2X-HyeRNscg0,1397
+ebarimt_pos_sdk/resources/bank_accounts/schema.py,sha256=qLjGxMRDbahglWITA_lPJz3saTdj_Eev66aYQkucmZg,1621
+ebarimt_pos_sdk/resources/info/info.py,sha256=BESBm7W5JL_ihW-RL7sSNyVPjJWwh2jHl25jgoRNW2Q,936
+ebarimt_pos_sdk/resources/info/schema.py,sha256=Sza96EyQ9oocyFr5eDOS7t7sTTT0HzBA3ocDLq1Fwfs,2628
+ebarimt_pos_sdk/resources/receipt/__init__.py,sha256=y3G2eCUIs2AhI4pDVnsc9fGUpt-9-y6N9msSyGQqI7E,705
+ebarimt_pos_sdk/resources/receipt/receipt.py,sha256=gTHPTauQYXlWf5eeOLo4IgDKCioTe1sOkNvN7xZKknQ,2922
+ebarimt_pos_sdk/resources/receipt/schema.py,sha256=QudB87TAToa33h1iZd0GdVarOW_Dwv0-17U8Ti8jUYc,3883
+ebarimt_pos_sdk/resources/resource.py,sha256=Ia4rZXTutLXARx3mommmmVB98FDKYuJeKFE4LVeqSNI,1593
+ebarimt_pos_sdk/resources/send_data/send_data.py,sha256=cvLl2jeLEp0kDfSw59gbZwEecKciDkejtAh7WJgULLs,776
+ebarimt_pos_sdk/resources/third_party/third_party.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ebarimt_pos_sdk/settings.py,sha256=tMLbUo_Pfqr1va5NVPor5-fgs0onn1Ndkduf3WlLCdU,841
+ebarimt_pos_sdk/transport/__init__.py,sha256=QD_WtnjPd2PQAV3ycnbItEuOyTMExIWdNj-wWgEQwjE,493
+ebarimt_pos_sdk/transport/async_transport.py,sha256=2tURA1JgBmcM8ofkXfWLWIFcRz585v83XeWxziTkGK0,1149
+ebarimt_pos_sdk/transport/http.py,sha256=Yj5lNKWHMdGckhPwH5OnJ8p_BA3WgL5s8SWCQYDJdug,1237
+ebarimt_pos_sdk/transport/sync_transport.py,sha256=z5RPt3NU5UVlwgmupLNeQE6TlYgve2XXbFVr7Fuorbw,1007
+ebarimt_pos_sdk/utils.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ebarimt_pos_sdk-0.0.1b2.dist-info/WHEEL,sha256=5DEXXimM34_d4Gx1AuF9ysMr1_maoEtGKjaILM3s4w4,80
+ebarimt_pos_sdk-0.0.1b2.dist-info/METADATA,sha256=m-XFrBdpTZ2j31Xt74OWYvmtWTZkHvzM9DT8khSr8Ks,4164
+ebarimt_pos_sdk-0.0.1b2.dist-info/RECORD,,

ebarimt_pos_sdk-0.0.1b2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.9.29
+Root-Is-Purelib: true
+Tag: py3-none-any