> For the complete documentation index, see [llms.txt](https://docs.eseye.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eseye.com/api-reference/api-reference-pt-br/api-de-operacoes-em-massa/overview.md).

# 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.                                                               |

{% hint style="info" %}
Se precisar desses valores, envie um e-mail para [Administração de Vendas](mailto:orders@eseye.com?subject=Request%20Prerequisites%20for%20bulk%20operations.) 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
  {% endhint %}

### 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](https://resources.anynetiot.com/template/update-icc-customerSuspend.CSV)    |
| Atualizar pacote do ICC                  | [Baixe o modelo de pacote](https://resources.anynetiot.com/template/update-icc-package.CSV)                    |
| Atualizar portfólio do ICC               | [Baixe o modelo de portfólio](https://resources.anynetiot.com/template/update-icc-portfolio.CSV)               |
| Atualizar status do ICC                  | [Baixe o modelo de status](https://resources.anynetiot.com/template/update-icc-status.CSV)                     |
| Atualizar atributo do ICC `friendlyName` | [Baixe o `friendlyName` modelo](https://resources.anynetiot.com/template/update-iccAttribute-friendlyName.CSV) |
| Atualizar atributo do ICC `orderId`      | [Baixe o `orderId` modelo](https://resources.anynetiot.com/template/update-iccAttribute-orderId.CSV)           |

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.eseye.com/api-reference/api-reference-pt-br/api-de-operacoes-em-massa/overview.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.