> ## 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 ERP — pedidos, compras, estoque, inventário e logística

Referência de **ERP** 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

[Pedidos de venda — PedidoVenda](#3-pedidos-de-venda-pedidovenda) · [Pedidos de compra — PedidoCompra](#3-pedidos-de-compra-pedidocompra) · [Conversão de venda em pedido — VendaPedido](#3-conversao-de-venda-em-pedido-vendapedido) · [Fornecedores — Fornecedor](#3-fornecedores-fornecedor) · [Saldos e movimentações de estoque — Estoque](#3-saldos-e-movimentacoes-de-estoque-estoque) · [Depósitos — Deposito](#3-depositos-deposito) · [Produtos e insumos — Insumo](#3-produtos-e-insumos-insumo) · [Inventário físico — Inventario](#3-inventario-fisico-inventario) · [Separação de pedidos — Separacao](#3-separacao-de-pedidos-separacao) · [Rentabilidade — Rentabilidade](#3-rentabilidade-rentabilidade) · [DRE por pedido de venda — DrePedidoVenda](#3-dre-por-pedido-de-venda-drepedidovenda)

---

## 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 depósitos

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

```bash
curl --request GET \
  --url "$API_URL/api/Deposito?PageNumber=1&PageSize=25" \
  --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": {
    "summary": null,
    "totalItems": 0,
    "pageNumber": 1,
    "pageSize": 25,
    "ids": null,
    "list": [],
    "totalPages": 0,
    "hasPreviousPage": false,
    "hasNextPage": false,
    "nextPageNumber": 0,
    "previousPageNumber": 1
  }
}
```

Inventário é `/api/Inventario`, conforme o client do ERP. Abrir inventário congela a posição e bloqueia o depósito; concluir aplica diferenças. Não confunda contagem com entrada/saída normal de estoque.

---

## Referência dos endpoints

### Pedidos de venda — PedidoVenda

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

#### `POST /api/PedidoVenda/SincronizarStatusFinanciados`

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

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

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

#### `GET /api/PedidoVenda/{id}/RecebimentosCrm`

**path** `id`: `long`; **query** `contaBancariaId`: `long?`.

**Retorno declarado:** `Task<ActionResult<RecebimentosCrmOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/PedidoVenda/{id}/RecebimentosCrm`

**path** `id`: `long`; **body** `model`: `SincronizarRecebimentosCrmInputDTO` — [SincronizarRecebimentosCrmInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-06-16y2x3u/#3-sincronizarrecebimentoscrminputdto).

**Retorno declarado:** `Task<ActionResult<RecebimentosCrmOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/PedidoVenda/{id}/Origem`

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

**Retorno declarado:** `Task<ActionResult<dynamic>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/PedidoVenda`

**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<PedidoVenda>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/PedidoVenda/Resumo`

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

**Retorno declarado:** `Task<ActionResult<ResumoPedidosVendaOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

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

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

**Retorno declarado:** `Task<ActionResult<PedidoVenda>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/PedidoVenda`

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

**Retorno declarado:** `Task<ActionResult<PedidoVenda>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `PUT /api/PedidoVenda/{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<PedidoVenda>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `PUT /api/PedidoVenda/{id}/RecebivelPorFinanciamento`

**path** `id`: `long`; **query** `valor`: `bool`.

**Retorno declarado:** `Task<ActionResult<PedidoVenda>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `PUT /api/PedidoVenda/{id}/Valor`

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

**Retorno declarado:** `Task<ActionResult<PedidoVenda>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/PedidoVenda/ExcluirLote`

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

**Retorno declarado:** `Task<ActionResult<ExcluirPedidosLoteOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

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

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

**Retorno declarado:** `Task`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/PedidoVenda/{id}/Confirmar`

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

**Retorno declarado:** `Task<ActionResult<PedidoVenda>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/PedidoVenda/{id}/Cancelar`

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

**Retorno declarado:** `Task<ActionResult<PedidoVenda>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/PedidoVenda/CurvaAbc`

**query** `dataInicio`: `DateTime`; **query** `dataFim`: `DateTime`; **query** `por`: `string`; **query** `fonte`: `string`; **query** `filtro`: `QueryFiltroInputDTO` — [QueryFiltroInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-05-1euyfrd/#3-queryfiltroinputdto).

**Retorno declarado:** `Task<ActionResult<CurvaAbcOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/PedidoVenda/{id}/Titulos`

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

**Retorno declarado:** `Task<ActionResult<TitulosDoPedidoOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/PedidoVenda/{id}/Financiamentos`

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

**Retorno declarado:** `Task<ActionResult<FinanciamentosDoPedidoOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/PedidoVenda/{id}/PlanoPagamento`

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

**Retorno declarado:** `Task<ActionResult<PlanoPagamentoPedidoOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/PedidoVenda/{id}/JustificarDivergencia`

**path** `id`: `long`; **body** `model`: `JustificarDivergenciaInputDTO` — [JustificarDivergenciaInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-04-62zu2h/#3-justificardivergenciainputdto).

**Retorno declarado:** `Task<ActionResult<PedidoVenda>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/PedidoVenda/Faturar`

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

**Retorno declarado:** `Task<ActionResult<TituloReceber>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

### Pedidos de compra — PedidoCompra

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

#### `GET /api/PedidoCompra/HistoricoInsumo/{insumoId}`

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

**Retorno declarado:** `Task<ActionResult<HistoricoCompraInsumoOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/PedidoCompra`

**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<PedidoCompra>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

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

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

**Retorno declarado:** `Task<ActionResult<PedidoCompra>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/PedidoCompra/{id}/Anexos`

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

**Retorno declarado:** `Task<ActionResult<List<AnexoTituloOutputDTO>>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/PedidoCompra/{id}/Anexos`

**path** `id`: `long`; **query** `legenda`: `string`.

**Retorno declarado:** `Task<ActionResult<List<AnexoTituloOutputDTO>>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

**Transporte:** `multipart/form-data`.

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

#### `DELETE /api/PedidoCompra/Anexos/{anexoId}`

**path** `anexoId`: `long`.

**Retorno declarado:** `Task`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/PedidoCompra`

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

**Retorno declarado:** `Task<ActionResult<PedidoCompra>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/PedidoCompra/{id}/PreviaXml`

**path** `id`: `long`; **body** `model`: `PreviaXmlCompraInputDTO` — [PreviaXmlCompraInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-05-1euyfrd/#3-previaxmlcomprainputdto).

**Retorno declarado:** `Task<ActionResult<PreviaXmlCompraOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `PUT /api/PedidoCompra/{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<PedidoCompra>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

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

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

**Retorno declarado:** `Task`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/PedidoCompra/{id}/Cancelar`

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

**Retorno declarado:** `Task<ActionResult<PedidoCompra>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `PUT /api/PedidoCompra/Item/{itemId}`

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

**Retorno declarado:** `Task<ActionResult<ItemPedidoCompra>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/PedidoCompra/Faturar`

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

**Retorno declarado:** `Task<ActionResult<TituloPagar>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

### Conversão de venda em pedido — VendaPedido

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

#### `GET /api/VendaPedido/StatusProjeto`

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

**Retorno declarado:** `Task<ActionResult<List<dynamic>>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/VendaPedido/Lista`

**query** `query`: `string`; **query** `lojaId`: `long?`; **query** `somentePendentes`: `bool`; **query** `statusProjetoId`: `long?`; **query** `dataIni`: `DateTime?`; **query** `dataFim`: `DateTime?`; **query** `pagingParams`: `PagingParams`.

**Retorno declarado:** `Task<ActionResult<PagedList<VendaReceberItemOutputDTO>>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/VendaPedido/GerarPedidos`

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

**Retorno declarado:** `Task<ActionResult<GerarPedidosVendaOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

### Fornecedores — Fornecedor

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

#### `GET /api/Fornecedor`

**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<Fornecedor>>`. **Acesso:** Bearer; permissões do usuário e do módulo.

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

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

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

**Retorno declarado:** `ActionResult<Fornecedor>`. **Acesso:** Bearer; permissões do usuário e do módulo.

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

#### `POST /api/Fornecedor`

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

**Retorno declarado:** `Task<ActionResult<Fornecedor>>`. **Acesso:** Bearer; permissões do usuário e do módulo.

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

#### `PUT /api/Fornecedor/{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<Fornecedor>>`. **Acesso:** Bearer; permissões do usuário e do módulo.

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

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

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

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

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

### Saldos e movimentações de estoque — Estoque

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

#### `GET /api/Estoque/Reconciliacao`

**query** `insumoId`: `long`; **query** `depositoId`: `long?`.

**Retorno declarado:** `Task<ActionResult<ReconciliacaoEstoqueOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/Estoque/Inconsistencias`

**query** `depositoId`: `long?`.

**Retorno declarado:** `Task<ActionResult<InconsistenciasEstoqueOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/Estoque/Rastreabilidade/Conferencia`

**query** `insumoId`: `long`; **query** `depositoId`: `long`.

**Retorno declarado:** `Task<RegularizacaoRastreabilidadeDTO>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Estoque/Rastreabilidade/Regularizar`

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

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

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

#### `GET /api/Estoque/Saldos`

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

**Retorno declarado:** `ActionResult<PagedList<SaldoEstoque>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/Estoque/Resumo`

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

**Retorno declarado:** `Task<ActionResult<ResumoEstoqueOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/Estoque/SugestaoCompra`

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

**Retorno declarado:** `Task<ActionResult<SugestaoCompraOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/Estoque/OpcoesCompra`

**query** `tipo`: `TipoInsumoEnum`.

**Retorno declarado:** `Task<ActionResult<OpcoesCompraOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/Estoque/CategoriasFixadas`

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

**Retorno declarado:** `Task<ActionResult<List<CategoriaInsumo>>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/Estoque/Saldo/{insumoId}/{depositoId}`

**path** `insumoId`: `long`; **path** `depositoId`: `long`.

**Retorno declarado:** `Task<ActionResult<SaldoEstoque>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/Estoque/Movimentos`

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

**Retorno declarado:** `ActionResult<PagedList<MovimentoEstoque>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/Estoque/Movimentos/{id}`

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

**Retorno declarado:** `Task<ActionResult<MovimentoEstoque>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Estoque/Movimentar`

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

**Retorno declarado:** `Task<ActionResult<MovimentoEstoque>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Estoque/Movimentos/{id}/Estornar`

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

**Retorno declarado:** `Task<ActionResult<MovimentoEstoque>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Estoque/Ajustar`

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

**Retorno declarado:** `Task<ActionResult<MovimentoEstoque>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Estoque/Importar`

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

**Retorno declarado:** `Task<ActionResult<EstoqueImportarResultadoDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Estoque/Transferir`

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

**Retorno declarado:** `Task<ActionResult<MovimentoEstoque>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Estoque/EntradaPedidoCompra/{pedidoCompraId}`

**path** `pedidoCompraId`: `long`.

**Retorno declarado:** `Task<ActionResult<List<MovimentoEstoque>>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Estoque/ReceberPedidoCompra`

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

**Retorno declarado:** `Task<ActionResult<ResultadoRecebimentoCompraOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Estoque/SaidaPedidoVenda/{pedidoVendaId}/{depositoId}`

**path** `pedidoVendaId`: `long`; **path** `depositoId`: `long`.

**Retorno declarado:** `Task<ActionResult<List<MovimentoEstoque>>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/Estoque/PreviaBaixaPedidoVenda/{pedidoVendaId}/{depositoId}`

**path** `pedidoVendaId`: `long`; **path** `depositoId`: `long`.

**Retorno declarado:** `Task<ActionResult<PreviaBaixaPedidoVendaOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Estoque/SaidaPedidoVendaItens/{pedidoVendaId}/{depositoId}`

**path** `pedidoVendaId`: `long`; **path** `depositoId`: `long`; **body** `model`: `SaidaPedidoVendaItensInputDTO` — [SaidaPedidoVendaItensInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-05-1euyfrd/#3-saidapedidovendaitensinputdto).

**Retorno declarado:** `Task<ActionResult<List<MovimentoEstoque>>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Estoque/CorrigirCusto`

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

**Retorno declarado:** `Task<ActionResult<SaldoEstoque>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/Estoque/Entregas/Previa`

**query** `pedidoVendaId`: `long`.

**Retorno declarado:** `Task<ActionResult<PreviaEntregaPedidoOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Estoque/Entregas`

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

**Retorno declarado:** `Task<ActionResult<EntregaCriadaOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/Estoque/Entregas`

**query** `filtro`: `FiltroEntregaInputDTO` — [FiltroEntregaInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-02-1y50x5n/#3-filtroentregainputdto); **query** `pagingParams`: `PagingParams`.

**Retorno declarado:** `Task<ActionResult<dynamic>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/Estoque/Entregas/{id}/PreviaDevolucao`

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

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

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

#### `POST /api/Estoque/Entregas/{id}/Devolver`

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

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

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

#### `POST /api/Estoque/Entregas/{id}/EntregarItem`

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

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

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

#### `POST /api/Estoque/PedidosVenda/{pedidoVendaId}/EntregarItem`

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

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

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

#### `POST /api/Estoque/Entregas/{id}/AdicionarItem`

**path** `id`: `long`; **body** `model`: `AdicionarItemEntregaInputDTO` — [AdicionarItemEntregaInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-01-12uez99/#3-adicionaritementregainputdto).

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

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

#### `GET /api/Estoque/Entregas/{id}`

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

**Retorno declarado:** `Task<ActionResult<EntregaProjetoDetalheOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/Estoque/CategoriasCompra`

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

**Retorno declarado:** `Task<ActionResult<List<CategoriaCompra>>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Estoque/Entregas/{entregaId}/Entregar`

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

**Retorno declarado:** `Task<ActionResult<List<MovimentoEstoque>>>`. **Acesso:** Bearer; perfis declarados: Administrador,Tecnico,Supervisor,Operador ERP.

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

#### `POST /api/Estoque/Entregas/{entregaId}/EntregarRestante`

**path** `entregaId`: `long`.

**Retorno declarado:** `Task<ActionResult<List<MovimentoEstoque>>>`. **Acesso:** Bearer; perfis declarados: Administrador,Tecnico,Supervisor,Operador ERP.

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

#### `GET /api/Estoque/BalancoMateriaisOS/{ordemServicoId}`

**path** `ordemServicoId`: `long`.

**Retorno declarado:** `Task<ActionResult<BalancoMateriaisOSOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Tecnico,Supervisor,Operador ERP.

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

#### `GET /api/Estoque/PreviaDevolucaoPedidoVenda/{pedidoVendaId}`

**path** `pedidoVendaId`: `long`.

**Retorno declarado:** `Task<ActionResult<PreviaDevolucaoEstoqueOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Estoque/DevolverPedidoVenda/{pedidoVendaId}`

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

**Retorno declarado:** `Task<ActionResult<List<MovimentoEstoque>>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Estoque/ResolverItensBaixa/{depositoId}`

**path** `depositoId`: `long`; **body** `model`: `ResolverItensBaixaInputDTO` — [ResolverItensBaixaInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-05-1euyfrd/#3-resolveritensbaixainputdto).

**Retorno declarado:** `Task<ActionResult<ResolverItensBaixaOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Estoque/MontarKit`

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

**Retorno declarado:** `Task<ActionResult<MovimentoEstoque>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Estoque/DesmontarKit`

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

**Retorno declarado:** `Task<ActionResult<MovimentoEstoque>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/Estoque/Unidades/{insumoId}/{depositoId}`

**path** `insumoId`: `long`; **path** `depositoId`: `long`.

**Retorno declarado:** `Task<ActionResult<List<UnidadeEstoque>>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/Estoque/Unidades`

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

**Retorno declarado:** `ActionResult<PagedList<UnidadeEstoqueOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/Estoque/Unidades/{id}`

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

**Retorno declarado:** `Task<ActionResult<UnidadeEstoqueDetalheOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Estoque/Unidades/Identificar`

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

**Retorno declarado:** `Task<ActionResult<int>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Estoque/Unidades/Baixar`

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

**Retorno declarado:** `Task<ActionResult<ResultadoBaixaUnidadesOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `PUT /api/Estoque/Unidades/{id}`

**path** `id`: `long`; **body** `model`: `AlterarUnidadeEstoqueInputDTO` — [AlterarUnidadeEstoqueInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-01-12uez99/#3-alterarunidadeestoqueinputdto).

**Retorno declarado:** `Task<ActionResult<UnidadeEstoqueOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

### Depósitos — Deposito

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

#### `GET /api/Deposito`

**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<Deposito>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

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

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

**Retorno declarado:** `ActionResult<Deposito>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/Deposito/SaidaPorLoja`

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

**Retorno declarado:** `Task<ActionResult<QuadroSaidaPorLojaOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Deposito/{id}/LojasAtendidas`

**path** `id`: `long`; **body** `model`: `LojasAtendidasInputDTO` — [LojasAtendidasInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-04-62zu2h/#3-lojasatendidasinputdto).

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

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

#### `POST /api/Deposito`

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

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

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

#### `PUT /api/Deposito/{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<Deposito>>`. **Acesso:** Bearer; perfis declarados: Administrador.

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

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

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

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

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

### Produtos e insumos — Insumo

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

#### `GET /api/Insumo`

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

**Retorno declarado:** `ActionResult<PagedList<Insumo>>`. **Acesso:** Bearer; permissões do usuário e do módulo.

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

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

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

**Retorno declarado:** `Task<ActionResult<Insumo>>`. **Acesso:** Bearer; permissões do usuário e do módulo.

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

#### `POST /api/Insumo`

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

**Retorno declarado:** `Task<ActionResult<Insumo>>`. **Acesso:** Bearer; permissões do usuário e do módulo.

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

#### `PUT /api/Insumo/{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<Insumo>>`. **Acesso:** Bearer; permissões do usuário e do módulo.

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

#### `GET /api/Insumo/{id}/Composicao`

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

**Retorno declarado:** `Task<ActionResult<List<ComposicaoKit>>>`. **Acesso:** Bearer; permissões do usuário e do módulo.

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

#### `PUT /api/Insumo/{id}/Composicao`

**path** `id`: `long`; **body** `componentes`: `List<ComposicaoKitItemInputDTO>` — [ComposicaoKitItemInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-01-12uez99/#3-composicaokititeminputdto).

**Retorno declarado:** `Task<ActionResult<List<ComposicaoKit>>>`. **Acesso:** Bearer; permissões do usuário e do módulo.

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

#### `POST /api/Insumo/{id}/AdicionarPrecoFornecedor`

**path** `id`: `long`; **body** `model`: `AddPrecoInsumoInputDTO` — [AddPrecoInsumoInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-01-12uez99/#3-addprecoinsumoinputdto).

**Retorno declarado:** `Task<ActionResult<Insumo>>`. **Acesso:** Bearer; permissões do usuário e do módulo.

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

#### `POST /api/Insumo/EditarPrecoFornecedor/{idPrecoInsumo}`

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

**Retorno declarado:** `Task<ActionResult<PrecoInsumo>>`. **Acesso:** Bearer; permissões do usuário e do módulo.

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

#### `DELETE /api/Insumo/ExcluirPrecoFornecedor/{idPrecoInsumo}`

**path** `idPrecoInsumo`: `long`.

**Retorno declarado:** `Task`. **Acesso:** Bearer; permissões do usuário e do módulo.

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

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

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

**Retorno declarado:** `Task`. **Acesso:** Bearer; permissões do usuário e do módulo.

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

#### `POST /api/Insumo/ExcluirEmMassa`

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

**Retorno declarado:** `Task<ActionResult<int>>`. **Acesso:** Bearer; permissões do usuário e do módulo.

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

#### `POST /api/Insumo/Importar`

**body** `lista`: `List<InsumoImportarInputDTO>` — [InsumoImportarInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-04-62zu2h/#3-insumoimportarinputdto).

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

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

#### `POST /api/Insumo/ExcluirPermanente`

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

**Retorno declarado:** `Task<string>`. **Acesso:** Bearer; permissões do usuário e do módulo.

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

#### `POST /api/Insumo/RestaurarInsumos`

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

**Retorno declarado:** `Task<string>`. **Acesso:** Bearer; permissões do usuário e do módulo.

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

#### `POST /api/Insumo/DisponibilidadeItemExtraEmMassa`

**query** `disponivel`: `bool`.

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

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

#### `POST /api/Insumo/SincronizarCatalogo`

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

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

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

#### `GET /api/Insumo/PreviaVinculoCatalogo`

**query** `tipo`: `TipoInsumoEnum`.

**Retorno declarado:** `Task<ActionResult<PreviaVinculoCatalogoOutputDTO>>`. **Acesso:** Bearer; permissões do usuário e do módulo.

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

#### `POST /api/Insumo/VincularCatalogo`

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

**Retorno declarado:** `Task<ActionResult<VincularCatalogoOutputDTO>>`. **Acesso:** Bearer; permissões do usuário e do módulo.

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

### Inventário físico — Inventario

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

#### `GET /api/Inventario`

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

**Retorno declarado:** `Task<ActionResult<PagedList<InventarioEstoque>>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

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

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

**Retorno declarado:** `Task<ActionResult<InventarioEstoqueDetalheOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Inventario`

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

**Retorno declarado:** `Task<ActionResult<InventarioEstoque>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `PUT /api/Inventario/{id}/Itens/{itemId}`

**path** `id`: `long`; **path** `itemId`: `long`; **body** `model`: `ContarItemInventarioInputDTO` — [ContarItemInventarioInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-01-12uez99/#3-contariteminventarioinputdto).

**Retorno declarado:** `Task<ActionResult<InventarioEstoqueItem>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Inventario/{id}/Itens`

**path** `id`: `long`; **body** `model`: `AdicionarItemInventarioInputDTO` — [AdicionarItemInventarioInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-01-12uez99/#3-adicionariteminventarioinputdto).

**Retorno declarado:** `Task<ActionResult<InventarioEstoqueItem>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Inventario/{id}/ImportarContagem`

**path** `id`: `long`; **body** `model`: `ImportarContagemInputDTO` — [ImportarContagemInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-03-186hp04/#3-importarcontageminputdto).

**Retorno declarado:** `Task<ActionResult<ImportarContagemResultadoOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Inventario/{id}/Concluir`

**path** `id`: `long`; **body** `model`: `ConcluirInventarioEstoqueInputDTO` — [ConcluirInventarioEstoqueInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-01-12uez99/#3-concluirinventarioestoqueinputdto).

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

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

#### `POST /api/Inventario/{id}/Cancelar`

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

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

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

### Separação de pedidos — Separacao

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

#### `GET /api/Separacao/Fila`

**query** `filtro`: `FiltroFilaSeparacaoInputDTO` — [FiltroFilaSeparacaoInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-02-1y50x5n/#3-filtrofilaseparacaoinputdto); **query** `pagingParams`: `PagingParams`.

**Retorno declarado:** `Task<ActionResult<FilaSeparacaoResultadoOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `GET /api/Separacao/{entregaId}`

**path** `entregaId`: `long`.

**Retorno declarado:** `Task<ActionResult<SeparacaoDetalheOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Separacao/{entregaId}/Fotos`

**path** `entregaId`: `long`; **query** `model`: `RegistrarFotoSeparacaoInputDTO` — [RegistrarFotoSeparacaoInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-05-1euyfrd/#3-registrarfotoseparacaoinputdto).

**Retorno declarado:** `Task<ActionResult<List<FotoSeparacaoOutputDTO>>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

**Transporte:** `multipart/form-data`.

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

#### `DELETE /api/Separacao/Fotos/{fotoId}`

**path** `fotoId`: `long`.

**Retorno declarado:** `Task`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Separacao/{entregaId}/SepararItem`

**path** `entregaId`: `long`; **body** `model`: `SepararItemInputDTO` — [SepararItemInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-05-1euyfrd/#3-separariteminputdto).

**Retorno declarado:** `Task<ActionResult<SeparacaoDetalheOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Separacao/{entregaId}/SepararItens`

**path** `entregaId`: `long`; **body** `model`: `SepararItensInputDTO` — [SepararItensInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-05-1euyfrd/#3-separaritensinputdto).

**Retorno declarado:** `Task<ActionResult<SeparacaoDetalheOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Separacao/{entregaId}/ConferirItens`

**path** `entregaId`: `long`; **body** `model`: `SepararItensInputDTO` — [SepararItensInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-05-1euyfrd/#3-separaritensinputdto).

**Retorno declarado:** `Task<ActionResult<SeparacaoDetalheOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Separacao/{entregaId}/SubstituirItem`

**path** `entregaId`: `long`; **body** `model`: `SubstituirItemSeparacaoInputDTO` — [SubstituirItemSeparacaoInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-06-16y2x3u/#3-substituiritemseparacaoinputdto).

**Retorno declarado:** `Task<ActionResult<SeparacaoDetalheOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Separacao/{entregaId}/AdicionarItem`

**path** `entregaId`: `long`; **body** `model`: `AdicionarItemSeparacaoInputDTO` — [AdicionarItemSeparacaoInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-01-12uez99/#3-adicionaritemseparacaoinputdto).

**Retorno declarado:** `Task<ActionResult<SeparacaoDetalheOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Separacao/{entregaId}/RemoverItem`

**path** `entregaId`: `long`; **body** `model`: `RemoverItemSeparacaoInputDTO` — [RemoverItemSeparacaoInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-05-1euyfrd/#3-removeritemseparacaoinputdto).

**Retorno declarado:** `Task<ActionResult<SeparacaoDetalheOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Separacao/{entregaId}/ConcluirSeparacao`

**path** `entregaId`: `long`; **body** `model`: `ConcluirSeparacaoInputDTO` — [ConcluirSeparacaoInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-01-12uez99/#3-concluirseparacaoinputdto).

**Retorno declarado:** `Task<ActionResult<SeparacaoDetalheOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Separacao/{entregaId}/ConferirItem`

**path** `entregaId`: `long`; **body** `model`: `SepararItemInputDTO` — [SepararItemInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-05-1euyfrd/#3-separariteminputdto).

**Retorno declarado:** `Task<ActionResult<SeparacaoDetalheOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Separacao/{entregaId}/ConcluirConferencia`

**path** `entregaId`: `long`; **body** `model`: `ConcluirSeparacaoInputDTO` — [ConcluirSeparacaoInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-01-12uez99/#3-concluirseparacaoinputdto).

**Retorno declarado:** `Task<ActionResult<SeparacaoDetalheOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Separacao/{entregaId}/Estornar`

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

**Retorno declarado:** `Task<ActionResult<SeparacaoDetalheOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Separacao/{entregaId}/GerarPendencia`

**path** `entregaId`: `long`; **body** `model`: `GerarPendenciaSeparacaoInputDTO` — [GerarPendenciaSeparacaoInputDTO](https://ajuda.groner.app/pt-br/article/api-groner-contratos-referencia-03-186hp04/#3-gerarpendenciaseparacaoinputdto).

**Retorno declarado:** `Task<ActionResult<GerarPendenciaSeparacaoOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

### Rentabilidade — Rentabilidade

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

#### `POST /api/Rentabilidade/Projetos`

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

**Retorno declarado:** `Task<ActionResult<RentabilidadeOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Rentabilidade/Projeto`

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

**Retorno declarado:** `Task<ActionResult<RentabilidadeProjetoDetalheOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/Rentabilidade/OrdensServico`

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

**Retorno declarado:** `Task<ActionResult<CustoOrdemServicoOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

### DRE por pedido de venda — DrePedidoVenda

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

#### `POST /api/DrePedidoVenda/Pedidos`

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

**Retorno declarado:** `Task<ActionResult<DrePedidosResultadoOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/DrePedidoVenda/Pedido/{pedidoVendaId}`

**path** `pedidoVendaId`: `long`.

**Retorno declarado:** `Task<ActionResult<DrePedidoDetalheOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

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

#### `POST /api/DrePedidoVenda/GerarRepassesEquipe`

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

**Retorno declarado:** `Task<ActionResult<GerarRepassesEquipeOutputDTO>>`. **Acesso:** Bearer; perfis declarados: Administrador,Supervisor,Operador ERP.

[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 -->