Transaction Builder API¶

from typing import Dict, Any

from rezen import RezenClient

client: RezenClient = RezenClient()
transaction_id: str = "your-transaction-id-here"

price_date_data: Dict[str, Any] = {
    "salePrice": {  # Use camelCase and object structure
        "amount": 750000,
        "currency": "USD"
    },
    "earnestMoney": 15000,  # Use camelCase
    "downPayment": 150000,  # Use camelCase
    "loanAmount": 600000,  # Use camelCase
    "contractDate": "2024-02-01",  # Use camelCase
    "closingDate": "2024-03-15",  # Use camelCase
    "inspectionDate": "2024-02-10",  # Use camelCase
    "appraisalDate": "2024-02-20"  # Use camelCase
}

client.transaction_builder.update_price_and_date_info(
    transaction_id,
    price_date_data
)

from typing import Dict, Any

from rezen import RezenClient

client: RezenClient = RezenClient()
transaction_id: str = "your-transaction-id-here"

title_data: Dict[str, Any] = {
    "company": "Premier Title Co",  # Use 'company' not 'title_company'
    "firstName": "Sarah",  # Use camelCase
    "lastName": "Johnson",  # Use camelCase
    "phoneNumber": "+1-555-789-0123",  # Use camelCase
    "email": "sarah@premiertitle.com",
    "address": "789 Title Lane, Title City, TC 54321",
    "policyNumber": "PT-2024-001234"  # Use camelCase
}

# Using either method works the same
client.transaction_builder.update_title_info(transaction_id, title_data)
# or
client.transaction_builder.update_real_title(transaction_id, title_data)

from typing import Dict, Any

from rezen import RezenClient

client: RezenClient = RezenClient()
transaction_id: str = "your-transaction-id-here"

payer_data: Dict[str, Any] = {
    "payerType": "SELLER",  # Use camelCase
    "commissionRate": 6.0,  # 6% commission, use camelCase
    "flatFee": False  # Percentage-based, not flat fee, use camelCase
}

# Using either method works the same
client.transaction_builder.add_commission_payer(transaction_id, payer_data)
# or
client.transaction_builder.update_commission_payer(transaction_id, payer_data)

from rezen import RezenClient

client = RezenClient()
transaction_id = "your-transaction-id"

# These method pairs do the same thing:

# Add buyer
client.transaction_builder.add_buyer(transaction_id, buyer_data)
client.transaction_builder.put_buyer_to_draft(transaction_id, buyer_data)

# Add seller
client.transaction_builder.add_seller(transaction_id, seller_data)
client.transaction_builder.put_seller_to_draft(transaction_id, seller_data)

# Update location
client.transaction_builder.update_location_info(transaction_id, location_data)
client.transaction_builder.put_location_to_draft(transaction_id, location_data)

# Update price and date
client.transaction_builder.update_price_and_date_info(transaction_id, price_data)
client.transaction_builder.put_price_and_date_to_draft(transaction_id, price_data)

from rezen.exceptions import InvalidFieldNameError

try:
    # Using wrong field name
    location_data = {
        "address": "123 Main St",  # ❌ Wrong! Should be 'street'
        "city": "Salt Lake City",
        "state": "UTAH",
        "zipCode": "84101"  # ❌ Wrong! Should be 'zip'
    }
    client.transaction_builder.update_location_info(transaction_id, location_data)
except InvalidFieldNameError as e:
    print(f"Field name error: {e}")
    print(f"Use '{e.correct_name}' instead of '{e.field_name}'")

from rezen.exceptions import InvalidFieldValueError

try:
    # Wrong state format
    location_data = {
        "street": "123 Main St",
        "city": "Salt Lake City",
        "state": "utah",  # ❌ Wrong! Must be uppercase
        "zip": "84101"
    }
    client.transaction_builder.update_location_info(transaction_id, location_data)
except InvalidFieldValueError as e:
    print(f"Invalid value for '{e.field_name}': {e.value}")
    print(f"Expected: {e.expected_format}")

from rezen.exceptions import InvalidFieldValueError, ValidationError

