Cargo-Planner Docs
Layouts Personalizáveis de Planos de Carga
Cargo-Planner permite que você decida como seus planos de carga são apresentados. Em vez de um formato fixo, você constrói layouts organizando blocos de informação em uma tela. Isso lhe dá controle sobre o que é mostrado e como é organizado para diferentes públicos - planos detalhados para funcionários do armazém ou resumos compactos para clientes.
Visão Geral
Com layouts você pode:
- Arrastar e soltar blocos para organizar seu plano de carga
- Escolher entre mais de 20 tipos de blocos (visões 3D, tabelas, notas, instruções, etc.)
- Configurar cada bloco com suas próprias configurações
- Mostrar ou ocultar blocos com base em condições (por exemplo, mostrar fotos apenas se houver)
- Criar múltiplos layouts para diferentes propósitos (armazém, cliente, gerente)
- Imprimir e compartilhar o resultado
Acessando o Construtor de Layout
Da Página do Plano de Carga
- Abra qualquer plano de carga
- Escolha um layout no seletor Layout na barra de ferramentas
- Clique no ícone de lápis ao lado para editar esse layout
O ícone de lápis só é mostrado para usuários que podem editar layouts.
Das Preferências
Vá para Preferências → 4. Plano de Carga, e clique em Gerenciar layouts em Layouts de Plano de Carga. Isso abre uma lista de todos os layouts, onde você pode criar, editar, copiar e deletá-los.
Interface do Construtor de Layout
O construtor de layout consiste em três áreas principais:
1. Paleta de Blocos (Barra Lateral Esquerda)
A paleta Adicionar Blocos lista os blocos disponíveis por categoria:
- Blocos Globais - Mostrados uma vez para todo o plano de carga (resumo, notas, itens não carregados, etc.)
- Blocos de Conjunto - Visualizações de conjuntos multi-contêiner
- Blocos de Contêiner - Mostrados para cada contêiner (visões 3D, tabelas de itens, instruções, etc.)
- Blocos Personalizados - Texto personalizado, espaçadores e quebras de página
Arraste um bloco para a tela para adicioná-lo. Use Buscar blocos… para encontrar um bloco pelo nome.
2. Tela (Centro)
A área principal de edição, onde os blocos são organizados em uma grade de 12 colunas. Você pode:
- Mover blocos arrastando a alça no bloco
- Redimensionar blocos arrastando o canto inferior direito
- Abrir o menu de um bloco (o ícone ⋮) para acessar Configurações ou Remover o bloco
Cada bloco mostra seu tamanho e um rótulo Condicional se tiver condições de visibilidade.
3. Barra de Ferramentas (Topo)
| Controle | O que faz |
|---|---|
| Ícone de lápis | Renomear o layout. Pressione Enter ou clique fora para manter |
| Copiar | Criar uma cópia do layout |
| Excluir | Excluir o layout |
| Salvar | Retornar à página anterior |
Abaixo da barra de ferramentas você pode adicionar uma Descrição do layout.
As alterações são salvas automaticamente enquanto você edita. Salvar apenas leva você de volta.
Os modelos mostram um rótulo Modelo e não podem ser renomeados, excluídos ou editados. Veja Usando Modelos.
Entendendo as Seções
Os layouts são divididos em três seções que controlam com que frequência os blocos são renderizados:
| Seção | Renderizado | Blocos típicos |
|---|---|---|
| Cabeçalho | Uma vez, no topo | Título, resumo, notas, itens não carregados, distribuição de grupos |
| Contêiner | Uma vez para cada contêiner | Visões 3D, informações do contêiner, tabelas de itens, instruções |
| Rodapé | Uma vez, na parte inferior | Termos e condições, informações de contato, avisos |
Blocos Globais e Personalizados podem ir em qualquer seção. Blocos de Contêiner e de Conjunto só podem ir na seção Contêiner.
Para mover um bloco para outra seção, arraste-o para lá ou altere a Colocação da Seção nas configurações dele.
Tipos de Blocos Disponíveis
Blocos Globais
Título do Plano de Carga
Mostra o nome da lista de carga como um título.
Autor
Mostra quem criou a lista de carga e, opcionalmente, quando.
| Configuração | Descrição |
|---|---|
| Mostrar Ícone | Mostrar um ícone ao lado do nome |
| Mostrar Rótulo | Mostrar o rótulo acima do nome |
| Mostrar Data de Criação | Mostrar a data em que a lista de carga foi criada |
| Rótulo Personalizado | Substituir o rótulo padrão “Criado por” |
| Ícone Personalizado | Nome de um ícone do Material Design a ser usado |
| Tamanho do Texto | Pequeno, médio ou grande |
| Variante do Cartão | Estilo do cartão: contornado, plano, texto ou elevado |
| Cor do Cartão | Cor de fundo do cartão |
Tabela Resumo
Um Resumo da Lista de Carga colapsável com a lista completa de carga da lista de carga, conforme inserido na página de dados.
| Configuração | Descrição |
|---|---|
| Expandido por padrão | Mostrar a tabela expandida em vez de colapsada |
Notas
Mostra as notas da lista de carga e as notas do plano de carga.
| Configuração | Descrição |
|---|---|
| Mostrar notas da lista de carga | Incluir as notas da lista de carga |
| Mostrar notas do plano de carga | Incluir as notas do plano de carga |
Itens Não Carregados
Lista a carga que não pôde ser carregada em nenhum contêiner.
| Configuração | Descrição |
|---|---|
| Expandido por padrão | Mostrar a lista expandida em vez de colapsada |
Distribuição de Grupos
Mostra onde cada remessa acabou: em quais contêineres foi carregada, quantas peças foram para cada um e quantas não puderam ser carregadas. Por padrão, lista apenas remessas que foram divididas, para que você possa verificar rapidamente quais remessas estão espalhadas por vários contêineres.
Cada linha mostra a remessa, seu número total de peças e os contêineres em que foi carregada, por exemplo, 1: 40HC (7) · 2: 20GP (5). Uma coluna Não carregado aparece quando parte de uma remessa não pôde ser carregada. As linhas são ordenadas por remessa.
| Configuração | Descrição |
|---|---|
| Agrupar por | A propriedade da carga para agrupar. Padrão para a remessa, mas qualquer propriedade de carga ou campo personalizado funciona, por exemplo, um número de pedido ou destino |
| Mostrar todos os grupos | Listar todos os grupos, não apenas os divididos |
| Apenas contêineres mistos | Listar apenas os contêineres que também contêm outros grupos. Contêineres contendo um único grupo são resumidos como uma contagem, por exemplo, +3 com apenas este grupo |
Um grupo é considerado dividido quando é carregado em mais de um contêiner ou quando apenas parte dele é carregada.
Peças em paletes e em pacotes são contadas individualmente, não o palete ou pacote em si. Carga sem um valor para a propriedade selecionada é deixada de fora. Quando contêineres idênticos são mostrados juntos (por exemplo, 1 a 3), a quantidade é por contêiner.
Blocos de Conjunto
Visão Geral do Conjunto
Mostra como os contêineres de um conjunto estão organizados juntos (útil para flat racks, open-tops, etc.). É mostrado no primeiro contêiner de cada conjunto com mais de um contêiner.
Blocos de Contêiner
Título do Contêiner
Mostra o número e o nome do contêiner. Contêineres idênticos mostrados juntos recebem um intervalo, por exemplo, 1 a 3.
| Configuração | Descrição |
|---|---|
| Estilo do título do contêiner | Número & Nome, Apenas Número ou Apenas Nome |
Visão 3D
Mostra uma visão 3D do contêiner carregado. Adicione várias para mostrar o contêiner de diferentes ângulos.
| Configuração | Descrição |
|---|---|
| Tipo de Visão | Principal, Lado 1, Lado 2, Topo, Frente, 3D, 3D Ortogonal, ou uma das quatro perspectivas 3D (frente-direita, trás-direita, trás-esquerda, frente-esquerda) |
| Largura/Altura da Tela (px) | Tamanho da visão |
| Mostrar Régua | Mostrar marcadores de dimensão |
| Mostrar Subdivisores da Régua | Adicionar marcadores mais finos à régua |
| Ocultar marcador de Centro de Gravidade | Ocultar o marcador de CoG |
| Visão Explodida | Colocar rótulos de carga ao redor do contêiner, com linhas apontando para a carga |
| Descrição | Uma legenda mostrada com a visão |
Filtragem de carga limita a visão a parte do contêiner, por exemplo, para mostrar o que está carregado na porta:
| Configuração | Descrição |
|---|---|
| Ativar filtro de carga | Ativar o filtro |
| Posição | Qual parte do contêiner: inferior, superior, frontal, traseira, lado 1 ou lado 2 |
| Limite (%) | Até onde a parte do contêiner alcança, como uma porcentagem de seu tamanho (padrão 33%) |
| Modo | Mostrar Apenas oculta a outra carga, Destacar a esmaece |
Imagens do Contêiner
Mostra as fotos anexadas ao contêiner. Você também pode adicionar fotos diretamente do bloco; o número de fotos por contêiner é limitado.
Informações do Contêiner
Mostra o comprimento interno, largura e altura do contêiner, sua carga útil e seu custo.
| Configuração | Descrição |
|---|---|
| Tamanho da Fonte | Tamanho do texto, de XXS a XXL. Padrão: S |
| Mostrar Custo | Incluir a linha de custo, se o contêiner tiver um |
Utilização do Contêiner
Mostra quanto do contêiner é utilizado: volume, peso líquido e espaço livre, e o peso taxável quando um fator de envio é definido. Um aviso aparece quando o peso está próximo do limite.
| Configuração | Descrição |
|---|---|
| Tamanho da Fonte | Tamanho do texto, de XXS a XXL. Padrão: S |
Totais do Contêiner
Mostra o comprimento total, largura e altura da carga carregada e o peso bruto. Se alguma carga estiver fora de medida (OoG), o excesso é listado também.
| Configuração | Descrição |
|---|---|
| Tamanho da Fonte | Tamanho do texto, de XXS a XXL. Padrão: S |
CoG / Eixos
Mostra o centro de gravidade (X, Y e Z) e, para veículos com eixos, os pesos líquidos e brutos dos eixos. Eixos acima do limite são sinalizados.
| Configuração | Descrição |
|---|---|
| Tamanho da Fonte | Tamanho do texto, de XXS a XXL. Padrão: S |
Aviso de OoG
Uma bandeira de aviso que só aparece em contêineres com carga fora de medida.
Instruções
Instruções passo a passo para carregar o contêiner.
| Configuração | Descrição |
|---|---|
| Modo de Carregamento | Por Camadas, Por Pilhas ou Por Propriedade. Pode ser alterado para um único plano de carga nas configurações de visualização |
| Agrupar etapas por | Com Por Propriedade: a propriedade da carga que cada etapa agrupa |
| Tamanho dos Gráficos | Gráficos de etapas pequenos, médios ou grandes |
| Ângulo da Câmera | Ângulo da câmera dos gráficos de etapas. Também usado pelo guia interativo |
| Ocultar Equipamento Secundário | Deixar de fora as etapas para paletes e outros equipamentos secundários |
| Aplanar Equipamento Secundário | Com o acima: listar o conteúdo dos paletes em vez do próprio palete |
| Ocultar marcador de CoG | Ocultar o marcador de centro de gravidade nos gráficos de etapas |
Link do Guia Interativo
Um botão que abre o guia interativo de carregamento para o contêiner, com um código QR opcional para que os trabalhadores possam escanear um plano de carga impresso e abrir o guia em um tablet.
| Configuração | Descrição |
|---|---|
| Texto do Botão | Texto no botão. Padrão: “Abrir guia de carregamento” |
| Modo de Carregamento | Como o guia agrupa as etapas. Padrão do layout segue o bloco de Instruções |
| Ângulo da Câmera | O ângulo da câmera em que o guia é aberto |
| Ocultar contagem de etapas | Ocultar o número de etapas abaixo do botão |
| Mostrar código QR | Mostrar um código QR que abre o guia |
Tabela de Itens
Uma tabela da carga no contêiner.
| Configuração | Descrição |
|---|---|
| Densidade da Tabela | Tamanho e espaçamento da fonte compactos, padrão ou confortáveis |
| Ocultar linha de totais | Deixar de fora a linha de soma na parte inferior |
| Aplanar Itens Aninhados | Listar o conteúdo de paletes e pacotes em uma lista plana em vez de aninhada |
| Adicionar coluna de caixa de seleção | Adicionar uma coluna para marcar a carga conforme é carregada |
| Colunas Visíveis | Quais colunas a tabela mostra |
| Ordem dos Itens | A ordem em que a carga é listada |
| Dimensões Adicionais | Unidades de comprimento e peso extras para mostrar ao lado da própria lista de carga |
Notas do Contêiner
Mostra as notas do contêiner. Nada é mostrado quando o contêiner não tem notas.
Metadados do Contêiner
Mostra os campos de metadados personalizados do contêiner. Os valores podem ser preenchidos diretamente do plano de carga, a menos que esteja bloqueado.
Nas configurações do bloco, selecione quais dos campos de metadados da sua empresa este layout mostra. Editar campos permite adicionar ou alterar os próprios campos.
Blocos Personalizados
Texto Personalizado
Seu próprio texto, escrito em Markdown: títulos, listas, negrito, links, etc.
| Configuração | Descrição |
|---|---|
| Título (opcional) | Um título para o bloco |
| Conteúdo | O texto, em Markdown |
| Envolver em cartão | Mostrar o texto com uma borda e preenchimento |
Espaçador
Adiciona espaço vertical entre blocos.
| Configuração | Descrição |
|---|---|
| Altura (pixels) | Altura do espaçador |
Quebra de Página
Inicia uma nova página neste ponto ao imprimir ou salvar como PDF.
Configurações de Bloco
Para alterar as configurações de um bloco, abra seu menu ⋮ na tela e selecione Configurações.
As alterações se aplicam conforme você as faz. Salvar fecha o diálogo e move o bloco se você alterou sua seção.
Além das configurações específicas do bloco descritas acima, cada bloco tem:
| Configuração | Descrição |
|---|---|
| Colocação da Seção | Cabeçalho, contêiner ou rodapé. Veja Entendendo as Seções |
| Posição X | A coluna em que o bloco começa (0-11) |
| Posição Y | A linha em que o bloco começa |
| Largura | Número de colunas que o bloco abrange (1-12) |
| Altura | Número de linhas que o bloco abrange (1-12) |
Condições de Visibilidade
Condições de visibilidade fazem um bloco aparecer apenas quando é relevante, por exemplo, mostrar o bloco de fotos apenas quando houver fotos.
Adicionando uma Condição
- Abra as Configurações do bloco
- Em Condições de Visibilidade, clique em Adicionar Condição
- Escolha um Campo e o Valor que ele deve ter (Verdadeiro ou Falso)
Um bloco com várias condições só é mostrado quando todas elas são atendidas.
Campos Disponíveis
| Campo | Verdadeiro quando |
|---|---|
| Tem Notas | A lista de carga ou plano de carga tem notas |
| Mostrar Não Carregado no Plano de Carga | A carga não carregada está configurada para ser mostrada no plano de carga |
| Tem Itens Não Carregados | Alguma carga não pôde ser carregada |
| É Primeiro no Conjunto | O contêiner é o primeiro de um conjunto com mais de um contêiner |
| Tem Metadados | O contêiner tem metadados |
| Tem Imagens | O contêiner tem fotos |
| Tem Notas do Contêiner | O contêiner tem notas |
| Modo Simples | O modo simples está ativado |
| Mostrar Fotos | As fotos estão ativadas |
| Aplanar Itens | As tabelas de itens estão aplanadas |
| Mostrar Instruções | As instruções de carregamento estão ativadas, em qualquer modo |
| Mostrar Régua | A régua está ativada para visões 3D |
| Mostrar Marca d’Água | A marca d’água está ativada |
| Agrupar Contêineres Similares | Contêineres idênticos são mostrados juntos |
Modo Simples até Agrupar Contêineres Similares seguem as configurações de visualização do plano de carga, para que um visualizador possa alternar blocos sem alterar o layout.
Exemplos
| Objetivo | Campo | Valor |
|---|---|---|
| Mostrar o bloco de fotos apenas quando houver fotos | Tem Imagens | Verdadeiro |
| Ocultar blocos detalhados no modo simples | Modo Simples | Falso |
| Mostrar uma visão geral do conjunto apenas uma vez por conjunto | É Primeiro no Conjunto | Verdadeiro |
| Mostrar um texto de aviso quando houver carga sobrando | Tem Itens Não Carregados | Verdadeiro |
Gerenciando Layouts
Todos os layouts são gerenciados em Preferências → 4. Plano de Carga → Gerenciar layouts. Cada layout na lista tem ícones para editar, copiar e excluir.
Criando um Layout
- Clique em Novo layout
- Dê um nome (por exemplo, “Layout de Armazém”, “Resumo do Cliente”)
- O novo layout vazio é aberto no construtor
- Adicione e organize blocos
Para começar a partir de um layout existente ou de um modelo, copie-o.
Usando Modelos
Cargo-Planner inclui três modelos: Clássico, que replica o formato tradicional de plano de carga, Simples e Compacto. Os modelos não podem ser editados ou excluídos, mas você pode copiá-los:
- Clique no ícone de cópia ao lado do modelo
- Dê um nome à sua cópia
- A cópia é aberta no construtor, pronta para personalizar
Se você clicar no ícone de lápis na página do plano de carga enquanto um modelo estiver selecionado, será perguntado se deseja Fazer uma cópia ou Visualizar modelo.
Definindo um Layout Padrão
O layout padrão é usado quando você abre um plano de carga. Defina-o em Preferências → 4. Plano de Carga em Layout ativo do plano de carga:
- Padrão da empresa - o layout usado por todos na empresa
- Preferência do usuário - seu próprio padrão, que substitui o padrão da empresa
Escolher um layout no seletor Layout em um plano de carga também o torna sua preferência de usuário.
Editando um Layout
Clique no ícone de edição ao lado do layout na lista ou no ícone de lápis ao lado do seletor Layout em um plano de carga. As alterações são salvas automaticamente.
Copiando um Layout
- Clique no ícone de cópia ao lado do layout ou em Copiar no construtor
- Insira um nome para a cópia
- A cópia é aberta no construtor
Renomeando um Layout
- Abra o layout no construtor
- Clique no ícone de lápis ao lado do nome
- Insira o novo nome e pressione Enter
Excluindo um Layout
- Clique no ícone de exclusão ao lado do layout
- Confirme a exclusão
Modelos (Clássico, Simples e Compacto) não podem ser excluídos.
Avançado: Parâmetros de Consulta
Ao compartilhar ou automatizar links de planos de carga, você pode definir o layout e as configurações de exibição com parâmetros de consulta:
/loadlist/123/loadplan?layout=my-custom-layout&showRuler=true&simpleMode=false| Parâmetro | Valores | Efeito |
|---|---|---|
layout | ID do Layout | Layout a ser usado |
instructions | layers, stacks, by-prop, off | Modo de instruções de carregamento, ou desativar instruções |
simpleMode | true / false | Modo simples |
flatItems | true / false | Aplanar tabelas de itens |
showRuler | true / false | Régua em visões 3D |
showImages | true / false | Fotos do contêiner |
showUnloaded | true / false | Mostrar carga não carregada |
showWatermark | true / false | Marca d’água |
print | Qualquer valor | Mostrar todos os contêineres em uma página, para impressão |
Isso é útil para:
- Geração automatizada de PDF via API
- Compartilhamento de links com configurações de exibição específicas
- URLs de modelo para formatação consistente
Dicas Gerais
- Comece com um modelo - Copie Clássico, Simples ou Compacto em vez de começar vazio
- Crie múltiplos layouts - Diferentes públicos precisam de informações diferentes
- Nomeie layouts claramente - Use nomes descritivos como “Armazém - Detalhado” ou “Cliente - Resumo”
- Mantenha simples - Não sobrecarregue o leitor com informações
- Verifique a impressão - Teste como o layout fica quando impresso ou salvo como PDF
Solução de Problemas
Bloco Não Exibido
Verifique se:
- O bloco tem condições de visibilidade que não são atendidas (procure o rótulo Condicional)
- O bloco não tem nada para mostrar, por exemplo, um bloco de notas quando não há notas, ou o aviso de OoG quando nenhuma carga está fora de medida
- O bloco está na seção que você espera (Cabeçalho, Contêiner ou Rodapé)
Bloco Desapareceu Após Movê-lo
Blocos de Contêiner e de Conjunto só funcionam na seção Contêiner. Se você mover um para o Cabeçalho ou Rodapé, ele é removido e um aviso é mostrado.
Não Consigo Editar um Modelo
Modelos (Clássico, Simples e Compacto) são somente leitura. Copie o modelo e edite sua cópia. Veja Usando Modelos.
Documentação Relacionada
- Configurações de visualização do plano de carga - Opções de exibição temporárias
- Compartilhamento de plano de carga - Compartilhe planos de carga com clientes
- Criando um plano de carga - Tutorial de introdução