Formatos e limites
Regras transversais para identificadores, datas, números, valores ausentes, paginação, intervalos e versões de schema.
Nesta página
Formatos canônicos
| Dado | Formato | Exemplo |
|---|---|---|
| Identificador | string | "000093254403147" |
| Período | YYYY-MM | "2026-07" |
| Data | YYYY-MM-DD | "2026-08-10" |
| Data e hora | ISO 8601 com offset | "2026-08-24T14:00:00Z" |
| Moeda | número em unidade principal | 41.32 BRL |
| Energia | number em kWh | 383 |
| Demanda | number em kW | 75.5 |
| Alíquota | pontos percentuais | 12 significa 12% |
Campos fora do schema da distribuidora são omitidos. Consulte os schemas COPEL e CELESC antes de exigir a presença de um campo.
null, zero e campo vazio
null significa que o valor não está disponível. Zero significa que a origem informou um zero real. Arrays válidos sem linhas usam []. Quando parsing de PDF não foi solicitado, pdf_data usa .
Limites públicos
| Operação | Limite | Comportamento ao exceder |
|---|---|---|
invoice_sync_latest.count | 120 | invalid_job_payload |
invoice_sync_range | 36 períodos | invalid_billing_period |
GET /jobs limit | 200 | invalid_request |
POST /pdf/parse | 20 MiB por padrão | pdf_too_large |
| Trabalhos ativos por cliente | 2.000 | job_limit_exceeded |
| Trabalho ativo idêntico | 1 por alvo | job_already_exists com o jobId atual |
| UCs ativas | Conforme contrato | active_uc_limit_exceeded |
Versões de schema
Envelopes e recursos públicos usam schemaVersion: "3.0". O objeto detalhado de PDF usa pdf_data.schema_version: "2.13". Verifique as duas versões separadamente.