> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.groner.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# API Engenharia — projeto técnico, visitas e homologação

Referência de **Engenharia** para integrar as operações descritas abaixo.

[Guia principal e downloads](https://ajuda.groner.app/pt-br/article/documentacao-da-api-groner-crm-vz2bq2/) · [Exemplos](#2-exemplos-de-requisicao-e-resposta) · [Endpoints](#2-referencia-dos-endpoints)

|| Revisão: **14/10/2026**. Classificação conferida nos clients dos produtos e nas rotas registradas do servidor. Respostas abaixo são exemplos completos do contrato escolhido com dados fictícios, não capturas de produção.

## Índice clicável

[Projetos de engenharia — ProjetosEngenharia](#3-projetos-de-engenharia-projetosengenharia) · [Visitas técnicas — VisitaTecnica](#3-visitas-tecnicas-visitatecnica) · [Homologação e vistoria — HomologacaoVistoria](#3-homologacao-e-vistoria-homologacaovistoria) · [Status do projeto técnico — StatusProjetoEngenharia](#3-status-do-projeto-tecnico-statusprojetoengenharia) · [Automações do projeto técnico — AutomacoesStatusProjetoEngenharia](#3-automacoes-do-projeto-tecnico-automacoesstatusprojetoengenharia) · [Automações de visita técnica — AutomacaoStatusVisitaTecnica](#3-automacoes-de-visita-tecnica-automacaostatusvisitatecnica) · [Automações de homologação — AutomacoesStatusHomologacaoVistoria](#3-automacoes-de-homologacao-automacoesstatushomologacaovistoria) · [Unidades consumidoras — UnidadeConsumidora](#3-unidades-consumidoras-unidadeconsumidora) · [Concessionárias — Concessionaria](#3-concessionarias-concessionaria)

---

## Como usar esta referência

**API central:** `https://{tenant}.api.groner.app`. Use `API_URL` com o host da empresa, sem `/api`. Envie Bearer. O middleware retorna o envelope `Content`; tabelas avançadas, downloads e 204 possuem transporte próprio. A operação e a função do usuário determinam o acesso.

Substitua tenant/token pelo ambiente autorizado e IDs de exemplo pelos cadastros reais. Os comandos são Bash; no PowerShell use `curl.exe` e adapte variáveis e continuação de linha.

**Recursos compartilhados:** a organização segue a finalidade principal da operação, não exclusividade de produto. Um client consumir um controller não significa que todas as actions desse controller sejam liberadas para aquele usuário. Consulte guard e contrato.

## Exemplos de requisição e resposta

### Consultar o resumo dos projetos de engenharia

**Requisição completa (Bash):**

```bash
curl --request GET \
  --url "$API_URL/api/AbaComplementar/ProjetosEngenharia/Summary" \
  --header "Authorization: Bearer $TOKEN" \
  --header "Accept: application/json"
```

**Resposta ilustrativa — HTTP 200:**

```json
{
  "Version": "1.0.0.0",
  "StatusCode": 200,
  "Message": "Requisição efetuada com suceesso.",
  "Content": {
    "totalProjetos": 0,
    "totalAprovados": 0,
    "totalPendentes": 0,
    "totalCancelados": 0,
    "totalReprovados": 0,
    "totalAguardando": 0,
    "valorTotal": 0,
    "valorAguardando": 0,
    "valorPendente": 0,
    "valorCancelado": 0,
    "valorReprovado": 0,
    "valorAprovado": 0,
    "totalEmAndamento": 0,
    "valorEmAndamento": 0
  }
}
```

O DTO de criação de projeto de engenharia recebe `ProjetoId` e `StatusId` opcional. O status técnico é independente de `StatusProjeto` comercial. A criação exige negócio existente e status de engenharia configurado. Visita técnica e homologação são processos técnicos; instalação e OS têm referência própria em Serviços/OS.

---

## Referência dos endpoints

### Projetos de engenharia — ProjetosEngenharia

**Uso encontrado nos clients:** Groner light. Compartilhamento não amplia permissões.

#### `GET /api/AbaComplementar/ProjetosEngenharia/{id}`

**path** `id`: `long`.

**Retorno declarado:** `Task<ActionResult<dynamic>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

#### `GET /api/AbaComplementar/ProjetosEngenharia`

**query** `projetoId`: `long`.

**Retorno declarado:** `Task<ActionResult<dynamic>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

#### `POST /api/AbaComplementar/ProjetosEngenharia`

**body** `dto`: `ProjetoEngenhariaInputDTO` — [ProjetoEngenhariaInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-05-1euyfrd/#3-projetoengenhariainputdto).

**Retorno declarado:** `Task<IActionResult>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

#### `PUT /api/AbaComplementar/ProjetosEngenharia/{id}`

**path** `id`: `long`; **body** `dto`: `EditarPropriedadeInputDTO` — [EditarPropriedadeInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-02-1y50x5n/#3-editarpropriedadeinputdto).

**Retorno declarado:** `Task<ActionResult<dynamic>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

#### `GET /api/AbaComplementar/ProjetosEngenharia/Lista`

**query** `filtro`: `FiltroProjetoEngenhariaInputDTO` — [FiltroProjetoEngenhariaInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-03-186hp04/#3-filtroprojetoengenhariainputdto); **query** `pagingParams`: `PagingParams`.

**Retorno declarado:** `Task<ActionResult<PagedList<dynamic>>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

#### `GET /api/AbaComplementar/ProjetosEngenharia/CardsIniciais`

**query** `filtro`: `FiltroProjetoEngenhariaInputDTO` — [FiltroProjetoEngenhariaInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-03-186hp04/#3-filtroprojetoengenhariainputdto); **query** `pageSize`: `int` (padrão `10`).

**Retorno declarado:** `Task<ActionResult<List<KanbanStatusProjetoEngenhariaDTO>>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

#### `DELETE /api/AbaComplementar/ProjetosEngenharia/{id}`

**path** `id`: `long`.

**Retorno declarado:** `Task`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

#### `GET /api/AbaComplementar/ProjetosEngenharia/Summary`

**query** `filtro`: `FiltroProjetoEngenhariaInputDTO` — [FiltroProjetoEngenhariaInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-03-186hp04/#3-filtroprojetoengenhariainputdto).

**Retorno declarado:** `Task<SummaryProjetoEngenhariaDTO>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

#### `GET /api/AbaComplementar/ProjetosEngenharia/ResumoPorProjetista`

**query** `filtro`: `FiltroProjetoEngenhariaInputDTO` — [FiltroProjetoEngenhariaInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-03-186hp04/#3-filtroprojetoengenhariainputdto).

**Retorno declarado:** `Task<List<ResumoProjetistaProjEngDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

#### `GET /api/AbaComplementar/ProjetosEngenharia/TabelaAvancada`

**query** `loadOptions`: `DataSourceLoadOptions`.

**Retorno declarado:** `Task<LoadResult>`. **Acesso:** Acesso sujeito às regras do ambiente; use a credencial da integração e confirme a permissão desta operação.

[Voltar ao índice](#2-indice-clicavel)

### Visitas técnicas — VisitaTecnica

**Uso encontrado nos clients:** Groner light, Groner os. Compartilhamento não amplia permissões.

#### `GET /api/AbaComplementar/VisitaTecnica/{id}`

**path** `id`: `long`.

**Retorno declarado:** `Task<dynamic>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

#### `POST /api/AbaComplementar/VisitaTecnica`

**body** `dto`: `VisitaTecnicaInputDTO` — [VisitaTecnicaInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-06-16y2x3u/#3-visitatecnicainputdto).

**Retorno declarado:** `Task<ActionResult<dynamic>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

#### `PUT /api/AbaComplementar/VisitaTecnica`

**query** `id`: `long`; **body** `dto`: `EditarPropriedadeInputDTO` — [EditarPropriedadeInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-02-1y50x5n/#3-editarpropriedadeinputdto).

**Retorno declarado:** `Task<ActionResult<dynamic>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

#### `GET /api/AbaComplementar/VisitaTecnica/Lista`

**query** `pagingParams`: `PagingParams`; **query** `filtro`: `FiltroVisitaTecnicaInputDTO` — [FiltroVisitaTecnicaInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-03-186hp04/#3-filtrovisitatecnicainputdto).

**Retorno declarado:** `Task<PagedList<dynamic>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

#### `GET /api/AbaComplementar/VisitaTecnica/Summary`

**query** `filtro`: `FiltroVisitaTecnicaInputDTO` — [FiltroVisitaTecnicaInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-03-186hp04/#3-filtrovisitatecnicainputdto).

**Retorno declarado:** `Task<SummaryVisitaTecnicaDTO>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

#### `DELETE /api/AbaComplementar/VisitaTecnica/{id}`

**path** `id`: `long`.

**Retorno declarado:** `Task`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

#### `GET /api/AbaComplementar/VisitaTecnica/TabelaAvancada`

**query** `loadOptions`: `DataSourceLoadOptions`.

**Retorno declarado:** `Task<LoadResult>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

### Homologação e vistoria — HomologacaoVistoria

**Uso encontrado nos clients:** Groner light. Compartilhamento não amplia permissões.

#### `GET /api/AbaComplementar/HomologacaoVistoria/{id}`

**path** `id`: `long`.

**Retorno declarado:** `Task<ActionResult<HomologacaoVistoriaOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

#### `GET /api/AbaComplementar/HomologacaoVistoria`

**query** `projetoId`: `long`.

**Retorno declarado:** `Task<ActionResult<HomologacaoVistoriaOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

#### `GET /api/AbaComplementar/HomologacaoVistoria/Lista`

**query** `query`: `string`; **query** `pagingParams`: `PagingParams`.

**Retorno declarado:** `Task<ActionResult<Safeleads.Services.PagedList<dynamic>>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

#### `POST /api/AbaComplementar/HomologacaoVistoria`

**body** `dto`: `HomologacaoVistoriaInputDTO` — [HomologacaoVistoriaInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-03-186hp04/#3-homologacaovistoriainputdto).

**Retorno declarado:** `Task<IActionResult>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

#### `PUT /api/AbaComplementar/HomologacaoVistoria/{id}`

**path** `id`: `long`; **body** `dto`: `EditarPropriedadeInputDTO` — [EditarPropriedadeInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-02-1y50x5n/#3-editarpropriedadeinputdto).

**Retorno declarado:** `Task<ActionResult<HomologacaoVistoriaOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

#### `GET /api/AbaComplementar/HomologacaoVistoria/TabelaAvancada`

**query** `loadOptions`: `DataSourceLoadOptions`.

**Retorno declarado:** `Task<LoadResult>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,PreVendedor,Vendedor,Gerente,Tecnico.

[Voltar ao índice](#2-indice-clicavel)

### Status do projeto técnico — StatusProjetoEngenharia

**Uso encontrado nos clients:** Groner light. Compartilhamento não amplia permissões.

#### `GET /api/StatusProjetoEngenharia`

**query** `filtro`: `QueryOnlyFiltroInputDTO` — [QueryOnlyFiltroInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-05-1euyfrd/#3-queryonlyfiltroinputdto); **query** `pagingParams`: `PagingParams`.

**Retorno declarado:** `ActionResult<PagedList<StatusProjetoEngenharia>>`. **Acesso:** Bearer; perfis declarados: Administrador,PreVendedor,Vendedor,Tecnico,Supervisor,Gerente.

[Voltar ao índice](#2-indice-clicavel)

#### `GET /api/StatusProjetoEngenharia/{id}`

**path** `id`: `long`.

**Retorno declarado:** `ActionResult<StatusProjetoEngenharia>`. **Acesso:** Bearer; perfis declarados: Administrador,PreVendedor,Vendedor,Tecnico,Supervisor,Gerente.

[Voltar ao índice](#2-indice-clicavel)

#### `POST /api/StatusProjetoEngenharia`

**body** `model`: `NomeInputDto` — [NomeInputDto](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-04-62zu2h/#3-nomeinputdto).

**Retorno declarado:** `Task<ActionResult<StatusProjetoEngenharia>>`. **Acesso:** Bearer; perfis declarados: Administrador,PreVendedor,Vendedor,Tecnico,Supervisor,Gerente.

[Voltar ao índice](#2-indice-clicavel)

#### `PUT /api/StatusProjetoEngenharia/{id}`

**path** `id`: `long`; **body** `model`: `EditarPropriedadeInputDTO` — [EditarPropriedadeInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-02-1y50x5n/#3-editarpropriedadeinputdto).

**Retorno declarado:** `Task<ActionResult<StatusProjetoEngenharia>>`. **Acesso:** Bearer; perfis declarados: Administrador,PreVendedor,Vendedor,Tecnico,Supervisor,Gerente.

[Voltar ao índice](#2-indice-clicavel)

#### `DELETE /api/StatusProjetoEngenharia/{id}`

**path** `id`: `long`.

**Retorno declarado:** `Task`. **Acesso:** Bearer; perfis declarados: Administrador,PreVendedor,Vendedor,Tecnico,Supervisor,Gerente.

[Voltar ao índice](#2-indice-clicavel)

#### `GET /api/StatusProjetoEngenharia/Tipos`

Sem parâmetros de cliente declarados na assinatura; confira transportes especiais na operação..

**Retorno declarado:** `List<TipoStatusEnumProjetoEngenharia>`. **Acesso:** Bearer; perfis declarados: Administrador,PreVendedor,Vendedor,Tecnico,Supervisor,Gerente.

[Voltar ao índice](#2-indice-clicavel)

### Automações do projeto técnico — AutomacoesStatusProjetoEngenharia

**Uso encontrado nos clients:** Groner light. Compartilhamento não amplia permissões.

#### `GET /api/AutomacoesStatusProjetoEngenharia`

**query** `pagingParams`: `PagingParams`.

**Retorno declarado:** `ActionResult<PagedList<AutomacaoStatusProjetoEngenharia>>`. **Acesso:** Bearer; perfis declarados: Administrador,PreVendedor,Vendedor,Tecnico,Gerente,Supervisor.

[Voltar ao índice](#2-indice-clicavel)

#### `POST /api/AutomacoesStatusProjetoEngenharia`

**body** `model`: `AddAutomacaoStatusProjetoEngenhariaInputDTO` — [AddAutomacaoStatusProjetoEngenhariaInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-01-12uez99/#3-addautomacaostatusprojetoengenhariainputdto).

**Retorno declarado:** `Task<ActionResult<AutomacaoStatusProjetoEngenharia>>`. **Acesso:** Bearer; perfis declarados: Administrador.

[Voltar ao índice](#2-indice-clicavel)

#### `PUT /api/AutomacoesStatusProjetoEngenharia/{id}`

**path** `id`: `long`; **body** `model`: `EditarPropriedadeInputDTO` — [EditarPropriedadeInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-02-1y50x5n/#3-editarpropriedadeinputdto).

**Retorno declarado:** `Task<ActionResult<AutomacaoStatusProjetoEngenharia>>`. **Acesso:** Bearer; perfis declarados: Administrador.

[Voltar ao índice](#2-indice-clicavel)

#### `DELETE /api/AutomacoesStatusProjetoEngenharia/{id}`

**path** `id`: `long`.

**Retorno declarado:** `Task`. **Acesso:** Bearer; perfis declarados: Administrador.

[Voltar ao índice](#2-indice-clicavel)

### Automações de visita técnica — AutomacaoStatusVisitaTecnica

**Uso encontrado nos clients:** Groner light. Compartilhamento não amplia permissões.

#### `GET /api/AutomacaoStatusVisitaTecnica`

Sem parâmetros de cliente declarados na assinatura; confira transportes especiais na operação..

**Retorno declarado:** `Task<ActionResult<List<AutomacaoStatusVisitaTecnica>>>`. **Acesso:** Bearer; perfis declarados: Administrador,PreVendedor,Vendedor,Tecnico,Gerente,Supervisor.

[Voltar ao índice](#2-indice-clicavel)

#### `GET /api/AutomacaoStatusVisitaTecnica/campos`

Sem parâmetros de cliente declarados na assinatura; confira transportes especiais na operação..

**Retorno declarado:** `ActionResult<List<CampoCondicaoVisitaOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,PreVendedor,Vendedor,Tecnico,Gerente,Supervisor.

[Voltar ao índice](#2-indice-clicavel)

#### `POST /api/AutomacaoStatusVisitaTecnica`

**body** `model`: `AddAutomacaoStatusVisitaTecnicaInputDTO` — [AddAutomacaoStatusVisitaTecnicaInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-01-12uez99/#3-addautomacaostatusvisitatecnicainputdto).

**Retorno declarado:** `Task<ActionResult<AutomacaoStatusVisitaTecnica>>`. **Acesso:** Bearer; perfis declarados: Administrador.

[Voltar ao índice](#2-indice-clicavel)

#### `PUT /api/AutomacaoStatusVisitaTecnica/{id}`

**path** `id`: `long`; **body** `model`: `EditarPropriedadeInputDTO` — [EditarPropriedadeInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-02-1y50x5n/#3-editarpropriedadeinputdto).

**Retorno declarado:** `Task<ActionResult<AutomacaoStatusVisitaTecnica>>`. **Acesso:** Bearer; perfis declarados: Administrador.

[Voltar ao índice](#2-indice-clicavel)

#### `DELETE /api/AutomacaoStatusVisitaTecnica/{id}`

**path** `id`: `long`.

**Retorno declarado:** `Task<ActionResult>`. **Acesso:** Bearer; perfis declarados: Administrador.

[Voltar ao índice](#2-indice-clicavel)

### Automações de homologação — AutomacoesStatusHomologacaoVistoria

#### `GET /api/AutomacoesStatusHomologacaoVistoria`

**query** `pagingParams`: `PagingParams`.

**Retorno declarado:** `ActionResult<PagedList<AutomacaoStatusHomologacaoVistoria>>`. **Acesso:** Bearer; perfis declarados: Administrador,PreVendedor,Vendedor,Tecnico,Gerente,Supervisor.

[Voltar ao índice](#2-indice-clicavel)

#### `POST /api/AutomacoesStatusHomologacaoVistoria`

**body** `model`: `AddAutomacaoStatusHomologacaoVistoriaInputDTO` — [AddAutomacaoStatusHomologacaoVistoriaInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-01-12uez99/#3-addautomacaostatushomologacaovistoriainputdto).

**Retorno declarado:** `Task<ActionResult<AutomacaoStatusHomologacaoVistoria>>`. **Acesso:** Bearer; perfis declarados: Administrador.

[Voltar ao índice](#2-indice-clicavel)

#### `PUT /api/AutomacoesStatusHomologacaoVistoria/{id}`

**path** `id`: `long`; **body** `model`: `EditarPropriedadeInputDTO` — [EditarPropriedadeInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-02-1y50x5n/#3-editarpropriedadeinputdto).

**Retorno declarado:** `Task<ActionResult<AutomacaoStatusHomologacaoVistoria>>`. **Acesso:** Bearer; perfis declarados: Administrador.

[Voltar ao índice](#2-indice-clicavel)

#### `DELETE /api/AutomacoesStatusHomologacaoVistoria/{id}`

**path** `id`: `long`.

**Retorno declarado:** `Task`. **Acesso:** Bearer; perfis declarados: Administrador.

[Voltar ao índice](#2-indice-clicavel)

### Unidades consumidoras — UnidadeConsumidora

**Uso encontrado nos clients:** Groner light. Compartilhamento não amplia permissões.

#### `POST /api/UnidadeConsumidora/{id}/AnalisarContaIA`

**path** `id`: `long`.

**Retorno declarado:** `Task<ActionResult<Safeleads.Models.DTO.Output.ContaEnergiaIAResultadoDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,PreVendedor,Supervisor,Vendedor,Tecnico,Gerente.

[Voltar ao índice](#2-indice-clicavel)

#### `GET /api/UnidadeConsumidora/Projeto/{id}`

**path** `id`: `long`; **query** `filtro`: `QueryFiltroInputDTO` — [QueryFiltroInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-05-1euyfrd/#3-queryfiltroinputdto); **query** `pagingParams`: `PagingParams`.

**Retorno declarado:** `ActionResult<PagedList<UnidadeConsumidora>>`. **Acesso:** Bearer; perfis declarados: Administrador,PreVendedor,Supervisor,Vendedor,Tecnico, Gerente.

[Voltar ao índice](#2-indice-clicavel)

#### `GET /api/UnidadeConsumidora/{id}`

**path** `id`: `long`.

**Retorno declarado:** `Task<ActionResult<UnidadeConsumidora>>`. **Acesso:** Bearer; perfis declarados: Administrador,PreVendedor,Supervisor,Vendedor,Tecnico, Gerente.

[Voltar ao índice](#2-indice-clicavel)

#### `POST /api/UnidadeConsumidora`

**body** `model`: `UnidadeConsumidoraInputDTO` — [UnidadeConsumidoraInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-06-16y2x3u/#3-unidadeconsumidorainputdto).

**Retorno declarado:** `Task<ActionResult<UnidadeConsumidora>>`. **Acesso:** Bearer; perfis declarados: Administrador,PreVendedor,Supervisor,Vendedor,Tecnico, Gerente.

[Voltar ao índice](#2-indice-clicavel)

#### `PUT /api/UnidadeConsumidora/{id}`

**path** `id`: `long`; **body** `model`: `EditarPropriedadeInputDTO` — [EditarPropriedadeInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-02-1y50x5n/#3-editarpropriedadeinputdto).

**Retorno declarado:** `Task<ActionResult<UnidadeConsumidora>>`. **Acesso:** Bearer; perfis declarados: Administrador,PreVendedor,Supervisor,Vendedor,Tecnico, Gerente.

[Voltar ao índice](#2-indice-clicavel)

#### `DELETE /api/UnidadeConsumidora/{id}`

**path** `id`: `long`.

**Retorno declarado:** `Task`. **Acesso:** Bearer; perfis declarados: Administrador,PreVendedor,Supervisor,Vendedor,Tecnico, Gerente.

[Voltar ao índice](#2-indice-clicavel)

#### `POST /api/UnidadeConsumidora/AdicionarConsumo12Meses/{id}`

**path** `id`: `long`; **query** `consumo`: `double`; **query** `ponta`: `bool` (padrão `false`).

**Retorno declarado:** `Task<ActionResult<dynamic>>`. **Acesso:** Acesso sujeito às regras do ambiente; use a credencial da integração e confirme a permissão desta operação.

[Voltar ao índice](#2-indice-clicavel)

#### `POST /api/UnidadeConsumidora/EditarConsumo12Meses/{id}/Mes/{mes}`

**path** `id`: `long`; **path** `mes`: `int`; **query** `consumo`: `double`; **query** `ponta`: `bool` (padrão `false`).

**Retorno declarado:** `Task<ActionResult<dynamic>>`. **Acesso:** Acesso sujeito às regras do ambiente; use a credencial da integração e confirme a permissão desta operação.

[Voltar ao índice](#2-indice-clicavel)

#### `POST /api/UnidadeConsumidora/RemoverConsumo12Meses/{id}`

**path** `id`: `long`; **query** `consumo`: `double`; **query** `ponta`: `bool` (padrão `false`).

**Retorno declarado:** `Task<ActionResult<dynamic>>`. **Acesso:** Acesso sujeito às regras do ambiente; use a credencial da integração e confirme a permissão desta operação.

[Voltar ao índice](#2-indice-clicavel)

#### `GET /api/UnidadeConsumidora/CalcularMediaConsumo/{id}`

**path** `id`: `long`.

**Retorno declarado:** `Task<ActionResult<dynamic>>`. **Acesso:** Acesso sujeito às regras do ambiente; use a credencial da integração e confirme a permissão desta operação.

[Voltar ao índice](#2-indice-clicavel)

#### `PUT /api/UnidadeConsumidora/{id}/AdicionarContaEnergia/{arquivoId}`

**path** `id`: `long`; **path** `arquivoId`: `long`.

**Retorno declarado:** `Task<ActionResult<UnidadeConsumidora>>`. **Acesso:** Acesso sujeito às regras do ambiente; use a credencial da integração e confirme a permissão desta operação.

[Voltar ao índice](#2-indice-clicavel)

#### `PUT /api/UnidadeConsumidora/{id}/RemoverContaEnergia`

**path** `id`: `long`.

**Retorno declarado:** `Task<ActionResult<UnidadeConsumidora>>`. **Acesso:** Acesso sujeito às regras do ambiente; use a credencial da integração e confirme a permissão desta operação.

[Voltar ao índice](#2-indice-clicavel)

### Concessionárias — Concessionaria

**Uso encontrado nos clients:** Groner light, Groner monitoramento-front. Compartilhamento não amplia permissões.

#### `GET /api/Concessionaria`

**query** `filtro`: `QueryFiltroInputDTO` — [QueryFiltroInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-05-1euyfrd/#3-queryfiltroinputdto); **query** `pagingParams`: `PagingParams`.

**Retorno declarado:** `ActionResult<PagedList<Concessionaria>>`. **Acesso:** Bearer; perfis declarados: Administrador,PreVendedor,Supervisor,Vendedor,Tecnico, Gerente.

[Voltar ao índice](#2-indice-clicavel)

#### `GET /api/Concessionaria/{id}`

**path** `id`: `long`.

**Retorno declarado:** `Task<ActionResult<Concessionaria>>`. **Acesso:** Bearer; perfis declarados: Administrador.

[Voltar ao índice](#2-indice-clicavel)

#### `POST /api/Concessionaria`

**body** `model`: `ConcessionariaInputDTO` — [ConcessionariaInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-01-12uez99/#3-concessionariainputdto).

**Retorno declarado:** `Task<ActionResult<Concessionaria>>`. **Acesso:** Bearer; perfis declarados: Administrador.

[Voltar ao índice](#2-indice-clicavel)

#### `POST /api/Concessionaria/AddLista`

**body** `model`: `List<ConcessionariaInputDTO>` — [ConcessionariaInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-01-12uez99/#3-concessionariainputdto).

**Retorno declarado:** `Task<ActionResult>`. **Acesso:** Bearer; perfis declarados: Administrador.

[Voltar ao índice](#2-indice-clicavel)

#### `PUT /api/Concessionaria/{id}`

**path** `id`: `long`; **body** `model`: `EditarPropriedadeInputDTO` — [EditarPropriedadeInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-02-1y50x5n/#3-editarpropriedadeinputdto).

**Retorno declarado:** `Task<ActionResult<Concessionaria>>`. **Acesso:** Bearer; perfis declarados: Administrador.

[Voltar ao índice](#2-indice-clicavel)

#### `DELETE /api/Concessionaria/{id}`

**path** `id`: `long`.

**Retorno declarado:** `Task`. **Acesso:** Bearer; perfis declarados: Administrador.

[Voltar ao índice](#2-indice-clicavel)

#### `POST /api/Concessionaria/ExcluirConcessionarias`

**body** `ids`: `long[]`.

**Retorno declarado:** `Task<List<long>>`. **Acesso:** Bearer; perfis declarados: Administrador.

[Voltar ao índice](#2-indice-clicavel)

#### `POST /api/Concessionaria/EditarEmMassa`

**body** `body`: `EditarConcessionariasEmMassaInputDTO` — [EditarConcessionariasEmMassaInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-02-1y50x5n/#3-editarconcessionariasemmassainputdto).

**Retorno declarado:** `Task<string>`. **Acesso:** Bearer; perfis declarados: Administrador.

[Voltar ao índice](#2-indice-clicavel)


<!-- groner-suporte:veja-tambem:inicio -->
## Veja também

* [Guia principal, autenticação e coleção Postman](https://ajuda.groner.app/pt-br/article/documentacao-da-api-groner-crm-vz2bq2/)
* [Como gerar token de API](https://ajuda.groner.app/pt-br/article/como-gerar-um-token-de-api-para-integrar-o-groner-com-outros-sistemas-2okhj6/)
* [Limites de requisições](https://ajuda.groner.app/pt-br/article/limites-de-requisicoes-da-api-da-groner-1cwtj65/)
<!-- groner-suporte:veja-tambem:fim -->