Trilha 08 · Integrações e implantação

Exemplos de integração: jurídico, público e empresas

Processos completos em que etapas batem em outros sistemas: buscas em tribunais, consultas cadastrais, ERP, sistemas de captura de intimações, protocolo legado, diário oficial, assinatura eletrônica. Cada exemplo mostra o padrão usado, a configuração dos blocos e o que trafega.

Esta lição aplica os cinco padrões da lição anterior em casos reais. Se ainda não leu, leia antes: os termos enviar e seguir, enviar e aguardar, conector intermediário e callback aparecem o tempo todo aqui.

Sobre os sistemas citados

Os nomes de sistemas de terceiros (tribunais, provedores de dados, Diário Oficial, plataformas de assinatura) são exemplos de onde a informação está. Antes de prometer uma integração, confirme com o cliente se o serviço oferece API, quais são os termos de uso, o custo, a forma de autenticação e o que a LGPD permite consultar. Muitas vezes o cliente já contrata um provedor que agrega essas fontes, e o conector só fala com esse provedor.

Caso 1 — Escritório de advocacia: abertura de caso com diligência

Situação. Antes de aceitar um novo cliente, o escritório precisa saber se há processos contra ele (risco de inadimplência ou de conflito), se o cadastro na Receita está regular e se o escritório já não representa a parte contrária. Hoje um estagiário consulta sites de tribunais um a um, cola prints num e-mail e o sócio decide. Leva dias e não deixa rastro.

Desenho no Autoflow. Clique em cada elemento do diagrama para ver como ele é configurado. Este diagrama é importável: baixe pelo laboratório da trilha BPMN ou abra o arquivo public/bpmn/juridico-abertura-caso.bpmn no editor do Autoflow (troque os ids das integrações e configure o bloco de documentos).

O que trafega na busca

Caso 1b — Intimação capturada abre processo de prazo (padrão 3)

O escritório contrata um serviço que lê os diários oficiais e captura intimações. Em vez de alguém redigitar cada intimação, o serviço (ou um conector) abre o processo no Autoflow pela API pública. O fluxo é o modelo Acompanhamento de prazo do pacote Advocacia: a regra Prazo por ato descobre quantos dias, o bloco Calcular prazo conta em dias úteis com o calendário do escritório (recesso incluído), e a tarefa Protocolar peça nasce com o prazo certo.

# O que o sistema de captura envia
curl -X POST https://autoflow.escritorio.com.br/api/public/v1/process-instances \
  -H "Authorization: Bearer pf_ab12cd34_…" \
  -H "Idempotency-Key: intimacao-INT-2026-10-23-0091" \
  -H "Content-Type: application/json" \
  -d '{
    "processDefinitionKey": "ACOMPANHAMENTO_PRAZO",
    "externalRef": "INT-2026-10-23-0091",
    "name": "Contestação — 0012345-67.2026.8.26.0100",
    "unit": { "branchCnpj": "12345678000190" },
    "variables": {
      "numeroProcesso": "0012345-67.2026.8.26.0100",
      "tipoAto": "CONTESTACAO",
      "dataIntimacao": "2026-10-23"
    }
  }'

Por que este par de exemplos é poderoso numa venda para o jurídico

Juntos, eles cobrem o ciclo inteiro: entrada automática (intimação vira processo), regra (prazo por tipo de ato), calendário (dias úteis com recesso), consulta externa (busca em tribunais) e saída (ERP e webhook). Nenhuma etapa depende de alguém copiar dados de uma tela para outra, e cada passo fica auditado.

Outras integrações típicas no jurídico

Necessidade no processo	Padrão	Como modelar
Consultar andamento de um processo judicial periodicamente	2 (com `status`)	Enviar com mensagem de retorno; o conector manda `outcome: "status"` a cada novidade (aparece na linha do tempo) e `completed` quando houver decisão.
Gerar minuta a partir de modelo no sistema de documentos	2	Enviar com os dados do caso; o retorno traz o `.docx`/PDF como documento do processo.
Protocolar peça em sistema do tribunal	Humano + 1	O protocolo em si costuma exigir certificado digital do advogado (fica fora do Autoflow). Depois, um Enviar registra o número do protocolo no sistema interno.
Lançar honorários no financeiro	1	Enviar para o ERP ao final; o resultado guarda o id do lançamento.
Avisar o cliente por canal próprio do escritório	4	Webhook `task.created` ou `process_instance.completed` para o sistema de mensagens do escritório. Ou o cliente vira participante externo no Portal Autoflow.

Caso 2 — Órgão público: alvará com consultas e publicação

Situação. Uma prefeitura recebe pedidos de alvará pelo portal de serviços, consulta a situação do CNPJ e débitos na dívida ativa, emite parecer, cobra a taxa por guia e publica a decisão no Diário Oficial do município.

Etapa	Padrão	Observação para órgão público
Entrada pelo portal de serviços	3	Use `externalRef` com o número do protocolo do portal: rastreabilidade de ponta a ponta.
Consulta de CNPJ e débitos	2	Registre a base legal da consulta. Mande no template só o necessário.
Emissão de guia e confirmação de pagamento	2 (dois retornos)	O primeiro retorno traz a guia; para esperar o pagamento, modele uma segunda espera com outra mensagem.
Publicação no Diário Oficial	2	A edição e a página voltam como variáveis: fundamento para a contagem de prazo de recurso.
Integração com o protocolo legado	1 ou 4	Se o órgão tem sistema de protocolo oficial, registre lá o número gerado (Enviar) ou deixe o protocolo ouvir os webhooks.
Prazo legal sem resposta	—	Prazo de borda na tarefa; lembre que o Calcular prazo conta dias úteis (veja a lição de setor público).

