TREINAMENTO · IMPLANTAÇÃO DE PEDIDOS

Manual de Implantação de Pedidos

Todo pedido nasce no Gestão — antes mesmo de existir um XML do Promob. O ambiente é criado lá, o cartão já aparece no Kanban do PCP e a equipe começa a trabalhar (inclusive a conferência/Liberação). Quando o arquivo do Promob chega, ele encaixa no que já existe — sem duplicar o pedido e sem perder o que já foi feito.

Onde começaMenu Gestão

Onde continuaPCP → Kanban de Produção

Quem usaComercial/Gestor abre no Gestão · PCP trabalha o cartão · quem importa vincula o XML

Por que tudo começa no Gestão

No fluxo tradicional, um pedido só existe no sistema depois que o XML do Promob é importado. Na prática, porém, o ambiente já é assunto comercial/técnico bem antes de o Promob gerar esse arquivo — e enquanto isso, ninguém no PCP enxergava o que estava represado esperando liberação.

Por isso a regra passou a ser: o pedido é implantado primeiro no Gestão. O cliente e o ambiente nascem lá, o cartão já aparece no Kanban do PCP (mesmo vazio, sem peça nenhuma), e só depois — quando o Promob mandar o arquivo de verdade — ele é vinculado ao cartão que já existe.

Gestão: cliente→Gestão: ambiente→Cartão no Kanban PCP→Vincular XML→Pedido completo

O ganho principal é visibilidade: o PCP vê e trabalha o ambiente (prazo, responsável, conferência) antes de o pedido "nascer" oficialmente — e quando o XML chega, não corre o risco de virar um pedido duplicado.

Passo 1 — Criar o cliente

No menu Gestão, botão + Novo projeto. O nome é o nome do cliente (padrão Heritage). Esse é o projeto-pai — ainda não é onde a opção de Kanban aparece.

A opção de já entrar no Kanban só existe no ambiente (subprojeto), não no cliente. Se de algum jeito ela fosse marcada no nível do cliente, o backend ignora silenciosamente — nenhum cartão é criado. Sempre desça um nível antes.

Passo 2 — Criar o ambiente, já no Kanban

Dentro do cliente aberto, botão + Novo ambiente. O modal pede:

Nome do ambiente (ex.: "Cozinha", "Suíte Master").
A caixinha "Já aparece no Kanban do PCP (antes do XML existir)".

"Cria um cartão vazio no PCP — dá visibilidade de quem está esperando liberação antes de o pedido nascer."

Marque quando a equipe já vai trabalhar esse ambiente antes do XML (ex.: já dá pra conferir/liberar). Deixe desmarcado se o ambiente ainda é só uma anotação comercial, sem produção prevista tão cedo — nesse caso ele fica só organizado no Gestão, sem virar cartão.

Marcando a caixinha, o ambiente já ganha um número de pedido de verdade (sequencial do cliente/tenant), mesmo sem nenhuma peça — a numeração não pula quando o XML chegar depois.

O cartão nasce sem pedido

Ao confirmar com a caixinha marcada, o sistema cria um pedido "vazio" (0 peças), com uma chave interna temporária (SEMPEDIDO-…), e o coloca direto como Liberado — não existe XML do cliente pra travar em Bloqueado. Ele entra automaticamente na 1ª etapa do pipeline do Kanban.

As etapas padrão do Kanban de Produção (criadas na primeira vez que o tenant abre o PCP) são:

Ordem	Etapa	O que costuma significar
1	Comercial	Ambiente acabou de nascer — é aqui que o cartão sem XML entra
2	Medição	Conferência de medidas antes de seguir
3	Liberação	Conferência final do projeto — normalmente a etapa que "conta R$" por liberador
4	Corte	Peças cortadas (chapa)
5	Borda	Fita de borda aplicada
6	Marcenaria	Montagem/acabamento
7	Carregamento	Pronto pra expedir

Nome e ordem das etapas são configuráveis por tenant (botão ⚙ Etapas no PCP) — não é fixo no código. A etapa que soma valor por liberador é a que estiver marcada contabilizaVenda ("conta R$"), normalmente a "Liberação" na Heritage, mas pode ter outro nome em outra marcenaria.

O cartão anda mesmo sem XML

Com o cartão já no Kanban, a equipe trabalha normalmente: abre o cartão, define prazo e responsável por etapa, deixa notas, arrasta pra próxima coluna — tudo isso sem nenhuma peça dentro dele ainda.

É esse o caso real que motivou o recurso: a conferência ("Liberação") de um ambiente às vezes acontece antes de o Promob gerar o XML. Sem esse fluxo, ninguém tinha onde registrar isso.

Se a etapa que "conta R$" fechar sem peça nenhuma ainda, o valor de venda fica pendente (não dá pra calcular Custo×Venda sem itens) — assim que o XML for vinculado (próximo passo), o valor pode ser recalculado pelo botão 🔄 Recalcular na aba PCP → Liberações.

Quando o XML chega: Vincular XML

Abra o cartão no Kanban. Enquanto ele estiver vazio (0 peças), aparece o botão 📎 Vincular XML — ele some assim que o cartão ganha a 1ª peça, então essa ação só existe nessa janela.

Ao escolher o arquivo, o sistema confirma:

"Vincular '{arquivo}' a este cartão? As peças do XML entram aqui, preservando as etapas já concluídas (inclusive Liberação)."

O que acontece ao confirmar:

As peças do XML entram neste cartão — não cria um pedido novo.
Nome e cliente são atualizados para o dado real do Promob.
Número do pedido e tudo que já foi feito no Kanban (prazos, responsáveis, notas, e qualquer etapa já concluída — inclusive uma Liberação feita antes do XML existir) são preservados.

Depois de vincular, a chave interna deixa de ser SEMPEDIDO-… e passa a ser a chave normal do Promob. Se esse mesmo XML for reimportado no futuro, ele já casa sozinho com este pedido — sem risco de duplicar.

Se o XML chegar antes

Nem sempre dá pra abrir o ambiente no Gestão antes de o Promob mandar o arquivo. Quando o XML chega primeiro, segue o fluxo tradicional de importação (ver Manual de Importação de Pedido) — e, depois, esse pedido pode ser aberto dentro do Gestão pela aba Pedidos, botão 🗂:

Modo automático — cria o cliente e o ambiente no Gestão a partir do pedido já importado.
Modo "vincular" — liga o pedido a um ambiente do Gestão que já existe, mas que ainda não tinha dono.

É o caminho inverso do "Vincular XML": aqui o pedido já existe e ganha uma casa no Gestão, em vez de o ambiente já existir e ganhar as peças depois.

A política combinada é sempre começar pelo Gestão (passos 1-6 deste manual). Esse caminho inverso é só pra quando a ordem não deu pra seguir — não é o padrão.

Checklist do fluxo completo

Cliente criado no Gestão (projeto-pai)
Ambiente criado como subprojeto (nível certo pra opção de Kanban aparecer)
Caixinha "Já aparece no Kanban do PCP" marcada, se a produção/conferência já vai começar
Cartão conferido no Kanban — coluna "Comercial", pedido já numerado
Equipe trabalha o cartão normalmente (prazo, responsável, notas, mover de etapa) mesmo sem peça
XML do Promob chegou → abrir o cartão → 📎 Vincular XML → confirmar
Conferir: peças entraram, nome/cliente bateram com o Promob, etapas já feitas (ex. Liberação) não foram perdidas