Como integrar API de consignado SIAPE para crédito público

Última atualização: 22 de agosto de 2026

Principais lições deste artigo

• Garantir os pré-requisitos técnicos: credenciamento junto à SGP e Serpro, criação de VPN e configuração de endpoints SOAP V2 são pré-requisitos obrigatórios para integração com o SIAPE.

• Isolar a infraestrutura legada: o siape-adapter atua como camada de tradução REST/JSON para SOAP/XML, isolando o core bancário da infraestrutura legada do governo.

• Versionar o motor de margem: o motor de regras de margem deve ser versionado em arquivos de configuração para refletir automaticamente as reduções anuais da MP 1.355/2026 até 2031.

• Acompanhar a saúde operacional: monitoramento de latência, taxa de anuência e cancelamentos automáticos de reserva é essencial para manter a operação estável.

• A Celcoin fornece a infraestrutura tecnológica para que empresas consigam ofertar produtos de crédito aos seus clientes. Conheça a infraestrutura de crédito da Celcoin.

Checklist de 8 etapas de integração

1. Credenciamento junto à SGP e Serpro.

2. Criação de VPN e whitelist de IPs.

3. Configuração de endpoints SOAP V2.

4. Desenvolvimento do siape-adapter.

5. Implementação do motor de regras de margem 2026.

6. Integração de anuência via SouGov.br.

7. Fluxo de averbação e portabilidade.

8. Monitoramento e tratamento de erros.

1) Contextualização do consignado SIAPE e atores envolvidos

O consignado SIAPE depende de uma integração técnica específica com a folha de pagamento federal. O Sistema Integrado de Administração de Recursos Humanos (SIAPE) é a plataforma do governo federal que gerencia a folha de pagamento dos servidores públicos federais ativos, aposentados e pensionistas. A integração técnica com o SIAPE para operações de crédito consignado público envolve quatro atores principais: a Secretaria de Gestão de Pessoas (SGP) do Ministério da Gestão e da Inovação em Serviços Públicos, o Serpro como operador da infraestrutura tecnológica, a consignatária credenciada, como uma fintech, um banco digital ou um originador, e o servidor público como tomador do crédito.

O canal de comunicação técnica entre a consignatária e o SIAPE ocorre exclusivamente via Web Service SOAP/XML, com autenticação por certificado digital e tráfego restrito à VPN fornecida pelo Serpro. A anuência do servidor é coletada pelo portal SouGov.br, que substitui fluxos anteriores baseados em papel ou e-mail direto.

A Celcoin não oferece nenhum tipo de empréstimo para consumidores. A Celcoin fornece a infraestrutura tecnológica para que empresas consigam ofertar produtos de crédito aos seus clientes.

2) Diagnóstico inicial: requisitos regulatórios em 2026

Com os atores e canais técnicos mapeados, o próximo passo é entender o ambiente regulatório que governa essas operações. Antes de iniciar qualquer desenvolvimento, equipes de produto e engenharia precisam mapear o marco regulatório vigente. Dois instrumentos normativos definem o ambiente operacional em 2026.

Box de compliance: MP 1.355/2026 e Decreto 12.957/2026

A Medida Provisória nº 1.355, de 4 de maio de 2026 altera a Lei nº 14.509/2022 e estabelece os seguintes limites para consignações facultativas:

• Teto global de 40% da remuneração mensal bruta, com até 5% destinados a cartão de crédito consignado ou saque e até 5% a cartão consignado de benefício ou saque.

• Redução progressiva de dois pontos percentuais ao ano a partir de 14 de janeiro de 2027, até atingir 30% em 2031.

• A margem de 5% para cartão consignado cai para 3% em 2027, 1% em 2028 e é zerada em 2029.

• Para beneficiários do BPC, Lei nº 8.742/1993, aplicam-se limites conforme a regulamentação aplicável.

• Contratos firmados antes de cada novo limite entrar em vigor mantêm as condições originais até a liquidação integral.

