La tabla de abajo indica, conector por conector, cuáles se pueden registrar y usar hoy y cuáles el producto rechaza configurar.
Fichas por conector:
conectores/fichas.md— uma página por conector, com campos, credenciais, limites e erros comuns.Leia antes:
README.md(vocabulário de estado + template dos 9 campos). Esta página é o mapa de estados público dos conectores — o passo a passo operacional detalhado vive no runbook operacional interno, não é duplicado aqui.
Dois vocabulários, e por que os dois existem#
Confundir os dois foi o que produziu a contradição entre a página inicial e esta página: a primeira mostrava Disponível e a segunda dizia Preview para o mesmo conector. Son ejes diferentes, y ambos siguen vigentes.
| Eixo | Valores | O que responde |
|---|---|---|
| Estado público (o selo do site e da tela de conexiones) | Disponível · Acesso limitado · Planejado | ¿Puedo usar esto hoy? |
| Maturidade (vocabulário interno de engenharia) | GA-candidato · Preview · Roadmap | ¿Cuánta evidencia hay detrás? |
Reglas que aplican en ambas superficies, sin excepción:
- "Disponível" = usable hoy, en el flujo normal del producto, con la credencial de su origen. El compromiso de disponibilidad de la plataforma es el SLA del plan (99,5% al mes a partir de Growth — ver /legal/sla); el estado del conector dice si acepta registro hoy.
- "Acesso limitado" siempre viene con la condición concreta escrita en la página del conector — "acesso limitado" sin condición seria una afirmación vacía.
- "Planejado" es lo que aún no existe. Ninguna superficie ofrece botón de "usar hoy" para estos.
Estado do catálogo (a verdade do produto)#
O estado público de cada conector é derivado do catálogo, não redigitado.
disponivel → Disponível; estrutura → Acesso limitado; roadmap →
Planejado. A coluna "Configuração" diz se o produto recusa cadastrar a
fonte hoje — e essa recusa é o único caso em que usar depende de falar com o
suporte.
| Conector | id | Categoria | Estado público | Maturidade | Configuração | Auth |
|---|---|---|---|---|---|---|
| Google Sheets | google_sheets | Planilhas e colaboração | Disponível | GA-candidato | aceita | conta de serviço |
| CSV | csv | Arquivos | Disponível | GA-candidato | aceita | envio para a área de recebimento |
| JSON | json | Arquivos | Disponível | GA-candidato | aceita | envio para a área de recebimento |
| Parquet | parquet | Arquivos | Disponível | GA-candidato | aceita | envio para a área de recebimento |
| PostgreSQL | postgresql | Bancos de dados | Disponível | GA-candidato | aceita | usuário/senha (rede: IP, SSH, Cloud SQL, VPN) |
| SQL Server | sqlserver | Bancos de dados | Disponível | GA-candidato | aceita | usuário/senha |
| Oracle | oracle | Bancos de dados | Disponível | GA-candidato | aceita | usuário/senha |
| MySQL | mysql | Bancos de dados | Disponível | GA-candidato | aceita | usuário/senha |
| MariaDB | mariadb | Bancos de dados | Acesso limitado | Preview | aceita | usuário/senha |
| Amazon Redshift | amazon_redshift | Bancos de dados | Acesso limitado | Preview | aceita | usuário/senha |
| CockroachDB | cockroachdb | Bancos de dados | Acesso limitado | Preview | aceita | usuário/senha |
| Supabase | supabase | Bancos de dados | Acesso limitado | Preview | aceita | usuário/senha |
| Neon | neon | Bancos de dados | Acesso limitado | Preview | aceita | usuário/senha |
| TimescaleDB | timescaledb | Bancos de dados | Acesso limitado | Preview | aceita | usuário/senha |
| AlloyDB | alloydb | Bancos de dados | Acesso limitado | Preview | aceita | usuário/senha |
| Azure SQL | azure_sql | Bancos de dados | Acesso limitado | Preview | aceita | usuário/senha |
bigquery | bigquery | Bancos de dados | Disponível | GA-candidato | aceita | conta de serviço |
| ClickHouse | clickhouse | Data warehouses | Acesso limitado | Preview | aceita | usuário e senha (Basic) |
| Databricks SQL | databricks_sql | Data warehouses | Acesso limitado | Preview | aceita | token de acesso |
| Elasticsearch | elasticsearch | Data warehouses | Acesso limitado | Preview | aceita | usuário e senha (Basic) |
| Cloud Firestore | firestore | Data warehouses | Acesso limitado | Preview | aceita | conta de serviço |
| Snowflake | snowflake | Data warehouses | Acesso limitado | Preview | aceita | par de chaves (chave privada) |
| Trino | trino | Data warehouses | Acesso limitado | Preview | aceita | usuário e senha (Basic) |
| Omie ERP | omie | ERP e gestão | Acesso limitado | Preview | aceita | App Key / App Secret |
| Bling ERP | bling | ERP e gestão | Acesso limitado | Preview | aceita | OAuth 2.0 (refresh token) |
| Conta Azul | conta_azul | ERP e gestão | Acesso limitado | Preview | aceita | OAuth 2.0 (refresh token) |
| Tiny ERP | tiny | ERP e gestão | Acesso limitado | Preview | aceita | token de acesso |
| NF-e (SEFAZ) | nfe | ERP e gestão | Acesso limitado | Preview | aceita | certificado A1 (.pfx) |
| Dynamics 365 | dynamics_365 | ERP e gestão | Acesso limitado | Preview | aceita | client id/secret (OAuth 2.0) |
| NetSuite | netsuite | ERP e gestão | Acesso limitado | Preview | aceita | OAuth 1.0a |
| Nibo | nibo | ERP e gestão | Acesso limitado | Preview | aceita | chave de API |
| Odoo | odoo | ERP e gestão | Acesso limitado | Preview | aceita | login de sessão |
| QuickBooks Online | quickbooks | ERP e gestão | Acesso limitado | Preview | aceita | OAuth 2.0 (refresh token) |
| Sankhya | sankhya | ERP e gestão | Acesso limitado | Preview | aceita | login de sessão |
| SAP Business One | sap_business_one | ERP e gestão | Acesso limitado | Preview | aceita | login de sessão |
| SAP S/4HANA | sap_s4hana | ERP e gestão | Acesso limitado | Preview | aceita | usuário e senha (Basic) |
| Senior | senior | ERP e gestão | Planejado | Roadmap | recusada | client id/secret (OAuth 2.0) |
| TOTVS Protheus | totvs_protheus | ERP e gestão | Planejado | Roadmap | recusada | chave de API |
| iFood | ifood | E-commerce e marketplaces | Acesso limitado | Preview | aceita | client id/secret (OAuth 2.0) |
| Loja Integrada | loja_integrada | E-commerce e marketplaces | Acesso limitado | Preview | aceita | chave de API |
| Magento 2 (Adobe Commerce) | magento2 | E-commerce e marketplaces | Acesso limitado | Preview | aceita | token de acesso |
| Mercado Livre | mercado_livre | E-commerce e marketplaces | Acesso limitado | Preview | aceita | OAuth 2.0 (refresh token) |
| Nuvemshop | nuvemshop | E-commerce e marketplaces | Acesso limitado | Preview | aceita | token de acesso |
| Shopify | shopify | E-commerce e marketplaces | Acesso limitado | Preview | aceita | token de acesso |
| Tray Commerce | tray | E-commerce e marketplaces | Acesso limitado | Preview | aceita | token de acesso |
| VTEX | vtex | E-commerce e marketplaces | Acesso limitado | Preview | aceita | chave de API |
| WooCommerce | woocommerce | E-commerce e marketplaces | Acesso limitado | Preview | aceita | usuário e senha (Basic) |
| Asaas | asaas | Pagamentos e financeiro | Acesso limitado | Preview | aceita | chave de API |
| Granatum | granatum | Pagamentos e financeiro | Acesso limitado | Preview | aceita | chave de API |
| Mercado Pago | mercado_pago | Pagamentos e financeiro | Acesso limitado | Preview | aceita | token de acesso |
| Pagar.me | pagarme | Pagamentos e financeiro | Acesso limitado | Preview | aceita | usuário e senha (Basic) |
| PagBank | pagbank | Pagamentos e financeiro | Planejado | Roadmap | recusada | token de acesso |
| Stripe | stripe | Pagamentos e financeiro | Acesso limitado | Preview | aceita | token de acesso |
| Vindi | vindi | Pagamentos e financeiro | Acesso limitado | Preview | aceita | usuário e senha (Basic) |
| Salesforce | salesforce | CRM e atendimento | Acesso limitado | Preview | aceita | OAuth 2.0 (refresh token) |
| HubSpot | hubspot | CRM e atendimento | Acesso limitado | Preview | aceita | OAuth 2.0 (refresh token) |
| Agendor | agendor | CRM e atendimento | Acesso limitado | Preview | aceita | chave de API |
| Freshdesk | freshdesk | CRM e atendimento | Acesso limitado | Preview | aceita | usuário e senha (Basic) |
| Intercom | intercom | CRM e atendimento | Acesso limitado | Preview | aceita | token de acesso |
| Moskit CRM | moskit | CRM e atendimento | Acesso limitado | Preview | aceita | chave de API |
| Movidesk | movidesk | CRM e atendimento | Acesso limitado | Preview | aceita | chave de API |
| Pipedrive | pipedrive | CRM e atendimento | Acesso limitado | Preview | aceita | chave de API |
| Ploomes | ploomes | CRM e atendimento | Acesso limitado | Preview | aceita | chave de API |
| RD Station CRM | rd_station_crm | CRM e atendimento | Acesso limitado | Preview | aceita | chave de API |
| RD Station Marketing | rd_station_marketing | CRM e atendimento | Acesso limitado | Preview | aceita | OAuth 2.0 (refresh token) |
| Zendesk | zendesk | CRM e atendimento | Acesso limitado | Preview | aceita | usuário e senha (Basic) |
| Zoho CRM | zoho_crm | CRM e atendimento | Acesso limitado | Preview | aceita | OAuth 2.0 (refresh token) |
| Meta Ads (Facebook e Instagram) | meta_ads | Marketing e analytics | Disponível | GA-candidato | aceita | token de acesso |
| Google Ads | google_ads | Marketing e analytics | Disponível | GA-candidato | aceita | OAuth 2.0 (refresh token) |
| ActiveCampaign | activecampaign | Marketing e analytics | Acesso limitado | Preview | aceita | chave de API |
| Brevo | brevo | Marketing e analytics | Acesso limitado | Preview | aceita | chave de API |
| Eduzz | eduzz | Marketing e analytics | Acesso limitado | Preview | aceita | token de acesso |
| Google Analytics 4 | google_analytics_4 | Marketing e analytics | Acesso limitado | Preview | aceita | conta de serviço |
| Google Search Console | google_search_console | Marketing e analytics | Acesso limitado | Preview | aceita | conta de serviço |
| Hotmart | hotmart | Marketing e analytics | Acesso limitado | Preview | aceita | client id/secret (OAuth 2.0) |
| Kiwify | kiwify | Marketing e analytics | Acesso limitado | Preview | aceita | client id/secret (OAuth 2.0) |
| Klaviyo | klaviyo | Marketing e analytics | Acesso limitado | Preview | aceita | chave de API |
| LinkedIn Ads | linkedin_ads | Marketing e analytics | Acesso limitado | Preview | aceita | token de acesso |
| Mailchimp | mailchimp | Marketing e analytics | Acesso limitado | Preview | aceita | usuário e senha (Basic) |
| Pinterest Ads | pinterest_ads | Marketing e analytics | Acesso limitado | Preview | aceita | OAuth 2.0 (refresh token) |
| TikTok Ads | tiktok_ads | Marketing e analytics | Acesso limitado | Preview | aceita | chave de API |
| Typeform | typeform | Marketing e analytics | Acesso limitado | Preview | aceita | token de acesso |
| Airtable | airtable | Produtividade e RH | Acesso limitado | Preview | aceita | token de acesso |
| Asana | asana | Produtividade e RH | Acesso limitado | Preview | aceita | token de acesso |
| ClickUp | clickup | Produtividade e RH | Acesso limitado | Preview | aceita | chave de API |
| Gupy | gupy | Produtividade e RH | Acesso limitado | Preview | aceita | token de acesso |
| Jira | jira | Produtividade e RH | Acesso limitado | Preview | aceita | usuário e senha (Basic) |
| monday.com | monday | Produtividade e RH | Acesso limitado | Preview | aceita | chave de API |
| Notion | notion | Produtividade e RH | Acesso limitado | Preview | aceita | token de acesso |
| Slack | slack | Produtividade e RH | Acesso limitado | Preview | aceita | token de acesso |
| Trello | trello | Produtividade e RH | Acesso limitado | Preview | aceita | chave de API |
| Twilio | twilio | Produtividade e RH | Acesso limitado | Preview | aceita | usuário e senha (Basic) |
| Banco Central (SGS) | bcb_sgs | Dados públicos | Acesso limitado | Preview | aceita | sem credencial (dados públicos) |
| BrasilAPI | brasilapi | Dados públicos | Acesso limitado | Preview | aceita | sem credencial (dados públicos) |
| IBGE (SIDRA) | ibge | Dados públicos | Acesso limitado | Preview | aceita | sem credencial (dados públicos) |
| Backblaze B2 | backblaze_b2 | Object storage | Acesso limitado | Preview | aceita | chave de API |
| Cloudflare R2 | cloudflare_r2 | Object storage | Acesso limitado | Preview | aceita | chave de API |
| DigitalOcean Spaces | digitalocean_spaces | Object storage | Acesso limitado | Preview | aceita | chave de API |
| MinIO | minio | Object storage | Acesso limitado | Preview | aceita | chave de API |
| Wasabi | wasabi | Object storage | Acesso limitado | Preview | aceita | chave de API |
| Amazon S3 | s3 | Object storage | Acesso limitado | Preview | aceita | chave de acesso / conta de serviço |
gcs | gcs | Object storage | Acesso limitado | Preview | aceita | chave de acesso / conta de serviço |
| Azure Blob Storage | azure_blob | Object storage | Acesso limitado | Preview | aceita | SAS token ou OAuth (Microsoft Entra ID) |
| Dropbox | dropbox | Arquivos remotos | Acesso limitado | Preview | aceita | OAuth 2.0 (refresh token) |
| Google Drive | google_drive | Arquivos remotos | Acesso limitado | Preview | aceita | conta de serviço |
| Arquivo por HTTP | http_file | Arquivos remotos | Acesso limitado | Preview | aceita | token de acesso |
| OneDrive / SharePoint | onedrive_sharepoint | Arquivos remotos | Acesso limitado | Preview | aceita | client id/secret (OAuth 2.0) |
| SFTP | sftp | Arquivos remotos | Acesso limitado | Preview | aceita | usuário e senha (Basic) |
| OData genérico | odata_generica | APIs genéricas | Acesso limitado | Preview | aceita | usuário e senha (Basic) |
| API REST genérica | rest_api_generica | APIs genéricas | Acesso limitado | Preview | aceita | token de acesso |
Condições de uso — conectores cuja configuração o produto recusa hoje (o texto é o mesmo da página pública do conector):
- Senior (
senior) — Ainda não é possível conectar o Senior por conta própria: o acesso à API depende de credencial de parceiro homologado. Hoje os dados entram por exportações agendadas para a área de recebimento do seu ambiente. - TOTVS Protheus (
totvs_protheus) — Ainda não é possível conectar o TOTVS Protheus por conta própria: a API REST varia por versão e customização do ambiente. Hoje os dados entram por exportações agendadas (CSV/JSON) para a área de recebimento do seu ambiente. - PagBank (
pagbank) — Ainda não é possível conectar o PagBank por conta própria: a API consulta uma cobrança de cada vez, pelo número dela, e não devolve a lista de cobranças da conta. Hoje o caminho é exportar o extrato e enviá-lo para a área de recebimento do seu ambiente.
Hoje o catálogo tem 110 conectores: 11 Disponível, 96 Acesso limitado e 3 Planejado.
<!-- gen:conectores-tabela:fim -->Os conectores que no aparecem em "Condições de uso" não dependem de nenhuma liberação caso a caso: dependem da credencial da sua origem e de o ambiente de nube do seu workspace estar configurado (sin ello la ejecución fallará, con mensaje, en lugar de fingir éxito).
O runner R/Python de scripts continua indisponível por aislamiento no provado. Ele no es un conector: es ejecución de script aislada.
Ficha por família (template dos 9 campos)#
Conectores ERP/Fiscal BR — Omie, Bling, Conta Azul, Tiny, NF-e
- Estado — Acesso limitado los cinco. Los cinco aceitan cadastro hoy: desde la Onda 15 la renovación automática del acceso (rotación del refresh token del Bling y del Conta Azul) es persistida por la plataforma, y la recusación de configuración dejó de existir. Ninguno de ellos se anuncia como disponibilidad general.
- O que faz — extraen tablas de negocio (pedidos, produtos, financeiro, NF-e) da API do ERP e cargan en la capa Bronze del workspace.
- Como funciona — cada conector es solo un adaptador sobre el SDK común de conectores: auth normalizada, paginación con tope, checkpoint de retomada, retry con
Retry-After, redaction y métricas vienen de serie. La misma batería de contrato corre contra los cinco. - Plano · Permissão — núcleo do produto · verificação de acesso (workspace ativo) · chave de desligamento execução de ingestão por capacidad. Extracción real exige credencial cifrada da fuente.
- Custo — extracción en sí es llamada a la API del ERP (R$0 na plataforma); la carga Bronze consume procesamiento de carga no datalake (cobrable) — ver
custo-limites-seguranca.md. - Limites — paginación con tope duro (default 10.000 páginas / 5.000.000 líneas); carga SaaS default
batchSize 5.000,maxRows 200.000. - Segurança — secreto (App Secret, refresh token, senha do certificado) entra na redacción de secretos; ningún error sale con token. Escopo por workspace na carga.
- Como validar — no console, em ETL/ELT → Conexões, use "Testar conexão" com a credencial da fonte e confirme que a descoberta lista as tabelas esperadas; após uma carga, verifique na camada Bronze do seu workspace as linhas ingeridas. O catálogo mostra o estado ("Preview até certificação com credencial real").
- En resumen — "<Conector> em Acesso limitado — a condição de uso está escrita na página do conector."
Conectores de Anúncios — Meta Ads e Google Ads
- Estado — Acesso limitado; os dois aceitam cadastro. Meta Ads depende de App Review Meta (
ads_read) para uso amplo; Google Ads, do developer token basic→standard. - O que faz — Meta Ads lê o endpoint de Insights (uma linha por dia,
time_increment=1) em 3 tabelas Bronze (meta_ads_campanhas/_conjuntos/_anuncios). Google Ads lê relatórios de desempenho (campanha/grupo/palavra-chave). - Como funciona — adaptadores sobre o SDK comum, com transporte com retry (429/5xx +
Retry-After) e checkpoint. O Google Ads recusa a ingestão em produção enquanto o developer token não estiver aprovado (nunca finge sucesso). - Plano · Permissão — núcleo · verificação de acesso · execução de ingestão.
- Custo — chamadas às APIs de Ads (R$0 plataforma) + carga Bronze cobrável.
- Limites — janelas de data configuráveis (7/14/30/90 dias, mês atual/passado); mesmos tetos de paginación do SDK.
- Segurança — access token / client secret / developer token / refresh token redactados em todo erro.
- Como validar — no console, conecte a conta de anúncios e rode "Testar conexão"; confirme que as tabelas de Insights/relatórios aparecem na descoberta e, após uma carga, na Bronze do seu workspace. Enquanto o app no é aprovado, a ingestão em producción es recusada con aviso claro.
- En resumen — Acesso limitado, o mesmo rótulo que a landing e o produto usam: no existe selo "em breve" em lugar nenhum. Subir de estado depende de App Review (Meta) e de developer token aprovado (Google).
Google Sheets
- Estado — Disponível: dá para cadastrar e usar hoje, sem liberação caso a caso.
- O que faz — lê abas de uma planilha (colunas reais, cabeçalho configurável) e carrega na Bronze.
- Como funciona — adaptador com paginación por janela de linhas e checkpoint (
{linha, columns}); "Testar conexão" indica o e-mail da conta de serviço a autorizar. - Plano · Permissão — núcleo · verificação de acesso · execução de ingestão.
- Custo — leitura da planilha R$0; carga Bronze cobrable.
- Limites — tetos do SDK; uma aba renomeada não derruba as demais (erro fica na tabela, o laço segue).
- Segurança — JSON da conta de serviço (e sua
private_key) redactados; escopo por workspace. - Como validar — no console, autorize o e-mail da conta de serviço na planilha, rode "Testar conexão" e confirme que as abas/colunas aparecem; após a carga, veja as linhas na Bronze.
- En resumen — "Google Sheets Disponível — cadastro e extração no fluxo normal."
Salesforce · HubSpot · Azure Blob
- Estado — Acesso limitado. Os três aceitam cadastro desde a Onda 15: a renovação automática do acesso do HubSpot é persistida pela plataforma e a leitura do container do Azure Blob passou a ser chamada pelo mesmo fluxo de fontes dos demais conectores.
- O que faz — Salesforce/HubSpot leem objetos/entidades do CRM; Azure Blob lê arquivos de um container.
- Como funciona — adaptadores sobre o SDK comum (Azure Blob tem retomada por nome de blob: blob ≤ último processado é pulado, não reprocessa).
- Plano · Permissão — núcleo · verificação de acesso · execução de ingestão.
- Custo — API/leitura R$0; carga Bronze cobrable.
- Limites — tetos do SDK.
- Segurança — credenciais redactadas; escopo por workspace.
- Como validar — no console, conecte a fonte, rode "Testar conexão" e confirme a descoberta das entidades/arquivos; após a carga, veja as linhas na Bronze do seu workspace.
- En resumen — "<Conector> em Acesso limitado — a condição de uso está escrita na página do conector."
Conectores declarativos da Onda 15 — ERPs, e-commerce, pagamentos, CRM, marketing, produtividade, dados públicos, warehouses, arquivos remotos, APIs genéricas e bancos compatíveis
- Estado — Acesso limitado em todos os conectores novos; Planejado em TOTVS Protheus, Senior e PagBank (configuração recusada com o motivo). A lista com o estado de cada um é a tabela gerada acima — nenhuma contagem é redigitada aqui.
- O que faz — cada conector lê os recursos listados na sua ficha (pedidos, clientes, cobranças, negócios, campanhas, tarefas, séries públicas, tabelas de warehouse, arquivos de uma pasta ou bucket…) e carrega na camada Bronze, uma tabela por recurso.
- Como funciona — o conector é uma especificação declarativa (auth, paginación, recursos e colunas) executada por UM motor por família: REST, SQL por HTTP (ClickHouse, Trino, Databricks, Snowflake) e arquivos remotos (S3 e compatibles, almacenamiento en la nube compatible, SFTP, Drive, Dropbox, OneDrive/SharePoint, HTTP). Os bancos compatíveis (MariaDB, Redshift, CockroachDB, Supabase, Neon, TimescaleDB, AlloyDB, Azure SQL) executam pelo driver do engine base. A mesma batería de contrato dos conectores escritos à mão roda contra cada um, com simulador derivado da própria especificação.
- Plano · Permissão — núcleo · verificação de acesso · execução de ingestão.
- Custo — chamadas à API/leitura da origem R$0 na plataforma; carga Bronze cobrable.
- Limites — tetos do SDK (páginas/linhas); extração completa a cada ejecución (sin janela incremental pelo agendador); tempo de ejecución limitado à função. O formato de fio de cada provedor veio da documentação pública, sem credencial real — a condição está no
ownerBlockerde cada conector. - Segurança — todo campo sensível é cifrado (AES-256-GCM) e entra na redação de secretos; tokens renovados entram na lista viva; nenhum erro sai com credencial.
- Como validar — no console, escolha o conector, preencha a credencial da sua conta, rode "Testar conexão" (uma chamada pequena ao recurso mais barato) e confirme a descoberta dos recursos; após a carga, confira as linhas na Bronze. Divergência de formato é esperada no primeiro contato com a API real: ela vira correção da especificação antes do gate de 30 dias.
- En resumen — "<Conector> em Acesso limitado — a condição de uso está escrita na página do conector." Para os Planejados: "Ainda não é possível usar hoje — a condição está na página."
O SDK comum (por que "novo conector = adaptador + suíte de contrato")#
O SDK comum de conectores é puro (sem I/O próprio; o transporte de rede é
inyectado). Um conector novo só escreve testar/descobrir/extrair; o resto vem da
fábrica de adaptadores:
| Peça | Garantia |
|---|---|
| Auth | credencial normalizada; o SDK sabe extrair o material sensível para redactar |
| Paginação | generator com teto duro e guarda anti-loop (cursor que no avanza encerra) |
| Checkpoint | contrato inyectable; lê antes de extrair, grava a cada lote, limpa ao concluir (próxima ejecución recomeça do zero) |
| Retry | backoff exponencial + jitter determinístico, respeita Retry-After; re-tenta só 429/5xx y error de rede |
| Redaction | todo error/log pasa por la redacción de secretos (cru, URL-encoded, JSON) |
| Métricas | una línea de telemetría por operación (linhas/bytes/ms/ok) — telemetría nunca derruba la extracción |
Contract suite: la misma batería prueba, para cada adaptador, que error lanzado es siempre redactado, métricas siempre emitidas y checkpoint retoma sin duplicar ni perder línea.
Schema drift e observabilidade#
- Schema drift: compara baseline salvo × schema descoberto. Columna/tabela nova →
info; coluna removida / tipo mudado / tabela removida →atencao(quebra o mart). Es lógica pura; onde o baseline é persistido é decisão do chamador. - Observabilidade: agrega os eventos en ejecuciones, taxa de erro, p50/p95, freshness. Limiares: erro ≥ 20% → degradado; p95 > 30 s → degradado; sin rodar > 26 h → degradado, > 72 h → parado.
Homologación de conectores (nunca automática)#
La homologación ejecuta sondas vivas (transporte inyectado, sem rede) contra o adaptador real: status honesto no catálogo · adaptador conformante · discover com ≥1 tabela · redaction ativa (planta um segredo-sentinela e exige que não vaze) · checkpoint suportado. Os itens humanos (30 dias com credencial real, reconciliação contra relatórios do provedor, rotação de token, quotas com tráfego real) los hace nuestro equipo, conector por conector — por eso la sonda automática nunca promueve un conector sola.