Ensaio

O ensaio roda a versão em edição do conector contra os sistemas de verdade, mas não grava nada: nem na Zoppy, nem no outro sistema.

• Leituras são de verdade, inclusive no banco do sistema local. Você vê os dados reais que o conector leu.
• Escritas não saem. Cada uma vira uma requisição planejada: a requisição exata que o conector mandaria, com método, endereço e corpo (segredos aparecem só como marcadores).

Amostra e completo

Ensaio	O que roda	Quando usar
Amostra	Só a primeira fatia da execução.	Ver rápido se o conector funciona. Se a amostra foi cortada (havia mais para ler), a tela marca que falta um ensaio completo.
Completo	A execução inteira, em fatias, lendo a origem toda.	Antes de publicar: publicar exige um ensaio completo limpo daquela versão, sem criação sem consulta. Uma versão nova (mesmo de um conector já ligado) precisa de novo ensaio.

O que conferir no resultado

• Status e contagens: quantos registros foram lidos, quantos seriam criados, atualizados ou ignorados, por objeto (clientes, pedidos, produtos).
• Requisições planejadas: o que sairia para cada sistema.
• Escritas feitas como leitura: chamadas POST, PUT, PATCH ou DELETE que o conector fez pelo caminho de leitura. Algumas APIs consultam por POST (e aí está certo); se for uma escrita de verdade, peça para a IA corrigir, porque ela teria saído no ensaio.
• Criação sem consulta (connect.write_without_lookup): o conector criaria um registro sem antes consultar se ele já existe. Toda escrita precisa ser idempotente: o conector busca pela chave natural (id externo, documento, e-mail ou telefone) antes de criar, ou atualiza pelo id, porque o mesmo registro volta a passar por ele depois de uma confirmação, de uma queda ou de um reprocesso. Com esse problema o ensaio não conta como limpo e a publicação é recusada; a IA corrige e ensaia de novo.
• Passos: cada chamada, consulta ao banco local e log, com dados pessoais mascarados.
• Quarentena: registros que o conector separaria, com o motivo.

Quando o ensaio é recusado antes de começar

Código	O que fazer
connect.hosts_awaiting_approval	Aprove os hosts novos na tela do conector.
connect.access_incomplete	Preencha os segredos que faltam no formulário de acesso.
connect.run_in_progress	O conector já tem uma execução rodando; espere ela terminar.

Todos os códigos estão no catálogo de erros.

O que o ensaio não garante

O ensaio sabe o que o conector mandaria, mas não sabe se o outro sistema (ou a Zoppy) aceitaria cada escrita. Por isso a primeira escrita em cada sistema espera a sua confirmação, e os registros recusados vão para a quarentena.