Página de Pedidos

A página Pedidos é a lista mestra de cada pedido de cliente em seu Board. Onde a página Trabalhos rastreia produtos individuais sendo fabricados, a página Pedidos rastreia os clientes e pedidos aos quais esses produtos pertencem — informações de contato, endereços de cobrança/entrega, datas de pedido, datas de entrega, valores totais e a origem da qual o pedido veio (entrada manual, Shopify, WooCommerce, API etc.).

Cada pedido neste sistema representa um pedido de cliente — tipicamente com um único cliente, um ou mais trabalhos (produtos) e um total a nível de pedido. Abra a página pela barra lateral principal (Pedidos) ou navegando para /orders.

Página de Pedidos

Nota sobre terminologia: internamente este recurso também é chamado de “cliente/projeto” — você verá essa redação em alguns painéis e formulários. Na interface e neste documento, usamos Pedido de forma consistente.

Sumário

Para que serve esta página
Anatomia da página
Buscando e ordenando
Visibilidade e ordem de colunas
Adicionando um novo pedido
Editando um pedido — o painel de Pedido
Ações de linha
Origens de pedidos
Vinculando uma Cotação a um pedido
Excluindo um pedido
Como Pedidos se relacionam com Trabalhos e Produção
Personalizando a página de Pedidos
Dicas e melhores práticas

Para que serve esta página

A página de Pedidos responde a estas perguntas:

Quem são nossos clientes? — cada cliente com pelo menos um pedido no sistema.
O que cada um pediu? — detalhe em um pedido para ver a lista de trabalhos (produtos) anexados a ele.
De onde veio o pedido? — entrada manual, uma loja de e-commerce, uma integração de API, uma importação CSV…
O que está pendente e quando? — datas de pedido e datas de entrega aparecem naturalmente na lista.
Como entramos em contato com eles? — e-mail, telefone, empresa, endereços de cobrança/entrega, mais qualquer número de contatos adicionais por pedido.
Qual é nosso link público para compartilhar com eles? — cada pedido tem um link de rastreamento do Portal do Cliente.

Use-a como:

Um CRM-leve para todos que compraram de você.
Um centro de comando para um pedido específico — abra-o, veja os trabalhos, pule para produção, imprima etiquetas.
Uma fonte de verdade para integrações upstream — pedidos sincronizados do Shopify/WooCommerce/etc. todos terminam aqui.

Anatomia da página

Ao longo da barra de ferramentas superior, da esquerda para a direita:

Caixa de busca — busca de texto livre em nome, núm ref, e-mail, telefone, empresa, ID externo e origem.
Seletor por página — 5, 10, 25, 50 ou 100 pedidos por página.
Configurações de coluna (ícone de engrenagem) — alterna visibilidade de colunas e reordena colunas.
Adicionar Pedido — cria um novo pedido.

Abaixo da barra de ferramentas fica a tabela de pedidos. Cada linha é um pedido. Clicar em qualquer lugar da linha (exceto nos ícones de ação) abre o painel de Pedido em modo de edição.

Na parte inferior da página fica a paginação com um contador Mostrando X a Y de Z resultados.

Buscando e ordenando

Busca

Digite na caixa de busca no canto superior esquerdo. A consulta corresponde a:

Nome (o nome do pedido/cliente)
Número do Pedido (ref_no)
E-mail
Telefone
Empresa
ID Externo
Origem

A busca não diferencia maiúsculas/minúsculas e usa correspondência de contém. A lista atualiza cerca de 300 ms após você parar de digitar, e a consulta é refletida na URL para que uma visualização filtrada possa ser favoritada ou compartilhada.

Ordenação

Clique em qualquer cabeçalho de coluna ordenável para ordenar por essa coluna. O ícone de seta mostra a direção atual; clicar no mesmo cabeçalho novamente inverte ascendente ↔ descendente.

Colunas ordenáveis: Núm Pedido, Data do Pedido, ID Externo, Origem, Valor Total, Data de Entrega. Outras colunas (Nome, Empresa, E-mail, Telefone, Ações) não são ordenáveis.

A ordenação padrão é criado mais recentemente primeiro.

Visibilidade e ordem de colunas

Clique no ícone de engrenagem na barra de ferramentas para abrir o popover de colunas. Você pode:

Ocultar uma coluna — clique em sua linha para alternar a visibilidade. Colunas ocultas desaparecem da tabela imediatamente.
Reordenar colunas — arraste o cabo de pegada à esquerda de cada linha.
Restaurar — restaura o layout padrão.

Algumas colunas são sempre visíveis (Nome, Ações) e não podem ser ocultadas — elas ficam acinzentadas no popover.

Colunas disponíveis:

Núm Pedido
Nome do Cliente (sempre visível)
Empresa
E-mail
Telefone
Data do Pedido
ID Externo
Origem
Valor Total (formatado em moeda)
Data de Entrega
Ações (sempre visível)

A visibilidade e ordem são salvas por navegador — cada usuário pode moldar seu próprio layout independentemente.

Adicionando um novo pedido

Clique em Adicionar Pedido no canto superior direito. O painel de Pedido abre em modo de criação na aba Geral.

