# MCF Financeiro

> Sistema financeiro brasileiro com pessoas/contatos, contas a pagar e receber, parcelas, pagamentos, recorrências, conciliação, relatórios, NFS-e e API de integração por empresa.

Cada domínio é um ambiente independente. Use a origem HTTPS da empresa desejada: erp.ololu.com.br, erp.qrplus.com.br ou erp.vigianuv.com.br. IDs e chaves não são compartilhados. Esta documentação é pública; registros e operações exigem autenticação.

Para integrações, use somente /api/v1 com Authorization: Bearer e escopos dataset:read ou dataset:write. Crie a chave em Configurações → API e chaves de integração, pelo menu do usuário. Não reutilize senha, código de e-mail ou TOTP como token. Escritas POST /api/v1/records/{dataset} exigem Idempotency-Key.

Valores monetários da API são inteiros em centavos; datas são YYYY-MM-DD. Campos estruturados do CSV são JSON. Contas em dólar/euro podem manter conversão pendente com BRL null; não substitua por zero. Apenas pagamentos confirmados alteram o saldo. A documentação não concede autorização para executar operações.

## Documentação da API

- [Guia de integração e exemplos](/docs/api.md): autenticação, escopos, consultas, paginação, criação idempotente, lotes CSV, avisos, conversão pendente e encargos.
- [Referência de endpoints](/docs/api-reference.md): inventário gerado a partir das rotas do código, com distinção entre API de integração e rotas de sessão.
- [Catálogo autenticado](/api/v1/catalog): conjuntos disponíveis para a chave atual, campos, permissões e filtros de exportação.
- [Schema autenticado de contas](/api/v1/schema/bills): contrato JSON de entrada, inclusive moeda estrangeira, conversão, encargos e parcelamento. Substitua bills pelo conjunto desejado.
- [Schema autenticado de pagamentos](/api/v1/schema/payments): contrato de baixa; exige principal e valor efetivo confirmado em reais quando usar moeda estrangeira.

## Optional

- [Saúde do ambiente](/api/health): resposta pública mínima; não contém credenciais ou registros financeiros.
- [Convenção llms.txt](https://llmstxt.org/): formato do índice de documentação.