POST Enviar Vendas em Lote
Envia vários orçamentos de uma vez. Modo "preparar envio": devolve o resultado por orçamento. A fila serializa o trabalho.
Ainda não disponível em produção
Esta rota existe na develop e ainda não foi publicada na main.
Autenticação necessária
Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
Permissão necessária
Exige a permissão read_movements.
Endpoint
POST https://api-dev.imagemais.com.br/api/integrations/conta-azul/deliveries/batch
Corpo da Requisição
| Campo | Tipo | Obrigatório | Valores válidos | Descrição |
|---|---|---|---|---|
budgetIds | number[] | ✅ | ao menos 1 item; até 100 itens; inteiro | IDs dos orçamentos |
Requisição
curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/integrations/conta-azul/deliveries/batch' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"budgetIds": [
1024,
1025
]
}'
Respostas
201 Sucesso
400 Requisição inválida
Retornado quando o corpo ou a query não passam na validação. A lista message traz um item por regra violada, por exemplo:
{
"message": [
"Cada orçamento deve ser um número inteiro",
"Envie no máximo 100 orçamentos por vez",
"Selecione ao menos um orçamento",
"budgetIds must be an array"
],
"error": "Bad Request",
"statusCode": 400
}
403 Sem permissão
{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}
404 Não encontrado
{
"message": "Orçamento ou movimentação não encontrado",
"error": "Not Found",
"statusCode": 404
}
500 Erro interno
{
"message": "Erro ao enfileirar os envios para a Conta Azul",
"error": "Internal Server Error",
"statusCode": 500
}