Visão geral

As APIs de Operações em Lote executam uma ação em vários itens, como cartões SIM. Você pode ativar, suspender, encerrar e atualizar itens em lote.

Use estas APIs para gerenciar grandes frotas de dispositivos ou SIMs. As operações em lote usam um arquivo CSV para alterar muitos SIMs.

Os tipos de tarefa mais comuns atualizam status, pacotes, portfólios e customerSuspend. Você também pode atualizar atributos como friendlyName e orderId. Quando a tarefa for concluída, baixe o arquivo de resposta de cada resultado de SIM.

Quando usar operações em lote

Use operações em lote para executar a mesma ação em muitos itens. Por exemplo:

• Ative vários cartões SIM.
• Suspenda ou encerre um lote de cartões SIM.
• Atualize atributos ou configurações para um grupo de itens.
• Envie e processe grandes conjuntos de dados em uma única operação.

Antes de começar, obtenha estes valores:

Item	Descrição
base64	Codificação Base64 de clientId:clientSecret para uma conta de serviço com permissões de arquivo e tarefa.
fileUrl	URL base do serviço de Arquivos.
jobUrl	URL base do serviço de Tarefas.
env	Seu ambiente: stage ou prod.
portfolioId	O portfólio que possui os arquivos e tarefas.

Se precisar desses valores, envie um e-mail para Administração de Vendas com o assunto Solicitação de pré-requisitos para operações em lote.

Inclua estes detalhes no e-mail:

• Nome da empresa
• Sua função
• Número de telefone de contato
• Endereço de e-mail de contato

Fluxo de trabalho

Execute o fluxo de trabalho em lote nesta ordem:

1. Obter token: Gere um token de acesso OAuth2.
2. Criar arquivo: Crie um registro de arquivo e um caminho S3.
3. Enviar ou baixar arquivo: Use action=upload para recuperar credenciais de upload S3 pré-assinadas.
4. Enviar arquivo para o S3: Selecione e envie seu arquivo CSV local.
5. Criar tarefa: Inicie a tarefa em lote para o CSV enviado.
6. Atualizar tarefa: Defina o status como queued para acionar a orquestração.
7. Obter arquivo de resposta: Aguarde até que responseFileId não seja nulo.
8. Enviar ou baixar arquivo: Use action=download para solicitar uma URL de resultados pré-assinada.
9. Baixe por meio da URL pré-assinada: Recupere o arquivo de resultados e salve-o localmente.

Escolha um modelo de CSV

Escolha o modelo para sua operação. Em seguida, selecione-o durante Enviar arquivo para o S3.

Operação	Modelo
Atualizar ICC customerSuspend	Baixe o customerSuspend modelo
Atualizar pacote do ICC	Baixe o modelo de pacote
Atualizar portfólio do ICC	Baixe o modelo de portfólio
Atualizar status do ICC	Baixe o modelo de status
Atualizar atributo do ICC friendlyName	Baixe o friendlyName modelo
Atualizar atributo do ICC orderId	Baixe o orderId modelo

Para atualizações de status, insira o valor do status em minúsculas.