Prompt (Van Sales)(Van Sales)(Van Sales)

RetornaReturnsDevuelve Result<StockControlEntity, Failure>

Ponto de entrada do estoque (default source: local). Decide a fonte e grava no cache (write-through). Chamado hoje apenas pelo DataSyncOrchestrator, com a fonte forçada do sweep de freshness.Stock entry point (default source: local). Picks the source and writes to cache (write-through). Today it is called only by DataSyncOrchestrator, with the freshness sweep's forced source.Punto de entrada del stock (default source: local). Elige la fuente y graba en caché (write-through). Hoy lo llama solo el DataSyncOrchestrator, con la fuente forzada del sweep de freshness.

Árvore de decisão de fonteSource decision treeÁrbol de decisión de fuente

1. useMockData ouoro source == mock→ _fetchFromMock(): lê o asset JSON de stock_control do mercado ativo (sintético ou real), mapeia por fromMap + toDomain(). Não grava cache.→ _fetchFromMock(): reads the market's stock_control JSON asset (synthetic or real), maps via fromMap + toDomain(). No cache write.→ _fetchFromMock(): lee el asset JSON de stock_control del mercado activo (sintético o real), mapea vía fromMap + toDomain(). No graba caché.
2. source == local ou offlineor offlineu offline→ _fetchFromCacheOrFail(): cache; se a box estiver vazia, Error(NetworkFailure).→ _fetchFromCacheOrFail(): cache; if the box is empty, Error(NetworkFailure).→ _fetchFromCacheOrFail(): caché; si la box está vacía, Error(NetworkFailure).
3. senão (remoto + conectado)otherwise (remote + connected)si no (remoto + conectado)→ _fetchFromRemoteWithFallback(): lê currentResourceProvider (null → cache), chama o remoto com resource.locationHierarchyId, mapeia, grava no cache; em erro, fallback pro cache (e só devolve o erro se o cache também estiver vazio).→ _fetchFromRemoteWithFallback(): reads currentResourceProvider (null → cache), calls remote with resource.locationHierarchyId, maps, writes cache; on error, falls back to cache (and only returns the error when the cache is empty too).→ _fetchFromRemoteWithFallback(): lee currentResourceProvider (null → caché), llama al remoto con resource.locationHierarchyId, mapea, graba caché; en error, fallback al caché (y solo devuelve el error si el caché también está vacío).

RetornaReturnsDevuelve Result<StockControlEntity?, Failure>

Só cache; box vazia vira Success(null). É este o método que todo o fluxo de pedido prompt usa (via GetAvailableStockForProductUseCase.loadSnapshot e AllocateManufacturingBatchesUseCase) — nenhuma leitura de estoque durante a montagem do carrinho dispara rede.Cache only; an empty box becomes Success(null). This is the method the whole prompt order flow uses (via GetAvailableStockForProductUseCase.loadSnapshot and AllocateManufacturingBatchesUseCase) — no stock read during cart building hits the network.Solo caché; box vacía se vuelve Success(null). Es este el método que usa todo el flujo de pedido prompt (vía GetAvailableStockForProductUseCase.loadSnapshot y AllocateManufacturingBatchesUseCase) — ninguna lectura de stock durante el armado del carrito toca la red.

RetornaReturnsDevuelve DateTime? (sem Result; erro é logado e vira null)(no Result; an error is logged and becomes null)(sin Result; el error se loguea y se vuelve null)

Timestamp da última sincronização do estoque, consumido pelo sweep de freshness para decidir se o dado venceu (TTL de 900 s).The stock's last-sync timestamp, consumed by the freshness sweep to decide whether the data is stale (900 s TTL).Timestamp de la última sincronización del stock, consumido por el sweep de freshness para decidir si el dato venció (TTL de 900 s).

RetornaReturnsDevuelve Result<void, Failure>

Destrutivo: o datasource local limpa a box raiz e os lotes antes de regravar. Chamado depois de um fetch remoto bem-sucedido — nunca por um envio de pedido. O merge de visita ad hoc não passa por aqui: ele entra pelo mergeAdhocStockControl do datasource local, que resolve o AdhocStockControlMerge e só então chama este saveStockControl.Destructive: the local datasource clears the root box and the batches before rewriting. Called after a successful remote fetch — never by an order submit. The ad-hoc visit merge does not come through here: it enters via the local datasource's mergeAdhocStockControl, which resolves AdhocStockControlMerge and only then calls this saveStockControl.Destructivo: el datasource local limpia la box raíz y los lotes antes de regrabar. Se llama tras un fetch remoto exitoso — nunca por un envío de pedido. El merge de visita ad hoc no pasa por aquí: entra por el mergeAdhocStockControl del datasource local, que resuelve el AdhocStockControlMerge y solo entonces llama a este saveStockControl.

getStockControl({locationHierarchySfid, dateReference?})

EnvioSendsEnvío

