Consignado do Exército — Introdução
API para originação de CCB consignado para militares do Exército Brasileiro (ativos, inativos e pensionistas). A reserva de margem é feita via Zetra (eConsig) e o ciclo todo — consulta de margem, emissão, averbação, desembolso e cancelamento — passa por essa plataforma.
| Item | Valor |
|---|---|
| Autoridade pagadora | Exército Brasileiro / Zetra (eConsig) |
Tipo de garantia (collateral_type) | military_payroll |
| Modelo de reserva | Averbação (assíncrona, consentida via documento de autorização) |
| Funcionamento | 24h por dia, todos os dias, inclusive feriados |
| Modalidades suportadas | Margem Livre (Crédito Novo) e Portabilidade + Refinanciamento |
| Token | Obrigatório na consulta de margem (senha do sistema militar) |
| Instrumento | CCB (via POST /debt) |
Atenção!
Os webhooks da QI Tech não devem ser mapeados de forma restrita. Campos adicionais podem ser incluídos aos payloads dos webhooks retornados em nossas APIs.
Reenvio de Webhooks
Você pode consultar e reenviar webhooks seguindo as instruções detalhadas na documentação: Reenvio de Webhooks.
Fluxo End-to-End
Modalidades
A operação se divide em três modalidades, escolhidas no collateral_data:
| Modalidade | reservation_type | Quando usar | Doc |
|---|---|---|---|
| Margem Livre (Crédito Novo) | new_credit | Militar com margem disponível; sem dívida externa nem refin de operação ativa | → Margem Livre |
| Refinanciamento | refinancing + operation_key | Renegociar operação QI ativa (prazo/taxa), eventualmente liberando troco | → Port + Refin |
| Portabilidade (com ou sem troco) | refinancing + original_contract_number | Trazer dívida de outro banco; pode incluir troco | → Port + Refin |
Pré-requisitos
Antes de qualquer requisição (Consulta, Emissão, etc):
- Upload do consentimento do militar via
POST /upload→ retornadocument_key. Ver Upload de Documentos. - Conhecer o token (senha do sistema militar Zetra) do borrower — é obrigatório no payload de
POST /military_payroll/balance.
Referência por área
- Consulta de Margem — endpoint
/military_payroll/balance+ token Zetra - Margem Livre — Simulação + Emissão para
new_credit - Portabilidade + Refinanciamento — Simulação + Emissão para
refinancing - Formalização — 5 modelos: QI Sign, PDF, opt-in, zip, selfie
- Cancelamento, Desaverbação e Reversal — pré + pós-desembolso + reversal automático
- Webhooks — todos os eventos assíncronos + payloads
- Mapa de Status — enumeradores consolidados
- Mocks (Sandbox) — dados de teste e cenários end-to-end