@lead-routing/cli 0.1.13 → 0.2.0

package/dist/prisma/migrations/20260308100000_route_match_config/migration.sql

@@ -0,0 +1,95 @@
+-- Migration: Route Match Config, Routing Branches, Default Owner
+-- Adds: RouteMatchConfig, RoutingBranch, BranchCondition models
+--       defaultOwner* fields on routing_rules
+--       LeadMatchAction, ContactMatchAction, AccountMatchAction enums
+--       MERGED value to RoutingStatus enum
+--       Makes assignmentType nullable on routing_rules
+
+-- 1. New enums
+CREATE TYPE "LeadMatchAction" AS ENUM ('SFDC_MERGE', 'ASSIGN_TO_OWNER', 'ASSIGN_CUSTOM');
+CREATE TYPE "ContactMatchAction" AS ENUM ('ASSIGN_TO_OWNER', 'ASSIGN_CUSTOM', 'SKIP');
+CREATE TYPE "AccountMatchAction" AS ENUM ('ASSIGN_TO_OWNER', 'ASSIGN_CUSTOM', 'SKIP');
+
+-- 2. Add MERGED to RoutingStatus enum
+ALTER TYPE "RoutingStatus" ADD VALUE 'MERGED';
+
+-- 3. Make assignmentType nullable on routing_rules
+ALTER TABLE "routing_rules" ALTER COLUMN "assignmentType" DROP NOT NULL;
+
+-- 4. Add defaultOwner* fields to routing_rules
+ALTER TABLE "routing_rules"
+  ADD COLUMN "defaultOwnerType" "AssignmentType",
+  ADD COLUMN "defaultOwnerUserId" TEXT,
+  ADD COLUMN "defaultOwnerTeamId" TEXT,
+  ADD COLUMN "defaultOwnerQueueId" TEXT;
+
+-- 5. Create routing_branches table
+CREATE TABLE "routing_branches" (
+  "id" TEXT NOT NULL,
+  "ruleId" TEXT NOT NULL,
+  "label" TEXT,
+  "priority" INTEGER NOT NULL DEFAULT 0,
+  "assignmentType" "AssignmentType" NOT NULL,
+  "assigneeUserId" TEXT,
+  "assigneeTeamId" TEXT,
+  "assigneeQueueId" TEXT,
+  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  "updatedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  CONSTRAINT "routing_branches_pkey" PRIMARY KEY ("id")
+);
+
+ALTER TABLE "routing_branches"
+  ADD CONSTRAINT "routing_branches_ruleId_fkey"
+  FOREIGN KEY ("ruleId") REFERENCES "routing_rules"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- 6. Create branch_conditions table
+CREATE TABLE "branch_conditions" (
+  "id" TEXT NOT NULL,
+  "branchId" TEXT NOT NULL,
+  "groupId" TEXT NOT NULL,
+  "fieldName" TEXT NOT NULL,
+  "operator" TEXT NOT NULL,
+  "value" TEXT,
+  "sortOrder" INTEGER NOT NULL DEFAULT 0,
+  CONSTRAINT "branch_conditions_pkey" PRIMARY KEY ("id")
+);
+
+ALTER TABLE "branch_conditions"
+  ADD CONSTRAINT "branch_conditions_branchId_fkey"
+  FOREIGN KEY ("branchId") REFERENCES "routing_branches"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- 7. Create route_match_configs table
+CREATE TABLE "route_match_configs" (
+  "id" TEXT NOT NULL,
+  "ruleId" TEXT NOT NULL,
+  "checkLeads" BOOLEAN NOT NULL DEFAULT true,
+  "checkContacts" BOOLEAN NOT NULL DEFAULT true,
+  "checkAccounts" BOOLEAN NOT NULL DEFAULT false,
+  "matchEmail" BOOLEAN NOT NULL DEFAULT true,
+  "matchPhone" BOOLEAN NOT NULL DEFAULT false,
+  "matchDomain" BOOLEAN NOT NULL DEFAULT false,
+  "onLeadMatch" "LeadMatchAction" NOT NULL DEFAULT 'SFDC_MERGE',
+  "leadAssignmentType" "AssignmentType",
+  "leadAssigneeUserId" TEXT,
+  "leadAssigneeTeamId" TEXT,
+  "leadAssigneeQueueId" TEXT,
+  "onContactMatch" "ContactMatchAction" NOT NULL DEFAULT 'ASSIGN_TO_OWNER',
+  "contactAssignmentType" "AssignmentType",
+  "contactAssigneeUserId" TEXT,
+  "contactAssigneeTeamId" TEXT,
+  "contactAssigneeQueueId" TEXT,
+  "onAccountMatch" "AccountMatchAction" NOT NULL DEFAULT 'ASSIGN_TO_OWNER',
+  "accountAssignmentType" "AssignmentType",
+  "accountAssigneeUserId" TEXT,
+  "accountAssigneeTeamId" TEXT,
+  "accountAssigneeQueueId" TEXT,
+  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  "updatedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  CONSTRAINT "route_match_configs_pkey" PRIMARY KEY ("id")
+);
+
+CREATE UNIQUE INDEX "route_match_configs_ruleId_key" ON "route_match_configs"("ruleId");
+
+ALTER TABLE "route_match_configs"
+  ADD CONSTRAINT "route_match_configs_ruleId_fkey"
+  FOREIGN KEY ("ruleId") REFERENCES "routing_rules"("id") ON DELETE CASCADE ON UPDATE CASCADE;

