Transações futurasFuture transactionsTransacciones futuras
O catálogo das transações de escrita que já estão previstas no contrato do Dispatcher — declaradas no enum DispatcherType — mas que ainda não foram implementadas no app: nenhuma tem, hoje, um builder de payload. São o roadmap de escrita. Cada uma ganhará seu próprio documento quando for construída.
The catalog of write transactions that are already foreseen in the Dispatcher contract — declared in the DispatcherType enum — but are not yet implemented in the app: none has a payload builder today. They are the write roadmap. Each will get its own document once it is built.
El catálogo de las transacciones de escritura que ya están previstas en el contrato del Dispatcher — declaradas en el enum DispatcherType — pero que aún no fueron implementadas en la app: ninguna tiene, hoy, un builder de payload. Son el roadmap de escritura. Cada una tendrá su propio documento cuando sea construida.
O que éWhat it isQué es
O Dispatcher é o canal único pelo qual o app envia dados ao backend (pedidos, respostas de tarefa, contagens de estoque, etc.). O contrato desse canal já prevê uma lista de transações — algumas já funcionam (cada uma com seu documento próprio), e outras estão reservadas para o futuro. The Dispatcher is the single channel through which the app sends data to the backend (orders, task answers, stock counts, etc.). That channel's contract already foresees a list of transactions — some already work (each with its own document), and others are reserved for the future. El Dispatcher es el canal único por el cual la app envía datos al backend (pedidos, respuestas de tarea, conteos de stock, etc.). El contrato de ese canal ya prevé una lista de transacciones — algunas ya funcionan (cada una con su propio documento), y otras están reservadas para el futuro.
Este documento reúne as seis transações futuras: elas existem apenas como uma declaração no contrato, sem a peça que monta o envio. Enquanto essa peça não for construída, elas não podem ser disparadas pelo app. O objetivo aqui é dar visibilidade do que virá — para produto planejar e para QA/suporte saberem que, por ora, não há nada a testar nessas telas. This document gathers the six future transactions: they exist only as a declaration in the contract, without the piece that assembles the send. Until that piece is built, they cannot be fired by the app. The goal here is to give visibility of what's coming — for product to plan and for QA/support to know that, for now, there's nothing to test on these flows. Este documento reúne las seis transacciones futuras: existen solo como una declaración en el contrato, sin la pieza que arma el envío. Mientras esa pieza no se construya, no pueden dispararse por la app. El objetivo aquí es dar visibilidad de lo que vendrá — para que producto planifique y QA/soporte sepan que, por ahora, no hay nada que probar en esos flujos.
Para que servirãoWhat they'll be forPara qué servirán
Uma linha de negócio por transação — em linguagem gerencial, sem detalhe técnico:One business line per transaction — in managerial language, no technical detail:Una línea de negocio por transacción — en lenguaje gerencial, sin detalle técnico:
- Fatura de pedidoOrder invoiceFactura de pedido
- Enviar ao backend a fatura de um pedido já feito — o documento fiscal associado à venda.Send an already-placed order's invoice to the backend — the fiscal document tied to the sale.Enviar al backend la factura de un pedido ya hecho — el documento fiscal asociado a la venta.
- Criação de tarefaTask creationCreación de tarea
- Criar uma nova tarefa a partir do app — registrar uma pendência ou atividade para acompanhamento.Create a new task from the app — register a to-do or activity for follow-up.Crear una nueva tarea desde la app — registrar un pendiente o actividad para seguimiento.
- Reconciliação de estoqueStock reconciliationReconciliación de stock
- Conciliar o estoque contado com o esperado — reportar ajustes e divergências de inventário.Reconcile counted stock against expected — report inventory adjustments and discrepancies.Conciliar el stock contado con el esperado — reportar ajustes y divergencias de inventario.
- Proposta de estoqueStock requestPropuesta de stock
- Enviar uma solicitação/proposta de reabastecimento de estoque — pedir reposição de mercadoria.Send a stock replenishment request/proposal — ask for merchandise restock.Enviar una solicitud/propuesta de reabastecimiento de stock — pedir reposición de mercadería.
- Alocação de estoqueStock allocationAsignación de stock
- Registrar a execução da alocação de estoque — confirmar como o estoque foi distribuído/destinado.Register the execution of stock allocation — confirm how stock was distributed/assigned.Registrar la ejecución de la asignación de stock — confirmar cómo se distribuyó/destinó el stock.
- Descarga de estoque da vanVan stock unloadDescarga de stock de la van
- Reportar a descarga do estoque da van (van sales) — registrar o que retornou do veículo ao final da rota.Report the van's stock unload (van sales) — register what returned from the vehicle at the end of the route.Reportar la descarga del stock de la van (van sales) — registrar lo que volvió del vehículo al final de la ruta.
Status
Todas as seis são, hoje, não disparáveis: o app não as envia porque ainda não têm a peça que monta o envio. Não há tela, botão ou fluxo que as acione.All six are, today, non-firable: the app doesn't send them because they still lack the piece that assembles the send. There's no screen, button or flow that triggers them.Las seis son, hoy, no disparables: la app no las envía porque aún no tienen la pieza que arma el envío. No hay pantalla, botón o flujo que las active.
Nada a testar hojeNothing to test todayNada que probar hoy Por serem apenas declarações do contrato, essas transações não produzem nenhum comportamento no app. Quando uma delas for implementada, ela sai deste índice e ganha seu próprio documento completo, com fluxo de telas e detalhamento técnico. Being mere contract declarations, these transactions produce no behavior in the app. When one is implemented, it leaves this index and gains its own full document, with screen flow and technical detail. Al ser meras declaraciones del contrato, estas transacciones no producen ningún comportamiento en la app. Cuando una sea implementada, sale de este índice y obtiene su propio documento completo, con flujo de pantallas y detalle técnico.
Catálogo técnicoTechnical catalogCatálogo técnico
As seis transações futuras estão declaradas no enum DispatcherType (lib/core/enums/dispatcher/dispatcher_type.dart), cada uma com seu serviceName (discriminador) e sua lista de enabledMarkets. O que as distingue das transações já documentadas é a ausência de um Build*DispatcherPayloadUseCase — sem builder, não há build() que monte o payload JSON, logo não há o que enviar.
The six future transactions are declared in the DispatcherType enum (lib/core/enums/dispatcher/dispatcher_type.dart), each with its serviceName (discriminator) and its enabledMarkets list. What sets them apart from the already-documented transactions is the absence of a Build*DispatcherPayloadUseCase — without a builder, there's no build() assembling the JSON payload, so there's nothing to send.
Las seis transacciones futuras están declaradas en el enum DispatcherType (lib/core/enums/dispatcher/dispatcher_type.dart), cada una con su serviceName (discriminador) y su lista de enabledMarkets. Lo que las distingue de las transacciones ya documentadas es la ausencia de un Build*DispatcherPayloadUseCase — sin builder, no hay build() que arme el payload JSON, así que no hay nada que enviar.
Não há tabela de payload aqui porque não há build(). Destino de todas: DispatcherDestination.salesforce (default do enum).There's no payload table here because there's no build(). Destination for all: DispatcherDestination.salesforce (enum default).No hay tabla de payload aquí porque no hay build(). Destino de todas: DispatcherDestination.salesforce (default del enum).
DispatcherType |
serviceName |
MercadosMarketsMercados | DestinoDestinationDestino | Por que "futura"Why "future"Por qué "futura" |
|---|---|---|---|---|
orderInvoice | Invoiceupload | BR · CL | salesforce | Sem Build*DispatcherPayloadUseCase.No Build*DispatcherPayloadUseCase.Sin Build*DispatcherPayloadUseCase. |
createTask | CreateTaskAPI | BR · CL · ZA | salesforce | Sem Build*DispatcherPayloadUseCase.No Build*DispatcherPayloadUseCase.Sin Build*DispatcherPayloadUseCase. |
stockReconciliation | StockReconciliationAPI | BR · CL | salesforce | Sem Build*DispatcherPayloadUseCase.No Build*DispatcherPayloadUseCase.Sin Build*DispatcherPayloadUseCase. |
stockRequest | StockProposalUploadAPI | BR · CL | salesforce | Sem Build*DispatcherPayloadUseCase.No Build*DispatcherPayloadUseCase.Sin Build*DispatcherPayloadUseCase. |
stockAllocationExecution | StockAllocationUploadAPI | BR · CL | salesforce | Sem Build*DispatcherPayloadUseCase.No Build*DispatcherPayloadUseCase.Sin Build*DispatcherPayloadUseCase. |
stockUnload | VanUnloadAPI | BR · CL | salesforce | Sem Build*DispatcherPayloadUseCase.No Build*DispatcherPayloadUseCase.Sin Build*DispatcherPayloadUseCase. |
Quando ganham doc próprioWhen they get their own docCuándo obtienen doc propio
No momento em que um Build{X}DispatcherPayloadUseCase for criado para uma dessas transações, ela sai deste índice e passa a ter um documento numerado próprio (NN_nome) no setor dispatcher, com rpc-card, tabela de payload de 4 colunas e transaction_example.json. Todas continuam usando o mesmo RPC genérico sendTransaction; o discriminador é o serviceName.
The moment a Build{X}DispatcherPayloadUseCase is created for one of these transactions, it leaves this index and gets its own numbered document (NN_name) in the dispatcher sector, with an rpc-card, a 4-column payload table and a transaction_example.json. They all keep using the same generic sendTransaction RPC; the discriminator is serviceName.
En el momento en que se cree un Build{X}DispatcherPayloadUseCase para una de estas transacciones, sale de este índice y obtiene su propio documento numerado (NN_nombre) en el sector dispatcher, con rpc-card, tabla de payload de 4 columnas y transaction_example.json. Todas siguen usando el mismo RPC genérico sendTransaction; el discriminador es el serviceName.
Volta ao índice de documentos.Back to the document index.Volver al índice de documentos.
MercadosMarketsMercados
A disponibilidade prevista de cada transação vem do seu DispatcherType.enabledMarkets. Coletivamente, as seis futuras cobrem Brasil e Chile, com a criação de tarefa alcançando também a África do Sul. AR/PY/PE não são listados por nenhuma delas.Each transaction's foreseen availability comes from its DispatcherType.enabledMarkets. Collectively, the six future ones cover Brazil and Chile, with task creation also reaching South Africa. AR/PY/PE are listed by none of them.La disponibilidad prevista de cada transacción viene de su DispatcherType.enabledMarkets. Colectivamente, las seis futuras cubren Brasil y Chile, con la creación de tarea alcanzando también Sudáfrica. AR/PY/PE no son listados por ninguna.
Cobertura declarada por transação (soma do enabledMarkets de cada uma):Declared coverage per transaction (each one's enabledMarkets):Cobertura declarada por transacción (el enabledMarkets de cada una):
DispatcherType |
BR | CL | ZA | AR | PY | PE |
|---|---|---|---|---|---|---|
orderInvoice | x | x | — | — | — | — |
createTask | x | x | x | — | — | — |
stockReconciliation | x | x | — | — | — | — |
stockRequest | x | x | — | — | — | — |
stockAllocationExecution | x | x | — | — | — | — |
stockUnload | x | x | — | — | — | — |
Só na criação de tarefaTask creation onlySolo en la creación de tarea
Entre as seis futuras, a África do Sul só aparece em createTask (CreateTaskAPI). As transações de fatura e de estoque valem apenas para Brasil e Chile.
Among the six future ones, South Africa only appears in createTask (CreateTaskAPI). The invoice and stock transactions apply to Brazil and Chile only.
Entre las seis futuras, Sudáfrica solo aparece en createTask (CreateTaskAPI). Las transacciones de factura y de stock aplican solo a Brasil y Chile.
AR · PY · PE
Existem como mercados do app (config PANGEA mínima), mas nenhuma das seis transações futuras os lista em enabledMarkets. A disponibilidade aqui é a prevista pelo contrato — não a real, já que nenhuma é disparável hoje.
They exist as app markets (minimal PANGEA config), but none of the six future transactions list them in enabledMarkets. Availability here is the one foreseen by the contract — not the actual one, since none is firable today.
Existen como mercados de la app (config PANGEA mínima), pero ninguna de las seis transacciones futuras los lista en enabledMarkets. La disponibilidad aquí es la prevista por el contrato — no la real, ya que ninguna es disparable hoy.