monta StockControlRequest com locationHierarchySfid (e dateReference só se não for nulo) e dispara getStockControl no StockControlConectaRepServiceClient.builds a StockControlRequest with locationHierarchySfid (and dateReference only when non-null) and fires getStockControl on StockControlConectaRepServiceClient.arma StockControlRequest con locationHierarchySfid (y dateReference solo si no es nulo) y dispara getStockControl en StockControlConectaRepServiceClient.

RetornoReturnRetorno

StockControlDTO (via response.toDTO())(via response.toDTO())(vía response.toDTO())

Fluxo de usoUsage flowFlujo de uso

caminho remoto do repository quando online e sem mock; o resultado é gravado no cache. lastModifiedDate (#3) não é parâmetro deste método.the repository's remote path when online and not mocking; the result is written to cache. lastModifiedDate (#3) is not a parameter of this method.camino remoto del repository cuando está online y sin mock; el resultado se graba en caché. lastModifiedDate (#3) no es parámetro de este método.

Tratamento de erroError handlingManejo de errores

GrpcError → GrpcExceptionHandler; outros → ServerException (shouldLog: true). O repository faz fallback pro cache.GrpcError → GrpcExceptionHandler; others → ServerException (shouldLog: true). The repository falls back to cache.GrpcError → GrpcExceptionHandler; otros → ServerException (shouldLog: true). El repository hace fallback al caché.

Envio / fluxo: persistência local via ObjectBox — box raiz StockControlModel + box de lotes StockModel pela relação ToMany. Alimenta todos os caminhos de cache do repository. Erro: qualquer falha vira CacheException (shouldLog: true).Sends / flow: local persistence via ObjectBox — StockControlModel root box + StockModel batch box through the ToMany relation. Feeds every cache path of the repository. Error: any failure becomes a CacheException (shouldLog: true).Envío / flujo: persistencia local vía ObjectBox — box raíz StockControlModel + box de lotes StockModel por la relación ToMany. Alimenta todos los caminos de caché del repository. Error: cualquier falla se vuelve CacheException (shouldLog: true).

getStockControl()

RetornoReturnRetorno

StockControlEntity?

ComportamentoBehaviorComportamiento

models.first.toDomain() ou null se a box estiver vazia.or null when the box is empty.o null si la box está vacía.

getStockControlLastSyncAt()

RetornoReturnRetorno

DateTime?

ComportamentoBehaviorComportamiento

models.first.lastSyncAt

saveStockControl({entity})

RetornoReturnRetorno

void

ComportamentoBehaviorComportamiento

clearStockControl() e depois put(entity.toModel()) — sempre uma única linha raiz.clearStockControl() then put(entity.toModel()) — always a single root row.clearStockControl() y luego put(entity.toModel()) — siempre una única fila raíz.

clearStockControl()

RetornoReturnRetorno

void

ComportamentoBehaviorComportamiento

limpa a box de lotes e a box raiz (usado internamente antes de gravar).clears the batch box and the root box (used internally before writing).limpia la box de lotes y la box raíz (uso interno antes de grabar).

mergeAdhocStockControl({incoming, accountSfid})

RetornoReturnRetorno

void

ComportamentoBehaviorComportamiento

é o ponto de entrada real do merge de visita ad hoc: lê o cache atual, delega a AdhocStockControlMerge.merge (que substitui os lotes da conta recebida) e regrava por saveStockControl — tudo dentro do datasource. O coordenador de merge ad hoc chama este método, não o repository.this is the real entry point of the ad-hoc visit merge: it reads the current cache, delegates to AdhocStockControlMerge.merge (which replaces the incoming account's batches) and rewrites through saveStockControl — all inside the datasource. The ad-hoc merge coordinator calls this method, not the repository.es el punto de entrada real del merge de visita ad hoc: lee el caché actual, delega a AdhocStockControlMerge.merge (que sustituye los lotes de la cuenta recibida) y regraba por saveStockControl — todo dentro del datasource. El coordinador de merge ad hoc llama a este método, no al repository.

getStockControl()

EnvioSendsEnvío

nenhum — lê o asset da pasta stock_control por mercado (currentMarketProvider) e por modo de mock (useRealMockDataProvider: sintético vs dump real).none — reads the asset from the stock_control folder per market (currentMarketProvider) and per mock mode (useRealMockDataProvider: synthetic vs real dump).ninguno — lee el asset de la carpeta stock_control por mercado (currentMarketProvider) y por modo de mock (useRealMockDataProvider: sintético vs dump real).

RetornoReturnRetorno

StockControlDTO (via StockControlDTOMapper.fromMap)(via StockControlDTOMapper.fromMap)(vía StockControlDTOMapper.fromMap)

Fluxo de usoUsage flowFlujo de uso

modo mock; o arquivo existe para os seis mercados, mas só BR e CL têm conteúdo sintético — 5 lotes cada, com os três tipos convivendo (2 stock_count, 2 van_load, 1 stock_view). O sintético da África do Sul é um stub vazio, como os de AR, PY e PE. Nos dumps reais o quadro é outro: BR (6 lotes) e CL (12) são todos stock_view, e a África do Sul (35 lotes) é toda stock_count — nenhum van_load em nenhum dump real.mock mode; the file exists for all six markets, but only BR and CL carry synthetic content — 5 batches each, with all three types coexisting (2 stock_count, 2 van_load, 1 stock_view). South Africa's synthetic file is an empty stub, like AR, PY and PE. The real dumps look different: BR (6 batches) and CL (12) are all stock_view, and South Africa (35 batches) is all stock_count — no van_load in any real dump.modo mock; el archivo existe para los seis mercados, pero solo BR y CL tienen contenido sintético — 5 lotes cada uno, con los tres tipos conviviendo (2 stock_count, 2 van_load, 1 stock_view). El sintético de Sudáfrica es un stub vacío, como los de AR, PY y PE. En los dumps reales el cuadro es otro: BR (6 lotes) y CL (12) son todos stock_view, y Sudáfrica (35 lotes) es todo stock_count — ningún van_load en ningún dump real.

Tratamento de erroError handlingManejo de errores

asset ausente ou JSON inválido → CacheException.missing asset or invalid JSON → CacheException.asset ausente o JSON inválido → CacheException.

fromString é case-insensitive, mas com uma particularidade: string vazia cai em stockCount (não em unknown) — só um valor desconhecido não vazio vira unknown. Nenhum consumidor filtra por type hoje (ver Pendências).fromString is case-insensitive, with one quirk: an empty string falls into stockCount (not unknown) — only a non-empty unknown value becomes unknown. No consumer filters by type today (see Pending).fromString es case-insensitive, con una particularidad: una cadena vacía cae en stockCount (no en unknown) — solo un valor desconocido no vacío se vuelve unknown. Ningún consumidor filtra por type hoy (ver Pendientes).

Membro derivado: isAwaitingApproval é true para pendingApproval e pendingExternalApproval — é ele que decide se o registro de pagamento diferido nasce aguardando a aprovação do pedido.Derived member: isAwaitingApproval is true for pendingApproval and pendingExternalApproval — it decides whether the deferred payment register is born awaiting order approval.Miembro derivado: isAwaitingApproval es true para pendingApproval y pendingExternalApproval — decide si el registro de pago diferido nace esperando la aprobación del pedido.

Matriz de comportamento — uma linha por getterBehavior matrix — one row per getterMatriz de comportamiento — una fila por getter

hasEditableAmount e requiresDebitOpenItem são escritos com != promptOrder, então o valor unknown herda o comportamento não-prompt (valor editável, título obrigatório) — uma origem corrompida no cache degrada para gestão financeira, não para prompt. fromString é case-sensitive (comparação exata do value) e loga o valor não mapeado.hasEditableAmount and requiresDebitOpenItem are written as != promptOrder, so unknown inherits the non-prompt behavior (editable amount, open item required) — a corrupted cached origin degrades to financial management, not to prompt. fromString is case-sensitive (exact value match) and logs the unmapped value.hasEditableAmount y requiresDebitOpenItem se escriben como != promptOrder, así que unknown hereda el comportamiento no-prompt (monto editable, documento obligatorio) — un origen corrupto en caché degrada a gestión financiera, no a prompt. fromString es case-sensitive (comparación exacta del value) y loguea el valor no mapeado.

Membros derivados: isPending (os dois primeiros), isSyncable (readyToSync) e isSent. Este ciclo é fila de escrita local do app, não contrato de backend — os mesmos quatro códigos existiam no app legado.Derived members: isPending (the first two), isSyncable (readyToSync) and isSent. This lifecycle is the app's local write queue, not a backend contract — the same four codes existed in the legacy app.Miembros derivados: isPending (los dos primeros), isSyncable (readyToSync) e isSent. Este ciclo es cola de escritura local de la app, no contrato de backend — los mismos cuatro códigos existían en la app legada.

normalize baixa a caixa e colapsa espaços/hífens em _, então tanto "Prompt-sales Rep" (usado nos JSONs reais) quanto "prompt_sales_rep" (usado no arquivo comentado de documentação do EMC) resolvem para o mesmo case. Valor não mapeado dispara logUnmappedEnumValue, que em debug/profile quebra por assert; em release degrada para unknown, que nunca consta de nenhuma lista de tipos permitidos.normalize lowercases and collapses spaces/hyphens into _, so both "Prompt-sales Rep" (used in the real JSONs) and "prompt_sales_rep" (used in the EMC's annotated documentation file) resolve to the same case. An unmapped value fires logUnmappedEnumValue, which in debug/profile throws via assert; in release it degrades to unknown, which is never present in any allowed-types list.normalize baja la caja y colapsa espacios/guiones en _, así que tanto "Prompt-sales Rep" (usado en los JSON reales) como "prompt_sales_rep" (usado en el archivo comentado de documentación del EMC) resuelven al mismo case. Un valor no mapeado dispara logUnmappedEnumValue, que en debug/profile rompe por assert; en release degrada a unknown, que nunca aparece en ninguna lista de tipos permitidos.

Enum de canal, não de gating: agrupa os tipos acima e é usado em filtros de visitas/entregas e nas etiquetas F/D/TS. O Prompt-sales Rep é canal physical. tradeMarketingRep não pertence a nenhum grupo, então resolve para unknown. fromString aceita tanto o nome do grupo quanto qualquer valor de tipo contido nele, e não loga nem faz assert no fallback.A channel enum, not a gating one: it groups the types above and is used in visit/delivery filters and in the F/D/TS badges. The Prompt-sales Rep is channel physical. tradeMarketingRep belongs to no group, so it resolves to unknown. fromString accepts both the group name and any type value inside it, and does not log nor assert on fallback.Enum de canal, no de gating: agrupa los tipos de arriba y se usa en filtros de visitas/entregas y en las etiquetas F/D/TS. El Prompt-sales Rep es canal physical. tradeMarketingRep no pertenece a ningún grupo, así que resuelve a unknown. fromString acepta tanto el nombre del grupo como cualquier valor de tipo contenido en él, y no loguea ni hace assert en el fallback.

Só o valor do ecossistema está aqui — os 31 valores completos de OrderStatus e os 4 de OrderStatusGroup vivem em Lista de pedidos §10. OrderStatus não tem chave de tradução: o value cru é renderizado na etiqueta. promptFulfillment é de entrada — vem do backend, aparece na etiqueta e no filtro de status, e nenhuma regra ramifica nele.Only the ecosystem's value is here — the full 31 values of OrderStatus and the 4 of OrderStatusGroup live in Order list §10. OrderStatus has no translation key: the raw value is rendered on the tag. promptFulfillment is inbound — it comes from the backend, shows on the tag and in the status filter, and no rule branches on it.Solo el valor del ecosistema está aquí — los 31 valores completos de OrderStatus y los 4 de OrderStatusGroup viven en Lista de pedidos §10. OrderStatus no tiene clave de traducción: el value crudo se renderiza en la etiqueta. promptFulfillment es de entrada — viene del backend, aparece en la etiqueta y en el filtro de estado, y ninguna regla ramifica en él.

Recorte do enum de 42 valores (36 com builder, 6 sem). Um pedido prompt sai hoje pelos mesmos serviços do pré-venda — o serviço dedicado do legado (Invoiceupload) está declarado no enum mas não tem builder, e os quatro serviços de operação de van também não. Os cinco aparecem apenas na própria linha do enum e nas chaves de tradução da central de dados.Excerpt of the 42-value enum (36 with a builder, 6 without). A prompt order goes out today through the same services as pre-sales — the legacy dedicated service (Invoiceupload) is declared in the enum but has no builder, and neither do the four van-operation services. All five appear only on their own enum line and in the data-center translation keys.Excerpto del enum de 42 valores (36 con builder, 6 sin). Un pedido prompt sale hoy por los mismos servicios que la preventa — el servicio dedicado del legado (Invoiceupload) está declarado en el enum pero no tiene builder, y los cuatro servicios de operación de van tampoco. Los cinco aparecen solo en su propia línea del enum y en las claves de traducción de la central de datos.

RetornaReturnsDevuelve Future<StockControlEntity?>

Chama GetAvailableStockForProductUseCase.loadSnapshot() (que é cache-only) e colapsa o Result: Success devolve o valor, Error devolve null. Ou seja, "cache vazio" e "falha de leitura" ficam indistinguíveis a partir daqui. Chamado 3× no CartOrchestrator (ao aplicar quantidade, ao avaliar o carrinho e ao avaliar o detalhe da promoção) e 1× no OrderDetailNotifier.Calls GetAvailableStockForProductUseCase.loadSnapshot() (cache-only) and collapses the Result: Success returns the value, Error returns null. So "empty cache" and "read failure" become indistinguishable from here on. Called 3× in CartOrchestrator (applying quantity, evaluating the cart and evaluating the promotion detail) and 1× in OrderDetailNotifier.Llama GetAvailableStockForProductUseCase.loadSnapshot() (solo caché) y colapsa el Result: Success devuelve el valor, Error devuelve null. O sea, "caché vacío" y "falla de lectura" quedan indistinguibles desde aquí. Se llama 3× en CartOrchestrator (al aplicar cantidad, al evaluar el carrito y al evaluar el detalle de la promoción) y 1× en OrderDetailNotifier.

RetornaReturnsDevuelve double

Delegação pura para GetAvailableStockForProductUseCase.availableFor. Alimenta o contexto de promoção (estoque real por produto) e o mapa de disponibilidade do detalhe do pedido.A pure delegation to GetAvailableStockForProductUseCase.availableFor. It feeds the promotion context (real stock per product) and the order detail's availability map.Delegación pura a GetAvailableStockForProductUseCase.availableFor. Alimenta el contexto de promoción (stock real por producto) y el mapa de disponibilidad del detalle del pedido.

RetornaReturnsDevuelve double

Compõe dois UseCases: resolve o disponível e passa para ClampQuantityToStockUseCase. É o corte de quantidade da linha do carrinho.Composes two UseCases: resolves availability and hands it to ClampQuantityToStockUseCase. It is the cart line's quantity clamp.Compone dos UseCases: resuelve el disponible y lo pasa a ClampQuantityToStockUseCase. Es el recorte de cantidad de la línea del carrito.

RetornaReturnsDevuelve double

O único método com regra própria: soma o que as linhas pagas do mesmo produto já consomem (ignora as linhas de bonificação) e passa isso como consumedByPurchase para ValidateRewardStockUseCase. Nenhum chamador hoje: quem faz esse cálculo no motor de promoções é o ApplyProductRewardUseCase, que injeta o ValidateRewardStockUseCase direto e mantém o próprio acumulador de bonificação concedida. Consequência: a dependência ValidateRewardStockUseCase do orquestrador existe só para alimentar este método.The only method with a rule of its own: it sums what the paid lines of the same product already consume (ignoring free-of-charge lines) and passes that as consumedByPurchase to ValidateRewardStockUseCase. No callers today: in the promotion engine that computation is done by ApplyProductRewardUseCase, which injects ValidateRewardStockUseCase directly and keeps its own granted-FoC accumulator. Consequence: the orchestrator's ValidateRewardStockUseCase dependency exists only to feed this method.El único método con regla propia: suma lo que las líneas pagas del mismo producto ya consumen (ignora las líneas de bonificación) y lo pasa como consumedByPurchase a ValidateRewardStockUseCase. Sin llamadores hoy: en el motor de promociones ese cálculo lo hace ApplyProductRewardUseCase, que inyecta ValidateRewardStockUseCase directo y mantiene su propio acumulador de bonificación concedida. Consecuencia: la dependencia ValidateRewardStockUseCase del orquestador existe solo para alimentar este método.

RetornaReturnsDevuelve List<CartItemBatchAllocationEntity>

Delega para o método puro AllocateManufacturingBatchesUseCase.allocate (o que recebe o snapshot), não para o execute que releria o repository.Delegates to the pure AllocateManufacturingBatchesUseCase.allocate (the one that takes the snapshot), not to the execute that would re-read the repository.Delega al método puro AllocateManufacturingBatchesUseCase.allocate (el que recibe el snapshot), no al execute que releería el repository.

Como o disponível é calculadoHow availability is computedCómo se calcula el disponible

1. Sem snapshotNo snapshotSin snapshotstockControl == null → 0.0. Cache vazio equivale a "sem estoque".stockControl == null → 0.0. An empty cache equals "no stock".stockControl == null → 0.0. Caché vacío equivale a "sin stock".
2. Soma dos lotesSum of batchesSuma de los lotessoma availableQuantity de todos os lotes com productTradeSKU == product.productSfid e availableQuantity > 0. Não filtra por type — lotes de van_load, stock_count e stock_view entram no mesmo bolo (ver Pendências).sums availableQuantity across every batch with productTradeSKU == product.productSfid and availableQuantity > 0. It does not filter by type — van_load, stock_count and stock_view batches are pooled together (see Pending).suma availableQuantity de todos los lotes con productTradeSKU == product.productSfid y availableQuantity > 0. No filtra por type — los lotes de van_load, stock_count y stock_view entran en la misma bolsa (ver Pendientes).
3. Conversão de unidadeUnit conversionConversión de unidadse a categoria do produto usa unidade secundária (ou o mercado usa secundária para todas), converte o total pelo fator de conversão; senão arredonda pela regra de quantidade (ProductUomUtils).if the product's category uses the secondary unit (or the market uses secondary for all), converts the total by the conversion factor; otherwise rounds by the quantity rule (ProductUomUtils).si la categoría del producto usa unidad secundaria (o el mercado usa secundaria para todas), convierte el total por el factor de conversión; si no, redondea por la regla de cantidad (ProductUomUtils).

Classe const, sem dependências — matemática pura.A const class with no dependencies — pure arithmetic.Clase const, sin dependencias — matemática pura.

Consumido direto pelo ApplyProductRewardUseCase do motor de promoções — a compra tem prioridade sobre a bonificação, e o acumulador de bonificações já concedidas evita que duas promoções gastem o mesmo lote. Ver Promoções.Consumed directly by the promotion engine's ApplyProductRewardUseCase — the purchase has priority over the free-of-charge grant, and the already-granted accumulator prevents two promotions from spending the same batch. See Promotions.Consumido directo por el ApplyProductRewardUseCase del motor de promociones — la compra tiene prioridad sobre la bonificación, y el acumulador de bonificaciones ya concedidas evita que dos promociones gasten el mismo lote. Ver Promociones.

Regra de alocaçãoAllocation ruleRegla de asignación converte a quantidade pedida para a unidade primária, percorre os lotes do produto com disponível > 0 na ordem em que vieram do backend (sem ordenar por validade ou lote), tira de cada um o que couber, e devolve uma lista de {batchId, quantity} na unidade de edição. Snapshot nulo ou quantidade ≤ 0 → lista vazia.converts the requested quantity to the primary unit, walks the product's batches with availability > 0 in backend order (no sorting by expiry or batch), takes what fits from each, and returns a list of {batchId, quantity} in the edit unit. A null snapshot or quantity ≤ 0 → empty list.convierte la cantidad pedida a la unidad primaria, recorre los lotes del producto con disponible > 0 en el orden en que vinieron del backend (sin ordenar por vencimiento ni lote), toma de cada uno lo que quepa, y devuelve una lista de {batchId, quantity} en la unidad de edición. Snapshot nulo o cantidad ≤ 0 → lista vacía.

RetornaReturnsDevuelve OrderTransactionStatus

Cascata de prioridades: cancelamento → pré-pagamento Pix → aprovação interna (exceto pedido indireto) → prompt (pendingExternalApproval se promptOrderUsesExternalApproval, senão invoicedNotSync) → onHold. O ramo prompt fica abaixo dos outros três, então um cancelamento ou uma aprovação pendente vence a marca de prompt.Priority cascade: cancellation → Pix pre-payment → internal approval (except indirect order) → prompt (pendingExternalApproval when promptOrderUsesExternalApproval, otherwise invoicedNotSync) → onHold. The prompt branch sits below the other three, so a cancellation or a pending approval outranks the prompt mark.Cascada de prioridades: cancelación → prepago Pix → aprobación interna (excepto pedido indirecto) → prompt (pendingExternalApproval si promptOrderUsesExternalApproval, si no invoicedNotSync) → onHold. La rama prompt queda debajo de las otras tres, así que una cancelación o una aprobación pendiente le gana a la marca prompt.

O builder do payload lê a marca do carrinho em três lugares:The payload builder reads the cart's mark in three places:El builder del payload lee la marca del carrito en tres lugares:

DeliveryDate

prompt → a própria data do pedido; senão a data de entrega do carrinho formatada.prompt → the order date itself; otherwise the cart's formatted delivery date.prompt → la propia fecha del pedido; si no, la fecha de entrega del carrito formateada.

IFlag

"1" em pedido prompt, "0" no pré-venda."1" on a prompt order, "0" on pre-sales."1" en pedido prompt, "0" en preventa.

alteredFull

!isPromptOrder && sendsAlteredFullFlag — prompt força false mesmo onde o mercado envia a flag.!isPromptOrder && sendsAlteredFullFlag — prompt forces false even where the market sends the flag.!isPromptOrder && sendsAlteredFullFlag — prompt fuerza false incluso donde el mercado envía la flag.

invoiceRefNo

indireto pelo status: preenchido com o número do pedido só quando sendsInvoiceRefOnExternalApproval e o status é pendingExternalApproval — na prática, o caminho prompt do Brasil.indirect through the status: filled with the order number only when sendsInvoiceRefOnExternalApproval and the status is pendingExternalApproval — in practice, Brazil's prompt path.indirecto por el estado: se llena con el número del pedido solo cuando sendsInvoiceRefOnExternalApproval y el estado es pendingExternalApproval — en la práctica, el camino prompt de Brasil.

O DispatcherType é resolvido sem olhar a marca de prompt: indireto → orderIndirect, aprovação → orderApproval, senão order. Não há campo de record type no payload (ver Pendências).The DispatcherType is resolved without looking at the prompt mark: indirect → orderIndirect, approval → orderApproval, otherwise order. There is no record type field in the payload (see Pending).El DispatcherType se resuelve sin mirar la marca de prompt: indirecto → orderIndirect, aprobación → orderApproval, si no order. No hay campo de record type en el payload (ver Pendientes).

ResolveDeliveryDateUseCase

primeira linha do execute: contexto prompt → devolve context.now formatado, curto-circuitando lead time do fornecedor, dias preferenciais, feriados, fins de semana e janela máxima.first line of execute: a prompt context → returns formatted context.now, short-circuiting supplier lead time, preferred weekdays, holidays, weekends and the max-ahead window.primera línea del execute: contexto prompt → devuelve context.now formateado, cortocircuitando lead time del proveedor, días preferidos, feriados, fines de semana y ventana máxima.

DeliveryDateRulesUseCase

isVisible: !context.isPromptOrder e isEditable: context.allowsDeliveryDateChange — a seção de data desaparece no prompt.isVisible: !context.isPromptOrder and isEditable: context.allowsDeliveryDateChange — the date section disappears under prompt.isVisible: !context.isPromptOrder y isEditable: context.allowsDeliveryDateChange — la sección de fecha desaparece en prompt.

ComputeCreditDateRangeUseCase

a data-base do intervalo de crédito é now no prompt, e a data de entrega do carrinho no pré-venda.the credit range's base date is now under prompt, and the cart's delivery date under pre-sales.la fecha base del rango de crédito es now en prompt, y la fecha de entrega del carrito en preventa.

No cálculo do atalho "Pix passa do limite de crédito", o pedido prompt adiciona a condição !(total > creditLimit). Fora do prompt essa cláusula é vacuamente verdadeira. Ou seja: o prompt restringe o bypass, não o amplia. Ver Carrinho para as demais travas.In the "Pix bypasses the credit limit" computation, a prompt order adds the condition !(total > creditLimit). Outside prompt that clause is vacuously true. In other words: prompt tightens the bypass, it does not widen it. See Cart for the other locks.En el cálculo del atajo "Pix pasa el límite de crédito", el pedido prompt agrega la condición !(total > creditLimit). Fuera del prompt esa cláusula es vacuamente verdadera. O sea: el prompt restringe el bypass, no lo amplía. Ver Carrito para las demás trabas.

RetornaReturnsDevuelve List<OrderActionStockIssueEntity>

Recebe checkVanStock. Com false, a comparação de quantidade é pulada e só sobram os problemas de "produto ausente do catálogo"; com true, cada linha paga cuja quantidade excede o disponível vira um problema. O notifier do detalhe do pedido só permite liberar se o número de linhas pagas for maior que o número de linhas com problema.It receives checkVanStock. With false, the quantity comparison is skipped and only "product missing from catalog" issues remain; with true, every paid line whose quantity exceeds availability becomes an issue. The order-detail notifier only allows release when the number of paid lines exceeds the number of issue lines.Recibe checkVanStock. Con false, la comparación de cantidad se omite y solo quedan los problemas de "producto ausente del catálogo"; con true, cada línea paga cuya cantidad excede el disponible se vuelve un problema. El notifier del detalle del pedido solo permite liberar si el número de líneas pagas es mayor que el de líneas con problema.

Monta o relatório de caixa a partir do primeiro método do rascunho de pagamento: sapCustomerId, poNumber, orderAmount, username, paymentMethod, referenceNumber (primeira referência de cobrança), documentDate e dateCreated; data ou número de pedido ausentes viram o sentinela "-". A referência da transação é o número do pedido. Disparado quando a origem do registro reporta caixa — pedido prompt e entrega.Builds the cash report from the payment draft's first method: sapCustomerId, poNumber, orderAmount, username, paymentMethod, referenceNumber (first collection reference), documentDate and dateCreated; a missing date or order number becomes the "-" sentinel. The transaction reference is the order number. Fired when the register's origin reports cash — prompt order and delivery.Arma el reporte de caja a partir del primer método del borrador de pago: sapCustomerId, poNumber, orderAmount, username, paymentMethod, referenceNumber (primera referencia de cobranza), documentDate y dateCreated; fecha o número de pedido ausentes se vuelven el centinela "-". La referencia de la transacción es el número del pedido. Se dispara cuando el origen del registro reporta caja — pedido prompt y entrega.

Entidade Freezed montada pelo cartContextProvider por conta; carrega a configuração de criação de pedido inteira, o catálogo, as promoções e os dados de crédito do varejo. Os getters do ecossistema:A Freezed entity built by cartContextProvider per account; it carries the whole order-creation config, the catalog, the promotions and the retail's credit data. The ecosystem's getters:Entidad Freezed armada por el cartContextProvider por cuenta; carga toda la configuración de creación de pedido, el catálogo, las promociones y los datos de crédito del punto de venta. Los getters del ecosistema:

getEmptyCart

estampa isPromptOrder no carrinho novo — o único ponto de decisão do modelo.stamps isPromptOrder on the new cart — the model's only decision point.estampa isPromptOrder en el carrito nuevo — el único punto de decisión del modelo.

_applyQuantity

com carrinho prompt, produto conhecido e alvo > 0: carrega o snapshot, corta a quantidade e aloca os lotes antes de fazer o upsert da linha.on a prompt cart, with a known product and target > 0: loads the snapshot, clamps the quantity and allocates batches before upserting the line.con carrito prompt, producto conocido y objetivo > 0: carga el snapshot, recorta la cantidad y asigna los lotes antes de hacer el upsert de la línea.

_evaluate · evaluatePromotionDetail

carregam o snapshot só quando o carrinho é prompt e o injetam no contexto de promoção.load the snapshot only when the cart is prompt and inject it into the promotion context.cargan el snapshot solo cuando el carrito es prompt y lo inyectan en el contexto de promoción.

_availableStock

carrinho não-prompt devolve a constante _unconstrainedStock (1e12) — "estoque infinito" para o motor de promoções; prompt devolve o disponível real por produto.a non-prompt cart returns the _unconstrainedStock constant (1e12) — "infinite stock" for the promotion engine; prompt returns the real per-product availability.un carrito no-prompt devuelve la constante _unconstrainedStock (1e12) — "stock infinito" para el motor de promociones; prompt devuelve el disponible real por producto.

É o único consumidor de presentation do PromptOrchestrator (via ref.read). Em prepareAction: cancelamento retorna antes de qualquer checagem; para as demais intenções calcula checkVanStock = order.isPromptOrder == true && orderConfig.checksVanStockForPromptOrders, e se verdadeiro monta o mapa de disponível por produto (_availableStockByProductSfid: um loadStockSnapshot + um availableStock por linha paga, resolvendo o SFID do produto a partir do SKU da linha). O veredito vai para OrderActionPreparationEntity.canProceed.The only presentation consumer of the PromptOrchestrator (via ref.read). In prepareAction: cancellation returns before any check; for the other intents it computes checkVanStock = order.isPromptOrder == true && orderConfig.checksVanStockForPromptOrders, and when true builds the per-product availability map (_availableStockByProductSfid: one loadStockSnapshot plus one availableStock per paid line, resolving the product SFID from the line's SKU). The verdict goes into OrderActionPreparationEntity.canProceed.Es el único consumidor de presentation del PromptOrchestrator (vía ref.read). En prepareAction: la cancelación retorna antes de cualquier verificación; para las demás intenciones calcula checkVanStock = order.isPromptOrder == true && orderConfig.checksVanStockForPromptOrders, y si es verdadero arma el mapa de disponible por producto (_availableStockByProductSfid: un loadStockSnapshot más un availableStock por línea paga, resolviendo el SFID del producto desde el SKU de la línea). El veredicto va a OrderActionPreparationEntity.canProceed.

GetterGetterGetter isPaymentCreationEnabled && splits.first.cart.isOnTimePayment

É este getter — e não isPromptOrder — que abre a área de configuração de pagamento do pedido. isPaymentCreationEnabled vem do módulo de criação de pagamento visível na configuração de gestão financeira do mercado; o segundo termo é a marca de pagamento à vista. O rascunho, porém, é chaveado e enviado como origem "pedido prompt".It is this getter — not isPromptOrder — that opens the order's payment configuration area. isPaymentCreationEnabled comes from the visible payment-creation module in the market's financial-management config; the second term is the pay-at-sight mark. The draft, however, is keyed and submitted under the "prompt order" origin.Es este getter — y no isPromptOrder — el que abre el área de configuración de pago del pedido. isPaymentCreationEnabled viene del módulo de creación de pago visible en la configuración de gestión financiera del mercado; el segundo término es la marca de pago al contado. El borrador, sin embargo, se clavea y se envía con origen "pedido prompt".

Depois que todas as parcelas do pedido são despachadas com sucesso, _registerDeferredPayments percorre as parcelas, lê o rascunho prompt_order:<conta>:<índice> (pulando os vazios) e chama o orquestrador de pagamento com origin: promptOrder, isDeferred: true e isAwaitingOrderApproval: split.status.isAwaitingApproval. O orquestrador retorna cedo no caminho diferido: grava o registro de pagamento (ORDER_PA ou CREATED) e não despacha nada. Por fim o rascunho é limpo.After every order split is dispatched successfully, _registerDeferredPayments walks the splits, reads the prompt_order:<account>:<index> draft (skipping empty ones) and calls the payment orchestrator with origin: promptOrder, isDeferred: true and isAwaitingOrderApproval: split.status.isAwaitingApproval. The orchestrator returns early on the deferred path: it stores the payment register (ORDER_PA or CREATED) and dispatches nothing. The draft is then cleared.Después de que todas las cuotas del pedido se despachan con éxito, _registerDeferredPayments recorre las cuotas, lee el borrador prompt_order:<cuenta>:<índice> (salteando los vacíos) y llama al orquestador de pago con origin: promptOrder, isDeferred: true e isAwaitingOrderApproval: split.status.isAwaitingApproval. El orquestador retorna temprano en el camino diferido: graba el registro de pago (ORDER_PA o CREATED) y no despacha nada. Al final el borrador se limpia.

O despacho real (PaymentCollectionAPI, comprovante de pagamento e CashPaymentReportAPI) acontece depois, em syncRegister, disparado da central de dados — nunca no envio do pedido. Consequência: o relatório de caixa de um pedido prompt nunca sai pelo caminho imediato; só pelo de sincronização.The actual dispatch (PaymentCollectionAPI, proof of payment and CashPaymentReportAPI) happens later, in syncRegister, triggered from the data center — never at order submit. Consequence: a prompt order's cash report never goes out through the immediate path; only through the sync one.El despacho real (PaymentCollectionAPI, comprobante de pago y CashPaymentReportAPI) ocurre después, en syncRegister, disparado desde la central de datos — nunca en el envío del pedido. Consecuencia: el reporte de caja de un pedido prompt nunca sale por el camino inmediato; solo por el de sincronización.

O estoque da van é um alvo de sync como qualquer outro: DataSyncType.stockControl (habilitado em BR, CL e ZA), dentro de um lote de sincronização, com getCachedLastSyncAt para o TTL (900 s) e execute(source:) para o refresh forçado. É o único caminho que traz estoque novo do backend.Van stock is a sync target like any other: DataSyncType.stockControl (enabled in BR, CL and ZA), inside a sync batch, with getCachedLastSyncAt for the TTL (900 s) and execute(source:) for the forced refresh. It is the only path that brings fresh stock from the backend.El stock de la van es un objetivo de sync como cualquier otro: DataSyncType.stockControl (habilitado en BR, CL y ZA), dentro de un lote de sincronización, con getCachedLastSyncAt para el TTL (900 s) y execute(source:) para el refresh forzado. Es el único camino que trae stock nuevo del backend.