Skip to main content

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​

CampoTipoObrigatórioValores válidosDescrição
budgetIdsnumber[]✅ao menos 1 item; até 100 itens; inteiroIDs 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
}