Rastreamento de ativo de merchandisingMerchandising asset item trackingSeguimiento de activo de merchandising

Merchandising asset item tracking é a transação de saída que registra o estado de uma peça de ativo de merchandising instalada. O DispatcherType.merchandisingAssetItemTracking resolve para o serviceName AssetItemTrackingUploadAPI (destino salesforce), habilitado em ZA e CL. Um único builder cobre os dois contextos de disparo — o assistente Log Snag e a edição rápida de peça — porque ambos preenchem o mesmo input Freezed. Merchandising asset item tracking is the outbound transaction that records the state of an installed merchandising asset piece. DispatcherType.merchandisingAssetItemTracking resolves to the serviceName AssetItemTrackingUploadAPI (salesforce destination), enabled in ZA and CL. A single builder covers both firing contexts — the Log Snag wizard and the quick piece edit — because both fill the same Freezed input. Merchandising asset item tracking es la transacción de salida que registra el estado de una pieza de activo de merchandising instalada. DispatcherType.merchandisingAssetItemTracking resuelve al serviceName AssetItemTrackingUploadAPI (destino salesforce), habilitado en ZA y CL. Un único builder cubre los dos contextos de disparo — el asistente Log Snag y la edición rápida de pieza — porque ambos completan el mismo input Freezed.

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.

