RX Universe Integration

RX Universe Integration - Quick Setup Guide

Table of Contents

1. Overview
2. Initial Setup
3. Product Configuration
4. Submitting Orders
5. Troubleshooting
6. Quick Reference

Overview

Submit optical lab orders directly to RX Universe manufacturing system with automated validation and error checking.

Features

• One-click order submission
• Real-time validation
• Automatic code discovery
• Remake order handling
• Multi-product support (lenses, treatments, frames, accessories)

Initial Setup

1. RX Universe Lab Settings (Global)

Path: Settings → Integration → RX Universe Lab Settings   

Configure the following fields:

. Vendor Setup

Path: Accounting  → Vendors > Vendors   

• Find Transmission Method Field
• Set Transmission Method = RX Universe    
• Then Find the Vendor Account Number Tab inside that , Just Select the Location and add the Rx Universer Customer Lab ID .
• Save the Record

Example Values:

• FS     - Test account
• SA     - Test account
• TC    , EG    , PP    , CH    , GC     - Other test accounts

Product Configuration

A. Lens Products

Path: Inventory → Products → Lenses → Lab Mapping Tab    

Code Discovery: Click "Fetch Available Materials" or "Fetch Available Styles"

B. Treatment Products

Path: Inventory → Products → Lens Treatment → Lab Mapping Tab    

Note: Products with category type lens_treatment     and RX Treatment Code will be sent in addons     array.

C. Frame Types

Path: Inventory → Configuration → Frame Types → [Type] → Lab Mapping Tab    

D. Miscellaneous Products

Path: Inventory → Products → Miscellaneous → Lab Mapping Tab    

• Field: UPC / SKU Code
• Example: 123456789012     or CLEAN-KIT-001    
• Max length: 20 characters
• Used for: Products with category type miscellaneous    
• Sent as: miscItems     array with desc + SKU

E. Remake Reasons

Path: Sales → Configuration → Remake Reasons → [Reason] → Lab Mapping Tab    

Note: If order is remake order then , the code is sent in addons     array.

Submitting Orders

Path: Sales → sales → Open or Create New Order   

To submit an order to RX Universe, you need to create a sale order, fill in all required information, and select the RX Universe lab supplier.

After click on the Send Button, before the Supplier

• If the data is incorrect, misconfigured, or missing, a validation error will occur.
• Review and correct the data properly.
• Submit the data again after making corrections.
• If the submission is successful, you will receive a notification like this.

After then just move to the Transmission Settings tab and move to the Rx universe Section Here you can find all the  Information About the Rx Universe .

Here update status and cancel order button is also avaiable , using that you can check the latest status of the order and also cancel that order.

Required Data:

Troubleshooting

Common Errors & Solutions

Configuration Checklist

Before First Submission:

Global Settings:

• Settings → Integration → RX Universe Lab Settings configured
  • Protocol: HTTP
  • Host/IP: 131.100.38.99
  • Port: 4567

Company Settings:

• Settings → Companies → Customer Number configured (e.g., FS, SA)

Test:

• Connection test successful (Fetch Materials works)

Products:

• Lens products have style + material codes
• Treatment products have treatment codes
• Frame types have frame codes
• Misc products have UPC/SKU codes
• Remake reasons have remake codes

Vendor:

• RX Universe vendor has transmission method set

Quick Diagnostics

Connection Test:

Product → Lab Mapping → Click "Fetch Materials"
Shows codes = Working
Error = Check Integration Settings

Settings Verification:

Settings → Integration → RX Universe Lab Settings
Protocol: HTTP
Host/IP: 131.100.38.99
Port: 4567

Settings → Companies → [Company]
Customer Number: FS

Quick Reference

Configuration Locations

API Endpoints

Payload Arrays

Example:

{
  "remarks": ["Patient needs rush delivery"],
  "addons": ["AR", "UV", "WRONG_RX"],
  "miscItems": [{"desc": "Cleaning Kit", "sku": "123456789012"}]
}

Field Limits

Test Accounts

SA    , FS    , TC    , EG    , PP    , CH    , GC    

Available Codes (March 2026)

Materials: P     (Plastic CR39), T     (Transition)

Styles: SV     (Single Vision) - Use Fetch buttons for complete list

Treatments: AR    , UV    , HC    , BLF    , SR     (examples)

Frame Types: FULL    , SEMI    , RIMLESS     (examples)