Checklist de homologação e entrada em produção

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.

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

ItemTesteEsperado
Serviço dedicado responde BloqueanteVerificar a conexão com a credencial da integraçãoResposta positiva, indicando empresa e filial
Filial principal correta BloqueanteConferir a filial informada na verificaçãoÉ a filial que será a padrão do Vendelo
Estrutura da integração criada BloqueanteExecutar a preparação da estruturaResultado confirmando que ficou completa
Agente de impressão presenteSolicitar um PDF pelo VendeloPDF gerado, sem erro de agente no console
Campo da solicitação de compraConferir o resultado da preparaçãoIdentificação do solicitante pronta
Artefatos de homologação fora de produção BloqueanteTentar usar cada recurso exclusivo de homologaçãoTodos indisponíveis

2. Segurança

ItemTesteEsperado
HTTPS em produção BloqueanteConferir o endereço configuradoComeça com https://
Certificado verificado BloqueanteConferir a configuração de certificadoAceitação irrestrita desligada, ou impressão digital preenchida
Certificado diferente interrompeApresentar certificado diverso do esperadoA integração falha, não segue
Acesso restrito por rede BloqueanteTentar alcançar o serviço de fora do caminho aprovadoRecusado
Usuário Protheus dedicadoConferir qual usuário está configuradoUsuário criado para a integração, não login de pessoa
Credencial fora do repositório BloqueanteConferir onde a senha está armazenadaEm secret ou variável protegida
Consulta recusa escrita BloqueanteTentar alterar dados por consulta, e encadear comandosTodas as tentativas recusadas
Log verboso desligadoConferir a configuração de logDesligado por padrão
Download de logs restritoTentar baixar com usuário sem permissãoRecusado pelo servidor

3. Carga inicial

ItemTesteEsperado
Carga executada em janela combinadaRegistrar horário de início e fimFora do horário de uso
Todos os grupos concluídos BloqueanteFiltrar a fila pelas entradas de cargaStatus Sincronizado
Volume conferidoComparar contagens entre ERP e VendeloDiferenças explicadas, não ignoradas
Erros da carga tratadosFiltrar a fila por erroCada erro com causa identificada e resolvida
Tempo medidoUsar as datas de criação e atualizaçãoNúmero registrado, para dimensionar futuras cargas

4. Cadastros

ItemTesteEsperado
Cliente alterado no ERP refleteAlterar um cliente no Protheus e aguardarAlteração aparece no Vendelo
Cliente criado no Vendelo chega ao ERP BloqueanteCriar cliente pelo aplicativoCadastro criado no Protheus, com loja e tipo corretos
Produto com preço e estoqueAbrir um produto no catálogoPreço da lista correta e saldo do ERP
Imagem do produtoAbrir um produto com foto no ERPFoto exibida, se a importação estiver habilitada
Campos de usuário circulamPreencher um campo de usuário nos dois ladosValor aparece do outro lado
Exclusão lógica refleteInativar um cadastro no ERPSituação refletida no Vendelo

5. Ciclo do pedido

ItemTesteEsperado
Pedido criado no Vendelo BloqueanteFechar um pedido pelo aplicativoPedido gravado no Protheus com número do ERP visível no Vendelo
Impostos calculados pelo ERPConferir o total do pedidoValores batem com o cálculo do Protheus
Alteração de pedido integradoAlterar quantidade e reenviarAlteração refletida no ERP
Pedido criado no ERP refleteDigitar um pedido no ProtheusDocumento aparece no Vendelo
Liberação e faturamentoLiberar e faturar no ERPSituação acompanhada no Vendelo
Nota fiscal refleteEmitir a notaDocumento aparece no Vendelo
DANFEAbrir a DANFE pelo aplicativoPDF real, ou aviso de recurso indisponível se a rotina do cliente não existir
Diferença entre cancelar e encerrar BloqueanteCancelar um pedido e encerrar outroCancelado some das telas e consultas do Protheus; encerrado permanece visível
Devolução refleteRegistrar devolução no ERPDocumento 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

ItemTesteEsperado
Situação financeira do clienteAbrir a tela financeira de um cliente com títulosLimite, títulos, parcelas e vencidos do ERP
BoletoSolicitar boleto de um título elegívelPDF real, ou aviso de recurso indisponível se a rotina do cliente não existir
Adiantamento de pedido pagoConcluir um pagamentoTítulo de adiantamento criado, se configurado
Tarifa do gatewayConferir o lançamentoTítulo a pagar. O modo lançamento contábil não é suportado.
Faturamento automáticoSe habilitado, concluir um pagamentoNota emitida, com a série configurada
Cancelamento de pedido pagoCancelar um pedido já pagoEstorno completo, ou recusa clara pedindo tratamento no ERP

7. Multi-filial

ItemTesteEsperado
Filiais reconhecidasConferir a lista de filiais no VendeloTodas as filiais que vão operar
Cadastros exclusivos por filial BloqueanteConferir condição de pagamento, conta corrente, natureza, TES e armazém em cada filialExistentes em todas
Pedido em filial não principalEmitir pedido em outra filialGravado corretamente
Faturamento em filial não principalFaturar nessa filialNota emitida, sem erro de licença
Licença TOTVS por CNPJ BloqueanteConferir licença de cada filialTodas licenciadas

8. Usuários, carteiras e licenças

ItemTesteEsperado
Vendedores importadosConferir a lista de vendedores no VendeloCorrespondem aos do Protheus
Vínculo por e-mailConferir o vínculo de cada vendedor com a pessoaVínculo correto antes de liberar o acesso
Carteiras de clientesEntrar como vendedorVê apenas a carteira dele
Licença ativa BloqueanteConferir licença de cada usuário que vai operarTodos com licença
Usuário do fluxo automatizadoConferir a licença do usuário configurado nas automaçõesLicença ativa
Perfis de permissãoEntrar com cada perfilAcesso conforme o combinado, inclusive à fila de integração

9. Comportamento em falha

ItemTesteEsperado
Integração parada acumulaParar o serviço REST, alterar cadastros, religarNada se perde; tudo é processado depois
Objeto da integração derrubado é recriadoDerrubar um objeto e aguardar a verificação automáticaReconstruído sozinho
Erro isolado por registroProvocar erro em um registro de um loteOs demais seguem; só o afetado fica em erro
Mensagem de erro compreensívelLer a descrição de itens em erroAponta a causa, não só um código
Reprocessamento após correçãoCorrigir a causa e reenfileirarItem conclui
Equipe sabe o risco do reprocessoPerguntar ao responsável pelo suporteSabe conferir a origem antes de reenfileirar uma inclusão que falhou por comunicação

10. Preparação da operação

ItemEsperado
Responsável pelo acompanhamento diário da filaNome definido
Caminho de escalonamento para a VendeloCombinado e documentado
Procedimento de rotação da credencialDefinido
Renovação de certificado inclui atualizar a impressão digitalNo procedimento do cliente
Equipe treinada na diferença entre cancelar e encerrarTreinamento realizado
Equipe sabe onde cada dado é editadoTreinamento realizado
Limitações conhecidas comunicadas ao clienteRegistrado
Janela e responsável para recargas futurasCombinado

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.

    Blocos do checklist aprovados:

    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.