Documentation Index
Fetch the complete documentation index at: https://developers.gyramais.com.br/llms.txt
Use this file to discover all available pages before exploring further.
Resumo: a fonte de benefícios sociais indica se o CPF recebe ou recebeu recentemente programas sociais do governo federal (Bolsa Família/Auxílio Brasil, BPC, Seguro Desemprego, Abono Salarial). É informação de perfil socioeconômico útil em segmentação, calibração de produtos e detecção de uso indevido.
O que é
O Brasil tem uma rede robusta de programas sociais e parte relevante da população adulta recebe algum benefício em algum momento. Para crédito PF, saber se o tomador está em programa social (e em qual) é informação de contexto para segmentar produto e calibrar capacidade. Responde:- O CPF recebe algum benefício social ativo?
- Qual programa? Há quanto tempo?
- Valor mensal aproximado?
- Histórico de passagem por programas?
De onde vem
- Tipo de fonte: bases públicas oficiais (CadÚnico, SIAPE, CAGED, RAIS), consolidadas via agregadores.
- Cobertura geográfica: Brasil, programas federais.
- Natureza do dado: público (participação em programa é informação pública, com nome e valor).
- Base legal: dados públicos conforme Lei de Acesso à Informação, finalidade de análise de crédito.
Frequência de atualização
| Componente | Atualização |
|---|---|
| Bolsa Família / Auxílio Brasil | mensal (ciclo de pagamento) |
| BPC | mensal |
| Seguro Desemprego | conforme parcelas pagas |
| Abono Salarial | anual |
Dados entregues
| Campo | Descrição | Exemplo |
|---|---|---|
socialBenefits.hasActive | Há benefício ativo? | true / false |
socialBenefits.programs[] | Lista de programas | [{...}] |
socialBenefits.programs[].name | Programa | "Bolsa Família", "BPC", "Seguro Desemprego", "Abono Salarial" |
socialBenefits.programs[].status | Ativo/encerrado | "ACTIVE" / "FINISHED" |
socialBenefits.programs[].startDate | Início | "2023-04-01" |
socialBenefits.programs[].endDate | Fim, se encerrado | null |
socialBenefits.programs[].monthlyValue | Valor mensal aproximado | 600.00 |
socialBenefits.totalMonthly | Soma dos benefícios ativos | 600.00 |
Casos de uso
Segmentação de produto PF
Produtos de cartão e consignado podem ter regras específicas para beneficiários (consignado INSS, crédito para BPC).
Capacidade realista
Renda via benefício é parte da capacidade de pagamento, desde que respeitado o teto de comprometimento.
Detecção de inconsistência
CPF recebendo Bolsa Família e com participação em várias empresas ativas é ponto de atenção.
Crédito consignado específico
Produto consignado BPC: identificar elegibilidade pelo campo
programs.name = "BPC".Como usar na política
Não usar como bloqueio genérico
Receber benefício social não é motivo para negar crédito. Pode ser motivo para ajustar produto, limite ou prazo.
Regras positivas para produto específico
Ex: produto consignado INSS só aprova quem tem
socialBenefits.programs.name = "APOSENTADORIA" ou equivalente.Limitações e considerações
- Discriminação: usar “recebe benefício” como critério negativo de crédito pode configurar discriminação. Cada organização deve revisar com sua área jurídica.
- Atraso de ciclo: benefício concedido este mês aparece com 30 a 60 dias de defasagem.
- Histórico limitado: a fonte cobre o ciclo atual e histórico recente (últimos 24-36 meses). Histórico antigo nem sempre está disponível.
- Variação regional: alguns programas estaduais/municipais não estão cobertos.
Perguntas frequentes
Posso recusar crédito por CPF receber Bolsa Família?
Posso recusar crédito por CPF receber Bolsa Família?
Tecnicamente possível, mas juridicamente arriscado. Pode configurar discriminação. Recomendamos usar o campo para segmentação de produto adequado, não para recusa.
BPC conta como renda para cálculo de limite?
BPC conta como renda para cálculo de limite?
Sim, é renda formal e pode ser considerada. Para consignado BPC, é a base do produto.
Seguro Desemprego vira sinal negativo?
Seguro Desemprego vira sinal negativo?
Indica desemprego recente, o que pode impactar capacidade. Tratar como informação contextual, não bloqueio automático.
A pessoa saiu do Bolsa Família recentemente, aparece?
A pessoa saiu do Bolsa Família recentemente, aparece?
Sim, como
status: "FINISHED" com endDate. Útil para entender histórico.Qual nível de relatório inclui benefícios sociais?
Qual nível de relatório inclui benefícios sociais?
Disponível a partir do COMPLETO.
Próximos passos
Financeira
Renda inferida e perfil financeiro.
Cadastral
Situação do CPF como pré-requisito.
Contatos e Localização
Endereços, telefones, e-mails, mapa e fachada.
Criar política PF
Regras e segmentação para produtos PF.