Dados abertos e layout de importação
Todas as listas do portal podem ser baixadas em CSV (abre no Excel) e JSON. Abaixo está o layout que os sistemas da prefeitura (contabilidade, folha, farmácia) usam para enviar os dados, por planilha ou pela API.
Como enviar
- Planilha: CSV separado por ponto e vírgula (UTF-8 ou Latin-1) ou XLSX, com a primeira linha igual aos nomes das colunas. Números como 1.234,56 ou 1234.56; datas como dd/mm/aaaa.
- Atualização: reenviar a mesma chave (por exemplo, o mesmo empenho) atualiza o registro, então dá para reenviar o mês inteiro.
- Prazo: despesas e receitas devem estar no portal até o primeiro dia útil seguinte ao registro (Decreto nº 7.185/2010).
Receitas orçamentárias (receitas)
Baixar modelo CSV
Uma linha por natureza de receita e mês, com a previsão e o arrecadado no mês. Reenviar o mesmo mês substitui os valores.
| Coluna | Tipo | Obrigatória | Descrição | Exemplo |
|---|---|---|---|---|
| exercicio | número inteiro | Sim | Ano do orçamento | 2026 |
| mes | número inteiro | Sim | Mês da arrecadação (1 a 12) | 10 |
| unidade_gestora | texto | – | Sigla ou código da unidade gestora (a sigla da secretaria liga ao órgão) | PMT |
| codigo | texto | Sim | Natureza da receita | 1.1.1.2.50.0.1 |
| descricao | texto | Sim | Descrição da natureza | IPTU – principal |
| categoria | texto | – | corrente, capital ou intra | corrente |
| fonte | texto | – | Fonte de recurso | 1.500 |
| valor_previsto | valor | – | Previsão atualizada para o mês | 35.000,00 |
| valor_arrecadado | valor | Sim | Arrecadado no mês | 32.418,77 |
| covid | sim ou não | – | sim se a despesa, receita ou contratação é ligada à Covid-19 | não |
Despesas: empenhos (empenhos)
Baixar modelo CSV
Uma linha por nota de empenho. Reenviar o mesmo número atualiza o empenho (por exemplo, com anulações).
| Coluna | Tipo | Obrigatória | Descrição | Exemplo |
|---|---|---|---|---|
| exercicio | número inteiro | Sim | Ano do orçamento | 2026 |
| unidade_gestora | texto | – | Sigla ou código da unidade gestora | SEDUC |
| numero | texto | Sim | Número do empenho | 10150003 |
| data | data | Sim | Data de emissão (dd/mm/aaaa) | 15/10/2026 |
| credor_nome | texto | Sim | Nome do credor | Tecnologia Exemplo Ltda. |
| credor_documento | texto | – | CNPJ ou CPF do credor | 12.345.678/0001-95 |
| funcao | texto | – | Função (código e nome) | 12 – Educação |
| subfuncao | texto | – | Subfunção | 361 – Ensino Fundamental |
| programa | texto | – | Programa | 0012 – Educação de Qualidade |
| acao | texto | – | Projeto ou atividade | 2.015 – Manutenção do Ensino Fundamental |
| natureza_despesa | texto | – | Natureza (elemento) da despesa | 3.3.90.30 |
| fonte | texto | – | Fonte de recurso | 1.540 |
| modalidade_licitacao | texto | – | Modalidade da licitação ou da contratação direta | Pregão eletrônico |
| numero_licitacao | texto | – | Número da licitação | 10.20.002/2026 |
| numero_contrato | texto | – | Número do contrato | 040/2026 |
| historico | texto | – | Histórico (descrição do bem ou serviço) | Aquisição de computadores para as escolas |
| valor_empenhado | valor | Sim | Valor empenhado | 295.000,00 |
| valor_anulado | valor | – | Valor anulado | 0,00 |
| covid | sim ou não | – | sim se a despesa, receita ou contratação é ligada à Covid-19 | não |
Despesas: liquidações (liquidacoes)
Baixar modelo CSV
Uma linha por liquidação, ligada ao empenho pelo exercício, unidade gestora e número do empenho (envie os empenhos antes).
| Coluna | Tipo | Obrigatória | Descrição | Exemplo |
|---|---|---|---|---|
| exercicio | número inteiro | Sim | Ano do empenho | 2026 |
| unidade_gestora | texto | – | Unidade gestora do empenho | SEDUC |
| numero_empenho | texto | Sim | Número do empenho | 10150003 |
| numero | texto | Sim | Número da liquidação | 1 |
| data | data | Sim | Data da liquidação | 28/10/2026 |
| valor | valor | Sim | Valor liquidado | 147.500,00 |
| documento_fiscal | texto | – | Nota fiscal ou documento | NF-e 4512 |
Despesas: pagamentos (pagamentos)
Baixar modelo CSV
Uma linha por pagamento, ligada ao empenho pelo exercício, unidade gestora e número do empenho.
| Coluna | Tipo | Obrigatória | Descrição | Exemplo |
|---|---|---|---|---|
| exercicio | número inteiro | Sim | Ano do empenho | 2026 |
| unidade_gestora | texto | – | Unidade gestora do empenho | SEDUC |
| numero_empenho | texto | Sim | Número do empenho | 10150003 |
| numero | texto | Sim | Número do pagamento (ordem bancária) | OB 3381 |
| data | data | Sim | Data do pagamento | 28/10/2026 |
| valor | valor | Sim | Valor pago | 147.500,00 |
Receitas e despesas extraorçamentárias (extraorcamentarios)
Baixar modelo CSV
Movimento do mês por conta extraorçamentária (retenções, consignações, depósitos, restos a pagar).
| Coluna | Tipo | Obrigatória | Descrição | Exemplo |
|---|---|---|---|---|
| exercicio | número inteiro | Sim | Ano | 2026 |
| mes | número inteiro | Sim | Mês (1 a 12) | 10 |
| natureza | texto | Sim | receita ou despesa | receita |
| unidade_gestora | texto | – | Unidade gestora | PMT |
| codigo | texto | Sim | Código da conta | 2.1.8.8.1.01.02 |
| descricao | texto | Sim | Descrição | INSS retido de terceiros |
| valor | valor | Sim | Valor no mês | 18.230,40 |
Folha de pagamento (folha)
Baixar modelo CSV
Uma linha por servidor na competência. Reenviar a mesma competência e matrícula substitui a linha. O CPF fica criptografado e aparece mascarado no portal.
| Coluna | Tipo | Obrigatória | Descrição | Exemplo |
|---|---|---|---|---|
| competencia | mês/ano | Sim | Mês da folha (mm/aaaa) | 10/2026 |
| matricula | texto | Sim | Matrícula | 120749-0 |
| nome | texto | Sim | Nome do servidor | Maria Exemplo da Silva |
| cpf | texto | – | CPF (opcional, aparece mascarado) | 123.456.789-09 |
| cargo | texto | Sim | Cargo ou função | Professor(a) – 40h |
| vinculo | texto | Sim | efetivo, comissionado, contratado, eletivo, estagiario, aposentado, pensionista ou outro | efetivo |
| unidade | texto | – | Sigla da secretaria ou unidade de lotação | SEDUC |
| data_admissao | data | – | Data de admissão | 01/03/2015 |
| carga_horaria | número inteiro | – | Carga horária semanal | 40 |
| remuneracao_bruta | valor | Sim | Remuneração bruta | 5.130,63 |
| descontos | valor | – | Descontos obrigatórios | 1.120,40 |
| liquido | valor | – | Líquido (se vazio, bruto − descontos) | 4.010,23 |
| covid | sim ou não | – | sim se a despesa, receita ou contratação é ligada à Covid-19 | não |
Medicamentos (medicamentos)
Baixar modelo CSV
Relação municipal de medicamentos com o estoque por farmácia. Reenviar o mesmo código e local atualiza o estoque.
| Coluna | Tipo | Obrigatória | Descrição | Exemplo |
|---|---|---|---|---|
| codigo | texto | Sim | Código do medicamento (CATMAT ou código interno) | BR0267610 |
| nome | texto | Sim | Nome e concentração | Losartana potássica 50 mg |
| apresentacao | texto | – | Apresentação | Comprimido |
| componente | texto | – | basico, estrategico ou especializado | basico |
| local | texto | – | Farmácia ou unidade de saúde | Farmácia Básica Central |
| estoque | número inteiro | Sim | Quantidade em estoque | 1200 |
| unidade_medida | texto | – | Unidade do estoque | comprimido |
| unidade_compra | texto | – | Unidade de compra | caixa com 30 |
| grupo | texto | – | Grupo | Anti-hipertensivos |
| subgrupo | texto | – | Subgrupo | Antagonistas da angiotensina II |
| categoria | texto | – | Categoria do medicamento | Uso contínuo |
| subcategoria | texto | – | Subcategoria do medicamento | Cardiovascular |
API de carga
O token é criado pelo administrador do portal (Transparência → Tokens da API). Cada chamada processa as linhas em segundo plano e devolve o endereço para acompanhar o resultado.
curl -X POST https://vpublica.veredati.com.br/api/v1/cargas/empenhos \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"linhas": [{"exercicio": 2026, "unidade_gestora": "SEDUC", "numero": "10150003", "data": "15/10/2026",
"credor_nome": "Tecnologia Exemplo Ltda.", "credor_documento": "12345678000195", "valor_empenhado": "295000,00"}]}'
# 202 Accepted → {"id": 42, "situacao": "pendente", ...}
curl https://vpublica.veredati.com.br/api/v1/cargas/42 -H "Authorization: Bearer $TOKEN"
# Também aceita o CSV do layout no corpo:
curl -X POST https://vpublica.veredati.com.br/api/v1/cargas/pagamentos -H "Authorization: Bearer $TOKEN" -H "Content-Type: text/csv" --data-binary @pagamentos.csv