Envio de notasNotes uploadEnvío de notas

Envio de notas é a transação de saída que persiste uma nota de varejo no backend. É disparada pela feature de Notas do varejo ao salvar (submitNote) ou excluir (deleteNote) uma nota. O payload é enxuto: um único envelope AccNoteData com um objeto de nota e seus anexos em base64. Notes upload is the outbound transaction that persists a retail note in the backend. It's fired by the Retail notes feature when saving (submitNote) or deleting (deleteNote) a note. The payload is lean: a single AccNoteData envelope with one note object and its base64 attachments. Envío de notas es la transacción de salida que persiste una nota de punto de venta en el backend. Se dispara desde la feature de Notas del punto de venta al guardar (submitNote) o eliminar (deleteNote) una nota. El payload es escueto: un único envelope AccNoteData con un objeto de nota y sus adjuntos en base64.

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. Para notas, serviceName = NoteUploadAPI.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. For notes, serviceName = NoteUploadAPI.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 notas, serviceName = NoteUploadAPI.

Para notas, resendMayDuplicate == true: um reenvio (ex.: recuperação de fila offline) pode duplicar a nota no backend; a idempotência via tid é o que mitiga isso.For notes, resendMayDuplicate == true: a resend (e.g. offline-queue recovery) may duplicate the note on the backend; idempotency via tid is what mitigates it.Para notas, resendMayDuplicate == true: un reenvío (p. ej. recuperación de cola offline) puede duplicar la nota en el backend; la idempotencia vía tid es lo que lo mitiga.

A transação é orquestrada pela feature de Notas (remote-first, §36). O notifier apenas reúne entities cruas e valores injetados (o base64 dos anexos é resolvido no notifier); o builder é o dono único da montagem do wire — derivação do resourceSfid, normalização de extensão e formatação de data. A cascata:The transaction is orchestrated by the Notes feature (remote-first, §36). The notifier only gathers raw entities and injected values (attachment base64 is resolved in the notifier); the builder is the sole owner of the wire assembly — resourceSfid derivation, extension normalization and date formatting. The cascade:La transacción se orquesta desde la feature de Notas (remote-first, §36). El notifier solo reúne entities crudas y valores inyectados (el base64 de los adjuntos se resuelve en el notifier); el builder es el dueño único del armado del wire — derivación del resourceSfid, normalización de extensión y formateo de fecha. La cascada:

• NotesNotifiersubmitNote · deleteNote
  • reúne entities cruas + base64gathers raw entities + base64reúne entities crudas + base64NotesDispatcherPayloadInput
    • build()BuildNotesDispatcherPayloadUseCasemonta o wireassembles the wirearma el wire
      • devolvereturnsdevuelveDispatcherEnvelope
        • SubmitNotesUseCaseDispatcherOrchestrator
          • serializa + authserialize + authserializa + authDispatcherGateway
            • sendTransactionBackendgRPC

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

NotesDispatcherPayloadInput (Freezed). Carrega o dado como existe no domínio; nada de formato wire. O relógio chega como submittedAt (via DateTimeUtils.now()); os anexos já chegam com o conteúdo lido em base64.NotesDispatcherPayloadInput (Freezed). Carries data as it exists in the domain; no wire shaping. The clock arrives as submittedAt (via DateTimeUtils.now()); attachments arrive with their content already read as base64.NotesDispatcherPayloadInput (Freezed). Lleva el dato como existe en el dominio; nada de formato wire. El reloj llega como submittedAt (vía DateTimeUtils.now()); los adjuntos llegan con su contenido ya leído en base64.

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. Campo, Tipo e Origem são código cru; só a Regra é prosa. Um exemplo completo (variante CL) 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. Field, Type and Source are raw code; only Rule is prose. A full example (CL variant) 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. Campo, Tipo y Origen son código crudo; solo la Regla es prosa. Un ejemplo completo (variante CL) está en transaction_example.json, junto a este doc.

Raiz do payloadPayload rootRaíz del payload

• AccNoteData[] objeto únicosingle objectobjeto único 7 camposfieldscampos

  Campo JSON	TipoTypeTipo	Origem do DadoData sourceOrigen del Dato	RegraRuleRegla
  id	string	note.id	id da nota (novo = note_<millis>, gerado no notifier); também vira transactionReferencenote id (new = note_<millis>, generated in the notifier); also becomes transactionReferenceid de la nota (nuevo = note_<millis>, generado en el notifier); también se vuelve transactionReference
  retailerId	string	input.accountSfid	SFID do varejo a que a nota pertenceSFID of the retail the note belongs toSFID del punto de venta al que pertenece la nota
  title	string	note.title	título (já trim()-ado no notifier)title (already trim()-med in the notifier)título (ya trim()-eado en el notifier)
  textPreview	string	note.text	corpo da nota (já trim()-ado no notifier)note body (already trim()-med in the notifier)cuerpo de la nota (ya trim()-eado en el notifier)
  isDeleted	bool	input.isDeleted	false ao criar/salvar, true ao excluirfalse on create/save, true on deletefalse al crear/guardar, true al eliminar
  resourceSfid	string	Calculado	resource.isPrimaryResource ? primaryResourceSfid : secondaryResourceSfidresource.isPrimaryResource ? primaryResourceSfid : secondaryResourceSfidresource.isPrimaryResource ? primaryResourceSfid : secondaryResourceSfid
  attachments	array	input.attachments	uma entrada por anexo capturado; [] quando não há anexo (ex.: exclusão)one entry per captured attachment; [] when there's none (e.g. deletion)una entrada por adjunto capturado; [] cuando no hay ninguno (p. ej. eliminación)

  • attachments[] por anexoper attachmentpor adjunto 3 camposfieldscampos

    Campo JSON	TipoTypeTipo	Origem do DadoData sourceOrigen del Dato	RegraRuleRegla
    filename	string	attachment.fileName	nome do arquivo (cru)file name (raw)nombre del archivo (crudo)
    fileType	string	attachment.fileType.replaceAll(".", "").toLowerCase()	extensão normalizada — sem ponto, minúscula (ex.: jpg, pdf)normalized extension — no dot, lowercase (e.g. jpg, pdf)extensión normalizada — sin punto, minúscula (p. ej. jpg, pdf)
    base64	string	attachment.base64	conteúdo do arquivo em base64 (lido no notifier)file content in base64 (read in the notifier)contenido del archivo en base64 (leído en el notifier)

O que o builder não emite, documentado fiel ao estado atual do código (nunca descrito como se já existisse):What the builder does not emit, documented faithfully to the current code state (never described as already existing):Lo que el builder no emite, documentado fiel al estado actual del código (nunca descrito como si ya existiera):