---
title: "Arc Batch"
method: POST
path: "/api/v1/arc/batch"
tags: ["arco"]
---

# Arc Batch

`POST /api/v1/arc/batch`

## Request

- Base URL: `https://app.estudoseletricos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.estudoseletricos.com/api/v1/arc/batch`
- Auth: none declared

A planilha do cliente (própria, ou exportada do PTW/ETAP/DIgSILENT) vira
um estudo por linha, pelo MESMO motor.

Duas honestidades que o núcleo já impõe e o contrato preserva: a linha que o
parser recusa sai em `recusadas` COM o motivo e a linha do arquivo (sumir
com ela faria o lote mentir sobre a cobertura), e a linha que entra mas não
calcula volta com `Ei_cal` NULO e o erro — nunca com zero.

## Request body

- LoteIn
  - `arquivo` ArquivoIn, required: Um documento da série: o XML da NF3e ou o PDF da fatura, em base64. Vem por JSON e não por multipart porque o resto do contrato já é JSON e o conteúdo é pequeno — o teto está em `AUDIT_MAX_BYTES`, e o PDF-bomba já é barrado pelo próprio núcleo (`PDF_MAX_PAGINAS`).
    - `nome` string, required
    - `conteudo_b64` string, required: o arquivo em base64
  - `defaults` LoteDefaults: O invólucro aplicado às linhas que não o trazem. O arquivo do cliente (PTW, ETAP, DIgSILENT ou planilha própria) raramente traz geometria: o default entra onde falta, e a coluna do arquivo PREVALECE onde existe.
    - `G_mm` number
    - `D_mm` number
    - `cfg` string
    - `Largura_mm` number
    - `Altura_mm` number
    - `Prof_mm` number
    - `responsavel` string
  - `projeto` string
  - `lang` string

## Response `200`

Successful Response

- LoteOut
  - `linhas` LinhaLoteOut[], required
    - `equipamento` string
    - `Voc_kV` number, nullable
    - `Ibf_kA` number, nullable
    - `Ei_cal` number, nullable
    - `LAS_mm` number, nullable
    - `categoria` string, nullable
    - `erro` string
    - `tempo_limitado` boolean: o tempo de eliminação desta barra foi LIMITADO a 2 s (IEEE 1584:2018 §6.9.1): a proteção levaria mais — a etiqueta e o memorial declaram
    - `t_max_adotado` string, nullable: a barra está no tempo MÁXIMO (IEEE 1584:2018 §6.9.1) por uma corrente de arco que a proteção não vê (reduzida_cega · plena_cega, G313) ou por nenhuma delas com a opção `t_sem_atuacao_ms` (sem_atuacao, G329); nulo = a proteção eliminou as duas
  - `n_ok` integer, required
  - `n_recusadas` integer, required
  - `recusadas` object[]: linhas que o parser rejeitou, com a linha do arquivo e o motivo
  - `engine` string
  - `tier` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api.md) · [All operations](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api/revisions/5877d717cb1b?raw)