Este é o aceite comum entre Vendelo, consultoria e cliente. Cada item tem um teste concreto e um resultado esperado. A regra é simples: item que não foi testado não está pronto, mesmo que esteja configurado. Percorra a lista com o cliente presente e registre o resultado; o que ficar em aberto vira pendência com responsável e data, não observação.
Índice
Como usar este checklist
- Rode em ambiente de homologação, com massa parecida com a real.
- Cada item tem um teste. Execute o teste, não pergunte se está configurado.
- Registre o resultado com data e responsável.
- Itens marcados como bloqueantes impedem a entrada em produção.
Reserve meio dia com o cliente presente. Checklist assinado à distância, sem alguém do cliente vendo a tela, é a origem clássica de discussão depois do go-live.
1. Ambiente e instalação
| Item | Teste | Esperado |
|---|---|---|
| Serviço dedicado responde Bloqueante | Verificar a conexão com a credencial da integração | Resposta positiva, indicando empresa e filial |
| Filial principal correta Bloqueante | Conferir a filial informada na verificação | É a filial que será a padrão do Vendelo |
| Estrutura da integração criada Bloqueante | Executar a preparação da estrutura | Resultado confirmando que ficou completa |
| Agente de impressão presente | Solicitar um PDF pelo Vendelo | PDF gerado, sem erro de agente no console |
| Campo da solicitação de compra | Conferir o resultado da preparação | Identificação do solicitante pronta |
| Artefatos de homologação fora de produção Bloqueante | Tentar usar cada recurso exclusivo de homologação | Todos indisponíveis |
2. Segurança
| Item | Teste | Esperado |
|---|---|---|
| HTTPS em produção Bloqueante | Conferir o endereço configurado | Começa com https:// |
| Certificado verificado Bloqueante | Conferir a configuração de certificado | Aceitação irrestrita desligada, ou impressão digital preenchida |
| Certificado diferente interrompe | Apresentar certificado diverso do esperado | A integração falha, não segue |
| Acesso restrito por rede Bloqueante | Tentar alcançar o serviço de fora do caminho aprovado | Recusado |
| Usuário Protheus dedicado | Conferir qual usuário está configurado | Usuário criado para a integração, não login de pessoa |
| Credencial fora do repositório Bloqueante | Conferir onde a senha está armazenada | Em secret ou variável protegida |
| Consulta recusa escrita Bloqueante | Tentar alterar dados por consulta, e encadear comandos | Todas as tentativas recusadas |
| Log verboso desligado | Conferir a configuração de log | Desligado por padrão |
| Download de logs restrito | Tentar baixar com usuário sem permissão | Recusado pelo servidor |
3. Carga inicial
| Item | Teste | Esperado |
|---|---|---|
| Carga executada em janela combinada | Registrar horário de início e fim | Fora do horário de uso |
| Todos os grupos concluídos Bloqueante | Filtrar a fila pelas entradas de carga | Status Sincronizado |
| Volume conferido | Comparar contagens entre ERP e Vendelo | Diferenças explicadas, não ignoradas |
| Erros da carga tratados | Filtrar a fila por erro | Cada erro com causa identificada e resolvida |
| Tempo medido | Usar as datas de criação e atualização | Número registrado, para dimensionar futuras cargas |
4. Cadastros
| Item | Teste | Esperado |
|---|---|---|
| Cliente alterado no ERP reflete | Alterar um cliente no Protheus e aguardar | Alteração aparece no Vendelo |
| Cliente criado no Vendelo chega ao ERP Bloqueante | Criar cliente pelo aplicativo | Cadastro criado no Protheus, com loja e tipo corretos |
| Produto com preço e estoque | Abrir um produto no catálogo | Preço da lista correta e saldo do ERP |
| Imagem do produto | Abrir um produto com foto no ERP | Foto exibida, se a importação estiver habilitada |
| Campos de usuário circulam | Preencher um campo de usuário nos dois lados | Valor aparece do outro lado |
| Exclusão lógica reflete | Inativar um cadastro no ERP | Situação refletida no Vendelo |
5. Ciclo do pedido
| Item | Teste | Esperado |
|---|---|---|
| Pedido criado no Vendelo Bloqueante | Fechar um pedido pelo aplicativo | Pedido gravado no Protheus com número do ERP visível no Vendelo |
| Impostos calculados pelo ERP | Conferir o total do pedido | Valores batem com o cálculo do Protheus |
| Alteração de pedido integrado | Alterar quantidade e reenviar | Alteração refletida no ERP |
| Pedido criado no ERP reflete | Digitar um pedido no Protheus | Documento aparece no Vendelo |
| Liberação e faturamento | Liberar e faturar no ERP | Situação acompanhada no Vendelo |
| Nota fiscal reflete | Emitir a nota | Documento aparece no Vendelo |
| DANFE | Abrir a DANFE pelo aplicativo | PDF real, ou aviso de recurso indisponível se a rotina do cliente não existir |
| Diferença entre cancelar e encerrar Bloqueante | Cancelar um pedido e encerrar outro | Cancelado some das telas e consultas do Protheus; encerrado permanece visível |
| Devolução reflete | Registrar devolução no ERP | Documento aparece no Vendelo |
Teste cancelar e encerrar com o cliente vendo a tela. É a diferença que mais gera reclamação depois do go-live, e ver o pedido sumir do Protheus explica melhor do que qualquer treinamento.
6. Financeiro
| Item | Teste | Esperado |
|---|---|---|
| Situação financeira do cliente | Abrir a tela financeira de um cliente com títulos | Limite, títulos, parcelas e vencidos do ERP |
| Boleto | Solicitar boleto de um título elegível | PDF real, ou aviso de recurso indisponível se a rotina do cliente não existir |
| Adiantamento de pedido pago | Concluir um pagamento | Título de adiantamento criado, se configurado |
| Tarifa do gateway | Conferir o lançamento | Título a pagar. O modo lançamento contábil não é suportado. |
| Faturamento automático | Se habilitado, concluir um pagamento | Nota emitida, com a série configurada |
| Cancelamento de pedido pago | Cancelar um pedido já pago | Estorno completo, ou recusa clara pedindo tratamento no ERP |
7. Multi-filial
| Item | Teste | Esperado |
|---|---|---|
| Filiais reconhecidas | Conferir a lista de filiais no Vendelo | Todas as filiais que vão operar |
| Cadastros exclusivos por filial Bloqueante | Conferir condição de pagamento, conta corrente, natureza, TES e armazém em cada filial | Existentes em todas |
| Pedido em filial não principal | Emitir pedido em outra filial | Gravado corretamente |
| Faturamento em filial não principal | Faturar nessa filial | Nota emitida, sem erro de licença |
| Licença TOTVS por CNPJ Bloqueante | Conferir licença de cada filial | Todas licenciadas |
8. Usuários, carteiras e licenças
| Item | Teste | Esperado |
|---|---|---|
| Vendedores importados | Conferir a lista de vendedores no Vendelo | Correspondem aos do Protheus |
| Vínculo por e-mail | Conferir o vínculo de cada vendedor com a pessoa | Vínculo correto antes de liberar o acesso |
| Carteiras de clientes | Entrar como vendedor | Vê apenas a carteira dele |
| Licença ativa Bloqueante | Conferir licença de cada usuário que vai operar | Todos com licença |
| Usuário do fluxo automatizado | Conferir a licença do usuário configurado nas automações | Licença ativa |
| Perfis de permissão | Entrar com cada perfil | Acesso conforme o combinado, inclusive à fila de integração |
9. Comportamento em falha
| Item | Teste | Esperado |
|---|---|---|
| Integração parada acumula | Parar o serviço REST, alterar cadastros, religar | Nada se perde; tudo é processado depois |
| Objeto da integração derrubado é recriado | Derrubar um objeto e aguardar a verificação automática | Reconstruído sozinho |
| Erro isolado por registro | Provocar erro em um registro de um lote | Os demais seguem; só o afetado fica em erro |
| Mensagem de erro compreensível | Ler a descrição de itens em erro | Aponta a causa, não só um código |
| Reprocessamento após correção | Corrigir a causa e reenfileirar | Item conclui |
| Equipe sabe o risco do reprocesso | Perguntar ao responsável pelo suporte | Sabe conferir a origem antes de reenfileirar uma inclusão que falhou por comunicação |
10. Preparação da operação
| Item | Esperado |
|---|---|
| Responsável pelo acompanhamento diário da fila | Nome definido |
| Caminho de escalonamento para a Vendelo | Combinado e documentado |
| Procedimento de rotação da credencial | Definido |
| Renovação de certificado inclui atualizar a impressão digital | No procedimento do cliente |
| Equipe treinada na diferença entre cancelar e encerrar | Treinamento realizado |
| Equipe sabe onde cada dado é editado | Treinamento realizado |
| Limitações conhecidas comunicadas ao cliente | Registrado |
| Janela e responsável para recargas futuras | Combinado |
Termo de aceite
O aceite é registrado pelo formulário abaixo, ao final do checklist e com o cliente presente. O envio confirma o aceite por e-mail para suporte@vendelo.com.br, com os participantes de cada lado (consultor Vendelo, consultoria de implantação e responsável do cliente), os blocos aprovados, as pendências com responsável e prazo, e a decisão sobre eventuais itens bloqueantes.
Item bloqueante em aberto significa go-live adiado. Se o cliente optar por seguir mesmo assim, registre a decisão no campo correspondente do formulário, com quem decidiu e qual o risco aceito.
Perguntas frequentes
Dá para homologar em produção?
Não é recomendado. Vários testes criam e cancelam documentos reais. Use ambiente de homologação com massa parecida com a real.
Quanto tempo leva o checklist?
Meio dia, quando o ambiente está pronto e a carga já foi feita. Se aparecerem pendências de cadastro no ERP, some o tempo de resolvê-las.
Precisa testar tudo de novo depois de uma correção?
Não tudo, mas refaça o item afetado e os que dependem dele. Correção em gravação de pedido, por exemplo, pede reteste do ciclo do pedido inteiro.
O cliente precisa estar presente?
Precisa. Boa parte dos itens envolve cadastro e decisão do cliente, e o aceite sem presença dele costuma virar discussão depois do go-live.
E se um item não se aplica ao cliente?
Marque como não aplicável e registre o motivo. Cliente que não usa solicitação de compra não precisa do campo correspondente, por exemplo. O que não vale é deixar em branco.
Quem assina?
Um responsável de cada lado: consultoria de implantação, cliente e Vendelo. É o que transforma o checklist em aceite.
Próxima leitura
Monitoramento, erros e reprocessamento seguro: com a integração em produção, veja como acompanhar a fila, entender os erros mais comuns e reprocessar sem duplicar.