API de assinatura eletrônica

Integre a API de assinatura eletrônica e formalização ao sistema do seu fundo

A API de assinatura eletrônica da Flixsign é REST, com webhooks, e expõe o fluxo inteiro da cessão: entrada de operações e documentos, assinatura em lote com ou sem ICP-Brasil, encaminhamento a registro, notas fiscais e conciliação, sem sair do sistema que o fundo já usa.

REST e JSON Documentação OpenAPI Ambiente de homologação
// webhook recebido pelo sistema do fundo (exemplo ilustrativo) POST https://sistema-do-fundo.com.br/webhooks/flixsign // corpo da requisição (JSON) { "evento": "envelope.finalizado", "operacao": "CESSAO-0412", "documentos": 38, "signatarios": [ { "papel": "cedente", "status": "assinado", "canal": "whatsapp" }, { "papel": "fundo", "status": "assinado", "canal": "e-mail" } ], "concluidoEm": "2026-10-14T14:32:07Z" }
Eventos da operaçãoOperação CESSAO-0412
  • signatario.assinouRecebido
  • envelope.finalizadoRecebido
  • operacao.finalizadaAgora
Em resumo

A API de assinatura eletrônica da Flixsign expõe o mesmo fluxo que a operação usa na tela. O sistema do fundo cria a operação e envia os documentos, por chamada direta ou arquivo CNAB 444; a Flixsign dispara as assinaturas em lote, com ou sem certificado ICP-Brasil, encaminha os títulos a registro, acompanha as notas fiscais e concilia os títulos; a cada etapa, um webhook avisa o seu sistema. Autenticação por token de integração, isolamento por conta e ambiente de homologação para testar antes de ir para produção.

REST, JSON e HTTPSWebhooks por eventoToken por empresaHomologação antes da produção
O que dá para fazer pela API

Cada etapa da formalização, comandada pelo sistema do fundo

A integração vai além do envio para assinatura: o que a operação faz na tela, o seu sistema faz por chamada à API de assinatura eletrônica, do recebimento da cessão à conciliação.

Operações e documentos

Crie a operação e envie os documentos da cessão, como termo, aditivos, CCBs e duplicatas, por chamada direta ou arquivo CNAB 444, sem redigitação.

Signatários e assinatura em lote

Defina signatários e grupos de assinatura, dispare o envio por e-mail ou WhatsApp e colete tudo em lote, com ou sem certificado ICP-Brasil. O cedente assina pelo celular, sem cadastro prévio.

Formalização e registro

Formalize os títulos e encaminhe CCBs e duplicatas a registro na sequência da assinatura, no mesmo fluxo da operação.

Arquivos CNAB 444

Dê entrada nas operações a partir do arquivo CNAB 444 gerado pelo sistema de gestão do fundo, com conversão e validação do conteúdo.

Notas fiscais

Acompanhe os eventos das notas fiscais vinculadas aos títulos antes e depois da cessão e receba cada novo evento por webhook.

Conciliação e consultas

Concilie títulos e baixas, consulte o status de cada operação, envelope e signatário e reúna a trilha de evidências de cada cessão.

Como funciona

Da credencial ao webhook, em quatro passos

1

Credencial

Primeiro, sua empresa recebe um token de integração próprio, que não depende da sessão de um usuário. Toda chamada vai com esse token no cabeçalho, em HTTPS.

2

Operação

Em seguida, o sistema do fundo cria a operação, envia os documentos e define os signatários, por chamada direta ou arquivo CNAB 444.

3

Assinatura

Depois, a Flixsign dispara os links por e-mail ou WhatsApp e cada signatário assina pelo celular, com ou sem certificado ICP-Brasil, tudo em lote.

4

Eventos e registro

Por fim, um webhook avisa o seu sistema a cada etapa. Os títulos seguem a registro e a trilha de evidências fica com data e hora de cada passo.

Eventos de webhook

Seu sistema fica sabendo de cada passo, sem consultar a API em intervalos

Você cadastra a URL de destino por conta e recebe um aviso em JSON a cada evento da operação. Os nomes abaixo são os eventos disponíveis hoje; os campos de cada aviso estão na documentação.

EventoQuando disparaO que o seu sistema pode fazer
Assinaturas
signatario.assinouUm signatário concluiu a assinatura dos documentos que lhe cabem.Atualizar o status do cedente ou do fundo na operação.
signatario.recusouUm signatário recusou assinar.Abrir um chamado para a mesa e interromper o fluxo da cessão.
Envelopes
envelope.finalizadoTodos os signatários do envelope assinaram.Baixar os documentos assinados e seguir para o registro.
envelope.canceladoO envelope foi cancelado.Encerrar a operação no sistema do fundo.
envelope.expiradoO prazo para assinatura venceu sem conclusão.Reenviar a operação ou cancelar a cessão.
envelope.deletadoO envelope foi excluído.Limpar referências no sistema do fundo.
Operações
operacao.grupoassinouUm grupo de signatários concluiu a sua etapa.Liberar a etapa seguinte do fluxo interno.
operacao.finalizadaA operação foi concluída.Dar a cessão como formalizada e iniciar a liquidação.
operacao.canceladaA operação foi cancelada.Estornar a cessão no sistema do fundo.
operacao.falhaenvioHouve falha no envio da operação.Alertar a mesa e tentar novamente.
Notas fiscais
nota.eventoHouve um novo evento em uma nota fiscal monitorada.Registrar o evento no acompanhamento do lastro da operação.
Sem polling. Em vez de consultar a API a cada minuto para saber se o cedente assinou, o seu sistema recebe o aviso no momento do evento e responde com a próxima etapa: registro, liquidação ou conciliação.
Autenticação, ambientes e segurança

