> 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 essas APIs para gerenciar grandes frotas de dispositivos ou SIMs. As operações em lote usam um arquivo CSV para alterar vários SIMs.

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

### Quando usar operações em lote

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

* Ativar vários cartões SIM.
* Suspender ou encerrar um lote de cartões SIM.
* Atualizar atributos ou configurações para um grupo de itens.
* Carregar e processar 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 job. |
| `fileUrl`     | URL base do serviço de Arquivos.                                                                         |
| `jobUrl`      | URL base do serviço de Job.                                                                              |
| `env`         | Seu ambiente: `stage` ou `prod`.                                                                         |
| `portfolioId` | O portfólio que possui os arquivos e jobs.                                                               |

{% hint style="info" %}
Se você precisar desses valores, envie um e-mail para [Sales Admin](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 job:** Inicie o job em lote para o CSV enviado.
6. **Atualizar job:** Defina o status como `queued` para acionar a orquestração.
7. **Obter ResponseFile:** Faça polling até que `responseFileId` não seja nulo.
8. **Enviar ou baixar arquivo:** Use `action=download` para solicitar uma URL de resultados pré-assinada.
9. **Baixar via 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 ICC                  | [Baixe o modelo do pacote](https://resources.anynetiot.com/template/update-icc-package.CSV)                    |
| Atualizar portfólio ICC               | [Baixe o modelo do 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 ICC `friendlyName` | [Baixe o `friendlyName` modelo](https://resources.anynetiot.com/template/update-iccAttribute-friendlyName.CSV) |
| Atualizar atributo 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 letras 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.