Importa planilha de SKUs (job assíncrono)
POST/sku/template
Envia uma planilha e agenda a importação correspondente. O processamento é assíncrono: a resposta apenas confirma o agendamento e devolve o identificador do processamento IDJob; o resultado chega por e-mail.
O envio do arquivo pode ser feito de duas maneiras. Na forma em duas etapas (usada pelo produto), a primeira chamada envia Action = RequestUploadUrl com nome, tipo, tamanho e resumo MD5 do arquivo e recebe de volta o endereço UploadUrl, os cabeçalhos Headers — que devem ser repetidos exatamente no envio do arquivo — e ExpiresIn, a validade do endereço em segundos (padrão 1 hora). A segunda chamada envia Action = ConfirmUpload com o Key devolvido; nesse momento o arquivo enviado é conferido contra o que foi declarado (tamanho real e nome original) antes de o processamento ser criado. Na forma direta, o arquivo vai como multipart/form-data no campo file. Em qualquer das formas o arquivo precisa respeitar o tamanho máximo configurado (padrão 50 MB).
O tipo de importação é definido por Type; quando Type não é informado, use IDTypeJob para indicar a ação em massa desejada. Alguns tipos (ex.: correios) não exigem arquivo e são disparados apenas com os parâmetros de query.
Duas ações em massa exigem um parâmetro adicional na query e são recusadas sem ele: IDTypeJob = 38 (Importar extrato OFX) exige IDBankAccount, e IDTypeJob = 41 (Importar conciliação adquirente) exige IDCompanyIntegration. O valor informado é guardado junto com o processamento e usado pela rotina que lê a planilha.
Reenviar o mesmo arquivo não duplica o processamento: quando já existe um processamento equivalente, a resposta devolve o IDJob que já estava em andamento.
Request
Responses
- 200
- 400
- 404
- 500
Endereço temporário para o envio do arquivo, quando a chamada foi Action = RequestUploadUrl; nos demais casos, confirmação do agendamento com o identificador do processamento IDJob.
Mensagens [BadRequest]:
Corpo da requisição inválidoAção não encontradaErro ao processar ação em massaEsta ação não requer o envio de um arquivoNão é possível enviar arquivo para esta açãoSelecione um arquivo para enviarNão foi possível identificar o tipo do arquivo selecionadoNão foi possível identificar o tamanho do arquivo selecionadoO arquivo selecionado excede o tamanho máximo permitidoNão foi possível validar o arquivo selecionado. Selecione-o novamente e tente de novoFalha ao gerar o link de upload: <detalhe>Não foi possível identificar o arquivo enviado. Solicite um novo envioNão foi possível localizar o arquivo enviado. Envie-o novamenteO arquivo enviado não corresponde ao arquivo selecionado. Envie-o novamenteNão foi possível validar o arquivo enviado. Envie-o novamenteNão foi possível ler o arquivo enviado. Envie-o novamenteNão foi possível confirmar o envio do arquivo. Tente novamenteNão foi possível processar o arquivo enviado. Envie-o novamenteIDBankAccount é obrigatórioIDCompanyIntegration é obrigatório
Conta do subdomínio não localizada. Resposta sem corpo.
Erro interno.