Guia Rápido AT — Cheat Sheet 1 página

Versão 3.0 — Maio 2026. Para Bitrix24 pós Sprint #8 (Híbrido Company+SPA, NA-005 automático, RAS digital, 7 e-mails).

Qual categoria usar?

Demanda	Categoria	Onde

|---------|-----------|------| | PDV com instalação por conta do fabricante | Instalação (22) | Automação → AT → Instalação | | Cliente reclamou defeito ou pediu preventiva | Manutenção (24) | Automação → AT → Manutenção | | Pré-visita para avaliação técnica | Vistoria (26) | Automação → AT → Vistoria | | Dúvida ou suporte sem visita | Help Desk (28) | Automação → AT → Help Desk | | Venda de peça avulsa | Peças (38) | Automação → AT → Peças | | Reclamação SAC/Devolução/Reclamação formal | SPA Reclamações (1090) | Automação → AT → Reclamações |

Fluxo Instalação (cat 22) — em 8 estágios

PDV Recebido
   ↓ (Stage Gate: OsNum, Empresa, Cliente, Produto, Subgrupo, Ns, TipoOcorrencia, Canal, NatServico, Descricao)
Triagem Técnica
   ↓ (Stage Gate: Autorizada, Atendente, Prioridade, Severidade, StatusGar, Origem)
AT Alocada — Aguarda Aceite      ← E-mail 1 (Solicitação) → AT Autorizada + RAS link + PDF Manual
   ↓
Aguarda Entrega ao Cliente       ← E-mail 2 (Apresentação AT) → Cliente
                                    E-mail 4 (Envio OS) → AT
   ↓
Em Instalação                    ← E-mail 3 (Embarque) + E-mail 5 (Entrega)
   ↓ (Stage Gate: Setor, Ambiente)
RAS Recebido + Aceite            ← AT preenche form HMAC; webhook popula campos automaticamente
   ↓ (Stage Gate: CausaRaiz, Sintomas, Servicos, Liberado, RasOk, RasArq, NotaAt)
Processo Financeiro              ← E-mail 6 (Solicitação Compra) → Compras
   ↓ (Stage Gate: VlrServico, CustoTotal, FatLib)
Encerrado                        ← E-mail 7 (Autorização Faturamento) → Financeiro
   ↓ (Stage Gate: NfeOk, NfeDado)

Ações principais por estágio

No estágio	Você precisa fazer

|-----------|---------------------| | PDV Recebido | Confirmar dados de cliente e produto | | Triagem Técnica | Escolher AT Autorizada + atendente + classificar prioridade/severidade | | AT Alocada | Aguardar resposta da AT (E-mail 1 já saiu automaticamente) | | Aguarda Entrega | Acompanhar logística — BackOffice cuida | | Em Instalação | Preencher Setor + Ambiente; AT está com o equipamento no cliente | | RAS Recebido | Avaliar nota da AT; conferir RAS preenchido (checklist em checklist-validacao-ras.html) | | Processo Financeiro | Validar Valor Serviço; aprovar Faturamento | | Encerrado | Confirmar NFe emitida |

NA-005 — preencher e o sistema calcula

Campo	Valor base

|-------|-----------| | Horas | R$ 180,00 / hora | | KM Urbano | R$ 2,80 / km | | KM Rodoviário | R$ 1,80 / km | | Diárias | R$ 220,00 / diária | | Pedágio | valor real | | Valor Instalação | R$ 180 a R$ 810 (tabela por equipamento) |

Cálculo: (horas × 180) + (kmU × 2,80) + (kmR × 1,80) + (diárias × 220) + pedágio + instalação.

Em até 60 segundos o Valor do Serviço aparece automaticamente.

Atalhos comuns

Criar OS rápida — botão + no topo do pipeline
Filtrar OSs do dia — filtro >=createdTime: hoje
Buscar AT por UF de atendimento — Empresas → filtro TYPE_ID=AT Autorizada + UF
Imprimir card — 3 pontinhos → Imprimir
Modo escuro — botão "Tema" no canto superior direito

Cadastrar AT Autorizada (modelo Híbrido)

CRM → Empresas → + Adicionar com TYPE_ID = AT Autorizada
Preencher dados nativos (CNPJ, endereço, e-mail principal)
Preencher UFs AT — (cobertura, famílias, bancário, contato técnico)
Automação → AT → Qualificação AT → + Item: vincular Company recém-criada, preencher IQS + treinamentos + anexar Acordo Qualidade (FO-025)

Cadastrar Representante

CRM → Empresas → + Adicionar com TYPE_ID = Representante
Preencher UFs Rep — (UF atuação, % Comissão, Status, datas, linhas)
Se for também AT executora, marcar Tem AT própria = Sim + preencher UFs AT —

Quando dá erro

Mensagem	Causa	Solução

|----------|-------|---------| | "Para mover para X, preencha A, B, C" | Stage Gate v2 — campos required | Preenche os listados | | "Token inválido" no RAS form | Link copiado errado | Use o link do E-mail 1 | | E-mail não chegou | Verificar caixa de spam | Avisar gestão se persistir | | Valor Serviço não calculou | Aguarde 60s (cron 1min) | Refresh do card |

Salk Medical — Guia Rápido AT v3.0 — Maio 2026