Documentação semana de implementação do IWMS

Implementação iWMS no CD — relatório por dia
Documento único com a semana de implementação. Cada dia começa em título grande (Dia 1 a Dia 4); entre um dia e outro há um separador destacado.
Dia 1 — Segunda 03/08: Recebimento e conferência por chave
Dia 2 — Terça 04/08: Finalizar recebimento e Atualizar Peso
Dia 3 — Quarta 05/08: Carga (app) e Relatórios / correções Illi
Dia 4 — Quinta 06/08: Embarque / expedição por placa
Início do Dia 1 (segunda)
Segunda-feira, 03/08/2026 — Dia 1
Primeiro dia da implementação iWMS no CD. Neste dia foi criado o novo módulo de Recebimento de mercadoria, com associação de NF-e ao pedido e início do fluxo de conferência de volume pela chave da nota — tanto na biblioteca Illi quanto no aplicativo iWMS (coletor / telas de pedido).
1. Resumo do dia
Novo módulo de recebimento: biblioteca Illi + integração no app iWMS.
Pedido passa de Confirmado para Recebimento ao associar a NF-e.
Histórico de etapas do recebimento (recebimento → conferência de volume).
Tela no app: Conferência Volume por Chave (ler a chave da NF-e e iniciar a conferência).
Acesso liberado no menu Illi/iWMS: Conferência Volume por Chave e Operações.
APK do iWMS em versão 2.4.6 com chave de release versionada.
2. O que foi criado de novo
Item
O que é
Módulo iWMS Recebimento (Illi)
Biblioteca para listar NF-e do fornecedor, associar a nota ao pedido e controlar as etapas do recebimento
Tela de associação de NF-e
Abre a partir do pedido Confirmado; mostra notas candidatas, badges e ação de associar
Registro do vínculo
Grava a associação no integrador (chave, número, série, volumes, peças, valor) e gera recibo no parecer do pedido
Etapas do recebimento
Cada avanço fecha a etapa atual e abre a próxima, mantendo histórico (ex.: RECEBIMENTO, CONFERENCIA VOLUME)
Conferência por chave no app
Telas no iWMS para consultar e iniciar conferência de volume pela chave da NF-e (44 dígitos), com vínculo a auditoria / etiqueta
Finalizar recebimento (API)
Encerramento da etapa de conferência / finalização do fluxo de recebimento iniciado no dia
3. Fluxo operacional liberado
Operador seleciona um pedido em situação Confirmado.
Inicia o recebimento e localiza a NF-e do fornecedor (número, série ou chave).
Confere valor, situação e itens; opcionalmente visualiza XML ou DANFE.
Associa a nota: pedido vai para Recebimento; badge Associada aparece na nota.
No coletor / app iWMS, com a chave da NF-e, inicia a Conferência Volume por Chave.
Detalhe de uso da tela de associação: ver o documento de recebimento já publicado no KB (Iniciar Recebimento / Associar nota).
4. Acessos liberados no iWMS neste dia
Menu / tela
Rota
Para que serve
Operações
operacao
Cadastro de operações e regras do extra no iWMS
Conferência Volume por Chave
etiqueta/volume/chave
Conferir volume do recebimento informando a chave da NF-e
5. Etapas do recebimento (conceito)
Ao associar a nota, nasce a etapa RECEBIMENTO.
Ao iniciar a conferência pela chave, a etapa vigente passa a CONFERENCIA VOLUME.
A etapa em andamento é a que ainda não foi encerrada; as anteriores ficam no histórico.
Etapa
Quando nasce
RECEBIMENTO
Ao associar a NF-e ao pedido
CONFERENCIA VOLUME
Ao iniciar a conferência pela chave da nota
6. Entregas técnicas do dia (commits)
Commits em 03/08/2026 — biblioteca Illi (relatórios) e aplicativo iWMS:
Onde
Horário aprox.
Mensagem do commit
O que entrou
Illi
16:19
recebimento de mercadoria no iwms
Módulo iwms_recebimento (listar e associar NF-e), documentação inicial e acesso Operações
App
18:09 / 21:27
auditoria / Conferência de volume por chave da NF-e
Telas e backend de conferência por chave, integração recebimento / auditoria / etiqueta
Illi
21:18
recebimento de mercadoria
Etapas do recebimento, conferência / finalização por chave, acesso Conferência Volume por Chave
App
21:36+
Versão 2.4.6 / APK / keystore
Release do APK do coletor com chave de assinatura versionada
7. Situação ao fim da segunda-feira
Base do Recebimento pronta: associar NF-e, mudar situação do pedido e registrar histórico de etapas.
Conferência de volume pela chave disponível no menu e nas telas do app iWMS.
Fechamentos e refinamentos do fluxo de finalizar / overrides na tela de pedido ficaram para o dia seguinte (terça).
Fim do Dia 1 (segunda)  |  Início do Dia 2 (terça)
Terça-feira, 04/08/2026 — Dia 2
Segundo dia da implementação iWMS no CD. Neste dia o fluxo de Recebimento foi fechado na prática (tela de pedido, validações e finalizar) e entrou o novo módulo / acesso de Atualizar Peso dos packs — no Illi e no aplicativo iWMS.
1. Resumo do dia
Finalização do Recebimento: botões e regras na tela de pedido alinhados ao fluxo com conferência.
Impede finalizar o recebimento “comum” quando o pedido foi iniciado com conferência — deve usar Finalizar Recebimento (conferência).
Exige conferência concluída no portal OBJ antes de confirmar / finalizar nesse caminho.
Limpeza de acessos duplicados no menu do iWMS (mesmo caminho de tela mais de uma vez).
Tela no app e acesso Illi Atualizar Peso: altera o peso dos packs do pedido de uma vez.
No app: filtro de pack por SKU e melhorias de UI; versão até 2.4.11. Também entrou expurgo no mesmo dia (fora do foco do recebimento/peso).
2. O que foi feito de novo ou alterado
Item
O que é
Ações na tela de pedido (Illi)
Scripts / override para Iniciar Recebimento, Finalizar Recebimento, exportar iWMS e integração com conferência / importação do CD
Regra de finalização
Se existe registro de recebimento iWMS no pedido, não deixa concluir pelo finalizar antigo; orienta o caminho com conferência
Conferência obrigatória
Antes de confirmar, verifica se a conferência de recebimento existe e já foi finalizada no portal OBJ
Acessos do menu iWMS
Remove duplicatas de rota: mantém uma entrada ativa por URL e preserva permissões de grupo
Atualizar Peso (app + Illi)
Tela no iWMS: lê etiqueta de pack, lista os packs do pedido e atualiza o peso de todos de uma vez; acesso pack/peso no menu
3. Fluxo operacional reforçado na terça
Pedido em Confirmado → Iniciar Recebimento → associar NF-e (fluxo da segunda).
Se o recebimento foi iniciado com conferência, a conclusão passa por Finalizar Recebimento no caminho de conferência — não pelo finalizar genérico.
A conferência precisa estar finalizada no portal OBJ; caso contrário o sistema bloqueia e informa o operador.
Após embalar / packs do pedido, o operador usa Atualizar Peso no app iWMS para gravar o peso dos packs.
4. Acessos liberados ou ajustados neste dia
Menu / tela
Rota
Para que serve
Atualizar Peso
pack/peso
Atualizar o peso dos packs do pedido a partir da etiqueta
Menu iWMS em geral
—
Deduplicação: uma tela ativa por rota, sem entradas repetidas
5. Entregas técnicas do dia (commits)
Commits em 04/08/2026 — biblioteca Illi (relatórios) e aplicativo iWMS:
Onde
Horário aprox.
Mensagem do commit
O que entrou
Illi
09:47
versao
Limpeza de acessos duplicados no iWMS; reforço no módulo de recebimento
App
09:52 / tarde
nova versao com expurgo / UI pack
Expurgo e ajustes de UI de pack / APK (paralelo ao foco recebimento-peso)
Illi
15:13
Implement validation to prevent finalization of receipt if the order was initiated with conference...
Validação ao finalizar, checagem de conferência e scripts na tela de pedido
Illi
17:47
Add access for updating pack weights in iWMS v14
Acesso Atualizar Peso (pack/peso) no install
App
18:38
Versão 2.4.11: ... atualizar peso por pedido/pack ...
Tela e APIs de atualizar peso, filtro pack por SKU e melhorias de UI
6. Situação ao fim da terça-feira
Recebimento fechado de ponta a ponta: iniciar, associar, conferir e finalizar com regras claras.
Módulo / tela de peso liberada no menu Illi e no app iWMS.
Expedição pela nova forma de carga ficou para o dia seguinte (quarta), no aplicativo iWMS.
Fim do Dia 2 (terça)  |  Início do Dia 3 (quarta)
Quarta-feira, 05/08/2026 — Dia 3
Terceiro dia da implementação iWMS no CD. O foco principal no aplicativo iWMS foi a nova forma de expedição pelo módulo de Carga (agrupar contentores que saem juntos). No Illi (relatórios) entraram ajustes / correções do Recebimento e o menu Relatórios.
1. Resumo do dia
App: módulo Carga completo (cadastro, QR A4, coletor, regras de entidade, finalização) — versão 2.4.12 / 2.4.13.
App: painéis de Relatórios operacionais (tarefas / contentores) e melhorias pontuais (IMEI no equipamento, UI, OTP no expurgo).
Illi: correções no Recebimento (SQL / conferência / XML) e cadastro dos acessos de Relatórios.
2. O que foi criado de novo (app — Carga)
Item
O que é
Módulo Carga
Agrupa contentores que vão sair juntos numa expedição; conta contentores, volumes e peso em tempo real
Backoffice
Lista, cadastro, detalhe, allowlist de entidades, itens e impressão A4 com QR Code
Coletor
Lê o QR da carga e depois cada contentor; segunda leitura do mesmo contentor remove (com confirmação)
Regras de aceite
Exigir entidade no contentor; exigir mesma entidade do destino; lista de entidades permitidas
Situações
ATIVO → ANDAMENTO → LIBERADA → EXPEDIDA → FINALIZADA (cancelamento DESATIVO)
Consulta por etiqueta
Ler o QR da carga e ver resumo (contentores, volumes, peso)
3. Fluxo operacional da carga
No backoffice, cadastrar a carga (nome, destino opcional, regras e entidades permitidas).
Imprimir a etiqueta A4 com QR Code da carga.
No coletor, ler o QR da carga e em seguida ler cada contentor que entra.
O sistema valida as regras, associa o contentor e atualiza totais (contentores / volumes / peso).
Finalizar a carga: trava novas leituras.
4. Complemento Illi neste dia
Item
Tipo
O que é
ID raiz / SQL Recebimento / XML
Correção
Ajustes no filtro de NF-e, fim de conferência e leitura de itens do XML
Menu Relatórios
Pequena implementação
Acessos: painel operacional, tarefas do dia, contentores sem endereço, contentores gerados no dia
5. Entregas técnicas do dia (commits)
Commits em 05/08/2026 — aplicativo iWMS e Illi:
Onde
Horário aprox.
Mensagem do commit
O que entrou
App
08:32 / 09:19
OTP expurgo / IMEI equipamento
Melhorias paralelas (expurgo com OTP; IMEI no cadastro de equipamento)
Illi
09:49 / 10:33
Update ID_RAIZ... / Relatórios v15
Correções do Recebimento e acessos de Relatórios
App
09:54
Remove token do dashboard / refatora tarefas
Painéis de relatório / tarefas no app
App
11:04
Versão 2.4.12 e implementa o módulo de carga
Backend, telas backoffice/coletor, QR, testes e documentação da carga
App
18:28 / 19:09
Atualiza lógica de carga / versão 2.4.13
Refinos de UI, filtro de carga e release 2.4.13
6. Situação ao fim da quarta-feira
Carga pronta para montar expedição por contentores no app iWMS.
Relatórios operacionais liberados (app + acessos Illi).
Próximo passo: liberar cargas para veículo / embarque (quinta).
Fim do Dia 3 (quarta)  |  Início do Dia 4 (quinta)
Quinta-feira, 06/08/2026 — Dia 4
Quarto dia da implementação iWMS no CD. No aplicativo iWMS avançou a expedição: embarque das cargas por placa, liberação no backoffice, leitura no coletor e versão 2.4.14.
1. Resumo do dia
Embarque: liberar cargas finalizadas para um veículo (placa / transportadora / data de saída).
Coletor de expedição: informar a placa, ler o QR de cada carga, marcar como enviada, remover se precisar e finalizar a expedição da placa.
Backoffice: Kanban / lista de cargas, diálogo de liberação; campos de faturamento na carga.
Documentação de atualização em produção via Docker Hub.
Neste repositório Illi: sem commits novos neste dia.
2. O que foi criado de novo ou alterado
Item
O que é
Embarque
Agrupa cargas liberadas por placa; acompanha pendentes x enviadas, peso e volumes
Liberação para expedição
No backoffice, selecionar cargas finalizadas e liberar com placa, transportadora e data de saída
Coletor expedição
Telas por placa: listar, ler QR da carga (enviar), remover carga do embarque, finalizar quando não restar pendente
Kanban / lista
Visão operacional das cargas e cálculos de acompanhamento na interface
Faturamento na carga
Registro de data / usuário de faturamento no cabeçalho da carga
3. Fluxo operacional do embarque
Cargas já finalizadas no fluxo da quarta.
No backoffice, liberar uma ou mais cargas para a placa do veículo.
No coletor, abrir a expedição pela placa e ler o QR de cada carga liberada (marca como enviada).
Se errou, remover a carga do embarque (volta a poder ser liberada depois).
Quando não houver pendente, finalizar a expedição da placa.
4. Entregas técnicas do dia (commits app)
Commits em 06/08/2026 no aplicativo iWMS:
Horário aprox.
Mensagem do commit
O que entrou
10:34
Adiciona suporte ao módulo de embarque e atualiza a lógica de carga
Tabelas e APIs de embarque, faturamento, Kanban, liberação, telas de expedição no coletor, testes
10:36 / 11:08
Atualiza versão backend / frontend para 2.4.14
Release 2.4.14
11:07
Refatora a lógica de cálculo e aprimora a interface nas páginas de carga
Ajustes de cálculo e UI no Kanban / lista
11:12
Documenta comando único de atualização em produção via Docker Hub
Docs de deploy / atualização em produção
5. Situação ao fim da quinta-feira
Cadeia carga → liberação → embarque por placa disponível no app iWMS (2.4.14).
Recebimento / peso / relatórios da segunda à quarta permanecem como base.