---
title: "Webhook de retorno com processamento de um lote solicitado."
method: POST
path: "/v2/webhook/lote-finalizado"
tags: ["API de Webhook"]
---

# Webhook de retorno com processamento de um lote solicitado.

`POST /v2/webhook/lote-finalizado`

## Request body

- StatusLote
  - `id` string, required — Código de identificação do lote
  - `status` 'PROCESSANDO' | 'PROCESSADO' | 'REJEITADO' | 'ERRO', required — Status do lote
  - `tipo` 'CADASTRO_SACADOR' | 'CADASTRO_SACADO' | 'ATUALIZACAO_CADASTRO_SACADOR' | 'ESCRITURACAO_DUPLICATA_FATURA' | 'ESCRITURACAO_DUPLICATA_CHAVE' | 'ESCRITURACAO_DUPLICATA_XML' | 'ALTERACAO_DUPLICATA' | 'MANUTENCAO_DOCUMENTO_FISCAL' | 'MANUTENCAO_INSTRUMENTO_PAGAMENTO' | 'INATIVACAO_DUPLICATA' | 'PAGAMENTO_DUPLICATA' | 'OPTIN_AGENDA_ORIGINADOR' | 'OPTIN_AGENDA_TITULAR' | 'OPTOUT_AGENDA' | 'MANIFESTACAO_SACADO - CRIACAO_CONTRATO' | 'ATUALIZACAO_CONTRATO' | 'ENCERRAMENTO_CONTRATO', required — Tipo de Lote de Processamento.
  - `total_itens_recebidos` integer, required — Total de itens recebidos no lote
  - `total_itens_processados` integer, required — Total de itens processados no lote
  - `total_itens_invalidos` integer, required — Total de itens inválidos no lote
  - `data_finalizacao` string, date-time — Data de finalização do lote
  - `data_criacao` string, date-time, required — Data de criação do lote
  - `lista_itens_processados` object[]
    - `referencia_item` string, required — Referência para identificação do item processado
    - `identificador_item_processado` string, required — Identificador CERC do item processado: - Para cadastro de sacador: Identificador do Sacador na CERC; - Para cadastro de sacado: Identificador do Sacado na CERC; - Para opt-in/out: Chave do Opt-in; - Para contratos: Identificador CERC do contrato. - Para duplicatas emitidas por fatura: identificador unico da duplicata (IUD)
    - `sub_itens` object[]
      - `referencia_subitem` string — Referência para identificação do subitem processado. - Para escrituração por arquivo XML: Parcela da fatura. - Para escrituração por chave de nota fiscal: Parcela da fatura.
      - `identificador_subitem_processado` string — Identificador CERC do subitem processado: - Para escrituração por arquivo XML: Identificador Único da duplicata (IUD). - Para escrituração por chave de nota fiscal: Identificador Único da duplicata (IUD).
  - `lista_itens_invalidos` object[]
    - `referencia_item` string, required — Referência para identificação do item inválido. Caso a requisição não possua o campo "referencia_externa", o campo será preenchido com o identificador do item que está sendo atualizado, correspondente ao fluxo: - Para fluxos de atualização cadastro de sacador: Documento do Sacador enviado pelo participante na atualização; - Para fluxos de atualização cadastro de sacado: Documento do Sacador enviado pelo participante na atualização; - Para fluxos de atualização de duplicatas: Identificador Único da duplicata (IUD) enviado pelo participante na atualização; - Para opt-out: Chave do Opt-in enviado pelo participante na atualização; - Para fluxos de atualização de contratos: Identificador CERC do contrato enviado pelo participante na atualização.
    - `erros` object[], required
      - `codigo` string, required — Código do erro
      - `mensagem` string, required — Mensagem do erro
    - `sub-items` object[]
      - `referencia_subitem` string — Referência para identificação do subitem processado. - Para escrituração por arquivo XML: Parcela da fatura. - Para escrituração por chave de nota fiscal: Parcela da fatura.
      - `erros` object[]
        - `codigo` string, required — Código do erro
        - `mensagem` string, required — Mensagem do erro

## Response `200`

Finalização do lote recebida com sucesso pelo Participante.

---

[API](https://skmtc.net/cerc/apis/receb-veis-de-arranjo-de-pagamento-institui-es-financeiras-d.md) · [All operations](https://skmtc.net/cerc/apis/receb-veis-de-arranjo-de-pagamento-institui-es-financeiras-d/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cerc/receb-veis-de-arranjo-de-pagamento-institui-es-financeiras-d/revisions/98997c37ec38/schema)