No mínimo, você precisa fornecer um Nome do Cliente. Todo o resto é opcional:

Número do Pedido (ref_no) — sua referência para este pedido. Frequentemente gerado automaticamente para novos pedidos.
Nome do Cliente, E-mail, Telefone, Empresa
País, Endereço de Cobrança, Endereço de Entrega
Data do Pedido, Data de Entrega
ID Externo e Origem — usados para amarrar este pedido a um sistema upstream. Mais útil quando integrações criam pedidos automaticamente.
Valor Total — o total monetário do pedido.
Cotação Relacionada (opcional) — vincule uma cotação existente a este pedido (veja Vinculando uma Cotação).

Clique em Salvar para criar o pedido. O painel muda para modo de edição e as abas Contatos e Trabalhos ficam disponíveis.

Editando um pedido — o painel de Pedido

Clique em qualquer linha da tabela para abrir o painel de Pedido em modo de edição. O painel tem três abas:

Aba Geral

O formulário completo de pedido — cada campo listado em Adicionando um novo pedido está aqui. Atualize o que precisar e clique em Salvar. O cabeçalho também mostra os timestamps Criado Em e Atualizado Em do pedido para referência.

Se o pedido tem um token de rastreamento (cada pedido recebe um automaticamente), um link de Portal do Cliente está disponível no cabeçalho do painel para que você possa copiar uma URL compartilhável para dar ao cliente.

Aba Contatos

Uma lista de pessoas adicionais associadas a este pedido — útil quando um pedido tem mais de um interessado (por exemplo, contato principal, contato de cobrança, gerente de projeto). Para cada contato você pode capturar:

Primeiro Nome
Sobrenome
E-mail
Telefone

Use Adicionar Contato para criar um, o ícone de lápis para editar e o ícone de lixeira para excluir (com confirmação). O título da aba mostra a contagem de contatos em um relance.

Aba Trabalhos

Uma lista somente leitura de cada trabalho (produto) anexado a este pedido, com cada trabalho:

Núm Ref
Nome
Quantidade
Data de entrega

Clique em um trabalho para pular para seu registro completo na página Trabalhos. Esta aba é a maneira mais fácil de ver “tudo que precisa ser feito para este pedido” sem sair do contexto do pedido.

O título da aba mostra a contagem de trabalhos.

Ações de linha

Cada linha de pedido tem um agrupamento de botões de ícone na coluna Ações à direita.

Link do Portal do Cliente

O ícone link-externo aparece quando o pedido tem um token de rastreamento (cada pedido recebe um quando criado). Clicar nele abre o Portal do Cliente em uma nova aba — uma página pública e somente leitura que o cliente pode usar para rastrear o progresso de seu pedido pela sua fábrica. A página mostra:

Logotipo e informações da empresa no topo
A lista de trabalhos no pedido
Para cada trabalho, um indicador de progresso passo a passo pelos seus departamentos (completo / em andamento / pendente / não aplicável)
A data de entrega do pedido e quaisquer outros campos relevantes
Opcionalmente um parâmetro de URL ?theme=dark para um tema escuro

O portal se atualiza automaticamente a cada dois minutos para que o cliente veja o status atualizado sem recarregar.

Você pode colar a URL do portal em e-mails, dashboards voltados para o cliente ou faturas para dar aos clientes uma visão de autoatendimento de onde seu pedido está.

Ver em Produção

O ícone folder-kanban abre a página Produção em uma nova aba pré-filtrada para o Núm Ref deste pedido — útil para pular rapidamente de “o cliente quer uma atualização” para “o que está realmente acontecendo no chão de fábrica para eles”.

Imprimir etiquetas

O ícone impressora abre o diálogo Imprimir Etiquetas para este pedido. O diálogo lista cada trabalho no pedido com uma entrada Cópias ao lado — pré-preenchida com a quantidade do trabalho. Ajuste as contagens de cópias (0 a 500 por trabalho) e clique em Imprimir etiquetas para gerar um PDF de etiquetas de código de barras de múltiplas páginas em uma nova aba.

Usos comuns:

Imprimir exatamente uma etiqueta por peça física (comportamento padrão).
Imprimir uma etiqueta mestra por trabalho (defina cópias como 1).
Pule trabalhos que você já etiquetou (defina cópias como 0).

O conteúdo e layout da etiqueta são configurados em Configurações do aplicativo → Etiqueta.

Editar

O ícone lápis (ou clicar em qualquer outro lugar da linha) abre o painel de Pedido em modo de edição.

Origens de pedidos

Cada pedido tem uma Origem que identifica como entrou no sistema. Existem dois tipos:

Origens do sistema

Embutidas no produto:

Manual — criado por um usuário via o botão Adicionar Pedido.
WooCommerce
Shopify
PrestaShop
Magento
OpenCart
CSV — importado de uma planilha (via o importador da página de Trabalhos).
API — criado por uma chamada à API pública.

As origens do sistema têm chaves previsíveis (manual, shopify, api, …) — esses são os valores que você verá no filtro de origem nos Webhooks, no importador CSV e em lugares similares.

Origens personalizadas