O motor de regras de margem da consignatária deve ser versionado para refletir automaticamente cada redução anual sem necessidade de redeploy manual.

3) Execução do processo

Etapa 1: credenciamento junto à SGP e Serpro

O credenciamento como consignatária autorizada começa com um protocolo formal junto à SGP. Esse protocolo exige apresentação de documentação societária, comprovação de regularidade fiscal e assinatura de termo de adesão ao sistema. Após aprovação da SGP, a consignatária recebe o código de consignatária que será utilizado em todas as chamadas ao Web Service.

Etapa 2: criação de VPN e whitelist de IPs

A integração com o SIAPEnet exige a criação de uma VPN dedicada com o Serpro, solicitada por e-mail para consignatarias@serpro.gov.br com assunto “[VPN] Informações para Criação de VPN”. O e-mail deve incluir CNPJ, razão social e dados de contato dos representantes comercial e técnico.

Dica útil: documente todos os IPs de saída dos ambientes de homologação e produção antes de abrir o chamado ao Serpro. Alterações posteriores de IP exigem novo processo de whitelist e podem interromper operações em produção.

Etapa 3: configuração de endpoints SOAP V2

Configurar corretamente os endpoints SOAP V2 garante acesso estável às operações do SIAPE. Consulte a documentação oficial para os endereços e detalhes de configuração. Todas as integrações devem usar o V2:

• Homologação: endpoint de homologação conforme manual, com WSDL acessível em ?wsdl.

• Produção: endpoint de produção conforme manual, com WSDL acessível em ?wsdl.

Uma vez configurados esses endpoints, a aplicação passa a ter acesso às operações disponíveis no V2, que incluem incluirContratoV2, renovarContratoV2, incluirContratoPortabilidade, consultarAnuenciaContratos e consultarAutorizacoesMargemConsignavel.

Etapa 4: desenvolvimento do siape-adapter

O siape-adapter funciona como um microserviço de isolamento entre o core bancário e o SIAPE. Esse serviço traduz chamadas REST/JSON internas da plataforma da consignatária para o protocolo SOAP/XML exigido pelo Serpro, e faz o caminho inverso na resposta. Essa camada de abstração impede acoplamento direto entre o core bancário e a infraestrutura legada do governo.

Boas práticas para o siape-adapter:

• Implementar circuit breaker para lidar com indisponibilidades do endpoint Serpro sem propagar falhas para o fluxo de originação.

• Versionar o contrato interno do adapter, por exemplo, /v1/contratos e /v2/contratos, de forma independente do versionamento do WSDL externo.

• Armazenar logs estruturados em JSON com correlationId para rastreabilidade ponta a ponta entre a chamada interna e a resposta SOAP.

• Manter o adapter inacessível diretamente pela internet, deixando o acesso restrito à rede interna ou a um service mesh.

Etapa 5: implementação do motor de regras de margem 2026

O motor de regras de margem precisa calcular a margem consignável disponível aplicando os limites descritos no box de compliance acima antes de qualquer chamada de inclusão de contrato. A lógica deve ficar externalizada em arquivo de configuração versionado, como YAML ou JSON, o que permite atualizar os percentuais a cada virada de ano sem alteração de código.

Dica útil: implemente testes automatizados parametrizados que simulem os limites de cada ano entre 2026 e 2031. Esses testes garantem que o motor aplique corretamente as reduções anuais sem intervenção manual.

Etapa 6: integração de anuência via SouGov.br

A anuência é obrigatória antes do desconto em folha para novos contratos e renovações. O fluxo opera da seguinte forma:

1. A consignatária chama incluirContratoV2 com até três e-mails de notificação e dois callback URLs, um para aceite e outro para recusa.

2. O Serpro notifica o servidor via SouGov.br e dispara o callback configurado após a decisão.

3. A autorização de anuência possui prazos de validade que devem ser observados para evitar expiração.

