Dispara um job de ação em massa (upload de planilha)
POST/job
Cria um job para processar em lote a ação indicada por IDTypeJob. O sistema:
- Valida o
IDTypeJobcontra o catálogo deTypeJob(cada tipo sabe processar um formato de planilha — importação de SKU, de pedidos, etc.). - Faz upload do arquivo enviado (multipart
file, até 5 MB no frontend) para o armazenamento temporário e calcula o hash SHA-256 do conteúdo. - Se já existe um job da mesma empresa com o mesmo hash ainda em processamento, reaproveita o job existente e retorna o
IDJobatual sem disparar de novo — bloqueio anti-duplicação. - Caso contrário, registra um novo job e dispara o processamento de forma assíncrona.
- Devolve
IDJobao cliente. O resultado real é gravado linha-a-linha e o usuário recebe a confirmação por e-mail. Acompanhe viaGET /job/{idjob}.
Request
Responses
- 200
- 400
- 404
- 500
Job criado (ou reaproveitado). Devolve IDJob para acompanhamento. O processamento é assíncrono — o resultado vem por e-mail e pode ser acompanhado em GET /job/{idjob}.
Falha de validação. Mensagens possíveis: [BadRequest] - Ação não encontrada (IDTypeJob inválido); [BadRequest] - Erro ao processar ação em massa (combinação rota/tipo não mapeada); [BadRequest] - IDBankAccount é obrigatório; [BadRequest] - IDCompanyIntegration é obrigatório. Também devolve 400 sem corpo quando o file está ausente para uma ação que exige arquivo.
Empresa do accountname não localizada (404 sem corpo).
Erro interno (prefixo Error:).