Voltar para Central de ajuda
FT-SCHEMA-DISCOVERY· 1.0.0Integrações

Descobrir o esquema da origem e do destino

Campos com cardinalidade, diferença para o catálogo e amostra real, iguais para todo formato, no assistente e na tela da integração.

Atualizado em 28/10/2026
O bloco Esquema aparece nos passos de origem e de destino do assistente e no botão Descobrir esquema da tela da integração. É o mesmo para todo formato: mostra os campos que o sistema entrega ou recebe, com a cardinalidade (uma lista vira coleção, como itens[*].codigo), o que mudaria no catálogo da sua empresa e uma amostra real para o mapeamento.

Como cada conector é lido



  • SAP OData: o $metadata do serviço e 5 registros reais da entidade.
  • API REST: a especificação OpenAPI (URL ou colada; fica guardada para a próxima atualização), a chamada real (GET na URL da conexão, sem os filtros de linha) ou um exemplo colado.
  • SOAP: o WSDL (escolha a operação) ou um XML colado.
  • IDoc, EDIFACT, X12, NF-e: os campos são os da mensagem do catálogo; cole um arquivo do parceiro para conferir. Com o XSD do cliente, o que ele traz além do catálogo vira a extensão da empresa.
  • Banco Oracle: 5 linhas da consulta da conexão, pela ponte (depois de criar a integração).


Diferença e divergência



  • Diferença para o catálogo: campos novos, removidos e que mudaram de forma. Se a gravação faria uma lista virar campo simples, o Lefia pede confirmação antes.
  • Divergência da amostra: quando o que chegou de verdade não é o que o catálogo diz (campo novo, obrigatório ausente, tipo mudou), aparece um aviso. O valor nunca é mostrado, só a forma dele.


Gravar



Usar este esquema (formato novo) ou Atualizar esquema (formato existente) grava no catálogo da sua empresa. No REST, SOAP e banco você confere o código e, na origem, a chave do documento. No OData, só os campos que o seu sistema tem além do catálogo padrão viram a extensão da empresa.

A amostra guardada



Os registros lidos ficam com a integração mascarados (e-mail, CPF/CNPJ, telefone e outros dados pessoais saem) e vencem no prazo de dados da integração. Enquanto não chega a primeira mensagem, o preview do mapeamento e as sugestões usam essa amostra.

Histórico de versões

  • 1.0.0

    Descoberta de esquema igual para todo formato, no mesmo passo do assistente e na tela da integração. OData lê o $metadata e 5 registros reais; REST lê a especificação OpenAPI (guardada para reuso), faz a chamada real ou lê um JSON colado; SOAP lê o WSDL ou um XML colado; IDoc, EDIFACT, X12 e NF-e partem do catálogo (ou do XSD do cliente) e conferem uma amostra colada; banco Oracle lê 5 linhas pela ponte. Todos mostram os campos com cardinalidade (listas viram coleções), o que muda em relação ao catálogo da empresa e um aviso quando a amostra real diverge (campo novo, obrigatório ausente, tipo mudou). "Usar este esquema" / "Atualizar esquema" grava numa regra só, com a guarda que não deixa uma lista virar campo simples sem confirmação. A amostra fica guardada com a integração, mascarada e no prazo de dados dela, e o mapeamento e as sugestões a usam antes da primeira execução.

    28/10/2026 · new