Status de balconistaClerk statusEstado de dependiente

Status de balconista é a transação de saída que registra a ativação ou inativação de um balconista do Conecta Você. É orquestrada pelo StaffOrchestrator, disparada tanto sozinha (setClerkStatus) quanto como segunda perna logo após o cadastro (saveClerk → _sendClerkStatus). Uma única variante, um único serviceName, sem prefixo Promo_. Clerk status is the outbound transaction that records the activation or deactivation of a Conecta Você clerk. It's orchestrated by StaffOrchestrator, fired both on its own (setClerkStatus) and as the second leg right after the upload (saveClerk → _sendClerkStatus). A single variant, a single serviceName, no Promo_ prefix. Estado de dependiente es la transacción de salida que registra la activación o inactivación de un dependiente de Conecta Você. La orquesta el StaffOrchestrator, disparada tanto sola (setClerkStatus) como segunda pierna justo después del alta (saveClerk → _sendClerkStatus). Una única variante, un único serviceName, sin prefijo Promo_.

DispatcherConectaRep.proto · proto3 · package mn.bat.conectarep.dispatcher. O serviço expõe um único RPC genérico — não existe mensagem por transação. TODA transação de escrita do app usa este mesmo sendTransaction; o que muda é o serviceName (discriminador) e o JSON dentro de message.The service exposes a single generic RPC — there's no per-transaction message. EVERY write transaction in the app uses this same sendTransaction; what changes is the serviceName (discriminator) and the JSON inside message.El servicio expone un único RPC genérico — no existe mensaje por transacción. TODA transacción de escritura de la app usa este mismo sendTransaction; lo que cambia es el serviceName (discriminador) y el JSON dentro de message.

Esta transação não está no conjunto leve — resendMayDuplicate == true: um reenvío (ex.: recuperação de fila offline) pode reaplicar o status no backend; a idempotência via tid é o que mitiga isso.This transaction is not in the lightweight set — resendMayDuplicate == true: a resend (e.g. offline-queue recovery) may re-apply the status on the backend; idempotency via tid is what mitigates it.Esta transacción no está en el conjunto liviano — resendMayDuplicate == true: un reenvío (p. ej. recuperación de cola offline) puede reaplicar el estado en el backend; la idempotencia vía tid es lo que lo mitiga.

A transação é orquestrada pelo StaffOrchestrator (remote-first, §36). O notifier apenas reúne a entity crua e o enum de ação; o builder é o dono único da limpeza do taxId, da formatação de data e da montagem wire. A cascata:The transaction is orchestrated by StaffOrchestrator (remote-first, §36). The notifier only gathers the raw entity and the action enum; the builder is the sole owner of the taxId cleanup, date formatting and wire assembly. The cascade:La transacción la orquesta el StaffOrchestrator (remote-first, §36). El notifier solo reúne la entity cruda y el enum de acción; el builder es el dueño único de la limpieza del taxId, el formateo de fecha y el armado wire. La cascada:

• StaffDetailsNotifiersetClerkStatus / saveClerk
  • reúne clerk + action + submittedAtgathers clerk + action + submittedAtreúne clerk + action + submittedAtStaffOrchestrator._sendClerkStatus
    • ClerkConectaVoceStatusDispatcherPayloadInputBuildClerkConectaVoceStatusDispatcherPayloadUseCasemonta o wireassembles the wirearma el wire
      • devolvereturnsdevuelveDispatcherEnvelope
        • SubmitClerkConectaVoceStatusUseCaseDispatcherRepository
          • serializa + authserialize + authserializa + authDispatcherGateway
            • sendTransactionBackendgRPC

O input (entities cruas)The input (raw entities)El input (entities crudas)

ClerkConectaVoceStatusDispatcherPayloadInput (Freezed). Carrega o dado como existe no domínio; nada de formato wire. O relógio chega como submittedAt (via DateTimeUtils.now() no orchestrator).ClerkConectaVoceStatusDispatcherPayloadInput (Freezed). Carries data as it exists in the domain; no wire shaping. The clock arrives as submittedAt (via DateTimeUtils.now() in the orchestrator).ClerkConectaVoceStatusDispatcherPayloadInput (Freezed). Lleva el dato como existe en el dominio; nada de formato wire. El reloj llega como submittedAt (vía DateTimeUtils.now() en el orchestrator).

O JSON serializado no campo message do request. A tabela tem 4 colunas — Campo JSON · Tipo · Origem do Dado · Regra — e lista todas as 6 chaves que o build() emite. Campo, Tipo e Origem são código cru; só a Regra é prosa. Um exemplo completo está em transaction_example.json, ao lado deste doc.The JSON serialized into the request's message field. The table has 4 columns — JSON field · Type · Data source · Rule — and lists all 6 keys that build() emits. Field, Type and Source are raw code; only Rule is prose. A full example sits in transaction_example.json, next to this doc.El JSON serializado en el campo message del request. La tabla tiene 4 columnas — Campo JSON · Tipo · Origen del Dato · Regla — y lista las 6 claves que build() emite. Campo, Tipo y Origen son código crudo; solo la Regla es prosa. Un ejemplo completo está en transaction_example.json, junto a este doc.

Todas as chaves são planas (sem arrays nem sub-objetos). O taxId limpo — clerk.taxId com . e - removidos, null → "" — preenche id, accountCode e user com o mesmo valor.All keys are flat (no arrays or sub-objects). The stripped taxId — clerk.taxId with . and - removed, null → "" — fills id, accountCode and user with the same value.Todas las claves son planas (sin arrays ni subobjetos). El taxId limpio — clerk.taxId con . y - removidos, null → "" — llena id, accountCode y user con el mismo valor.

O que o builder envia inerte ou fixo, documentado fiel ao estado atual do código (nunca descrito como se já existisse):What the builder ships inert or fixed, documented faithfully to the current code state (never described as already existing):Lo que el builder envía inerte o fijo, documentado fiel al estado actual del código (nunca descrito como si ya existiera):