---
name: Sicoob API - config OAuth e certificado
description: Scopes OAuth, localizacao e formato do certificado PFX para integracao Sicoob (boletos)
type: reference
originSessionId: 2b74afa8-ad08-407b-80cf-49ce17097f66
---
# Sicoob API

## OAuth scopes

```
boletos_consulta boletos_alteracao boletos_inclusao
```

## Certificado

- **Local**: `writable/uploads/certificados/`
- **Formato**: PFX
- **Senha**: criptografada AES-256-CBC

## Endpoints diagnosticos (controller `Sicoob`)

- `GET /sicoob/diagnostico-boleto/{nossoNumero}?token={CRON_TOKEN_SECRETO}` — consulta direta no Sicoob
- `GET /sicoob/cancelar-diagnostico/{nossoNumero}?token={CRON_TOKEN_SECRETO}` — cancela boleto sem auth de sessao

## Particularidades

- Sicoob retorna `valorPago = 0` mesmo em boletos liquidados → validar via `situacaoBoleto = liquidado` E `LIQUIDACAO` em `listaHistorico`. Detalhes: [[auditoria_cobranca_2026_04_17]]
- Flag `boletos.ignorar_sync_sicoob = 1` impede o cron de alterar status do boleto (para reconciliacao manual).
- Apos protesto ativo ~20 dias, Sicoob da BAIXA POR PROTESTO automaticamente — protesto continua ATIVO no cartorio (CRA). Para resolver: gerar novo boleto + `Sicoob::removerProtesto` quando pagar.