satusehat-integration 0.1.0__tar.gz

satusehat_integration-0.1.0/PKG-INFO

@@ -0,0 +1,11 @@
+Metadata-Version: 2.4
+Name: satusehat-integration
+Version: 0.1.0
+Summary: SATUSEHAT FHIR R4 SDK for Python
+Requires-Python: >=3.10
+Requires-Dist: requests>=2.31
+Requires-Dist: pydantic>=2.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: ruff; extra == "dev"

satusehat_integration-0.1.0/README.md

@@ -0,0 +1,184 @@
+# satusehat-integration-python
+
+> **Open-source Python SDK for integrating with SATUSEHAT** — Indonesia's national health data platform powered by FHIR R4. Pure Python, no framework dependency.
+
+[![Python](https://img.shields.io/badge/Python-3.10%2B-blue)](https://python.org)
+[![FHIR R4](https://img.shields.io/badge/FHIR-R4-orange)](https://hl7.org/fhir/R4/)
+[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE)
+[![CI](https://github.com/ivanwilliammd/satusehat-integration-python/actions/workflows/ci.yml/badge.svg)](https://github.com/ivanwilliammd/satusehat-integration-python/actions)
+
+---
+
+## Overview
+
+`satusehat-integration-python` is an **open-source** Python SDK for integrating with **SATUSEHAT** — Indonesia's national health data platform powered by FHIR R4.
+
+Built on the official [SATUSEHAT Platform Guidelines](https://satusehat.kemkes.go.id/platform/docs). Ships with:
+- **50 DataType** classes — composable FHIR R4 value objects with `to_json()` serialization
+- **50 PayloadBuilder** classes — fluent builders for all FHIR resources (Patient, Practitioner, Organization, etc.)
+- **Queue + Rate Limiter** — in-memory queue with configurable RPM rate limiting
+
+Zero dependencies beyond standard library. Works standalone or with Django/FastAPI/Flask.
+
+---
+
+## Requirements
+
+- Python 3.10 or later
+
+---
+
+## Quick Install
+
+```bash
+pip install satusehat-integration-python
+# or
+git clone https://github.com/ivanwilliammd/satusehat-integration-python.git
+cd satusehat-integration-python && pip install -e .
+```
+
+```env
+# .env
+SATUSEHAT_ENV=DEV          # DEV | STG | PROD
+SATUSEHAT_BASE_URL_DEV=https://api-satusehat-dev.dto.kemkes.go.id
+CLIENTID_DEV=your_client_id
+CLIENTSECRET_DEV=your_client_secret
+ORGID_DEV=your_org_id
+```
+
+---
+
+## Architecture
+
+### DataType Classes (`src/datatype/`)
+
+Atomic FHIR R4 value objects. All provide a `to_json()` method — nested types serialize to clean FHIR JSON automatically.
+
+| Category | Classes |
+|----------|---------|
+| Core | `Coding`, `CodeableConcept`, `Identifier`, `ContactPoint`, `Address`, `HumanName`, `Reference` |
+| Quantity | `Age`, `Quantity` |
+| Utility | `Period`, `ParameterComponent` |
+
+Example — `HumanName`:
+
+```python
+from src.datatype.datatypes import HumanName
+
+name = HumanName(
+    family='Doe',
+    given=['John', 'Michael'],
+    use='official'
+)
+# name.to_json() → {'family': 'Doe', 'given': ['John', 'Michael'], 'use': 'official'}
+```
+
+### PayloadBuilder Pattern (`src/builder/`)
+
+Fluent builder for each FHIR resource. Each builder exposes chainable methods and returns the resource payload via `to_json()`.
+
+```python
+from src.builder.payload_builders import PatientBuilder, HumanName
+
+patient = PatientBuilder()
+patient.add_name(HumanName(family='Doe', given=['John'], use='official').to_json())
+patient.set_gender('male')
+patient.set_birth_date('1990-01-15')
+
+payload = patient.to_json()
+```
+
+---
+
+## Supported FHIR Resources
+
+All 51 resources fully implemented via PayloadBuilder classes. Core (✅) + Non-Core (💼):
+
+| # | Resource | Notes |
+|---|----------|-------|
+| 1 | Patient | ✅ MPI |
+| 2 | Practitioner | ✅ SDMK |
+| 3 | PractitionerRole | ✅ |
+| 4 | Organization | ✅ MSI |
+| 5 | Location | ✅ |
+| 6 | Encounter | ✅ |
+| 7 | Condition | ✅ |
+| 8 | Observation | ✅ |
+| 9 | Procedure | ✅ |
+| 10 | MedicationRequest | ✅ |
+| 11 | Bundle | ✅ batch/transaction |
+| 12–37 | CarePlan through Task | ✅ |
+| 38–50 | Account through Invoice | 💼 Billing/Claim resources |
+
+---
+
+## Usage Examples
+
+### Patient
+
+```python
+from src.builder.payload_builders import PatientBuilder
+
+patient = PatientBuilder()
+patient.add_name({
+    'family': 'Doe',
+    'given': ['John'],
+    'use': 'official'
+})
+patient.set_gender('male')
+patient.set_birth_date('1990-01-15')
+patient.add_telecom({'system': 'phone', 'value': '081234567890', 'use': 'mobile'})
+
+payload = patient.to_json()
+print(payload)
+```
+
+### Claim (BPJS Klaim)
+
+```python
+from src.builder.payload_builders import ClaimBuilder
+
+claim = ClaimBuilder()
+claim.set_status('active')
+claim.set_use('claim')
+claim.set_type('institutional')
+claim.set_patient('pat-123', 'enc-456')
+claim.add_item(1, 'PROCID001', 150000, 'IDR')
+claim.set_total(150000, 'IDR')
+
+payload = claim.to_json()
+```
+
+---
+
+## Documentation
+
+| Page | Description |
+|------|-------------|
+| [Wiki Home](https://github.com/ivanwilliammd/satusehat-integration-python.wiki.git) | Full documentation |
+| [Getting Started](https://github.com/ivanwilliammd/satusehat-integration-python/wiki/Getting-Started) | Installation, configuration |
+| [DataTypes](https://github.com/ivanwilliammd/satusehat-integration-python/wiki/DataTypes) | Complete type reference |
+| [Builders](https://github.com/ivanwilliammd/satusehat-integration-python/wiki/Builders) | Builder usage guide |
+| [Resources](https://github.com/ivanwilliammd/satusehat-integration-python/wiki/Resources) | All FHIR resources |
+| [Claim Module](https://github.com/ivanwilliammd/satusehat-integration-python/wiki/Claim-Module) | BPJS Klaim integration |
+
+---
+
+## External Resources
+
+- [HL7 FHIR R4 Specification](https://hl7.org/fhir/R4/)
+- [SATUSEHAT Platform Docs](https://satusehat.kemkes.go.id/platform/docs)
+- [Main PHP SDK](https://github.com/ivanwilliammd/satusehat-integration)
+- [SATUSEHAT Sandbox API](https://api-satusehat-dev.dto.kemkes.go.id)
+
+---
+
+## Contributing
+
+Contributions are welcome. Please ensure tests pass and follow existing code conventions.
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).

satusehat_integration-0.1.0/pyproject.toml

@@ -0,0 +1,9 @@
+[project]
+name = "satusehat-integration"
+version = "0.1.0"
+description = "SATUSEHAT FHIR R4 SDK for Python"
+requires-python = ">=3.10"
+dependencies = ["requests>=2.31", "pydantic>=2.0"]
+
+[project.optional-dependencies]
+dev = ["pytest", "pytest-cov", "ruff"]

satusehat_integration-0.1.0/setup.cfg

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

satusehat_integration-0.1.0/src/__init__.py

@@ -0,0 +1 @@
+# src package

satusehat_integration-0.1.0/src/builder/__init__.py

@@ -0,0 +1,227 @@
+from src.builder.account import AccountBuilder
+from src.builder.adverse_event import AdverseEventBuilder
+from src.builder.allergy_intolerance import AllergyIntoleranceBuilder
+from src.builder.appointment import AppointmentBuilder
+from src.builder.appointment_response import AppointmentResponseBuilder
+from src.builder.audit_event import AuditEventBuilder
+from src.builder.base_builder import BaseBuilder
+from src.builder.basic import BasicBuilder
+from src.builder.binary import BinaryBuilder
+from src.builder.biologically_derived_product import BiologicallyDerivedProductBuilder
+from src.builder.body_structure import BodyStructureBuilder
+from src.builder.bundle import BundleBuilder
+from src.builder.care_plan import CarePlanBuilder
+from src.builder.care_team import CareTeamBuilder
+from src.builder.charge_item import ChargeItemBuilder
+from src.builder.charge_item_definition import ChargeItemDefinitionBuilder
+from src.builder.charge_item_response import ChargeItemResponseBuilder
+from src.builder.claim import ClaimBuilder
+from src.builder.claim_response import ClaimResponseBuilder
+from src.builder.clinical_impression import ClinicalImpressionBuilder
+from src.builder.communication import CommunicationBuilder
+from src.builder.communication_request import CommunicationRequestBuilder
+from src.builder.composition import CompositionBuilder
+from src.builder.condition import ConditionBuilder
+from src.builder.consent import ConsentBuilder
+from src.builder.contract import ContractBuilder
+from src.builder.coverage import CoverageBuilder
+from src.builder.coverage_eligibility_request import CoverageEligibilityRequestBuilder
+from src.builder.coverage_eligibility_response import CoverageEligibilityResponseBuilder
+from src.builder.detected_issue import DetectedIssueBuilder
+from src.builder.device import DeviceBuilder
+from src.builder.device_definition import DeviceDefinitionBuilder
+from src.builder.device_request import DeviceRequestBuilder
+from src.builder.device_use_statement import DeviceUseStatementBuilder
+from src.builder.diagnostic_report import DiagnosticReportBuilder
+from src.builder.document_reference import DocumentReferenceBuilder
+from src.builder.effect_evidence_synthesis import EffectEvidenceSynthesisBuilder
+from src.builder.encounter import EncounterBuilder
+from src.builder.enrollment_request import EnrollmentRequestBuilder
+from src.builder.episode_of_care import EpisodeOfCareBuilder
+from src.builder.event_definition import EventDefinitionBuilder
+from src.builder.evidence import EvidenceBuilder
+from src.builder.evidence_variable import EvidenceVariableBuilder
+from src.builder.example_scenario import ExampleScenarioBuilder
+from src.builder.family_member_history import FamilyMemberHistoryBuilder
+from src.builder.flag import FlagBuilder
+from src.builder.genomic_study import GenomicStudyBuilder
+from src.builder.goal import GoalBuilder
+from src.builder.group import GroupBuilder
+from src.builder.guidance_response import GuidanceResponseBuilder
+from src.builder.imaging_manifest import ImagingManifestBuilder
+from src.builder.imaging_selection import ImagingSelectionBuilder
+from src.builder.imaging_study import ImagingStudyBuilder
+from src.builder.immunization import ImmunizationBuilder
+from src.builder.immunization_evaluation import ImmunizationEvaluationBuilder
+from src.builder.immunization_recommendation import ImmunizationRecommendationBuilder
+from src.builder.invoice import InvoiceBuilder
+from src.builder.library import LibraryBuilder
+from src.builder.linkage import LinkageBuilder
+from src.builder.list_resource import ListResourceBuilder
+from src.builder.location import LocationBuilder
+from src.builder.measure import MeasureBuilder
+from src.builder.measure_report import MeasureReportBuilder
+from src.builder.media import MediaBuilder
+from src.builder.medication import MedicationBuilder
+from src.builder.medication_administration import MedicationAdministrationBuilder
+from src.builder.medication_dispense import MedicationDispenseBuilder
+from src.builder.medication_request import MedicationRequestBuilder
+from src.builder.medication_statement import MedicationStatementBuilder
+from src.builder.message_definition import MessageDefinitionBuilder
+from src.builder.message_header import MessageHeaderBuilder
+from src.builder.molecular_sequence import MolecularSequenceBuilder
+from src.builder.nutrition_order import NutritionOrderBuilder
+from src.builder.observation import ObservationBuilder
+from src.builder.operation_outcome import OperationOutcomeBuilder
+from src.builder.organization import OrganizationBuilder
+from src.builder.patient import PatientBuilder
+from src.builder.payment_notice import PaymentNoticeBuilder
+from src.builder.payment_reconciliation import PaymentReconciliationBuilder
+from src.builder.person import PersonBuilder
+from src.builder.plan_definition import PlanDefinitionBuilder
+from src.builder.practitioner import PractitionerBuilder
+from src.builder.practitioner_role import PractitionerRoleBuilder
+from src.builder.procedure import ProcedureBuilder
+from src.builder.provenance import ProvenanceBuilder
+from src.builder.questionnaire import QuestionnaireBuilder
+from src.builder.questionnaire_response import QuestionnaireResponseBuilder
+from src.builder.related_person import RelatedPersonBuilder
+from src.builder.request_group import RequestGroupBuilder
+from src.builder.research_definition import ResearchDefinitionBuilder
+from src.builder.research_element_definition import ResearchElementDefinitionBuilder
+from src.builder.research_subject import ResearchSubjectBuilder
+from src.builder.risk_assessment import RiskAssessmentBuilder
+from src.builder.risk_evidence_synthesis import RiskEvidenceSynthesisBuilder
+from src.builder.schedule import ScheduleBuilder
+from src.builder.search_parameter import SearchParameterBuilder
+from src.builder.service_request import ServiceRequestBuilder
+from src.builder.slot import SlotBuilder
+from src.builder.specimen import SpecimenBuilder
+from src.builder.substance import SubstanceBuilder
+from src.builder.substance_nucleic_acid import SubstanceNucleicAcidBuilder
+from src.builder.substance_polymer import SubstancePolymerBuilder
+from src.builder.substance_protein import SubstanceProteinBuilder
+from src.builder.substance_source_material import SubstanceSourceMaterialBuilder
+from src.builder.substance_specification import SubstanceSpecificationBuilder
+from src.builder.subscription import SubscriptionBuilder
+from src.builder.supply_delivery import SupplyDeliveryBuilder
+from src.builder.supply_request import SupplyRequestBuilder
+from src.builder.task import TaskBuilder
+from src.builder.test_report import TestReportBuilder
+from src.builder.test_script import TestScriptBuilder
+from src.builder.verification_result import VerificationResultBuilder
+
+__all__ = [
+    "AccountBuilder",
+    "AdverseEventBuilder",
+    "AllergyIntoleranceBuilder",
+    "AppointmentBuilder",
+    "AppointmentResponseBuilder",
+    "AuditEventBuilder",
+    "BaseBuilder",
+    "BasicBuilder",
+    "BinaryBuilder",
+    "BiologicallyDerivedProductBuilder",
+    "BodyStructureBuilder",
+    "BundleBuilder",
+    "CarePlanBuilder",
+    "CareTeamBuilder",
+    "ChargeItemBuilder",
+    "ChargeItemDefinitionBuilder",
+    "ChargeItemResponseBuilder",
+    "ClaimBuilder",
+    "ClaimResponseBuilder",
+    "ClinicalImpressionBuilder",
+    "CommunicationBuilder",
+    "CommunicationRequestBuilder",
+    "CompositionBuilder",
+    "ConditionBuilder",
+    "ConsentBuilder",
+    "ContractBuilder",
+    "CoverageBuilder",
+    "CoverageEligibilityRequestBuilder",
+    "CoverageEligibilityResponseBuilder",
+    "DetectedIssueBuilder",
+    "DeviceBuilder",
+    "DeviceDefinitionBuilder",
+    "DeviceRequestBuilder",
+    "DeviceUseStatementBuilder",
+    "DiagnosticReportBuilder",
+    "DocumentReferenceBuilder",
+    "EffectEvidenceSynthesisBuilder",
+    "EncounterBuilder",
+    "EnrollmentRequestBuilder",
+    "EpisodeOfCareBuilder",
+    "EventDefinitionBuilder",
+    "EvidenceBuilder",
+    "EvidenceVariableBuilder",
+    "ExampleScenarioBuilder",
+    "FamilyMemberHistoryBuilder",
+    "FlagBuilder",
+    "GenomicStudyBuilder",
+    "GoalBuilder",
+    "GroupBuilder",
+    "GuidanceResponseBuilder",
+    "ImagingManifestBuilder",
+    "ImagingSelectionBuilder",
+    "ImagingStudyBuilder",
+    "ImmunizationBuilder",
+    "ImmunizationEvaluationBuilder",
+    "ImmunizationRecommendationBuilder",
+    "InvoiceBuilder",
+    "LibraryBuilder",
+    "LinkageBuilder",
+    "ListResourceBuilder",
+    "LocationBuilder",
+    "MeasureBuilder",
+    "MeasureReportBuilder",
+    "MediaBuilder",
+    "MedicationBuilder",
+    "MedicationAdministrationBuilder",
+    "MedicationDispenseBuilder",
+    "MedicationRequestBuilder",
+    "MedicationStatementBuilder",
+    "MessageDefinitionBuilder",
+    "MessageHeaderBuilder",
+    "MolecularSequenceBuilder",
+    "NutritionOrderBuilder",
+    "ObservationBuilder",
+    "OperationOutcomeBuilder",
+    "OrganizationBuilder",
+    "PatientBuilder",
+    "PaymentNoticeBuilder",
+    "PaymentReconciliationBuilder",
+    "PersonBuilder",
+    "PlanDefinitionBuilder",
+    "PractitionerBuilder",
+    "PractitionerRoleBuilder",
+    "ProcedureBuilder",
+    "ProvenanceBuilder",
+    "QuestionnaireBuilder",
+    "QuestionnaireResponseBuilder",
+    "RelatedPersonBuilder",
+    "RequestGroupBuilder",
+    "ResearchDefinitionBuilder",
+    "ResearchElementDefinitionBuilder",
+    "ResearchSubjectBuilder",
+    "RiskAssessmentBuilder",
+    "RiskEvidenceSynthesisBuilder",
+    "ScheduleBuilder",
+    "SearchParameterBuilder",
+    "ServiceRequestBuilder",
+    "SlotBuilder",
+    "SpecimenBuilder",
+    "SubstanceBuilder",
+    "SubstanceNucleicAcidBuilder",
+    "SubstancePolymerBuilder",
+    "SubstanceProteinBuilder",
+    "SubstanceSourceMaterialBuilder",
+    "SubstanceSpecificationBuilder",
+    "SubscriptionBuilder",
+    "SupplyDeliveryBuilder",
+    "SupplyRequestBuilder",
+    "TaskBuilder",
+    "TestReportBuilder",
+    "TestScriptBuilder",
+    "VerificationResultBuilder",
+]

satusehat_integration-0.1.0/src/builder/account.py

@@ -0,0 +1,67 @@
+"""Account resource builder for SATUSEHAT FHIR R4."""
+from typing import List, Optional
+from src.builder.base_builder import BaseBuilder
+
+
+class AccountBuilder(BaseBuilder):
+    """Builder for Account resource."""
+
+    def __init__(self):
+        super().__init__("Account")
+    def set_id(self, id: str) -> "AccountBuilder":
+        self.data["id"] = id
+        return self
+
+    def set_status(self, status: str) -> "AccountBuilder":
+        self.data["status"] = status
+        return self
+
+    def set_type(self, code: str, system: str, display: Optional[str] = None) -> "AccountBuilder":
+        self.data["type"] = {"coding": [{"system": system, "code": code}]}
+        if display:
+            self.data["type"]["coding"][0]["display"] = display
+        return self
+
+    def set_name(self, name: str) -> "AccountBuilder":
+        self.data["name"] = name
+        return self
+
+    def set_subject(self, reference: str, display: Optional[str] = None) -> "AccountBuilder":
+        self.data["subject"] = {"reference": reference}
+        if display:
+            self.data["subject"]["display"] = display
+        return self
+
+    def set_service_period(self, start: Optional[str] = None, end: Optional[str] = None) -> "AccountBuilder":
+        period: dict = {}
+        if start:
+            period["start"] = start
+        if end:
+            period["end"] = end
+        self.data["servicePeriod"] = period
+        return self
+
+    def add_coverage(
+        self,
+        coverage_reference: str,
+        priority: Optional[int] = None,
+        coverage_display: Optional[str] = None
+    ) -> "AccountBuilder":
+        self.data.setdefault("coverage", [])
+        cov: dict = {"coverage": {"reference": coverage_reference}}
+        if priority:
+            cov["priority"] = priority
+        if coverage_display:
+            cov["coverage"]["display"] = coverage_display
+        self.data["coverage"].append(cov)
+        return self
+
+    def set_owner(self, reference: str, display: Optional[str] = None) -> "AccountBuilder":
+        self.data["owner"] = {"reference": reference}
+        if display:
+            self.data["owner"]["display"] = display
+        return self
+
+    def set_description(self, description: str) -> "AccountBuilder":
+        self.data["description"] = description
+        return self

satusehat_integration-0.1.0/src/builder/adverse_event.py

@@ -0,0 +1,31 @@
+from typing import Optional
+from src.builder.base_builder import BaseBuilder
+
+
+class AdverseEventBuilder(BaseBuilder):
+    def __init__(self) -> None:
+        super().__init__("AdverseEvent")
+
+    def set_id(id: str) -> "AdverseEventBuilder":
+        self._set("id", id)
+        return self
+
+    def add_identifier(system: str, value: str) -> "AdverseEventBuilder":
+        self._append("identifier", {"system": system, "value": value})
+        return self
+
+    def set_status(status: str) -> "AdverseEventBuilder":
+        self._set("status", status)
+        return self
+
+    def set_code(code: dict) -> "AdverseEventBuilder":
+        self._set("code", code)
+        return self
+
+    def set_subject(reference: str, display: str = None) -> "AdverseEventBuilder":
+        self._set("subject", {"reference": reference, "display": display}) if display else self._set("subject", {"reference": reference})
+        return self
+
+    def set_description(description: str) -> "AdverseEventBuilder":
+        self._set("description", description)
+        return self

satusehat_integration-0.1.0/src/builder/allergy_intolerance.py

@@ -0,0 +1,48 @@
+from src.builder.base_builder import BaseBuilder
+
+class AllergyIntoleranceBuilder(BaseBuilder):
+    def __init__(self) -> None:
+        super().__init__("AllergyIntolerance")
+
+    def identifier(self, identifier: dict) -> "AllergyIntoleranceBuilder":
+        return self._push("identifier", identifier)
+
+    def clinical_status(self, code: str, system: str = "http://terminology.kemkes.go.id/CodeSystem/allergyintolerance-clinical", display: str = "") -> "AllergyIntoleranceBuilder":
+        v = {"coding": [{"system": system, "code": code, "display": display}]}
+        return self._set("clinicalStatus", v)
+
+    def verification_status(self, code: str, system: str = "http://terminology.kemkes.go.id/CodeSystem/allergyintolerance-verification", display: str = "") -> "AllergyIntoleranceBuilder":
+        return self._set("verificationStatus", {"coding": [{"system": system, "code": code, "display": display}]})
+
+    def type(self, code: str, system: str = "http://terminology.kemkes.go.id/CodeSystem/allergyintolerance-type", display: str = "") -> "AllergyIntoleranceBuilder":
+        return self._set("type", {"coding": [{"system": system, "code": code, "display": display}]})
+
+    def category(self, value: str) -> "AllergyIntoleranceBuilder":
+        return self._set("category", [value])
+
+    def code(self, codeable_concept: dict) -> "AllergyIntoleranceBuilder":
+        return self._set("code", codeable_concept)
+
+    def patient(self, reference: str, display: str = "") -> "AllergyIntoleranceBuilder":
+        sub = {"reference": reference}
+        if display:
+            sub["display"] = display
+        return self._set("patient", sub)
+
+    def encounter(self, reference: str) -> "AllergyIntoleranceBuilder":
+        return self._set("encounter", {"reference": reference})
+
+    def onset_date_time(self, value: str) -> "AllergyIntoleranceBuilder":
+        return self._set("onsetDateTime", value)
+
+    def recorded_date(self, value: str) -> "AllergyIntoleranceBuilder":
+        return self._set("recordedDate", value)
+
+    def recorder(self, reference: str) -> "AllergyIntoleranceBuilder":
+        return self._set("recorder", {"reference": reference})
+
+    def asserter(self, reference: str) -> "AllergyIntoleranceBuilder":
+        return self._set("asserter", {"reference": reference})
+
+    def note(self, text: str) -> "AllergyIntoleranceBuilder":
+        return self._set("note", [{"text": text}])

satusehat_integration-0.1.0/src/builder/appointment.py

@@ -0,0 +1,31 @@
+from typing import Optional
+from src.builder.base_builder import BaseBuilder
+
+
+class AppointmentBuilder(BaseBuilder):
+    def __init__(self) -> None:
+        super().__init__("Appointment")
+
+    def set_id(id: str) -> "AppointmentBuilder":
+        self._set("id", id)
+        return self
+
+    def add_identifier(system: str, value: str) -> "AppointmentBuilder":
+        self._append("identifier", {"system": system, "value": value})
+        return self
+
+    def set_status(status: str) -> "AppointmentBuilder":
+        self._set("status", status)
+        return self
+
+    def set_code(code: dict) -> "AppointmentBuilder":
+        self._set("code", code)
+        return self
+
+    def set_subject(reference: str, display: str = None) -> "AppointmentBuilder":
+        self._set("subject", {"reference": reference, "display": display}) if display else self._set("subject", {"reference": reference})
+        return self
+
+    def set_description(description: str) -> "AppointmentBuilder":
+        self._set("description", description)
+        return self

satusehat_integration-0.1.0/src/builder/appointment_response.py

@@ -0,0 +1,31 @@
+from typing import Optional
+from src.builder.base_builder import BaseBuilder
+
+
+class AppointmentResponseBuilder(BaseBuilder):
+    def __init__(self) -> None:
+        super().__init__("AppointmentResponse")
+
+    def set_id(id: str) -> "AppointmentResponseBuilder":
+        self._set("id", id)
+        return self
+
+    def add_identifier(system: str, value: str) -> "AppointmentResponseBuilder":
+        self._append("identifier", {"system": system, "value": value})
+        return self
+
+    def set_status(status: str) -> "AppointmentResponseBuilder":
+        self._set("status", status)
+        return self
+
+    def set_code(code: dict) -> "AppointmentResponseBuilder":
+        self._set("code", code)
+        return self
+
+    def set_subject(reference: str, display: str = None) -> "AppointmentResponseBuilder":
+        self._set("subject", {"reference": reference, "display": display}) if display else self._set("subject", {"reference": reference})
+        return self
+
+    def set_description(description: str) -> "AppointmentResponseBuilder":
+        self._set("description", description)
+        return self