Overview

Fact: the address row of a franchise unit changed in common.addresses. Same payload as Franchise Address CreatedFranchise Address CreatedEvent•v1.0.0A franchise unit received its address in CNA Nexus. The address block of the franchise snapshot plus the franchise id. P...Ownercna-platformSchemaMapView docs: the full address after the change (FranchiseAddressData) plus franchiseId, never a delta. See Franchise AddressFranchise AddressEntity•v1.0.0The address of a franchise unit - street, number, complement, neighborhood, postal code, IBGE city or foreign city and s...Ownercna-platformView docs.

When it is published. CNA NexusCNA NexusService•v1.0.0Franchise network back-office (franchises, economic groups, partners, contracts and amendments, document storage, AI doc...PublishesInviteUser, ContractActivationRequested +13SubscribesContractActivationRequested, AmendmentApplyRequested +4Ownercna-platformMapRepoView docs, always through manager.afterCommit(), whenever an existing address row of a franchise is updated: the updateAddress GraphQL mutation (updateFranchiseAddress), applyContractToFranchiseAggregate (a renewal, resale or re-activation projecting a ContractContractEntity•v1.0.0A franchise contract in CNA Nexus - opening, renewal or resale - uploaded as a document, analysed by AI, reviewed by a p...Ownercna-platformView docs onto the unit, see Contract Activation RequestedContract Activation RequestedEvent•v1.0.0A user saved a contract for activation. cna-nexus's activation consumer turns it ACTIVE and creates or updates the franc...Ownercna-platformSchemaMapView docs) and the amendment handler handleAddressChange (an ADDRESS Contract AmendmentContract AmendmentEntity•v1.0.0A supplementary document attached to a contract - attachment, addendum or rescission - carrying one change per contract ...Ownercna-platformView docs, see Amendment Apply RequestedAmendment Apply RequestedEvent•v1.0.0A user finished reviewing a contract amendment and asked for its changes to be applied. cna-nexus's amendment consumer e...Ownercna-platformSchemaMapView docs). The last two commits also emit Franchise UpdatedFranchise UpdatedEvent•v1.2.0A franchise unit changed in CNA Nexus - edited in one of the franchise screens, re-activated from a contract, or amended...Ownercna-platformSchemaMapView docs with the same address in payload.address; the consumer’s upsert is idempotent. refreshAddressLocation, the post-commit geocoding that rewrites only the coordinates, emits nothing of its own: the producer is registered after it, afterCommit callbacks run in order, and the producer re-reads the row, so the message carries the geocoded latitude and longitude. Through the mutation the coordinates are resolved before the write.

What the consumer does. CNA OneCNA OneService•v1.0.0Franchise operating system (franchises and employees, pricing, products and learning books, school operations). Publishe...PublishesGrantApplicationAccess, EmployeeCreated +6SubscribesInviteUser, FranchiseCreated +9Ownercna-platformMapRepoView docs (franchiseConsumer, group franchise-franchise-events, handler syncFranchiseAddress): the same as for FranchiseAddressCreated. It loads the franchise by franchiseId and, when the unit is not mirrored yet, logs a warning and drops the message (the unit has no CNPJ yet, see FranchiseAddressCreated); otherwise requires street, number, neighborhood, postalCode and an IBGE cityId known to cna-one, turns latitude and longitude into one PostGIS point when both are present and on the globe — a broken pair is logged and the address keeps no point — and updates the unit’s row in place. cityName, state, countryId, foreignCity and foreignState are ignored. Failures are logged and reported to Sentry, never rethrown.

Kafka

Payload schema

Same payload type as FranchiseAddressCreated (FranchiseAddressPayload).

Source of truth

import { FranchiseAddressPayload } from 'events/nexus/franchise/FranchiseAddressCreated';

export class FranchiseAddressUpdated extends Event<FranchiseAddressPayload> {
  static readonly owner = 'NEXUS';
  static readonly aggregateRoot = 'Franchise';
  static readonly routingKey = 'franchiseId';
  static readonly version = '1.0.0';
}

Known drift

Observed 2026-09-23.

• cna-nexus, the canonical repository, has no FranchiseAddressUpdated class and emits nothing from the address write paths yet. The class above is the target; this page is written against the pending cna-nexus pull request and the link goes here when it opens.
• cna-one api/app/events/nexus/franchise/FranchiseAddressUpdated.ts exists only on branch jl/feature/CWH-48874-consume-franchise-address-events (not merged into staging) and matches the class above: same fields, key and version.