---
title: "Audit Vigilancia"
method: POST
path: "/api/v1/audit/vigilancia"
tags: ["auditoria"]
---

# Audit Vigilancia

`POST /api/v1/audit/vigilancia`

## Request

- Base URL: `https://app.estudoseletricos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.estudoseletricos.com/api/v1/audit/vigilancia`
- Auth: none declared

O relatório MENSAL da vigilância da fatura (P5) — o que o ciclo trouxe.

É documento de serviço pago, atrás da assinatura como o Parecer, e a série de
demonstração também não vira documento. Nada é guardado entre um mês e o
outro: a série enviada é o estado (G260).

## Request body

- VigilanciaIn: O relatório MENSAL da vigilância da fatura (P5): a série da UC e o ciclo do mês.
  - `entrada` AuditoriaIn, required
    - `arquivos` ArquivoIn[]
      - `nome` string, required
      - `conteudo_b64` string, required: o arquivo em base64
    - `demonstracao` boolean: a série de DEMONSTRAÇÃO do núcleo (dado fictício)
    - `parametros` object: as MESMAS chaves da página da plataforma; o que não vier, a regra declara como não executável nomeando o campo
    - `grupos` string[], nullable: None = catálogo inteiro; o filtrado sai como pulado
    - `base_aneel` boolean: consultar a base tarifária da ANEEL (e o Fio B) para esta série. Sem ela, T01, T04 e G01–G03 se declaram não executáveis: a rede vive na casca, e a consulta usa cache local de 24 h
    - `uc` string, nullable: a unidade consumidora auditada quando os documentos trazem mais de uma (o relatório agrupado traz dezenas). A série é de UMA UC: sem a escolha, a resposta é 422 com as UCs em `ucs`
  - `competencia` string, nullable: o ciclo do relatório (AAAA-MM); vazio = o último da série
  - `ident` Ident: Identificação do memorial — o que o expander do app pede antes do PDF.
    - `tag` string: circuito/instalação
    - `empresa` string
    - `resp` string: responsável técnico
  - `white_label` WhiteLabel: A marca do PARCEIRO no documento (S19/M1). Sob white-label a marca da plataforma some do documento INTEIRO, inclusive do Termo de Responsabilidade — resta só a versão do motor. Vale nos TRÊS documentos que o implementam (parecer de faturas, memorial de demanda e de recuperação — o "pacote do parceiro" da G106). Os memoriais das ferramentas e o caderno da planta ainda não o suportam, e por isso não o declaram: campo que o gerador ignora é promessa quebrada em silêncio.
    - `nome` string
    - `logo_png_b64` string, nullable: PNG em base64; passa pelo MESMO gate do upload do app

## Response `200`

Successful Response

## Other responses

- `402`: exige assinatura ativa
- `422`: série de demonstração, ciclo fora da série ou documento ilegível

---

[API](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api.md) · [All operations](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api/revisions/5877d717cb1b?raw)