bpjs-bridging 0.1.0__tar.gz

bpjs_bridging-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2021 Moriz
+Copyright (c) 2026 Syamsul
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bpjs_bridging-0.1.0/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.4
+Name: bpjs-bridging
+Version: 0.1.0
+Summary: Unofficial Python client for BPJS Kesehatan API supporting VClaim, iCare, Antrean RS, and Aplicare.
+Home-page: https://github.com/shiday1993/bpjs
+Author: Syamsul
+Author-email: shiday1993@gmail.com
+License: MIT
+Project-URL: Bug Tracker, https://github.com/shiday1993/bpjs/issues
+Project-URL: Source Code, https://github.com/shiday1993/bpjs
+Keywords: bpjs,vclaim,icare,antrean-rs,aplicare,jkn
+Classifier: Development Status :: 3 - Alpha
+Classifier: Operating System :: OS Independent
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: lzstring
+Requires-Dist: requests
+Requires-Dist: pycryptodome
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# BPJS Python Client
+
+Unofficial Python client untuk integrasi API BPJS Kesehatan.
+
+Library ini menyediakan interface sederhana untuk melakukan request ke beberapa layanan BPJS Kesehatan seperti **VClaim, iCare, Antrean RS, dan Aplicare**, termasuk pembuatan signature dan dekripsi response pada service yang membutuhkannya.
+
+> Project ini bukan library resmi dari BPJS Kesehatan.
+
+## Fitur
+
+- Generate `X-Signature` menggunakan HMAC SHA-256
+- Generate header autentikasi BPJS
+- Dekripsi response terenkripsi menggunakan AES
+- Dekompresi response menggunakan LZString
+- Mendukung beberapa service:
+  - VClaim
+  - iCare
+  - Antrean RS
+  - Aplicare
+- Interface request yang sama untuk setiap service
+- Mendukung GET, POST, PUT, dan DELETE
+- Normalisasi response BPJS
+
+## Instalasi
+
+```bash
+pip install bpjs-bridging
+```
+
+> Nama package dapat berubah sebelum rilis resmi ke PyPI.
+
+## Penggunaan
+
+```python
+from bpjs import Bridging
+
+config = {
+    "consid": "your_consid",
+    "secret": "your_secret",
+    "user_key": "your_userkey",
+    "host": "base_url",
+}
+
+vclaim = Bridging(config, "vclaim")
+
+response = vclaim.request("referensi/propinsi")
+
+print(response)
+```
+
+### POST Request
+
+```python
+payload = {
+    "param": "0000000000000",
+    "kodedokter": 123456,
+}
+
+response = icare.request(
+    "api/rs/validate",
+    method="post",
+    payload=payload,
+)
+
+print(response)
+```
+
+## Service
+
+Service ditentukan ketika membuat instance `Bridging`.
+
+```python
+vclaim = Bridging(config, "vclaim")
+icare = Bridging(config, "icare")
+antrean = Bridging(config, "antrean")
+aplicare = Bridging(config, "aplicare")
+```
+
+Setiap konfigurasi `config` membawa host service yang akan digunakan.
+
+## Konfigurasi
+
+```python
+config = {
+    "host": "SERVICE_HOST",
+    "consid": "consid",
+    "secret": "secret",
+    "user_key": "userkey",
+}
+```
+
+Jangan menyimpan credential BPJS secara langsung di source code pada aplikasi production. Gunakan environment variable atau mekanisme secret management lainnya.
+
+## Credit
+
+Implementasi awal mekanisme signature dan dekripsi response
+dikembangkan berdasarkan:
+
+[morizbebenk/pybpjs](https://github.com/morizbebenk/pybpjs)
+
+Project ini kemudian direfaktor dan dikembangkan lebih lanjut
+untuk mendukung beberapa service BPJS melalui interface berbasis class.
+
+## Sumber Daya
+- https://dvlp.bpjs-kesehatan.go.id:8888/trust-mark/portal.html
+
+## Lisensi
+- Aplikasi ini open source dengan lisensi [MIT](LICENSE).
+
+## Disclaimer
+
+Project ini merupakan library pihak ketiga dan tidak berafiliasi, didukung, atau dikelola oleh BPJS Kesehatan.
+
+Pengguna bertanggung jawab atas penggunaan credential dan kepatuhan terhadap ketentuan API BPJS Kesehatan.

bpjs_bridging-0.1.0/README.md

@@ -0,0 +1,114 @@
+# BPJS Python Client
+
+Unofficial Python client untuk integrasi API BPJS Kesehatan.
+
+Library ini menyediakan interface sederhana untuk melakukan request ke beberapa layanan BPJS Kesehatan seperti **VClaim, iCare, Antrean RS, dan Aplicare**, termasuk pembuatan signature dan dekripsi response pada service yang membutuhkannya.
+
+> Project ini bukan library resmi dari BPJS Kesehatan.
+
+## Fitur
+
+- Generate `X-Signature` menggunakan HMAC SHA-256
+- Generate header autentikasi BPJS
+- Dekripsi response terenkripsi menggunakan AES
+- Dekompresi response menggunakan LZString
+- Mendukung beberapa service:
+  - VClaim
+  - iCare
+  - Antrean RS
+  - Aplicare
+- Interface request yang sama untuk setiap service
+- Mendukung GET, POST, PUT, dan DELETE
+- Normalisasi response BPJS
+
+## Instalasi
+
+```bash
+pip install bpjs-bridging
+```
+
+> Nama package dapat berubah sebelum rilis resmi ke PyPI.
+
+## Penggunaan
+
+```python
+from bpjs import Bridging
+
+config = {
+    "consid": "your_consid",
+    "secret": "your_secret",
+    "user_key": "your_userkey",
+    "host": "base_url",
+}
+
+vclaim = Bridging(config, "vclaim")
+
+response = vclaim.request("referensi/propinsi")
+
+print(response)
+```
+
+### POST Request
+
+```python
+payload = {
+    "param": "0000000000000",
+    "kodedokter": 123456,
+}
+
+response = icare.request(
+    "api/rs/validate",
+    method="post",
+    payload=payload,
+)
+
+print(response)
+```
+
+## Service
+
+Service ditentukan ketika membuat instance `Bridging`.
+
+```python
+vclaim = Bridging(config, "vclaim")
+icare = Bridging(config, "icare")
+antrean = Bridging(config, "antrean")
+aplicare = Bridging(config, "aplicare")
+```
+
+Setiap konfigurasi `config` membawa host service yang akan digunakan.
+
+## Konfigurasi
+
+```python
+config = {
+    "host": "SERVICE_HOST",
+    "consid": "consid",
+    "secret": "secret",
+    "user_key": "userkey",
+}
+```
+
+Jangan menyimpan credential BPJS secara langsung di source code pada aplikasi production. Gunakan environment variable atau mekanisme secret management lainnya.
+
+## Credit
+
+Implementasi awal mekanisme signature dan dekripsi response
+dikembangkan berdasarkan:
+
+[morizbebenk/pybpjs](https://github.com/morizbebenk/pybpjs)
+
+Project ini kemudian direfaktor dan dikembangkan lebih lanjut
+untuk mendukung beberapa service BPJS melalui interface berbasis class.
+
+## Sumber Daya
+- https://dvlp.bpjs-kesehatan.go.id:8888/trust-mark/portal.html
+
+## Lisensi
+- Aplikasi ini open source dengan lisensi [MIT](LICENSE).
+
+## Disclaimer
+
+Project ini merupakan library pihak ketiga dan tidak berafiliasi, didukung, atau dikelola oleh BPJS Kesehatan.
+
+Pengguna bertanggung jawab atas penggunaan credential dan kepatuhan terhadap ketentuan API BPJS Kesehatan.

bpjs_bridging-0.1.0/pyproject.toml

@@ -0,0 +1,6 @@
+[build-system]
+requires = [
+    "setuptools>=42",
+    "wheel"
+]
+build-backend = "setuptools.build_meta"

bpjs_bridging-0.1.0/setup.cfg

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

bpjs_bridging-0.1.0/setup.py

@@ -0,0 +1,58 @@
+import setuptools
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setuptools.setup(
+    name="bpjs-bridging",
+    version="0.1.0",
+
+    author="Syamsul",
+    author_email="shiday1993@gmail.com",
+
+    description=(
+        "Unofficial Python client for BPJS Kesehatan API "
+        "supporting VClaim, iCare, Antrean RS, and Aplicare."
+    ),
+
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+
+    url="https://github.com/shiday1993/bpjs",
+
+    project_urls={
+        "Bug Tracker": "https://github.com/shiday1993/bpjs/issues",
+        "Source Code": "https://github.com/shiday1993/bpjs",
+    },
+
+    classifiers=[
+        "Development Status :: 3 - Alpha",
+        "Operating System :: OS Independent",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.14",
+    ],
+
+    package_dir={"": "src"},
+    packages=setuptools.find_packages(where="src"),
+
+    python_requires=">=3.9",
+
+    license="MIT",
+
+    keywords=[
+        "bpjs",
+        "vclaim",
+        "icare",
+        "antrean-rs",
+        "aplicare",
+        "jkn",
+    ],
+
+    install_requires=[
+        "lzstring",
+        "requests",
+        "pycryptodome",
+    ],
+)

bpjs_bridging-0.1.0/src/bpjs/__init__.py

@@ -0,0 +1 @@
+from .bpjs import Bridging

bpjs_bridging-0.1.0/src/bpjs/bpjs.py

@@ -0,0 +1,195 @@
+from Crypto.Cipher import AES
+from datetime import datetime
+import lzstring
+import requests
+import hashlib
+import base64
+import hmac
+import json
+
+
+class Bridging:
+    SERVICE_CONFIG = {
+        "vclaim": {
+            "encrypted": True,
+            "use_user_key": True,
+            "content_type": "application/x-www-form-urlencoded",
+        },
+        "icare": {
+            "encrypted": True,
+            "use_user_key": True,
+            "content_type": "application/json",
+        },
+        "antrean": {
+            "encrypted": True,
+            "use_user_key": True,
+            "content_type": "application/json",
+        },
+        "aplicare": {
+            "encrypted": False,
+            "use_user_key": False,
+            "content_type": "application/json",
+        },
+    }
+
+    UNENCRYPTED_ENDPOINTS = {
+        "vclaim": [
+            "SEP/2.0/delete",
+            "SEP/2.0/update",
+        ]
+    }
+
+    def __init__(self, client, service):
+        service = service.lower()
+        if service not in self.SERVICE_CONFIG:
+            raise ValueError(f"Service BPJS tidak dikenal: {service}")
+        self.service = service
+        self.config = self.SERVICE_CONFIG[service]
+        self.host = client["host"].rstrip("/")
+        self.consid = client["consid"]
+        self.secret = client["secret"]
+        self.user_key = client.get("user_key")
+
+    # URL
+    @staticmethod
+    def _fixed_url(value):
+        return value.strip("/")
+
+    def _build_url(self, endpoint):
+        return f"{self._fixed_url(self.host)}/{self._fixed_url(endpoint)}"
+
+    # AUTH / SIGNATURE
+    def _timestamp(self):
+        return str(int(datetime.now().timestamp()))
+
+    def _signature(self, timestamp):
+        message = f"{self.consid}&{timestamp}"
+        signature = hmac.new(
+            self.secret.encode("utf-8"),
+            message.encode("utf-8"),
+            hashlib.sha256
+        ).digest()
+        return base64.b64encode(signature).decode()
+
+    def _headers(self, timestamp):
+        headers = {
+            "X-cons-id": self.consid,
+            "X-timestamp": timestamp,
+            "X-signature": self._signature(timestamp),
+            "Content-Type": self.config["content_type"],
+            "Accept": "*/*",
+        }
+        if self.config.get("use_user_key") and self.user_key:
+            headers["user_key"] = self.user_key
+        return headers
+
+    # DECRYPT
+    def _decrypt(self, encrypted, timestamp):
+        if not encrypted:
+            return None
+        key = f"{self.consid}{self.secret}{timestamp}"
+        key_hash = hashlib.sha256(key.encode("utf-8")).digest()
+        decryptor = AES.new(
+            key_hash[:32],
+            AES.MODE_CBC,
+            IV=key_hash[:16]
+        )
+        plain = decryptor.decrypt(base64.b64decode(encrypted))
+        compressed = plain.decode("utf-8")
+        lz = lzstring.LZString()
+        decompressed = lz.decompressFromEncodedURIComponent(compressed)
+        return json.loads(decompressed)
+
+    def _should_decrypt(self, endpoint):
+        if not self.config.get("encrypted"):
+            return False
+        exclusions = self.UNENCRYPTED_ENDPOINTS.get(self.service,[])
+        endpoint = self._fixed_url(endpoint)
+        for item in exclusions:
+            if item.lower() in endpoint.lower():
+                return False
+        return True
+
+    # RESPONSE
+    @staticmethod
+    def _error(code, message):
+        return {
+            "metaData": {
+                "code": code,
+                "message": message,
+            },
+            "response": None,
+        }
+
+    def _parse_response(self, res, endpoint, timestamp):
+        if res.status_code == 404:
+            return self._error(404, "URL tidak ditemukan")
+        try:
+            body = res.json()
+        except ValueError:
+            return self._error(res.status_code,res.text)
+
+        metadata = (
+            body.get("metaData")
+            or body.get("metadata")
+            or {}
+        )
+        code = metadata.get("code", metadata.get("Code", res.status_code))
+        message = metadata.get("message", metadata.get("Message", ""))
+        try:
+            numeric_code = int(code)
+        except (TypeError, ValueError):
+            numeric_code = code
+
+        if numeric_code == 0:
+            return self._error(400, message)
+
+        response = body.get("response")
+        if response is None:
+            return {
+                "metaData": {
+                    "code": code,
+                    "message": message,
+                },
+                "response": None,
+            }
+
+        if self._should_decrypt(endpoint):
+            try:
+                response = self._decrypt(response, timestamp )
+            except Exception as e:
+                return self._error(500, f"Gagal decrypt response BPJS: {e}" )
+
+        return {
+            "metaData": {
+                "code": code,
+                "message": message,
+            },
+            "response": response,
+        }
+
+    # REQUEST
+    def request(self, endpoint, method="GET", payload=None, timeout=30):
+        timestamp = self._timestamp()
+        url = self._build_url(endpoint)
+        headers = self._headers(timestamp)
+        method = method.upper()
+        try:
+            kwargs = {
+                "headers": headers,
+                "timeout": timeout,
+            }
+            if payload is not None:
+                kwargs["data"] = json.dumps(payload)
+
+            res = requests.request(method,url,**kwargs)
+            return self._parse_response(res,endpoint,timestamp)
+
+        except requests.exceptions.ConnectTimeout:
+            return self._error(504,"Koneksi ke BPJS timeout")
+        except requests.exceptions.ReadTimeout:
+            return self._error(504, "BPJS terlalu lama merespons")
+        except requests.exceptions.ConnectionError as e:
+            return self._error(503, f"Gagal terhubung ke BPJS: {e}" )
+        except requests.exceptions.RequestException as e:
+            return self._error(502, f"Request BPJS gagal: {e}")

bpjs_bridging-0.1.0/src/bpjs_bridging.egg-info/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.4
+Name: bpjs-bridging
+Version: 0.1.0
+Summary: Unofficial Python client for BPJS Kesehatan API supporting VClaim, iCare, Antrean RS, and Aplicare.
+Home-page: https://github.com/shiday1993/bpjs
+Author: Syamsul
+Author-email: shiday1993@gmail.com
+License: MIT
+Project-URL: Bug Tracker, https://github.com/shiday1993/bpjs/issues
+Project-URL: Source Code, https://github.com/shiday1993/bpjs
+Keywords: bpjs,vclaim,icare,antrean-rs,aplicare,jkn
+Classifier: Development Status :: 3 - Alpha
+Classifier: Operating System :: OS Independent
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: lzstring
+Requires-Dist: requests
+Requires-Dist: pycryptodome
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# BPJS Python Client
+
+Unofficial Python client untuk integrasi API BPJS Kesehatan.
+
+Library ini menyediakan interface sederhana untuk melakukan request ke beberapa layanan BPJS Kesehatan seperti **VClaim, iCare, Antrean RS, dan Aplicare**, termasuk pembuatan signature dan dekripsi response pada service yang membutuhkannya.
+
+> Project ini bukan library resmi dari BPJS Kesehatan.
+
+## Fitur
+
+- Generate `X-Signature` menggunakan HMAC SHA-256
+- Generate header autentikasi BPJS
+- Dekripsi response terenkripsi menggunakan AES
+- Dekompresi response menggunakan LZString
+- Mendukung beberapa service:
+  - VClaim
+  - iCare
+  - Antrean RS
+  - Aplicare
+- Interface request yang sama untuk setiap service
+- Mendukung GET, POST, PUT, dan DELETE
+- Normalisasi response BPJS
+
+## Instalasi
+
+```bash
+pip install bpjs-bridging
+```
+
+> Nama package dapat berubah sebelum rilis resmi ke PyPI.
+
+## Penggunaan
+
+```python
+from bpjs import Bridging
+
+config = {
+    "consid": "your_consid",
+    "secret": "your_secret",
+    "user_key": "your_userkey",
+    "host": "base_url",
+}
+
+vclaim = Bridging(config, "vclaim")
+
+response = vclaim.request("referensi/propinsi")
+
+print(response)
+```
+
+### POST Request
+
+```python
+payload = {
+    "param": "0000000000000",
+    "kodedokter": 123456,
+}
+
+response = icare.request(
+    "api/rs/validate",
+    method="post",
+    payload=payload,
+)
+
+print(response)
+```
+
+## Service
+
+Service ditentukan ketika membuat instance `Bridging`.
+
+```python
+vclaim = Bridging(config, "vclaim")
+icare = Bridging(config, "icare")
+antrean = Bridging(config, "antrean")
+aplicare = Bridging(config, "aplicare")
+```
+
+Setiap konfigurasi `config` membawa host service yang akan digunakan.
+
+## Konfigurasi
+
+```python
+config = {
+    "host": "SERVICE_HOST",
+    "consid": "consid",
+    "secret": "secret",
+    "user_key": "userkey",
+}
+```
+
+Jangan menyimpan credential BPJS secara langsung di source code pada aplikasi production. Gunakan environment variable atau mekanisme secret management lainnya.
+
+## Credit
+
+Implementasi awal mekanisme signature dan dekripsi response
+dikembangkan berdasarkan:
+
+[morizbebenk/pybpjs](https://github.com/morizbebenk/pybpjs)
+
+Project ini kemudian direfaktor dan dikembangkan lebih lanjut
+untuk mendukung beberapa service BPJS melalui interface berbasis class.
+
+## Sumber Daya
+- https://dvlp.bpjs-kesehatan.go.id:8888/trust-mark/portal.html
+
+## Lisensi
+- Aplikasi ini open source dengan lisensi [MIT](LICENSE).
+
+## Disclaimer
+
+Project ini merupakan library pihak ketiga dan tidak berafiliasi, didukung, atau dikelola oleh BPJS Kesehatan.
+
+Pengguna bertanggung jawab atas penggunaan credential dan kepatuhan terhadap ketentuan API BPJS Kesehatan.

bpjs_bridging-0.1.0/src/bpjs_bridging.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+src/bpjs/__init__.py
+src/bpjs/bpjs.py
+src/bpjs_bridging.egg-info/PKG-INFO
+src/bpjs_bridging.egg-info/SOURCES.txt
+src/bpjs_bridging.egg-info/dependency_links.txt
+src/bpjs_bridging.egg-info/requires.txt
+src/bpjs_bridging.egg-info/top_level.txt

bpjs_bridging-0.1.0/src/bpjs_bridging.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

bpjs_bridging-0.1.0/src/bpjs_bridging.egg-info/requires.txt

@@ -0,0 +1,3 @@
+lzstring
+requests
+pycryptodome

bpjs_bridging-0.1.0/src/bpjs_bridging.egg-info/top_level.txt

@@ -0,0 +1 @@
+bpjs