ADF-XML Migration Guide

from xml.sax.saxutils import escape

def acp_to_adf(envelope: dict) -> str:
    lead = envelope.get("lead", {})
    c = lead.get("contact") or {}
    v = (lead.get("vehicle_interests") or [{}])[0]
    d = envelope.get("dealership", {})
    src = envelope.get("source", {})
    gen = envelope["acp"]["generated_at"]

    condition = v.get("condition", "new")
    status = "used" if condition == "certified" else condition

    def tag(name, val, **attrs):
        if not val: return ""
        a = " ".join(f'{k}="{escape(str(v))}"' for k, v in attrs.items())
        return f"<{name}{' ' + a if a else ''}>{escape(str(val))}</{name}>"

    return f"""<?xml version="1.0" encoding="UTF-8"?>
<?adf version="1.0"?>
<adf>
  <prospect status="new">
    <requestdate>{gen}</requestdate>
    <vehicle interest="buy" status="{status}">
      {tag("year", v.get("year"))}
      {tag("make", v.get("make"))}
      {tag("model", v.get("model"))}
      {tag("trim", v.get("trim"))}
      {tag("stock", v.get("stock_number"))}
      {tag("vin", v.get("vin"))}
    </vehicle>
    <customer>
      <contact>
        {tag("name", c.get("first_name"), part="first")}
        {tag("name", c.get("last_name"), part="last")}
        {tag("email", c.get("email"))}
        {tag("phone", c.get("phone"), type="voice")}
      </contact>
    </customer>
    <vendor>{tag("vendorname", d.get("name"))}</vendor>
    <provider>{tag("name", src.get("provider"))}</provider>
  </prospect>
</adf>"""

function acpToAdf(array $envelope): string
{
    $lead = $envelope['lead'] ?? [];
    $c = $lead['contact'] ?? [];
    $v = ($lead['vehicle_interests'] ?? [[]])[0] ?? [];
    $d = $envelope['dealership'] ?? [];
    $src = $envelope['source'] ?? [];
    $gen = $envelope['acp']['generated_at'];

    $status = ($v['condition'] ?? 'new') === 'certified'
        ? 'used'
        : ($v['condition'] ?? 'new');

    $e = fn($s) => htmlspecialchars($s ?? '', ENT_XML1);

    $tag = fn($name, $val, $attrs = '') =>
        $val ? "<{$name}{$attrs}>{$e($val)}</{$name}>" : '';

    return <<<XML
    <?xml version="1.0" encoding="UTF-8"?>
    <?adf version="1.0"?>
    <adf>
      <prospect status="new">
        <requestdate>{$gen}</requestdate>
        <vehicle interest="buy" status="{$status}">
          {$tag('year', $v['year'] ?? null)}
          {$tag('make', $v['make'] ?? null)}
          {$tag('model', $v['model'] ?? null)}
          {$tag('trim', $v['trim'] ?? null)}
          {$tag('stock', $v['stock_number'] ?? null)}
          {$tag('vin', $v['vin'] ?? null)}
        </vehicle>
        <customer><contact>
          {$tag('name', $c['first_name'] ?? null, ' part="first"')}
          {$tag('name', $c['last_name'] ?? null, ' part="last"')}
          {$tag('email', $c['email'] ?? null)}
          {$tag('phone', $c['phone'] ?? null, ' type="voice"')}
        </contact></customer>
        <vendor>{$tag('vendorname', $d['name'] ?? null)}</vendor>
        <provider>{$tag('name', $src['provider'] ?? null)}</provider>
      </prospect>
    </adf>
    XML;
}

import xml.etree.ElementTree as ET
import uuid
from datetime import datetime, timezone

def adf_to_acp(adf_xml: str) -> dict:
    root = ET.fromstring(adf_xml)
    prospect = root.find("prospect")
    customer = prospect.find(".//customer/contact")
    vehicle = prospect.find("vehicle")
    vendor = prospect.find("vendor")

    # Extract name parts
    names = {}
    if customer is not None:
        for n in customer.findall("name"):
            names[n.get("part", "")] = n.text

    now = datetime.now(timezone.utc).isoformat()
    rand = uuid.uuid4().hex[:8]
    req_date = prospect.findtext("requestdate", now)

    return {
        "acp": {
            "version": "1.0.0",
            "protocol": "acp",
            "generated_at": req_date,
            "envelope_id": f"acp_{int(datetime.now().timestamp())}_{rand}",
            "parent_envelope_id": None
        },
        # ... same structure as JS version
        # Populate source, dealership, lead, transaction,
        # conversation, events from parsed XML
    }

function adfToAcp(string $adfXml): array
{
    $xml = simplexml_load_string($adfXml);
    $prospect = $xml->prospect;
    $contact = $prospect->customer->contact;
    $vehicle = $prospect->vehicle;
    $vendor = $prospect->vendor;

    $names = [];
    foreach ($contact->name ?? [] as $n) {
        $names[(string) $n['part']] = (string) $n;
    }

    $now = gmdate('c');
    $rand = bin2hex(random_bytes(4));
    $reqDate = (string) ($prospect->requestdate ?? $now);

    return [
        'acp' => [
            'version' => '1.0.0',
            'protocol' => 'acp',
            'generated_at' => $reqDate,
            'envelope_id' => "acp_" . time() . "_{$rand}",
            'parent_envelope_id' => null,
        ],
        'source' => [
            'provider' => (string) ($prospect->provider->name ?? 'adf_import'),
            'agent_type' => 'sales_chat',
            'channel' => 'web_chat',
        ],
        'dealership' => [
            'id' => (string) ($vendor->id ?? "dealer_{$rand}"),
            'name' => (string) ($vendor->vendorname ?? 'Unknown'),
        ],
        'lead' => [
            'id' => "lead_adf_" . time(),
            'status' => 'new',
            'contact' => [
                'first_name' => $names['first'] ?? null,
                'last_name' => $names['last'] ?? null,
                'email' => (string) ($contact->email ?? null),
                'phone' => (string) ($contact->phone ?? null),
            ],
            'vehicle_interests' => $vehicle ? [[
                'year' => (int) $vehicle->year,
                'make' => (string) $vehicle->make,
                'model' => (string) $vehicle->model,
                'trim' => (string) ($vehicle->trim ?? null),
                'condition' => (string) ($vehicle['status'] ?? 'new'),
                'stock_number' => (string) ($vehicle->stock ?? null),
            ]] : [],
            'intents' => [],
            'score' => null,
        ],
        // transaction, conversation, events...
    ];
}