Remover itens de lote

DELETE /api/v1/valepix/employees/batch/{batch_id}

Remove itens específicos de um lote antes da confirmação.

Autenticação

Envie um API token ativo no header Authorization.

Authorization: Bearer <VALEPIX_API_TOKEN>
Accept: application/json
Content-Type: application/json

Path params

Parâmetro	Tipo	Obrigatório	Descrição
batch_id	string	Sim	Identificador do lote retornado no upload

Body

Campo	Tipo	Obrigatório	Descrição
item_ids	array de strings	Sim	IDs dos itens do lote que devem ser removidos

Exemplo curl

curl --request DELETE \
  --header "Authorization: Bearer $VALEPIX_API_TOKEN" \
  --header "Content-Type: application/json" \
  --header "Accept: application/json" \
  --url "https://routes.valepix.com.br/api/v1/valepix/employees/batch/$BATCH_ID" \
  --data '{
    "item_ids": [
      "00000000-0000-4000-8000-000000000101"
    ]
  }'

Response

{
  "success": "success",
  "data": {
    "success": true
  }
}

Erros comuns

HTTP	Quando acontece	Ação recomendada
400	batch_id ausente, item_ids ausente ou payload inválido	Corrigir IDs e body
401	Token ausente, inválido, expirado ou revogado	Conferir token
403	Token sem acesso ao recurso solicitado	Confirmar token com a ValePix
404	Lote ou item não encontrado	Conferir batch_id e item_ids
500	Erro interno temporário	Tentar novamente com backoff