> For the complete documentation index, see [llms.txt](https://docs.giro.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giro.tech/desenvolvedores/api-gtsec/importacao-de-recebimento-atribuicao/fechar-lote-de-recebimento-atribuicao.md).

# Fechar lote de Recebimento/Atribuição

Realiza o fechamento de um lote de eventos de recebimento/atribuição, com a verificação dos valores totais presente no lote.

Esta chamada deve ser executada somente após o envio de todas as importações de recebimentos/atribuições do lote.

## POST /integration/contract/batch-events/close

> Fechar lote de recebimentos/atribuições

```json
{"openapi":"3.0.0","info":{"title":"API do GTSec","version":"1.0.0"},"servers":[{"url":"https://integration.staging.gtsec.giro.tech","description":"Ambiente de Staging"},{"url":"https://integration.gtsec.com.br","description":"Ambiente de Produção"}],"security":[{"TokenAuth":[]}],"components":{"securitySchemes":{"TokenAuth":{"type":"apiKey","in":"header","name":"Authorization"}}},"paths":{"/integration/contract/batch-events/close":{"post":{"tags":["Integration"],"summary":"Fechar lote de recebimentos/atribuições","operationId":"closeContractBatchEvents","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["emissor_cnpj","numero_lote_evento","quantidade_total","valor_total"],"properties":{"emissor_cnpj":{"type":"string","maxLength":18,"description":"CNPJ do emissor (Securitizadora/Fundo) para fechamento do lote de eventos de contrato.\n\n* **Formato:** Pode ser enviado com ou sem pontuação.\n* **CNPJ numérico:** 14 dígitos (ex.: `55.759.179/0001-57`).\n* **CNPJ alfanumérico:** 12 caracteres alfanuméricos (`A-Z`, `0-9`) + 2 dígitos verificadores numéricos (ex.: `VK80.3CNK/0001-59`).\n* **Normalização:** A API remove pontuação, mantém apenas letras e números e converte letras para maiúsculas.\n* **Validação:** Dígitos verificadores Mod11 (incluindo CNPJ alfanumérico).\n* **Erros:** `Documento CNPJ '{valor}' invalido.`; `A identificacao do emissor '{valor}' e invalida para o emissor autenticado.`\n","pattern":"^(\\d{2}\\.\\d{3}\\.\\d{3}/\\d{4}-\\d{2}|[A-Za-z0-9]{2}\\.[A-Za-z0-9]{3}\\.[A-Za-z0-9]{3}/[A-Za-z0-9]{4}-\\d{2}|\\d{14}|[A-Za-z0-9]{12}\\d{2})$"},"numero_lote_evento":{"type":"string","maxLength":12,"description":"Número do lote de eventos do contrato."},"quantidade_total":{"type":"integer","description":"Quantidade total dos eventos no lote."},"valor_total":{"type":"number","format":"decimal","description":"Valor total de eventos de RECEBIMENTO no lote."}}}}}},"responses":{"200":{"description":"Lote fechado com sucesso","content":{"application/json":{"schema":{"type":"object","required":["emissor_cnpj","numero_lote_evento","numero_contrato","tipo_evento"],"properties":{"emissor_cnpj":{"type":"string","maxLength":18,"description":"CNPJ do emissor (Securitizadora/Fundo) do evento de contrato.\n\n* **Formato:** Pode ser enviado com ou sem pontuação.\n* **CNPJ numérico:** 14 dígitos (ex.: `55.759.179/0001-57`).\n* **CNPJ alfanumérico:** 12 caracteres alfanuméricos (`A-Z`, `0-9`) + 2 dígitos verificadores numéricos (ex.: `VK80.3CNK/0001-59`).\n* **Normalização:** A API remove pontuação, mantém apenas letras e números e converte letras para maiúsculas.\n* **Validação:** Dígitos verificadores Mod11 (incluindo CNPJ alfanumérico).\n* **Erros:** `Documento CNPJ '{valor}' invalido.`; `A identificacao do emissor '{valor}' e invalida para o emissor autenticado.`\n","pattern":"^(\\d{2}\\.\\d{3}\\.\\d{3}/\\d{4}-\\d{2}|[A-Za-z0-9]{2}\\.[A-Za-z0-9]{3}\\.[A-Za-z0-9]{3}/[A-Za-z0-9]{4}-\\d{2}|\\d{14}|[A-Za-z0-9]{12}\\d{2})$"},"numero_lote_evento":{"type":"string","maxLength":12,"description":"Identificador do lote de eventos do contrato.\n\n* **Formato:** **Numérico (aceita somente números)**.\n* **Regra:** Deve ser único. Sem vínculo com um lote já fechado. Não deve conter zeros à esquerda.\n"},"numero_contrato":{"type":"string","maxLength":50,"description":"Número do contrato.\n\n* **Formato:** **Texto (aceita letras, números e caracteres especiais)**.\n* **Regra:** Deve ser único.\n"},"tipo_evento":{"type":"string","enum":["RECEBIMENTO","ATRIBUIR_VALOR_DISPONIVEL","ATRIBUIR_VALOR_INFORMADO"],"description":"Tipo do evento associado ao contrato."},"valor_evento":{"type":"number","format":"decimal","maxLength":14,"description":"Valor do evento.\n\n* **Opcionalidade:** Obrigatório para os tipos de evento: RECEBIMENTO e ATRIBUIR_VALOR_INFORMADO.\n* **Formato:** Numérico no padrão **10,4** (10 dígitos inteiros, 4 decimais).\n* **Sinal:** Deve ser **positivo**.\n"},"modo_atribuicao":{"type":"string","maxLength":50,"enum":["LIQUIDACAO_CONTRATO","LIQUIDACAO_RECEBIVEL"],"description":"Modo de atribuição do evento.\n\n* **Opcionalidade:** Obrigatório para os tipos de evento: ATRIBUIR_VALOR_DISPONIVEL e ATRIBUIR_VALOR_INFORMADO.\n"},"numero_controle_participante":{"type":"string","maxLength":80,"description":"Número de controle do participante do recebível.\n\n* **Utilização:** Necessário para o modo de atribuição LIQUIDACAO_RECEBIVEL.\n* **Padrão:** Deve seguir o padrão número-parcela (ex: 12345678-1).\n* **Formato:** **Texto (aceita letras, números e caracteres especiais)**.\n"}}}}}},"400":{"description":"Erro na requisição","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Código do erro"},"message":{"type":"string","description":"Mensagem descritiva do erro"},"details":{"type":"array","items":{"type":"string"},"description":"Detalhes adicionais do erro"}},"required":["code","message"]}}}},"500":{"description":"Erro interno do servidor","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Código do erro"},"message":{"type":"string","description":"Mensagem descritiva do erro"},"details":{"type":"array","items":{"type":"string"},"description":"Detalhes adicionais do erro"}},"required":["code","message"]}}}}}}}}}
```
