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 handler:
- Valida o
IDTypeJobcontra o catálogo deTypeJob(cada tipo aponta para umaFunctionNameLambda que sabe processar a planilha —skuFileTemplateImport,orderTemplateImport, etc.). - Faz upload do arquivo enviado (multipart
file, até 5 MB no frontend) para o S3 emTemp/<accountname>_<uuid>.<ext>e calcula o hash SHA-256 do conteúdo. - Se já existe um
Jobsda mesma empresa com o mesmo hash ainda em processamento (StartedAt IS NOT NULL AND FinishedAt IS NULL), reaproveita o job existente e retorna oIDJobatual sem disparar de novo — bloqueio anti-duplicação. - Caso contrário, grava um novo
Jobs(comIDFile,FileHash,Metadata,IDTypeJob) e invoca a função associada de forma assíncrona (InvocationType: Event). - Devolve
IDJobao cliente. O resultado real é gravado emJobsResultlinha-a-linha pela função invocada 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:).