Definidas em Configurações do aplicativo → Origens de Pedidos, com seu próprio nome, chave, cor e ordenação. Útil quando você tem outros canais de entrada (pedidos por telefone, integrações de marketplace, um sistema personalizado, …) e quer que apareçam distintamente em relatórios e filtros.

A origem é mostrada na coluna Origem na página de Pedidos e também é usada para definir o escopo de webhooks (veja Webhooks) — por exemplo, você pode configurar um alerta do Slack que só dispara para pedidos com origem no Shopify.

Vinculando uma Cotação a um pedido

Se o seu Board inclui o módulo de Cotações, a aba Geral tem um campo Cotação Relacionada. Digite pelo menos dois caracteres na busca para escolher dentre cotações existentes.

Quando vinculado:

A cotação e o pedido são unidos um-para-um.
O pedido herda algum contexto (assunto, info do cliente, total geral) da cotação.
Você pode navegar do pedido de volta para a cotação.

Cada cotação pode ser vinculada a no máximo um pedido — se uma cotação já está vinculada em outro lugar, não aparecerá nos resultados de busca.

Para desvincular, limpe o campo e salve.

Excluindo um pedido

Abra o pedido no painel de Pedido, então clique em Excluir no rodapé. Um diálogo de confirmação avisará que todos os contatos também serão excluídos.

O que é e o que não é cascateado na exclusão:

Excluído: o próprio pedido, todos os seus contatos, o token público de rastreamento.
Não excluído: trabalhos que estavam anexados a este pedido. Aqueles se tornam trabalhos “órfãos” (sem pedido pai), mas seus dados de produção, registros de tempo, desenhos etc. permanecem intactos.

A exclusão é permanente — não há lixeira. Se você quiser apenas ocultar um pedido concluído, considere arquivar em vez disso no nível do trabalho.

Como Pedidos se relacionam com Trabalhos e Produção

Ajuda manter o modelo de dados em mente:

Pedido ─┬─ Trabalho 1 ─── Etapas de estação de trabalho, registros, desenhos, controle de tempo
        ├─ Trabalho 2 ─── …
        └─ Trabalho N ─── …

Pedido = um pedido de cliente (esta página)
Trabalho = um produto/item sendo fabricado (Trabalhos)
Etapas de estação de trabalho sob cada trabalho = o fluxo do chão de fábrica (Produção)

Então se você tem um único pedido para 3 cadeiras e 2 mesas:

1 linha na página Pedidos (o pedido).
5 linhas na página Trabalhos (uma por linha de produto — embora tipicamente agrupados por SKU em 2 ou 5 trabalhos dependendo de como você modela).
Cada trabalho aparece como cartões em várias colunas de estação de trabalho no kanban de Produção.

A mesma combinação de ID externo + origem é o que permite que importações e integrações anexem trabalhos a pedidos existentes em vez de criar duplicatas — veja a seção de importação CSV em Trabalhos.

Personalizando a página de Pedidos

Parte do que a página de Pedidos exibe é configurado em outros lugares:

Para alterar…	Vá para…
Origens de Pedidos disponíveis (origens personalizadas, cores, ordenação)	Configurações do aplicativo → Origens de Pedidos
Moeda usada para formatação do Valor Total	Configurações do aplicativo → Geral
Layout de etiqueta (usado por Imprimir Etiquetas)	Configurações do aplicativo → Etiqueta
Informações da empresa no Portal do Cliente (logotipo, nome, contato)	Configurações do aplicativo → Geral
Notificações e webhooks vinculados a eventos de pedidos	Configurações do aplicativo → Webhooks (docs)
Renomear “Pedidos” na barra lateral	Configurações do aplicativo → Nomenclatura

As mudanças têm efeito imediato na página de Pedidos — sem necessidade de atualização.

Dicas e melhores práticas

Use a busca amplamente. Como ela cobre Nome, E-mail, Telefone, Empresa, ID Externo e Origem, você pode encontrar um pedido por quase qualquer pedaço de informação que o cliente fornecer.
Sempre preencha Data do Pedido e Data de Entrega — elas conduzem a ordenação, os filtros de data do quadro de Produção e a exibição do Portal do Cliente.
Defina o par ID Externo + Origem ao importar ou integrar. Esse par é a chave que o sistema usa para detectar duplicatas em importações subsequentes.
Entregue o link do Portal do Cliente aos clientes em vez de atender perguntas “onde está meu pedido?”. Ele se atualiza automaticamente e reflete o estado de produção ao vivo.
Use Ver em Produção como uma resposta de um clique quando um cliente ligar perguntando sobre seu pedido — você vai direto da linha do pedido para o kanban filtrado para a referência dele.
Imprima etiquetas em massa por pedido em vez de por trabalho — o diálogo Imprimir Etiquetas permite que você defina cópias por linha em um só lugar.
Combine com Webhooks para encaminhar eventos a nível de pedido para Slack, Teams, um ERP ou sua própria automação — veja Webhooks.
Recorte colunas para sua função. Um vendedor pode manter E-mail/Telefone/Empresa visíveis; um planejador pode preferir Data do Pedido/Data de Entrega/Valor Total em vez disso.