Conversão de dados e integração
A carga do acervo e dos leitores do sistema anterior é feita por planilha, e os demais sistemas da Prefeitura conversam com a biblioteca por uma API.
Conversão do acervo
Acervo › Importar planilha recebe um CSV (separado por ";" ou ",", em UTF-8 ou no padrão do Excel). Cada linha é uma obra; obras com ISBN já cadastrado recebem só os novos exemplares. Baixe a planilha modelo na própria tela.
Colunas: isbn, titulo*, subtitulo, autores, editora, local_publicacao, ano, edicao, assuntos, cdd, cutter, idioma, paginas, tipo_material, serie, notas; para exemplares, tombo (vários separados por "|") ou exemplares (quantidade, com tombo automático), e localizacao, forma_aquisicao, data_aquisicao, valor.
O resultado mostra linhas lidas, obras e exemplares criados e cada linha recusada com o motivo (ISBN inválido, tombo repetido…), para correção e nova carga. Leitores são importados do mesmo jeito (manual Cadastro de leitores).
API de integração com a Gestão Pública
Administração › Integração (API) gera tokens de acesso para os demais sistemas da Prefeitura (ERP, portal da transparência, rede de ensino, BI). O token aparece uma única vez e pode ser revogado.
| Método | Endereço | Uso |
|---|---|---|
| GET | /api/v1/status |
Disponibilidade (sem token) |
| GET | /api/v1/indicadores |
Totais de acervo, leitores, empréstimos, atrasos, multas |
| GET | /api/v1/acervo?q= |
Pesquisa no acervo |
| GET | /api/v1/acervo/{id} |
Ficha e exemplares |
| GET | /api/v1/patrimonio |
Relação patrimonial (tombos, valores, baixas) |
| GET/POST | /api/v1/leitores |
Consulta e sincronização de leitores por CPF |
| GET | /api/v1/emprestimos?de=&ate= |
Movimentação |
| GET | /api/v1/inadimplentes |
Atrasos e multas |
Autenticação: cabeçalho Authorization: Bearer <token>. O último uso de cada token fica registrado, e as gravações entram na auditoria.