Technical Documentation
Platform Architecture & Technical Overview
A deep dive into the technology powering PerfectRx's pharmacy fulfillment platform. From API-first design to event-driven processing, discover how we deliver enterprise-grade reliability at scale.
Order Processing Pipeline
End-to-End Order Workflow
From prescription intake to patient delivery, every order flows through our automated processing pipeline with built-in quality gates and compliance checkpoints.
Order Intake
Multi-channel order ingestion via REST APIs, batch file imports, or direct portal entry with real-time validation.
- REST API endpoints
- CSV/batch processing
- Webhook integrations
- Portal entry
Patient & Order Creation
Master Patient Index management with automated patient matching, deduplication, and partner association.
- MPI management
- Duplicate detection
- Partner linking
- Demographics sync
Verification & Validation
Comprehensive prescription verification including provider credentials, controlled substance checks, and eligibility validation.
- Prescription verification
- Compliance checks
- Insurance eligibility
- Provider validation
Quality Checks
Automated quality gates including drug interaction screening, therapeutic duplication checks, and dosage verification.
- Drug interactions
- Therapeutic review
- Dosage validation
- Allergy screening
Fulfillment
Automated dispensing with barcode verification, inventory allocation, and batch assembly for optimized shipping.
- Automated dispensing
- Inventory allocation
- Batch assembly
- Barcode verification
Shipment & Delivery
Multi-carrier shipping integration with real-time tracking, cold chain management, and delivery confirmation.
- Multi-carrier support
- Real-time tracking
- Cold chain logistics
- Delivery notifications
Processing Pipeline
Order Lifecycle Architecture
Every prescription flows through our automated processing pipeline with multiple validation checkpoints ensuring accuracy, compliance, and timely delivery.
Technical Capabilities
Built for Enterprise Scale
Modern architecture designed for high availability, security, and seamless integration with your existing systems.
API Architecture
RESTful Endpoints
Standard REST APIs with OpenAPI documentation for seamless integration
Webhook Events
Real-time event notifications for order status changes
Batch Processing
High-throughput async processing via message queues
Event-Driven Architecture
Event Bus
Central event bus for decoupled microservices communication
Message Queues
Reliable async task processing with automatic retries
Real-time Updates
Instant status propagation across all systems
Audit Trail
Complete event history for compliance and debugging
Data & Security
HIPAA Compliant
End-to-end encryption and access controls for PHI protection
Data Isolation
Partner-level data segregation with role-based access
Audit Logging
Comprehensive logging for regulatory compliance
Integrations
Connect Your Systems
Our API-first architecture enables seamless integration with telehealth platforms, EMR systems, shipping carriers, and insurance networks. Real-time webhooks keep your systems synchronized.
Telehealth Platforms
Direct integration with virtual care providers
Shipping Carriers
UPS, USPS, FedEx with real-time tracking
// POST /v1/prescriptions/transmitEScript
{
"externalPatientId": "patient-123",
"referenceId": "order-456",
"partnerAccount": "partner-abc",
"fulfillmentDetails": {
"shippingAddress": {
"addressLine1": "123 Main St",
"addressCity": "Dallas",
"addressState": "TX",
"addressZip": "75201"
},
"shippingOption": "priority"
},
"prescriptions": [{
"rxReferenceId": "RX-789",
"quantity": 30,
"totalRefills": 2,
"directions": "Take once daily",
"prescribedBy": {
"npi": "1234567890",
"firstName": "Jane",
"lastName": "Smith"
}
}]
}Ready to Integrate?
Our technical team is ready to help you evaluate PerfectRx for your platform. Get API documentation, sandbox access, and integration support.