Create a batch of COBV charges (Bacen /lotecobv)

Registers a batch of due-date charges for async processing. Bacen contract: responds 202 without a body; poll GET /lotecobv/{id} for per-item status.

Path Parameters

id
Type: string
required

Body·

required

application/json

Corpo para criação/alteração de lote de cobranças com vencimento (COBV) — Bacen LoteCobVBody

cobsv
Type: array object[] · …200
required

Cobranças do lote, cada uma com seu txid fornecido pelo cliente

Item de um lote COBV: txid fornecido pelo cliente + dados da cobrança com vencimento
descricao
Type: string
max length:
140
required

Descrição do lote

Responses

202

Batch accepted for asynchronous processing. Bacen answers 202 with no body; poll GET /lotecobv/{id} for the per-item status.

Código interno	HTTP	Descrição	Erro normativo Bacen
`CHARGE-0041`	400	Invalid COBV batch request	`LoteCobVOperacaoInvalida`
`PIX-0001`	400	Headers x-branch and x-account-number are required	`PixConsultaInvalida`

application/json

403

Access denied — the credential does not carry the scope required by this operation, or the client certificate was rejected. Answered at the exposure gateway (Bacen: AcessoNegado).

Código interno	HTTP	Descrição	Erro normativo Bacen
`CHARGE-0040`	404	COBV batch (lote) not found	`LoteCobVNaoEncontrado`

application/json

503

Service temporarily unavailable (Bacen: ServicoIndisponivel).

put/api/lotecobv/{id}

curl 'http://localhost:8080/api/lotecobv/{id}' \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "descricao": "Cobranças dos alunos do mês de julho",
  "cobsv": [
    {
      "txid": "txid12345678901234567890123456",
      "chave": "",
      "calendario": {
        "dataDeVencimento": "",
        "validadeAposVencimento": 0
      },
      "valor": {
        "original": "",
        "multa": {
          "modalidade": 1,
          "valorPerc": ""
        },
        "juros": {
          "modalidade": 1,
          "valorPerc": ""
        },
        "abatimento": {
          "modalidade": 1,
          "valorPerc": ""
        },
        "desconto": {
          "modalidade": 1,
          "descontoDataFixa": [
            {
              "data": "",
              "valorPerc": ""
            }
          ],
          "valorPerc": ""
        }
      },
      "devedor": {
        "cpf": "",
        "cnpj": "",
        "nome": "",
        "email": "",
        "logradouro": "",
        "cidade": "",
        "uf": "",
        "cep": ""
      },
      "recebedor": {
        "nome": "",
        "cidade": "",
        "taxId": "",
        "logradouro": "",
        "uf": "",
        "cep": ""
      },
      "solicitacaoPagador": "",
      "infoAdicionais": [
        {
          "nome": "",
          "valor": ""
        }
      ],
      "loc": {
        "id": ""
      },
      "emitImage": true
    }
  ]
}'

No Body

Batch accepted for asynchronous processing. Bacen answers 202 with no body; poll GET /lotecobv/{id} for the per-item status.