---
title: "Criar lote"
method: POST
path: "/batch"
tags: ["Lotes"]
---

# Criar lote

`POST /batch`

## Headers

- `User-Agent` string

## Request body

- union
  - object
    - `name` string
    - `auto_close` boolean — Opção que indica se o lote será fechado de forma automática. Ao ser informada como `true`, o lote será fechado e processado assim que for criado.
    - `type` 'BOLETO', required
    - `billets` BilletReq[]
      - `value` number, float — O campo value é opcional e é usado apenas se você precisar configurar um valor diferente para o boleto, em casos onde o valor do boleto fica em aberto ou tem juros e multas. Caso contrário não passe esta propriedade.
      - `payment_date` string, required
      - `barcode` string, required
      - `description` string, required
      - `integration_id` string
  - object
    - `name` string
    - `auto_close` boolean — Opção que indica se o lote será fechado de forma automática. Ao ser informada como `true`, o lote será fechado e processado assim que for criado.
    - `type` 'TRANSFERENCIA'
    - `transfers` TransferReq[]
      - union
        - object
          - `value` number, float, required — Valor da transferência
          - `integration_id` string — ID de integração
          - `idempotency_key` string — Chave de idempotência
          - `payment_date` string, date — Data para agendamento do pagamento (YYYY-MM-DD) - Prazo máximo de 30 dias
          - `pix_description` string — Comentário que será enviado no Pix
          - `destination_bank_account` object, required
            - `pix_key_type` 'EMAIL' | 'CPF' | 'CNPJ' | 'TELEFONE' | 'CHAVE_ALEATORIA', required
            - `pix_key` string, required
            - `email` string — E-mail para notificar o recebedor sobre a transferência Pix
          - `pix_key_validation` object
            - `cpf_cnpj` string — Documento para validar se o recebedor é o titular da chave Pix
          - `pix_end2end_id` string — End2end id da consulta de chaves Pix no DICT
          - `recurrence` RecurrenceReq
            - `interval` integer, required — Intervalo de tempo entre pagamentos
            - `interval_type` 'day' | 'month', required
            - `number_of_payments` integer — Número de pagamentos a serem realizados Caso seja `null`, a recorrência terá fim indeterminado
        - object
          - `value` number, float, required — Valor da transferência
          - `integration_id` string — ID de integração
          - `idempotency_key` string — Chave de idempotência
          - `payment_date` string, date — Data para agendamento do pagamento (YYYY-MM-DD) - Prazo máximo de 30 dias
          - `pix_description` string — Comentário que será enviado no Pix
          - `pix_key_validation` object
            - `cpf_cnpj` string — Documento para validar se o recebedor é o titular da chave Pix
          - `emv` string, required
          - `pix_end2end_id` string — End2end id da consulta de chaves Pix no DICT
        - object
          - `value` number, float, required — Valor da transferência
          - `integration_id` string — ID de integração
          - `idempotency_key` string — Chave de idempotência
          - `payment_date` string, date — Data para agendamento do pagamento (YYYY-MM-DD) - Prazo máximo de 30 dias
          - `pix_description` string — Comentário que será enviado no Pix
          - `destination_bank_account` object, required
            - `name` string — Nome do recebedor
            - `cpf_cnpj` string, required — Documento do recebedor
            - `bank_code` integer, required — Código do banco
            - `bank_ispb` string — ISPB do banco, obrigatório se o bank_code não for preenchido
            - `email` string — E-mail do recebedor
            - `agency` string, required — Agência da conta
            - `account` string, required — Número da conta
            - `account_digit` string, required — Dígito do número da conta
            - `account_type` 'CONTA_CORRENTE' | 'CONTA_POUPANCA' | 'CONTA_PAGAMENTO' | 'CONTA_FACIL' | 'ENTIDADES_PUBLICAS', required

## Response `200`

Successful response

- object
  - `id` integer

---

[API](https://skmtc.net/transfeera/apis/autentica-o.md) · [All operations](https://skmtc.net/transfeera/apis/autentica-o/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/transfeera/autentica-o/revisions/cf24b926bbaa/schema)