Credencial própria, dados isolados por conta e um ambiente para testar

A API de assinatura eletrônica segue o padrão que o time de tecnologia do fundo já conhece: HTTPS, JSON e especificação OpenAPI (Swagger) de cada serviço, com os esquemas de requisição e resposta.

Token de integração por empresa

Cada empresa recebe a própria credencial, enviada no cabeçalho de cada chamada. Ela não depende da sessão de um usuário da tela.

Isolamento por conta

Cada conta enxerga apenas os próprios dados: operações, documentos, signatários e webhooks ficam no escopo da credencial.

Criptografia e LGPD

Documentos criptografados do envio ao arquivamento e dados pessoais tratados conforme a LGPD.

Homologação antes da produção

Ambiente de homologação para desenvolver e testar a integração de ponta a ponta antes de ligar em produção.

Ilustração 3D de notebook e servidor conectados a um documento aprovado, representando a API de assinatura eletrônica da Flixsign
Feita por quem opera

A integração faz o que a mesa já faz, sem camada paralela

A Flixsign nasceu na mesa de operações. Por isso, a API de assinatura eletrônica expõe os mesmos objetos que o time usa na tela, operação, envelope, signatário e título, e devolve respostas padronizadas, com código, mensagem e dados em cada chamada.

  • REST
  • JSON
  • HTTPS
  • OpenAPI
  • Webhooks
  • CNAB 444
  • Com e sem ICP-Brasil
  • E-mail e WhatsApp
  • Notas fiscais
  • Conciliação
Sistema do fundocria a operação e envia os documentos
API Flixsignformaliza e dispara as assinaturas
Signatáriosassinam pelo celular, em lote
Webhookavisa o seu sistema a cada evento
Perguntas frequentes

Dúvidas do time de tecnologia sobre a API de assinatura eletrônica

Não achou a sua? Fale com o time técnico.

Preciso integrar para usar a Flixsign?
Não. A plataforma funciona pela tela, com entrada das operações por upload ou arquivo CNAB 444. A API é para quem quer que o sistema do fundo crie as operações e receba os eventos automaticamente.
A API é REST? Em que formato?
Sim. A API de assinatura eletrônica da Flixsign usa chamadas HTTPS, com JSON na requisição e na resposta. Além disso, cada serviço tem a sua especificação OpenAPI (Swagger), com os esquemas de entrada e saída.
Como funciona a autenticação?
Por token. A empresa recebe um token de integração próprio, enviado no cabeçalho de cada chamada. Ele não depende da sessão de um usuário da tela e, além disso, vale apenas para os dados da própria conta.
Existe ambiente de testes?
Sim. Há um ambiente de homologação para desenvolver e testar a integração de ponta a ponta antes de ligar em produção.
Como o meu sistema fica sabendo que a cessão foi assinada?
Por webhook. Você cadastra a URL do seu sistema e recebe um aviso em JSON a cada evento: assinatura concluída, recusa, envelope finalizado, operação concluída e evento de nota fiscal, entre outros, sem precisar consultar a API em intervalos.
Dá para assinar com e sem certificado ICP-Brasil pela API?
Sim. Na API de assinatura eletrônica, cada documento segue na modalidade que a operação exige, e a assinatura em lote cobre os dois casos. O cedente recebe o link por e-mail ou WhatsApp e, em seguida, assina pelo celular, sem cadastro prévio.
Quanto tempo leva uma integração?
Depende do escopo. Uma integração que cria operações e recebe webhooks é mais curta; por outro lado, fluxos com CNAB 444, registro e notas fiscais pedem mais etapas de homologação. O time técnico ajuda a dimensionar o seu caso.
A Flixsign faz registro, escrituração ou custódia?
Não. A Flixsign formaliza os documentos e encaminha os títulos a registro, mas não é escrituradora, registradora nem custodiante. No lastro, confere na base oficial da NF-e se cada nota existe e qual é o status dela, antes e depois da cessão; a responsabilidade regulatória pela verificação continua com o gestor e o custodiante.
Integração

Vamos desenhar a integração do seu fundo?

Deixe seu contato e o time técnico retorna com o caminho de integração da API de assinatura eletrônica, o acesso à documentação e ao ambiente de homologação.

  • Documentação OpenAPI e ambiente de homologação
  • Mapeamento do fluxo: entrada, assinatura, registro e notas fiscais
  • Próximos passos e prazos com o time técnico

Fale com o time técnico

Leva dois minutos. Retornamos pelo canal que você preferir.