---
title: "Cadastra lote de pagamentos de comissão"
method: POST
path: "/v1/financeiro/lotes/cadastrar"
tags: ["Lotes"]
---

# Cadastra lote de pagamentos de comissão

`POST /v1/financeiro/lotes/cadastrar`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api`
- URL: `https://integracao.cvcrm.com.br/api/v1/financeiro/lotes/cadastrar`
- Auth: none declared. Required headers: `email`, `token`

> 🔒 **Autenticação necessária**
>
> Esta API utiliza autenticação via **e-mail e token** nos headers da requisição.
> Consulte o tutorial completo antes de fazer sua primeira chamada:
> [Como autenticar nas APIs do CV CRM (v1 — E-mail e Token)](https://desenvolvedor.cvcrm.com.br/docs/como-autenticar-apis-cvcrm-email-token)

A interface viabiliza a criação de lote do sistema CV. A requisição cria o lote no CVCRM com os pagamentos das comissões, se não enviar os pagamentos irá inserir todos os pagamentos da comissão que não esteja num lote.

## Headers

- `email` string, required
- `token` string, required

## Request body

- CadastrarLote: Requisição para cadastrar lote de pagamentos
  - `nota_fiscal` string, string: Nota fiscal do lote do pagamentos
  - `observacao` string, string: Observação do lote do pagamentos
  - `descricao` string, string: Descrição do lote do pagamentos
  - `nome` string, string: Nome do lote de pagamentos
  - `comissoes` object[], required: Comissões
    - `idcomissao` integer: Identificador da comissão
    - `pagamentos` object[]
      - `idpagamento_comissao` integer: Identificador do pagamento

## Response `200`

Cadastro de lote realizado com sucesso.

- LotePOST: Retorno do cadastro de lote de pagamentos com sucesso.
  - `idLote` string: Retorna o identificador do lote cadastrado
  - `sucesso` boolean

## Other responses

- `400`: Erro de solicitação de lote, revise os parâmetros!
- `401`: E-mail e/ou token incorreto(s) na requisição de cadastro de lote.
- `403`: Sem permissão no perfil de acesso ou módulo inativo para cadastrar lote.
- `404`: URL não encontrada na requisição de cadastro de lote.
- `422`: Erro inesperado na requisição de cadastro de lote, por favor entre em contato com o suporte técnico.

---

[API](https://skmtc.dev/cvcrm/apis/clientes.md) - [All operations](https://skmtc.dev/cvcrm/apis/clientes/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/clientes/revisions/42bf5add8bf3?raw)