Propor um mapeamento de mapa-de-campo/dialeto apenas em configuração para uma amostra de origem
Inspeciona uma amostra representativa de um arquivo de origem e retorna uma proposta de mapeamento/dialeto APENAS EM CONFIGURAÇÃO (sugestões de coluna→chave-canônica, dialeto, confiança e justificativa por campo). É CONSULTIVA e sem efeitos colaterais: produzir uma proposta NÃO PERSISTE NADA. O operador revisa a proposta e a confirma pelo caminho EXISTENTE de declaração de mapa de campo. O tenant é resolvido do JWT e o contexto/origem do path — nunca do corpo. A resposta nunca carrega valores parseados, valores monetários ou transações.
Autorizações
Autenticação por Bearer token (formato: "Bearer {token}")
Parâmetros de caminho
Context ID ID do contexto
Source ID ID da origem
Corpo
Amostra representativa de arquivo de origem
1"id;value;ccy;posted_at\nA1;10,50;BRL;2025-06-01\n"
Dica de formato de arquivo declarado
csv, json, xml, camt053 "csv"
Dicas de operador não secretas opcionais (ex.: locale=pt-BR, has_header=true)
Resposta
OK
Detalhamento por campo que embasa o mapeamento proposto
Dialeto de origem proposto; null quando o advisor não tem sugestão de dialeto
Mapa de campo canônico proposto (chave canônica -> coluna de origem); null quando o advisor não pôde propor um mapeamento