4. Os códigos de status relevantes são 10 para Aguardando Anuência, 11 para Anuência Recusada, 12 para Anuência Expirada e 13 para Anuência Interrompida por Restrição.

Etapa 7: fluxo de averbação e portabilidade

No período de disponibilidade do SIAPE, as operações devem ser submetidas até às 19h, exceto em dias específicos até às 22h. Após a reserva de margem no SIAPE, o banco originador possui um prazo para liberar a margem. O não cumprimento desse prazo pode cancelar a reserva automaticamente. Uma reserva cancelada não pode ser reutilizada imediatamente, sendo necessário aguardar o encerramento do período original antes de nova tentativa.

Operações de portabilidade seguem regras operacionais próprias. Propostas com pendências podem ser canceladas automaticamente após determinado período. O status 09, Portado, confirma a conclusão bem-sucedida da operação.

Etapa 8: monitoramento e tratamento de erros

O siape-adapter deve expor métricas de latência, taxa de erro por operação SOAP e volume de callbacks recebidos. A configuração de alertas deve priorizar cenários de maior impacto operacional, como expiração de anuência, código 12, falha de TED e cancelamento automático de reserva por inatividade.

A Celcoin como adaptador neutro para integração SIAPE

Construir e manter toda essa infraestrutura internamente, com VPN Serpro, siape-adapter, motor de regras versionado, gestão de callbacks e monitoramento, representa custo de engenharia relevante e risco regulatório contínuo. A solução de crédito da Celcoin fornece esse conjunto como infraestrutura modular e pronta para uso, permitindo que fintechs, bancos digitais e originadores foquem na experiência do cliente e na originação, sem construir camadas de integração legada.

Funcionalidade da Celcoin	Benefício para sua empresa
APIs modulares	Integrações mais rápidas, com redução de custos e prazos de desenvolvimento.
Experiência e suporte ao desenvolvedor	Documentação, SDKs e sandboxes reduzem ciclos de integração e custos de engenharia.
Capacidade de lançamento rápido	Módulos pré-construídos e entrega via SaaS aceleram lançamentos e melhoram o tempo para geração de receita.
Distribuição white-label e embutida, embedded	Suporte a produtos financeiros com marca própria.
Escalabilidade com confiabilidade	Solução com alta disponibilidade e escalável na nuvem mantém serviços funcionando mesmo com altos volumes.
Cobertura de diversas possibilidades de pagamentos, incluindo crédito	Oferta de pagamentos e emissão de crédito aumenta conversão, ARPU e fidelização.
Acesso a dados e personalização	Dados e análises via Open Finance permitem ofertas personalizadas e melhoram conversão e retenção.
Compliance e conformidade como princípio	KYC, AML e relatórios integrados reduzem risco regulatório e aceleram ciclos de vendas.
Prevenção de fraude e controles de risco	Monitoramento baseado em IA e autenticação robusta reduzem estornos, perdas e exposição regulatória.
Força do ecossistema de parceiros da Celcoin	Parcerias e integrações com bancos, redes e fintechs ampliam cobertura e velocidade de entrada no mercado.

Conheça a infraestrutura modular de crédito da Celcoin.

4) Validação e monitoramento com indicadores de sucesso

O acompanhamento de indicadores operacionais após o go-live orienta ajustes técnicos e de produto. Após o go-live, os indicadores operacionais prioritários para equipes de engenharia são:

• Taxa de anuência concluída: proporção de contratos que atingem status diferente de 11, 12 ou 13 dentro do prazo de validade.

• Latência do siape-adapter: tempo médio de resposta das chamadas SOAP, com alertas para degradação acima do baseline de homologação.

• Taxa de cancelamento automático de reserva: volume de reservas não liberadas dentro do prazo, o que indica gargalo no fluxo de liberação.

• Cobertura do motor de margem: percentual de propostas rejeitadas pelo motor antes de chegar ao SIAPE, evitando erros de limite no Web Service.

