new-site/scripts/workers/services/form_499a_discontinuance.py

"""FCC Form 499-A Discontinuance Filing Handler.

For carriers who no longer provide telecommunications services and need
to close out their USAC 499-A filing obligations. Files a final 499-A
with zero revenue and requests discontinuance status from USAC.

This is typically for:
- Pure broadband resale ISPs who were incorrectly filing 499-A
- Carriers who have ceased operations
- Companies that were acquired and the FRN is being retired
"""
from __future__ import annotations

import logging
import os
from datetime import datetime

from .base_handler import BaseComplianceHandler

logger = logging.getLogger("workers.services.form_499a_discontinuance")


class Form499ADiscontinuanceHandler(BaseComplianceHandler):
    SERVICE_SLUG = "fcc-499a-discontinuance"
    SERVICE_NAME = "Form 499-A Discontinuance Filing"

    async def process(self, order_data: dict) -> dict | None:
        order_number = order_data.get("order_number", "")
        entity = order_data.get("entity", {})
        intake_data = order_data.get("intake_data", {})

        filer_id = intake_data.get("filer_id_499") or entity.get("filer_id_499", "")
        frn = intake_data.get("frn") or entity.get("frn", "")
        legal_name = entity.get("legal_name") or intake_data.get("entity_name", "")

        logger.info(
            "Form499ADiscontinuanceHandler: %s for %s (FRN: %s, Filer ID: %s)",
            order_number, legal_name, frn, filer_id,
        )

        discontinuance_reason = intake_data.get("discontinuance_reason", "Ceased providing telecommunications services")
        last_service_date = intake_data.get("last_service_date", "")

        # Create admin todo with discontinuance instructions
        # (USAC E-File discontinuance is a manual process — file zero-revenue 499-A
        #  then submit discontinuance request via USAC contact form)
        self._create_admin_todo(
            order_number,
            f"FILE 499-A DISCONTINUANCE for {legal_name}\n\n"
            f"FRN: {frn}\n"
            f"Filer ID: {filer_id}\n"
            f"Reason: {discontinuance_reason}\n"
            f"Last service date: {last_service_date or 'Not specified'}\n\n"
            f"Steps:\n"
            f"1. Log in to USAC E-File (https://forms.universalservice.org/)\n"
            f"2. File a final 499-A with $0 revenue for the current year\n"
            f"3. In the comments/notes section, state: "
            f"'This is a final filing. {legal_name} has discontinued all "
            f"telecommunications services as of {last_service_date or 'current date'}. "
            f"Please close this filer account.'\n"
            f"4. Contact USAC at (888) 641-8722 or usac@usac.org to confirm "
            f"discontinuance and request removal of future filing obligations\n"
            f"5. Confirm that CPNI, RMD, and other FCC filings are also discontinued\n\n"
            f"Client email: {entity.get('contact_email') or order_data.get('customer_email', '')}",
        )

        # Send confirmation to client
        self._send_confirmation(
            to=entity.get("contact_email") or order_data.get("customer_email", ""),
            entity_name=legal_name,
            order_number=order_number,
            filer_id=filer_id,
        )

        return {"status": "submitted_for_processing"}

    def _send_confirmation(
        self, to: str, entity_name: str, order_number: str, filer_id: str,
    ) -> None:
        if not to:
            return
        try:
            import smtplib
            from email.mime.multipart import MIMEMultipart
            from email.mime.text import MIMEText

            subject = f"Form 499-A Discontinuance Filed — {entity_name}"
            html = f"""
            <div style="font-family:Inter,sans-serif;max-width:600px;margin:0 auto;color:#1f2937">
              <div style="background:#1e3a5f;padding:16px 24px;border-radius:8px 8px 0 0">
                <h2 style="color:#fff;margin:0;font-size:16px">Form 499-A Discontinuance</h2>
              </div>
              <div style="padding:24px;border:1px solid #e5e7eb;border-top:none;border-radius:0 0 8px 8px">
                <p>We've received your request to discontinue the FCC Form 499-A filing
                obligation for <strong>{entity_name}</strong> (Filer ID: {filer_id}).</p>

                <p>We will:</p>
                <ol style="font-size:14px;color:#374151;padding-left:1.25rem">
                  <li>File a final Form 499-A with zero revenue</li>
                  <li>Request USAC to close your filer account</li>
                  <li>Confirm discontinuance of related obligations (CPNI, RMD)</li>
                </ol>

                <p>You'll receive a confirmation email once the discontinuance is processed
                by USAC. This typically takes 2-4 weeks.</p>

                <p style="font-size:13px;color:#6b7280;margin-top:1rem">
                  Order: {order_number}<br>
                  Questions? Reply to this email or contact
                  <a href="mailto:ops@performancewest.net">ops@performancewest.net</a>.
                </p>
              </div>
            </div>
            """
            msg = MIMEMultipart("alternative")
            msg["From"] = os.environ.get("SMTP_FROM", "Performance West <noreply@performancewest.net>")
            msg["To"] = to
            msg["Subject"] = subject
            msg.attach(MIMEText(html, "html"))

            with smtplib.SMTP(
                os.environ.get("SMTP_HOST", "co.carrierone.com"),
                int(os.environ.get("SMTP_PORT", "587")),
                timeout=30,
            ) as s:
                s.starttls()
                s.login(os.environ.get("SMTP_USER", ""), os.environ.get("SMTP_PASS", ""))
                s.send_message(msg)
        except Exception as exc:
            logger.warning("Discontinuance confirmation email failed: %s", exc)