Para esta transação, resendMayDuplicate == true (não está na lista de tipos leves): um reenvío pode duplicar o registro no backend; a idempotência via tid é o que mitiga isso. O DispatcherOrchestrator despacha direto (sem fila offline — só DispatcherType.visit enfileira).For this transaction, resendMayDuplicate == true (it's not in the lightweight set): a resend may duplicate the record on the backend; idempotency via tid is what mitigates it. The DispatcherOrchestrator dispatches it directly (no offline queue — only DispatcherType.visit queues).Para esta transacción, resendMayDuplicate == true (no está en el conjunto liviano): un reenvío puede duplicar el registro en el backend; la idempotencia vía tid es lo que lo mitiga. El DispatcherOrchestrator lo despacha directo (sin cola offline — solo DispatcherType.visit encola).

Um único DispatcherType e um único serviceName. Não há variantes de tipo — o que muda é o contexto de disparo (qual notifier monta o input) e, com ele, quais campos do input chegam preenchidos.A single DispatcherType and a single serviceName. There are no type variants — what changes is the firing context (which notifier assembles the input) and, with it, which input fields arrive populated.Un único DispatcherType y un único serviceName. No hay variantes de tipo — lo que cambia es el contexto de disparo (qué notifier arma el input) y, con él, qué campos del input llegan completados.

A transação é orquestrada pelo fluxo de merchandising (remote-first, §36). O notifier apenas reúne entities cruas e labels selecionados; o builder é o dono único de toda derivação wire (rename, formatação de data, trim(), composição de motivo, token de remoção de código). A cascata:The transaction is orchestrated by the merchandising flow (remote-first, §36). The notifier only gathers raw entities and selected labels; the builder is the sole owner of every wire derivation (rename, date formatting, trim(), reason composition, barcode-removal token). The cascade:La transacción se orquesta desde el flujo de merchandising (remote-first, §36). El notifier solo reúne entities crudas y labels seleccionados; el builder es el dueño único de toda derivación wire (rename, formateo de fecha, trim(), composición de motivo, token de remoción de código). La cascada:

• Merchandising flownotifier
  • reúne entities cruas + labelsgathers raw entities + labelsreúne entities crudas + labelsMerchandisingAssetItemTrackingDispatcherPayloadInput
    • build()BuildMerchandisingAssetItemTrackingDispatcherPayloadUseCasemonta o wireassembles the wirearma el wire
      • devolvereturnsdevuelveDispatcherEnvelope
        • SubmitMerchandisingAssetItemTrackingUseCaseDispatcherOrchestrator
          • serializa + authserialize + authserializa + authDispatcherGateway
            • sendTransactionBackendgRPC

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

MerchandisingAssetItemTrackingDispatcherPayloadInput (Freezed). Carrega o dado como existe no domínio; nada de formato wire. O relógio chega como submittedAt: DateTime (via DateTimeUtils.now()). No Log Snag os labels vêm das seleções (atividade → serviço → motivo); na edição rápida chegam vazios.MerchandisingAssetItemTrackingDispatcherPayloadInput (Freezed). Carries data as it exists in the domain; no wire shaping. The clock arrives as submittedAt: DateTime (via DateTimeUtils.now()). In Log Snag the labels come from the selections (activity → service → reason); in the quick edit they arrive empty.MerchandisingAssetItemTrackingDispatcherPayloadInput (Freezed). Lleva el dato como existe en el dominio; nada de formato wire. El reloj llega como submittedAt: DateTime (vía DateTimeUtils.now()). En Log Snag los labels vienen de las selecciones (actividad → servicio → motivo); en la edición rápida llegan vacíos.

O JSON serializado no campo message do request. Cada tabela abaixo tem 4 colunas — Campo JSON · Tipo · Origem do Dado · Regra — e lista toda chave que o build() emite (22 no total: 2 raízes + 16 na peça + 4 por imagem). 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. Each table below has 4 columns — JSON field · Type · Data source · Rule — and lists every key that build() emits (22 in total: 2 roots + 16 in the piece + 4 per image). 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. Cada tabla abajo tiene 4 columnas — Campo JSON · Tipo · Origen del Dato · Regla — y lista toda clave que build() emite (22 en total: 2 raíces + 16 en la pieza + 4 por imagen). 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.

Raiz do payloadPayload rootRaíz del payload

• assetItemTracking objeto únicosingle objectobjeto único 16 camposfieldscampos

  Campo JSON	TipoTypeTipo	Origem do DadoData sourceOrigen del Dato	RegraRuleRegla
  reasonType	string	input.serviceLabel	rótulo do serviço; "" na edição rápidaservice label; "" in the quick editrótulo del servicio; "" en la edición rápida
  reason	string	_composeReason(input)	reasonLabel não vazio → "{serviceLabel} - {reasonLabel}"; senão activityLabelreasonLabel non-empty → "{serviceLabel} - {reasonLabel}"; else activityLabelreasonLabel no vacío → "{serviceLabel} - {reasonLabel}"; si no activityLabel
  assetItemID	string	Calculado	serviceTarget == assets ? "" : item.sfidserviceTarget == assets ? "" : item.sfidserviceTarget == assets ? "" : item.sfid
  assetID	string	input.asset.sfid	—
  comments	string	input.comment	trim()
  VisitID	string	input.visitSfid	—
  TargetQuantity	string	Fixo: ""	contrato · inertecontract · inertcontrato · inerte
  ActualQuantity	string	Fixo: ""	contrato · inertecontract · inertcontrato · inerte
  ProductID	string	Fixo: ""	contrato · inertecontract · inertcontrato · inerte
  ProductHierarchyID	string	Fixo: ""	contrato · inertecontract · inertcontrato · inerte
  URL	string	Fixo: ""	contrato · inertecontract · inertcontrato · inerte
  assetItemStatus	string	input.assetItemStatus	"" na edição rápida"" in the quick edit"" en la edición rápida
  assetItemInstalledAt	string	input.accountSfid	nome do campo é "installed at", mas o valor é o sfid da contafield name is "installed at", but the value is the account sfidel nombre del campo es "installed at", pero el valor es el sfid de la cuenta
  assetItemInstalledDate	string	input.submittedAt	formato yyyy-MM-dd (DateFormatType.isoDate)yyyy-MM-dd format (DateFormatType.isoDate)formato yyyy-MM-dd (DateFormatType.isoDate)
  Qty	string	Fixo: "1"	—
  barcode	string	Calculado	removesBarcode ? "Delete" : input.barcoderemovesBarcode ? "Delete" : input.barcoderemovesBarcode ? "Delete" : input.barcode

  • base64Image por fotoper photopor foto 4 camposfieldscampos

    Uma entrada por índice de input.imagesBase64. Se não há foto, o array fica vazio.One entry per index of input.imagesBase64. If there's no photo, the array is empty.Una entrada por índice de input.imagesBase64. Si no hay foto, el array queda vacío.

    Campo JSON	TipoTypeTipo	Origem do DadoData sourceOrigen del Dato	RegraRuleRegla
    assetId	string	input.asset.sfid	—
    filename	string	Calculado	"{item.sfid}_{index}.jpg""{item.sfid}_{index}.jpg""{item.sfid}_{index}.jpg"
    assetItemID	string	Calculado	mesmo valor de assetItemID da peça (vazio se target = assets)same value as the piece's assetItemID (empty if target = assets)mismo valor que el assetItemID de la pieza (vacío si target = assets)
    image1	string	input.imagesBase64[index]	conteúdo base64 da fotophoto base64 contentcontenido base64 de la foto

O que o builder envia inerte ou ainda não preenche, documentado fiel ao estado atual do código (nunca descrito como se já existisse):What the builder ships inert, or does not yet fill, documented faithfully to the current code state (never described as already existing):Lo que el builder envía inerte, o aún no completa, documentado fiel al estado actual del código (nunca descrito como si ya existiera):