Dashboards operacionais devem cruzar esses indicadores com o calendário de reduções de margem da MP 1.355/2026. Esse cruzamento ajuda a antecipar impactos em volume de propostas aprovadas a cada virada de ano.

Aplicações e desdobramentos

Uma integração SIAPE bem estruturada abre espaço para desdobramentos além da originação básica. A operação pode incluir gestão de risco de carteira com alertas automáticos de afastamento e desligamento do servidor, formalização digital de contratos com emissão de CCB via SCD e cobrança estruturada com rastreabilidade ponta a ponta. Esses módulos compõem a jornada completa de crédito consignado público que a solução de crédito da Celcoin disponibiliza para originadores, correspondentes bancários e fintechs.

Explore como a Celcoin acelera sua operação de crédito consignado.

FAQ

O que é o siape-adapter e por que ele é necessário na integração com o SIAPE?

O siape-adapter é um microserviço de isolamento que traduz chamadas REST/JSON do sistema interno da consignatária para o protocolo SOAP/XML exigido pelo Web Service do Serpro. Esse microserviço é necessário porque o acoplamento direto entre o core bancário e o endpoint SOAP do governo cria fragilidade operacional. Qualquer mudança de versão no WSDL ou indisponibilidade do Serpro impacta diretamente a originação. Com o adapter como camada intermediária, é possível versionar contratos internos de forma independente, implementar circuit breakers e manter logs estruturados sem alterar a lógica de negócio da plataforma principal.

Como o motor de regras de margem deve ser configurado para refletir as mudanças da MP 1.355/2026?

O motor de regras de margem deve externalizar os percentuais de limite em arquivos de configuração versionados, como YAML ou JSON, separados do código da aplicação. Essa abordagem permite atualizar os limites a cada virada de ano conforme o cronograma previsto, sem necessidade de redeploy. A lógica deve calcular a margem disponível aplicando o teto global vigente, os sublimites de cartão consignado e as condições de contratos anteriores, que mantêm suas condições originais até a liquidação. Testes automatizados parametrizados para cada ano entre 2026 e 2031 garantem que o motor aplique corretamente cada redução anual.

Quais são os prazos críticos no fluxo de anuência e portabilidade que podem causar cancelamento automático?

Os prazos críticos no fluxo de anuência e portabilidade exigem monitoramento ativo pelas equipes de engenharia e operações. A autorização de anuência possui validade definida, e contratos não formalizados dentro do prazo podem receber status de anuência expirada. Após a reserva de margem no SIAPE, o banco originador possui um prazo para liberar a margem, e o não cumprimento pode cancelar a reserva automaticamente e impedir reutilização imediata. Propostas de portabilidade com pendências não resolvidas também podem ser canceladas automaticamente pelo sistema. Alertas operacionais devem ser configurados com antecedência suficiente para acionar times de operações antes de cada um desses vencimentos.

A Celcoin oferece crédito consignado diretamente para servidores públicos?

Não. Conforme mencionado anteriormente, a Celcoin atua como provedora de infraestrutura tecnológica para empresas, como fintechs, bancos digitais, originadores e correspondentes bancários, que desejam ofertar crédito consignado público aos seus clientes finais. Essa atuação inclui o adaptador neutro para integração SIAPE, o motor de regras de margem versionado, APIs modulares para toda a jornada de crédito e suporte técnico especializado para equipes de engenharia e produto.

Quais operações SOAP do V2 são indispensáveis para uma integração completa de consignado SIAPE?

Uma integração completa de consignado SIAPE requer ao menos cinco operações do V2. A operação incluirContratoV2 atende novos contratos com fluxo de anuência. A operação renovarContratoV2 trata refinanciamentos. A operação incluirContratoPortabilidade cobre operações de portabilidade. A operação consultarAnuenciaContratos permite verificar o status de anuência. A operação consultarAutorizacoesMargemConsignavel consulta a margem disponível antes da proposta. Todas essas operações estão disponíveis no V2 e devem ser utilizadas nas integrações.