No setor público

Em órgãos públicos, o conector quase sempre fica dentro da rede do órgão, porque os sistemas legados não são expostos à internet. O Autoflow chama apenas o conector, por HTTPS, e o conector conversa com o resto pela rede interna. Isso também facilita a aprovação pela equipe de segurança: um único ponto de entrada, auditável. Lembre: o Autoflow bloqueia chamadas para endereços de rede privada, então o conector precisa ter um endereço HTTPS acessível, por exemplo atrás do gateway de API ou do proxy reverso do órgão.

Caso 3 — Empresas: ERP, CRM, crédito e assinatura

Situação	Padrão	Fluxo
Venda faturada no ERP inicia o emplacamento	3	ERP chama a API pública com o número da nota como `externalRef`. É o caso dos exemplos reais do pacote Concessionária.
Análise de crédito em birô	2	Enviar ao conector com CPF/CNPJ e valor; o retorno traz `score` e `faixaRisco`; uma regra DMN decide a alçada a partir deles.
Assinatura eletrônica de contrato	2	Enviar com o link temporário do contrato (`{{ documents.CONTRATO.url }}`); o conector cria o envelope na plataforma de assinatura; o retorno traz o PDF assinado como documento. O Autoflow não tem assinatura digital nativa: este é o caminho.
CRM atualiza a oportunidade quando a proposta é aprovada	4	Webhook `task.completed` / `process_instance.completed` para o CRM.
Vendedores que vivem no ERP	5	SSO + tarefas no modal do ERP (veja o exemplo `samples/erp-sample-ui` do repositório).
Despachante (parceiro gerenciado)	2	Já pronto no pacote Concessionária: o cliente só habilita em Integrações prontas. Veja o fluxo real de primeiro emplacamento na lição de fluxos.

Assinatura eletrônica, em detalhe

Tarefa “Elaborar contrato” gera o documento (anexado pelo usuário ou vindo de outro Enviar).
Enviar para o conector de assinatura: template com nome, e-mail e CPF dos signatários e {{ documents.CONTRATO.url }} (link temporário, expira em 72 h por padrão). Mensagem de retorno contrato-assinado, documentos do retorno: CONTRATO_ASSINADO.
Aguardar retorno externo com timer de 5 dias → “Cobrar assinatura do cliente”.
O conector recebe o aviso da plataforma de assinatura e chama o callback com o PDF assinado (multipart, campo CONTRATO_ASSINADO). Se o signatário recusar: outcome: "rejected" com o motivo → gateway → “Renegociar contrato”.

Como apresentar isso ao cliente

Mapeie as integrações no AS-IS. Toda vez que alguém disser “aí eu entro no sistema X e copio…”, anote: é candidata a integração.
Classifique em um dos 5 padrões. Use a tabela de decisão da lição anterior.
Separe responsabilidades. O fluxo e os blocos são configuração no Autoflow (você). O conector é desenvolvimento (TI do cliente, um parceiro ou sua equipe). Os sistemas de terceiros têm contrato próprio.
Comece sem integração se for preciso. Uma tarefa humana “Consultar processos nos tribunais e anexar o relatório” funciona no dia 1. Quando o conector ficar pronto, troque a tarefa pelo par Enviar + Aguardar e publique uma nova versão. O processo, os formulários e os indicadores continuam os mesmos.
Teste os cenários de erro. Recusa, fora do ar, demora e retorno com pendência, antes do go-live.

A estratégia do passo 4 é a mais importante

Ela evita que o projeto inteiro fique parado esperando uma integração. O cliente começa a ganhar com o fluxo organizado, os prazos e a rastreabilidade, e a automação das consultas entra depois como melhoria. Você também mede o antes e o depois: “a busca levava 2 dias manualmente e agora leva 20 minutos”.

Resumo

Jurídico: busca em tribunais e consulta cadastral com enviar e aguardar; intimações entrando pela API pública; ERP com enviar e seguir; avisos por webhook.
Órgão público: o conector fica dentro da rede do órgão e é o único ponto de contato com os sistemas legados. O cidadão participa pelo Portal Autoflow.
Empresas: crédito, assinatura eletrônica e ERP seguem os mesmos padrões. Assinatura digital sempre via plataforma externa e conector.
Comece com tarefa humana no lugar da integração e troque por blocos quando o conector estiver pronto: o fluxo não para por causa da integração.

QuizVerifique seu entendimento0/5 respondidas · 0 certas

1.No caso jurídico, por que a verificação de conflito usa "enviar e seguir" e a busca nos tribunais usa "enviar e aguardar"?

2.Um sistema de captura de intimações deve criar um processo no Autoflow para cada intimação. Como evitar processos duplicados se ele reenviar?

3.Os sistemas da prefeitura só funcionam na rede interna. Como integrar?

4.O conector do cliente ainda não está pronto, mas o go-live está marcado. O que fazer?

5.Como o PDF assinado na plataforma de assinatura chega ao processo?

AnteriorPadrões de integração na prática PróximaInfraestrutura e implantação