Skip to main content

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), Relatórios e Relatóriosinício /do correçõesfaturamento Illi
  • Dia 4 — Quinta 06/08: EmbarqueEmbarque, /Fatura expediçãoCarga pore placafaturamento na finalização (3.0.1)

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

  1. Operador seleciona um pedido em situação Confirmado.
  2. Inicia o recebimento e localiza a NF-e do fornecedor (número, série ou chave).
  3. Confere valor, situação e itens; opcionalmente visualiza XML ou DANFE.
  4. Associa a nota: pedido vai para Recebimento; badge Associada aparece na nota.
  5. 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

  1. Pedido em Confirmado → Iniciar Recebimento → associar NF-e (fluxo da segunda).
  2. 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.
  3. A conferência precisa estar finalizada no portal OBJ; caso contrário o sistema bloqueia e informa o operador.
  4. 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 eRecebimento, 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

  1. No backoffice, cadastrar a carga (nome, destino opcional, regras e entidades permitidas).
  2. Imprimir a etiqueta A4 com QR Code da carga.
  3. No coletor, ler o QR da carga e em seguida ler cada contentor que entra.
  4. O sistema valida as regras, associa o contentor e atualiza totais (contentores / volumes / peso).
  5. 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).
  • PróximoBase passo:do liberarfaturamento cargasIlli para veículo /iniciada; embarque (quinta).+ 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. NoDe aplicativomanhã, iWMSo app avançou a expedição:o embarque das cargas por placa,placa liberação(2.4.14). À tarde/noite, Illi e app fecharam o ciclo com Fatura Carga: ao finalizar a expedição no backoffice,coletor, leiturao lote é faturado no Illi (gera NF-e / movimentação), com proteção contra duplicidade. Release do coletor e versãoem 2.4.143.0.1.

1. Resumo do dia

  • Embarque:Manhã (app): embarque — liberar cargas finalizadaspor paraplaca, um veículo (placa / transportadora / datacoletor 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:expedição, Kanban / listalista, 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 cargas,fechar diálogoo deembarque; liberação;etiqueta campos100x50 decom faturamentoids nada carga.fatura; Documentaçãoparametrização dedo atualizaçãosistema; emAPK produção3.0.0 via/ Docker Hub. Neste repositório Illi: sem commits novos neste dia.3.0.1.

2. O que foi criado de novo ou alterado

Item Onde
O que é Embarque Agrupa cargas liberadas por placa; acompanha pendentes x enviadas, peso e volumes Liberação para expediçãoApp No backoffice, selecionarLibera cargas finalizadas epara liberarveículo; comcoletor placa, transportadora e data de saída Coletor expedição Telas por placa: listar, lerlê QR da carga (enviar),por removerplaca; cargaremove do/ embarque,finaliza finalizar quando não restar pendenteexpedição Kanban / lista de carga VisãoApp operacionalAcompanhamento das cargasvisual e cálculos de acompanhamentocontentores na/ interfacevolumes / peso Fatura Carga Illi Biblioteca que fatura o lote de cargas no Illi (pedido / NF-e / fluxo), com tela de configuração Faturamento na cargafinalização RegistroApp 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 datafatura App Impressão 100x50 mm com ids de movimentação / usuárioNF-e deretornados faturamentopelo noIlli cabeçalho(uma dapor cargaveículo/lote) Parametrização do sistema App Tela / módulo para parâmetros do sistema (import do ambiente na primeira subida)

3. Fluxo operacional do(embarque embarque+ fatura)

  1. Cargas já finalizadas no fluxo da quarta.
  2. No backoffice, liberar uma ou mais cargas para a placa do veículo.
  3. No coletor, abrir a expedição pela placa e ler o QR de cada carga liberada (marca como enviada).
  4. SeAo errou, remover a carga do embarque (volta a poder ser liberada depois).
Quando não houver pendente, finalizar a expedição da placa.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 app)commits)

Commits em 06/08/2026 no— aplicativo iWMS: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 TabelasEmbarque, e APIs de embarque, faturamento,liberação, Kanban, liberação, telas de expedição no coletor, testescoletor App 10:36 / 11:07 / 11:08 / 11:12 Atualiza versão backend / frontend paraVersão 2.4.14 / UI carga / Docker Hub Release 2.4.1414, ajustes de cálculo/UI e docs de deploy 11:07Illi Refatora18:32 aAdd lógicaiWMS deFatura cálculoCarga module with configuration management Módulo iwms_fatura_carga, configuração e aprimora a interface nas páginas de carga Ajustes de cálculo e UIacessos no Kanban / listainstall 11:12Illi Documenta19:15 comandoEnhance únicoiWMS 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 atualizaçãofatura, parametrização App 19:32 Corrige rollback do estado de erro de negócio... Correção do estado da fatura em produçãoerro viade Dockernegócio Hub Illi Docs20:19 deRefactor deployiWMS Fatura Carga for improved error handling and pricing logic Anti-duplicidade e preços no faturamento App 20:15 / atualização20:17 emversao produção/ Publica a versão 3.0.1... Release coletor 3.0.1 (APK e assets)

5. Situação ao fim da quinta-feira

  • Cadeia cargacompleta no CD: recebimento → liberaçãopeso → carga → embarque por placa disponível→ nofaturamento appIlli iWMSna (2.4.14).finalização.
  • RecebimentoApp em 3.0.1; Illi com módulo Fatura Carga operacional.
Proteção contra NF-e duplicada em caso de falha de rede / pesoresposta / relatórios da segunda à quarta permanecem como base.ambígua.
Back to top