package/dist/prisma/migrations/20260309200000_add_path_label_to_routing_logs/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE "routing_logs" ADD COLUMN IF NOT EXISTS "pathLabel" TEXT;

package/dist/prisma/migrations/20260310000000_add_team_to_routing_log/migration.sql

@@ -0,0 +1,6 @@
+-- AlterTable
+ALTER TABLE "routing_logs" ADD COLUMN "teamId" TEXT;
+ALTER TABLE "routing_logs" ADD COLUMN "teamName" TEXT;
+
+-- CreateIndex
+CREATE INDEX "routing_logs_orgId_teamId_idx" ON "routing_logs"("orgId", "teamId");

package/dist/prisma/migrations/20260310100000_add_field_type_to_branch_conditions/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE "branch_conditions" ADD COLUMN "fieldType" TEXT NOT NULL DEFAULT 'TEXT';

package/dist/prisma/migrations/20260310200000_analytics_foundation/migration.sql

@@ -0,0 +1,84 @@
+-- Add analytics columns to routing_logs
+ALTER TABLE "routing_logs" ADD COLUMN "routingDurationMs" INTEGER;
+ALTER TABLE "routing_logs" ADD COLUMN "branchId" TEXT;
+
+-- AddForeignKey
+ALTER TABLE "routing_logs" ADD CONSTRAINT "routing_logs_branchId_fkey" FOREIGN KEY ("branchId") REFERENCES "routing_branches"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- CreateIndex
+CREATE INDEX "routing_logs_orgId_ruleId_idx" ON "routing_logs"("orgId", "ruleId");
+
+-- CreateTable: routing_daily_aggregates
+CREATE TABLE "routing_daily_aggregates" (
+    "id" TEXT NOT NULL,
+    "orgId" TEXT NOT NULL,
+    "date" DATE NOT NULL,
+    "ruleId" TEXT,
+    "pathLabel" TEXT,
+    "branchId" TEXT,
+    "teamId" TEXT,
+    "assigneeId" TEXT,
+    "objectType" "SfdcObjectType",
+    "successCount" INTEGER NOT NULL DEFAULT 0,
+    "failedCount" INTEGER NOT NULL DEFAULT 0,
+    "unmatchedCount" INTEGER NOT NULL DEFAULT 0,
+    "mergedCount" INTEGER NOT NULL DEFAULT 0,
+    "totalCount" INTEGER NOT NULL DEFAULT 0,
+    "avgDurationMs" DOUBLE PRECISION,
+    "minDurationMs" INTEGER,
+    "maxDurationMs" INTEGER,
+    "p50DurationMs" INTEGER,
+    "p95DurationMs" INTEGER,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "routing_daily_aggregates_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "routing_daily_aggregates_orgId_date_idx" ON "routing_daily_aggregates"("orgId", "date");
+
+-- CreateIndex (unique composite)
+CREATE UNIQUE INDEX "routing_daily_aggregates_orgId_date_ruleId_pathLabel_branch_key" ON "routing_daily_aggregates"("orgId", "date", "ruleId", "pathLabel", "branchId", "teamId", "assigneeId", "objectType");
+
+-- AddForeignKey
+ALTER TABLE "routing_daily_aggregates" ADD CONSTRAINT "routing_daily_aggregates_orgId_fkey" FOREIGN KEY ("orgId") REFERENCES "organizations"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- CreateTable: conversion_tracking
+CREATE TABLE "conversion_tracking" (
+    "id" TEXT NOT NULL,
+    "orgId" TEXT NOT NULL,
+    "routingLogId" TEXT NOT NULL,
+    "sfdcLeadId" TEXT NOT NULL,
+    "isConverted" BOOLEAN NOT NULL DEFAULT false,
+    "convertedAt" TIMESTAMP(3),
+    "opportunityId" TEXT,
+    "opportunityAmount" DOUBLE PRECISION,
+    "opportunityStageName" TEXT,
+    "ruleId" TEXT,
+    "ruleName" TEXT,
+    "pathLabel" TEXT,
+    "teamId" TEXT,
+    "assigneeId" TEXT,
+    "assigneeName" TEXT,
+    "lastCheckedAt" TIMESTAMP(3),
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "conversion_tracking_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "conversion_tracking_routingLogId_key" ON "conversion_tracking"("routingLogId");
+
+-- CreateIndex
+CREATE INDEX "conversion_tracking_orgId_isConverted_idx" ON "conversion_tracking"("orgId", "isConverted");
+
+-- CreateIndex
+CREATE INDEX "conversion_tracking_orgId_sfdcLeadId_idx" ON "conversion_tracking"("orgId", "sfdcLeadId");
+
+-- AddForeignKey
+ALTER TABLE "conversion_tracking" ADD CONSTRAINT "conversion_tracking_orgId_fkey" FOREIGN KEY ("orgId") REFERENCES "organizations"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "conversion_tracking" ADD CONSTRAINT "conversion_tracking_routingLogId_fkey" FOREIGN KEY ("routingLogId") REFERENCES "routing_logs"("id") ON DELETE CASCADE ON UPDATE CASCADE;

package/dist/prisma/schema.prisma

@@ -43,6 +43,25 @@ enum RoutingStatus {
   FAILED
   UNMATCHED
   RETRY
+  MERGED
+}
+
+enum LeadMatchAction {
+  SFDC_MERGE
+  ASSIGN_TO_OWNER
+  ASSIGN_CUSTOM
+}
+
+enum ContactMatchAction {
+  ASSIGN_TO_OWNER
+  ASSIGN_CUSTOM
+  SKIP
+}
+
+enum AccountMatchAction {
+  ASSIGN_TO_OWNER
+  ASSIGN_CUSTOM
+  SKIP
 }
 
 enum Plan {
@@ -79,7 +98,9 @@ model Organization {
   auditLogs    AuditLog[]
   sfdcQueues   SfdcQueue[]
   fieldSchemas FieldSchema[]
-  billingInfo  BillingInfo?
+  billingInfo             BillingInfo?
+  routingDailyAggregates  RoutingDailyAggregate[]
+  conversionTracking      ConversionTracking[]
 
   @@map("organizations")
 }
@@ -172,29 +193,112 @@ model TeamMember {
 }
 
 model RoutingRule {
-  id               String         @id @default(cuid())
+  id               String          @id @default(cuid())
   orgId            String
   objectType       SfdcObjectType
   triggerEvent     TriggerEvent
   name             String
   priority         Int
-  status           RuleStatus     @default(ACTIVE)
-  assignmentType   AssignmentType
-  assigneeUserId   String?        // references User.id (individual user)
-  assigneeTeamId   String?        // references RoundRobinTeam.id
-  assigneeQueueId  String?        // references SfdcQueue.id
-  isDryRun         Boolean        @default(false)
-  createdAt        DateTime       @default(now())
-  updatedAt        DateTime       @updatedAt
-
-  org        Organization    @relation(fields: [orgId], references: [id], onDelete: Cascade)
-  team       RoundRobinTeam? @relation("TeamRules", fields: [assigneeTeamId], references: [id])
-  queue      SfdcQueue?      @relation(fields: [assigneeQueueId], references: [id])
-  conditions RuleCondition[]
+  status           RuleStatus      @default(ACTIVE)
+  // Legacy single-assignee fields (used by old rules; null for new Route Builder rules)
+  assignmentType   AssignmentType?
+  assigneeUserId   String?         // references User.id (individual user)
+  assigneeTeamId   String?         // references RoundRobinTeam.id
+  assigneeQueueId  String?         // references SfdcQueue.id
+  isDryRun         Boolean         @default(false)
+  // Default owner: absolute catch-all for new Route Builder routes
+  defaultOwnerType     AssignmentType?
+  defaultOwnerUserId   String?
+  defaultOwnerTeamId   String?
+  defaultOwnerQueueId  String?
+  createdAt        DateTime        @default(now())
+  updatedAt        DateTime        @updatedAt
+
+  org        Organization     @relation(fields: [orgId], references: [id], onDelete: Cascade)
+  team       RoundRobinTeam?  @relation("TeamRules", fields: [assigneeTeamId], references: [id])
+  queue      SfdcQueue?       @relation(fields: [assigneeQueueId], references: [id])
+  conditions RuleCondition[]  // legacy conditions (old-style rules)
+  branches   RoutingBranch[]  // new Route Builder paths
+  matchConfig RouteMatchConfig?
 
   @@map("routing_rules")
 }
 
+model RoutingBranch {
+  id              String         @id @default(cuid())
+  ruleId          String
+  rule            RoutingRule    @relation(fields: [ruleId], references: [id], onDelete: Cascade)
+  label           String?
+  priority        Int            @default(0)
+  assignmentType  AssignmentType
+  assigneeUserId  String?
+  assigneeTeamId  String?
+  assigneeQueueId String?
+  createdAt       DateTime       @default(now())
+  updatedAt       DateTime       @updatedAt
+
+  conditions  BranchCondition[]
+  routingLogs RoutingLog[]
+
+  @@map("routing_branches")
+}
+
+model BranchCondition {
+  id        String        @id @default(cuid())
+  branchId  String
+  branch    RoutingBranch @relation(fields: [branchId], references: [id], onDelete: Cascade)
+  groupId   String
+  fieldName String
+  fieldType String        @default("TEXT")
+  operator  String
+  value     String?
+  sortOrder Int           @default(0)
+
+  @@map("branch_conditions")
+}
+
+model RouteMatchConfig {
+  id              String      @id @default(cuid())
+  ruleId          String      @unique
+  rule            RoutingRule @relation(fields: [ruleId], references: [id], onDelete: Cascade)
+
+  // Which objects to check
+  checkLeads      Boolean     @default(true)
+  checkContacts   Boolean     @default(true)
+  checkAccounts   Boolean     @default(false)
+
+  // Which fields to match on
+  matchEmail      Boolean     @default(true)
+  matchPhone      Boolean     @default(false)
+  matchDomain     Boolean     @default(false)
+
+  // Lead match outcome
+  onLeadMatch           LeadMatchAction    @default(SFDC_MERGE)
+  leadAssignmentType    AssignmentType?
+  leadAssigneeUserId    String?
+  leadAssigneeTeamId    String?
+  leadAssigneeQueueId   String?
+
+  // Contact match outcome
+  onContactMatch        ContactMatchAction @default(ASSIGN_TO_OWNER)
+  contactAssignmentType AssignmentType?
+  contactAssigneeUserId  String?
+  contactAssigneeTeamId  String?
+  contactAssigneeQueueId String?
+
+  // Account match outcome
+  onAccountMatch        AccountMatchAction @default(ASSIGN_TO_OWNER)
+  accountAssignmentType AssignmentType?
+  accountAssigneeUserId  String?
+  accountAssigneeTeamId  String?
+  accountAssigneeQueueId String?
+
+  createdAt       DateTime    @default(now())
+  updatedAt       DateTime    @updatedAt
+
+  @@map("route_match_configs")
+}
+
 model RuleCondition {
   id          String @id @default(cuid())
   ruleId      String
@@ -217,6 +321,7 @@ model RoutingLog {
   eventType      TriggerEvent
   ruleId         String?
   ruleName       String?
+  pathLabel      String?  // which branch/path triggered: e.g. "Path A" or "Default Owner"
   assigneeId     String?  // SFDC user/queue ID
   assigneeName   String?
   assignmentType AssignmentType?
@@ -226,12 +331,20 @@ model RoutingLog {
   retryCount      Int             @default(0)
   dismissed       Boolean         @default(false)
   recordSnapshot  Json?           // full field payload from SFDC at time of routing
-  createdAt       DateTime        @default(now())
+  teamId             String?
+  teamName           String?
+  routingDurationMs  Int?              // ms from webhook receipt → SFDC assignment
+  branchId           String?           // FK → RoutingBranch for path-level analytics
+  createdAt          DateTime        @default(now())
 
-  org Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
+  org                Organization    @relation(fields: [orgId], references: [id], onDelete: Cascade)
+  branch             RoutingBranch?  @relation(fields: [branchId], references: [id])
+  conversionTracking ConversionTracking?
 
   @@index([orgId, createdAt])
   @@index([orgId, status])
+  @@index([orgId, teamId])
+  @@index([orgId, ruleId])
   @@map("routing_logs")
 }
 
@@ -313,3 +426,61 @@ model Session {
   @@index([orgId])
   @@map("sessions")
 }
+
+model RoutingDailyAggregate {
+  id             String          @id @default(cuid())
+  orgId          String
+  date           DateTime        @db.Date
+  ruleId         String?
+  pathLabel      String?
+  branchId       String?
+  teamId         String?
+  assigneeId     String?
+  objectType     SfdcObjectType?
+  successCount   Int             @default(0)
+  failedCount    Int             @default(0)
+  unmatchedCount Int             @default(0)
+  mergedCount    Int             @default(0)
+  totalCount     Int             @default(0)
+  avgDurationMs  Float?
+  minDurationMs  Int?
+  maxDurationMs  Int?
+  p50DurationMs  Int?
+  p95DurationMs  Int?
+  createdAt      DateTime        @default(now())
+  updatedAt      DateTime        @updatedAt
+
+  org Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
+
+  @@unique([orgId, date, ruleId, pathLabel, branchId, teamId, assigneeId, objectType])
+  @@index([orgId, date])
+  @@map("routing_daily_aggregates")
+}
+
+model ConversionTracking {
+  id                   String    @id @default(cuid())
+  orgId                String
+  routingLogId         String    @unique
+  sfdcLeadId           String
+  isConverted          Boolean   @default(false)
+  convertedAt          DateTime?
+  opportunityId        String?
+  opportunityAmount    Float?
+  opportunityStageName String?
+  ruleId               String?
+  ruleName             String?
+  pathLabel            String?
+  teamId               String?
+  assigneeId           String?
+  assigneeName         String?
+  lastCheckedAt        DateTime?
+  createdAt            DateTime  @default(now())
+  updatedAt            DateTime  @updatedAt
+
+  org        Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
+  routingLog RoutingLog   @relation(fields: [routingLogId], references: [id], onDelete: Cascade)
+
+  @@index([orgId, isConverted])
+  @@index([orgId, sfdcLeadId])
+  @@map("conversion_tracking")
+}

package/dist/sfdc-package/force-app/main/default/classes/AccountTriggerTest.cls

@@ -55,4 +55,30 @@ class AccountTriggerTest {
         System.assertEquals(String.valueOf(a.Id), parsed.get('recordId'));
         System.assertNotEquals(null, parsed.get('fields'));
     }
+
+    @isTest
+    static void testPayloadBuilderBuildBatch() {
+        // Unit-test the batch payload builder
+        List<Account> accts = new List<Account>();
+        accts.add(new Account(Name = 'Batch A'));
+        accts.add(new Account(Name = 'Batch B'));
+        insert accts;
+        accts = [SELECT Id, Name FROM Account WHERE Id IN :accts];
+
+        String payload = RoutingPayloadBuilder.buildBatch('Account', 'INSERT', accts);
+        Map<String, Object> parsed = (Map<String, Object>) JSON.deserializeUntyped(payload);
+
+        System.assertEquals('ACCOUNT', parsed.get('objectType'));
+        System.assertEquals('INSERT', parsed.get('eventType'));
+        System.assertNotEquals(null, parsed.get('sfdcOrgId'));
+
+        List<Object> records = (List<Object>) parsed.get('records');
+        System.assertEquals(2, records.size(), 'Expected 2 records in batch');
+
+        for (Object r : records) {
+            Map<String, Object> rec = (Map<String, Object>) r;
+            System.assertNotEquals(null, rec.get('recordId'));
+            System.assertNotEquals(null, rec.get('fields'));
+        }
+    }
 }

package/dist/sfdc-package/force-app/main/default/classes/LeadTriggerTest.cls

@@ -92,4 +92,53 @@ class LeadTriggerTest {
         Routing_Error_Log__c errLog = [SELECT Status_Code__c FROM Routing_Error_Log__c LIMIT 1];
         System.assertEquals(500, (Integer) errLog.Status_Code__c);
     }
+
+    @isTest
+    static void testBatchPayloadFormat() {
+        // Verify RoutingPayloadBuilder.buildBatch produces correct schema
+        Lead l = new Lead(FirstName = 'Batch', LastName = 'Test', Company = 'BatchCo');
+        insert l;
+        l = [SELECT Id, FirstName, LastName, Company FROM Lead WHERE Id = :l.Id];
+
+        String payload = RoutingPayloadBuilder.buildBatch('Lead', 'INSERT', new List<Lead>{ l });
+        Map<String, Object> parsed = (Map<String, Object>) JSON.deserializeUntyped(payload);
+
+        System.assertEquals('LEAD', parsed.get('objectType'));
+        System.assertEquals('INSERT', parsed.get('eventType'));
+        System.assertNotEquals(null, parsed.get('sfdcOrgId'));
+        System.assertNotEquals(null, parsed.get('timestamp'));
+
+        List<Object> records = (List<Object>) parsed.get('records');
+        System.assertEquals(1, records.size(), 'Expected 1 record in batch');
+
+        Map<String, Object> rec = (Map<String, Object>) records[0];
+        System.assertEquals(String.valueOf(l.Id), rec.get('recordId'));
+        System.assertNotEquals(null, rec.get('fields'));
+    }
+
+    @isTest
+    static void testBulkInsertUsesBatchEndpoint() {
+        // Verify that inserting multiple leads sends to /route/batch
+        Routing_Settings__c settings = Routing_Settings__c.getOrgDefaults();
+        settings.Engine_Endpoint__c = 'https://engine.example.com';
+        upsert settings;
+
+        RoutingEngineMock mock = new RoutingEngineMock();
+        Test.setMock(HttpCalloutMock.class, mock);
+
+        Test.startTest();
+        List<Lead> leads = new List<Lead>();
+        for (Integer i = 0; i < 5; i++) {
+            leads.add(new Lead(
+                FirstName = 'Bulk' + i,
+                LastName  = 'Test' + i,
+                Company   = 'BulkCo'
+            ));
+        }
+        insert leads;
+        Test.stopTest();
+
+        System.assertEquals(0, [SELECT COUNT() FROM Routing_Error_Log__c],
+            'Expected no error logs for batch callout');
+    }
 }

package/dist/sfdc-package/force-app/main/default/classes/RoutingEngineCallout.cls

@@ -23,10 +23,9 @@ public with sharing class RoutingEngineCallout {
 
         List<SObject> records = queryRecords(objectType, recordIds);
 
-        for (SObject record : records) {
-            String payload = RoutingPayloadBuilder.build(objectType, eventType, record);
-            sendPayload(payload, secret, engineEndpoint);
-        }
+        // Send all records in a single batch HTTP call to /route/batch
+        String batchPayload = RoutingPayloadBuilder.buildBatch(objectType, eventType, records);
+        sendBatchPayload(batchPayload, secret, engineEndpoint);
     }
 
     // ─── Private helpers ───────────────────────────────────────────────────────
@@ -44,6 +43,34 @@ public with sharing class RoutingEngineCallout {
         return Database.query(soql);
     }
 
+    private static void sendBatchPayload(String payload, String secret, String engineEndpoint) {
+        String signature = hmacSha256(payload, secret);
+
+        HttpRequest req = new HttpRequest();
+        req.setEndpoint(engineEndpoint.removeEnd('/') + '/route/batch');
+        req.setMethod('POST');
+        req.setHeader('Content-Type', 'application/json');
+        req.setHeader('X-Sfdc-Org-Id', UserInfo.getOrganizationId());
+        req.setHeader('X-Signature-256', 'sha256=' + signature);
+        req.setBody(payload);
+        req.setTimeout(30000); // 30s for batch
+
+        Http http = new Http();
+        HttpResponse res;
+
+        try {
+            res = http.send(req);
+        } catch (Exception e) {
+            logError(payload, 0, 'Batch callout exception: ' + e.getMessage());
+            return;
+        }
+
+        if (res.getStatusCode() != 200 && res.getStatusCode() != 202) {
+            logError(payload, res.getStatusCode(), res.getBody());
+        }
+    }
+
+    // Kept for backward compatibility (single-record POST to /route)
     private static void sendPayload(String payload, String secret, String engineEndpoint) {
         String signature = hmacSha256(payload, secret);
 

package/dist/sfdc-package/force-app/main/default/classes/RoutingEngineMock.cls

@@ -8,9 +8,13 @@ global class RoutingEngineMock implements HttpCalloutMock {
     private Integer statusCode;
     private String responseBody;
 
+    // Captured from last request for test assertions
+    global String lastEndpoint { get; private set; }
+    global String lastBody { get; private set; }
+
     global RoutingEngineMock() {
-        this.statusCode = 200;
-        this.responseBody = '{"ok":true}';
+        this.statusCode = 202;
+        this.responseBody = '{"accepted":1,"duplicates":0}';
     }
 
     global RoutingEngineMock(Integer statusCode, String responseBody) {
@@ -19,6 +23,9 @@ global class RoutingEngineMock implements HttpCalloutMock {
     }
 
     global HTTPResponse respond(HTTPRequest req) {
+        lastEndpoint = req.getEndpoint();
+        lastBody = req.getBody();
+
         HttpResponse res = new HttpResponse();
         res.setStatusCode(this.statusCode);
         res.setHeader('Content-Type', 'application/json');

package/dist/sfdc-package/force-app/main/default/classes/RoutingPayloadBuilder.cls

@@ -27,6 +27,42 @@ public with sharing class RoutingPayloadBuilder {
         return JSON.serialize(payload);
     }
 
+    /**
+     * Serialises a batch of SObject records into the JSON payload format
+     * expected by the engine's POST /route/batch endpoint.
+     *
+     * Schema:
+     * {
+     *   "objectType": "LEAD",
+     *   "eventType":  "INSERT",
+     *   "sfdcOrgId":  "00D000000000001EAA",
+     *   "timestamp":  "2026-02-23T10:32:00Z",
+     *   "records": [
+     *     { "recordId": "00Q...", "fields": { ... } },
+     *     ...
+     *   ]
+     * }
+     */
+    public static String buildBatch(String objectType, String eventType, List<SObject> records) {
+        List<Map<String, Object>> recordList = new List<Map<String, Object>>();
+        for (SObject record : records) {
+            recordList.add(new Map<String, Object>{
+                'recordId' => String.valueOf(record.get('Id')),
+                'fields'   => extractFields(record)
+            });
+        }
+
+        Map<String, Object> payload = new Map<String, Object>{
+            'objectType' => objectType.toUpperCase(),
+            'eventType'  => eventType.toUpperCase(),
+            'sfdcOrgId'  => UserInfo.getOrganizationId(),
+            'timestamp'  => Datetime.now().formatGmt('yyyy-MM-dd\'T\'HH:mm:ss\'Z\''),
+            'records'    => recordList
+        };
+
+        return JSON.serialize(payload);
+    }
+
     // ─── Private ───────────────────────────────────────────────────────────────
 
     private static Map<String, Object> extractFields(SObject record) {