Voltar para Central de ajuda
Integrações

Como o wizard de integração guarda formatos default

Wizard admin não cria mais message_type stub. Salva default_source_format + default_destination_format na integration; "Derivar mapping" usa pra pré-preencher.

Atualizado em 28/09/2026

Mudança (PR #286)



Ao finalizar wizard de criação de integração, o sistema salva 2 colunas novas em integrations:
  • default_source_format (ex: A_BillingDocument)
  • default_destination_format (ex: INVOIC_D01B)


E NÃO cria mais message_type automaticamente.

Por quê



Antes, wizard criava stub BILLING_DOCUMENT com destination_format=JSON (formato da conexão). Quando user ia criar mapping de verdade, o sistema não conseguia reusar e criava duplicata → erro "2 message_types ativos pra mesma integration".

Como criar mapping agora



  1. Abra a integração
  2. Clique "Nova Mensagem" → "Derivar da integração"
  3. Modo B mostra form com formatos pré-preenchidos a partir dos defaults da integração
  4. User pode mudar antes de submeter — não trava
  5. Submit cria message_type + mapping atomicamente


Separação clara: criação de integração e criação de mapping são fluxos distintos.

Direção e tipo de mensagem sem mapping (28/09/2026)



  • Direção no passo 4: vem do fluxo origem → destino, a mesma regra da integração. Numa integração de saída (ex.: SAP → EDIFACT) aparece Saída com o porquê, sem pergunta; de EDIFACT/X12 para o SAP, Entrada. Quando o fluxo não diz quem envia (os dois lados EDI, ou nenhum), a tela pergunta — sem nada marcado — e só cria depois da escolha. Vale para Manual e Derivar.
  • Tipo de mensagem ativo sem mapping: a tela da integração mostra um card Sem mapping com o botão Gerar mapping, que abre o Derivar com esse tipo já escolhido. Acontece, por exemplo, depois de trocar o formato de origem na edição da integração.
  • De um formato anterior: o mapping cujo tipo foi substituído (formato trocado na edição) continua na lista com essa marca. Nada é apagado; ele não é usado pelo tipo ativo.


Pontos para revisar no fim da criação (28/09/2026)



No Criar com Mapeamento IA (Nova mensagem e Derivar), quando a geração das regras deixa avisos — chave do receptor, campos que o sistema de destino calcula, código que precisa de conversão, parceiro sem função — ou quando duas regras criadas disputam o mesmo campo, o último passo mostra a lista e o link Abrir no editor de mapeamento. A mensagem já foi criada como rascunho; revise no editor antes de publicar.