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 5); 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), Relatórios e início do faturamento Illi
- Dia 4 — Quinta 06/08: Expedição por placa, Fatura Carga e faturamento na finalização (3.0.1)
- Dia 5 — Sexta 07/08: Embarque / Desembarque (3.0.2 / 3.0.3), Illi v19 e data de entrega na NF-e
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, o menu Relatórios e, no fim do dia, o início do módulo Fatura Carga (financeiro vinculado).
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.
- Illi (noite): esboço do módulo iwms_fatura_carga (financeiro vinculado à carga).
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 |
| Módulo Fatura Carga (esboço) | Início | Biblioteca Illi para faturar carga / financeiro vinculado (base; consolidada na quinta) |
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 |
| Illi | 19:40 | versao financeiro vinculado | Criação inicial do módulo iwms_fatura_carga e acesso no install do iWMS |
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).
- Base do faturamento Illi iniciada; embarque + faturamento na finalização na 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. De manhã, o app avançou o embarque por placa (2.4.14). À tarde/noite, Illi e app fecharam o ciclo com Fatura Carga: ao finalizar a expedição no coletor, o lote é faturado no Illi (gera NF-e / movimentação), com proteção contra duplicidade. Release do coletor em 3.0.1.
1. Resumo do dia
- Manhã (app): embarque — liberar cargas por placa, coletor de expedição, Kanban / lista, docs Docker Hub (2.4.14).
- Tarde/noite (Illi): módulo iwms_fatura_carga completo (configuração, geração financeira, anti-duplicidade, preços).
- Tarde/noite (app): ao finalizar expedição da placa, chama o Illi para faturar o lote antes de fechar o embarque; etiqueta 100x50 com ids da fatura; parametrização do sistema; APK 3.0.0 / 3.0.1.
2. O que foi criado de novo ou alterado
| Item | Onde | O que é |
|---|---|---|
| Embarque | App | Libera cargas finalizadas para veículo; coletor lê QR da carga por placa; remove / finaliza expedição |
| Kanban / lista de carga | App | Acompanhamento visual e cálculos de contentores / volumes / peso |
| Fatura Carga | Illi | Biblioteca que fatura o lote de cargas no Illi (pedido / NF-e / fluxo), com tela de configuração |
| Faturamento na finalização | App | Finalizar expedição chama o Illi; grava situação da fatura no embarque; não reenvia sozinho se a resposta ficou ambígua |
| Etiqueta de fatura | App | Impressão 100x50 mm com ids de movimentação / NF-e retornados pelo Illi (uma por veículo/lote) |
| Parametrização do sistema | App | Tela / módulo para parâmetros do sistema (import do ambiente na primeira subida) |
3. Fluxo operacional (embarque + fatura)
- Cargas finalizadas no fluxo da quarta.
- No backoffice, liberar cargas para a placa do veículo.
- No coletor, ler o QR de cada carga liberada (marca como enviada).
- Ao finalizar a expedição da placa: o app fatura o lote no Illi (Fatura Carga) e só então fecha o embarque.
- Se a resposta do Illi for clara e de sucesso: grava dados da fatura, imprime etiqueta de fatura.
- Se a rede falhar ou a resposta ficar ambígua: o sistema não reenvia sozinho — o operador precisa confirmar o reenvio, para não duplicar NF-e.
4. Entregas técnicas do dia (commits)
Commits em 06/08/2026 — aplicativo iWMS e Illi:
| Onde | Horário aprox. | Mensagem do commit | O que entrou |
|---|---|---|---|
| App | 10:34 | Adiciona suporte ao módulo de embarque e atualiza a lógica de carga | Embarque, liberação, Kanban, telas de expedição no coletor |
| App | 10:36 / 11:07 / 11:08 / 11:12 | Versão 2.4.14 / UI carga / Docker Hub | Release 2.4.14, ajustes de cálculo/UI e docs de deploy |
| Illi | 18:32 | Add iWMS Fatura Carga module with configuration management | Módulo iwms_fatura_carga, configuração e acessos no install |
| Illi | 19:15 | Enhance iWMS Fatura Carga module with new pull functionality and UI updates | Melhorias no módulo e rastreio no financeiro |
| App | 19:18 | Adiciona faturamento junto ao illi na finalização da expedição... | Chamada ao Illi no finalizar, idempotência, etiqueta de fatura, parametrização |
| App | 19:32 | Corrige rollback do estado de erro de negócio... | Correção do estado da fatura em erro de negócio |
| Illi | 20:19 | Refactor iWMS Fatura Carga for improved error handling and pricing logic | Anti-duplicidade e preços no faturamento |
| App | 20:15 / 20:17 | versao / Publica a versão 3.0.1... | Release coletor 3.0.1 (APK e assets) |
5. Situação ao fim da quinta-feira
- Cadeia no CD até o faturamento: recebimento → peso → carga → expedição por placa → faturamento Illi na finalização.
- App em 3.0.1; Illi com módulo Fatura Carga operacional.
- Proteção contra NF-e duplicada em caso de falha de rede / resposta ambígua.
- Transporte físico pós-fatura (Embarque / Desembarque) na sexta.
Fim do Dia 4 (quinta) | Início do Dia 5 (sexta)
Sexta-feira, 07/08/2026 — Dia 5
Quinto e último dia da semana de implementação no CD. Depois do faturamento da quinta, o app ganhou as telas de Embarque e Desembarque no coletor: saída física do veículo com foto da CNH e recebimento no destino. No Illi, o install v19 liberou os acessos dessas telas; a Fatura Carga passou a preencher a data de entrega da NF-e com a data de saída do embarque quando houver vínculo. Releases do coletor: 3.0.2 e, em seguida, 3.0.3 com correção da finalização do embarque.
1. Resumo do dia
- App: fluxo Embarque / Desembarque após a carga faturada — cadeia FATURADO → TRANSPORTE → RECEBIDO.
- App: finalizar embarque exige foto da CNH do motorista; não finaliza com carga faturada pendente na placa.
- Illi v19: acessos de menu Embarque e Desembarque no coletor.
- Illi Fatura Carga: data de entrega da NF-e usa a data de saída do embarque ativo das cargas ou, se não houver, a data do dia.
- Release 3.0.2 (acessos) e 3.0.3 (correção da finalização do embarque).
2. O que foi criado de novo ou alterado
| Item | Onde | O que é |
|---|---|---|
| Embarque | App (coletor) | Após faturamento: informar placa, ler cargas faturadas, finalizar com foto da CNH; carga vai para TRANSPORTE |
| Desembarque | App (coletor) | No destino: informar placa, ler cargas em transporte, finalizar; carga vai para RECEBIDO |
| Distinção de Expedição | App | Embarque / Desembarque são etapas depois da fatura; não confundir com a Expedição por placa da quinta |
| Acessos Illi v19 | Illi | Rotas carga/coletor/embarque e carga/coletor/desembarque na árvore de acesso do iWMS |
| Data de entrega na NF-e | Illi (Fatura Carga) | Preenche data de entrega com a data de saída do embarque vinculado às cargas, quando existir |
| Versões 3.0.2 / 3.0.3 | App | 3.0.2 com acessos; 3.0.3 corrige finalização do embarque |
3. Fluxo operacional (embarque + desembarque)
- Cargas já faturadas na finalização da expedição (Dia 4).
- No coletor, abrir Embarque, informar a placa e ler o QR de cada carga faturada.
- Ao finalizar o embarque: tirar / enviar a foto da CNH; não pode sobrar carga faturada pendente. Cargas passam a TRANSPORTE.
- No destino, abrir Desembarque, informar a mesma placa e ler o QR de cada carga em transporte.
- Ao finalizar o desembarque: não pode sobrar carga em transporte; cargas passam a RECEBIDO.
Detalhe de uso: ver o documento de Expedição no KB (seções Embarque e Desembarque).
4. Acessos liberados no iWMS neste dia (Illi v19)
| Menu / tela | Rota | Para que serve |
|---|---|---|
| Embarque | carga/coletor/embarque | Embarcar cargas faturadas no veículo e finalizar com foto da CNH |
| Desembarque | carga/coletor/desembarque | Desembarcar cargas do veículo pela placa no destino |
5. Entregas técnicas do dia (commits)
Commits em 07/08/2026 — aplicativo iWMS e Illi:
| Onde | Horário aprox. | Mensagem do commit | O que entrou |
|---|---|---|---|
| App | 11:55 | Atualiza a documentação e os modelos para suportar o novo fluxo de embarque e desembarque | Telas, models, migration, CNH, cadeia FATURADO → TRANSPORTE → RECEBIDO, testes |
| App | 12:23 | Publica a versão 3.0.2 com acessos de Embarque e Desembarque | Release 3.0.2 |
| Illi | 12:23 | iWMS v19: cadastra acessos de Embarque e Desembarque no coletor | Install v19 nas rotas do coletor |
| App | 12:37 | Corrige finalização do embarque e publica a versão 3.0.3 | Correção + release 3.0.3 |
| Illi | 12:44 | versao (Fatura Carga) | Data de entrega da NF-e a partir da data de saída do embarque |
6. Situação ao fim da sexta-feira (fechamento da semana)
- Cadeia completa no CD: recebimento → peso → carga → expedição → faturamento Illi → embarque → desembarque / recebido.
- App em 3.0.3; Illi com acessos v19 e Fatura Carga com data de entrega alinhada ao embarque.
- Semana de implementação 03/08 a 07/08 documentada neste relatório.