try:
    price_data = {
        "dealType": "COMPENSATING",
        "propertyType": "RESIDENTIAL",
        "salePrice": 500000,  # ❌ Wrong! Must be object
        "representationType": "BUYERS_AGENT"  # ❌ Wrong! Should be 'BUYER'
    }
    client.transaction_builder.update_price_and_date_info(transaction_id, price_data)
except InvalidFieldValueError as e:
    # Catches: "Invalid value for 'salePrice': 500000. 
    # Expected: Object with 'amount' and 'currency' fields"
    print(f"Error: {e}")
except ValidationError as e:
    # Catches missing required fields
    print(f"Validation error: {e}")

from rezen import RezenClient
from rezen.exceptions import RezenError
import logging

def create_complete_transaction():
    """Create a complete transaction with all participants and details."""

    try:
        client = RezenClient()

        # Step 1: Create transaction builder
        print("Creating transaction builder...")
        response = client.transaction_builder.create_transaction_builder()
        transaction_id = response['id']
        print(f"✅ Created transaction: {transaction_id}")

        # Step 2: Add buyer
        print("Adding buyer...")
        buyer_data = {
            "firstName": "John",  # Use camelCase
            "lastName": "Doe",  # Use camelCase
            "email": "john.doe@email.com",
            "phoneNumber": "+1-555-123-4567"  # Use camelCase
        }
        client.transaction_builder.add_buyer(transaction_id, buyer_data)
        print("✅ Added buyer")

        # Step 3: Add seller
        print("Adding seller...")
        seller_data = {
            "firstName": "Jane",  # Use camelCase
            "lastName": "Smith",  # Use camelCase
            "email": "jane.smith@email.com",
            "phoneNumber": "+1-555-987-6543"  # Use camelCase
        }
        client.transaction_builder.add_seller(transaction_id, seller_data)
        print("✅ Added seller")

        # Step 4: Add property location
        print("Setting property location...")
        location_data = {
            "street": "123 Dream House Lane",  # Use 'street' not 'address'
            "street2": "",
            "city": "Salt Lake City",
            "state": "UTAH",  # Must be UTAH (all caps)
            "zip": "84101",  # Use 'zip' not 'zipCode'
            "county": "Salt Lake",
            "unit": "",
            "yearBuilt": 2020,  # Use camelCase
            "mlsNumber": "MLS123456",  # Use camelCase
            "escrowNumber": ""
        }
        client.transaction_builder.update_location_info(transaction_id, location_data)
        print("✅ Set property location")

        # Step 5: Set pricing and dates
        print("Setting pricing and dates...")
        price_data = {
            "salePrice": {  # Use camelCase and object structure
                "amount": 850000,
                "currency": "USD"
            },
            "earnestMoney": 17000,  # Use camelCase
            "acceptanceDate": "2024-02-01",  # Use camelCase
            "closingDate": "2024-03-15"  # Use camelCase
        }
        client.transaction_builder.update_price_and_date_info(transaction_id, price_data)
        print("✅ Set pricing and dates")

        # Step 6: Add service providers
        print("Adding service providers...")
        inspector_data = {
            "type": "INSPECTOR",
            "firstName": "Mike",  # Use camelCase
            "lastName": "Inspector",  # Use camelCase
            "company": "Quality Inspections Inc",
            "phoneNumber": "+1-555-INSPECT",  # Use camelCase
            "email": "mike@qualityinspections.com"
        }
        client.transaction_builder.add_participant(transaction_id, inspector_data)
        print("✅ Added inspector")

        # Step 7: Submit transaction
        print("Submitting transaction...")
        submit_response = client.transaction_builder.submit_transaction(transaction_id)
        print("✅ Transaction submitted successfully!")

        return {
            "success": True,
            "transaction_id": transaction_id,
            "submit_response": submit_response
        }

    except RezenError as e:
        logging.error(f"ReZEN API error: {e}")
        return {
            "success": False,
            "error": str(e),
            "transaction_id": transaction_id if 'transaction_id' in locals() else None
        }
    except Exception as e:
        logging.error(f"Unexpected error: {e}")
        return {
            "success": False,
            "error": str(e)
        }

# Run the example
result = create_complete_transaction()
if result["success"]:
    print(f"🎉 Transaction {result['transaction_id']} created successfully!")
else:
    print(f"❌ Failed to create transaction: {result['error']}")