---
title: "Arc Label Preview"
method: POST
path: "/api/v1/arc/label/preview"
tags: ["arco"]
---

# Arc Label Preview

`POST /api/v1/arc/label/preview`

## 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/label/preview`
- Auth: none declared

A PRÉ-VISUALIZAÇÃO da etiqueta, sem o gate do documento: o que a aba do app
mostra ao lado do cálculo — o layout do PDF em HTML do núcleo
(`calc_core.render_label_preview`) e o trabalhador equipado (`worker_svg`).
O documento de campo, o PDF que se imprime e se afixa, continua atrás da
assinatura (`arc/label`). O corpo da etiqueta é em português por norma.

## Request body

- ArcLabelIn: A etiqueta ANSI Z535.4 / NBR 17227 §7. Documento assinável: mesmo gate do memorial. A norma manda a etiqueta em PORTUGUÊS (§7.2.3) — não há `lang`.
  - `entrada` ArcRequest, required
    - `Voc` number, required: tensão de operação (kV)
    - `Ibf` number, required: corrente de falta franca trifásica (kA)
    - `G` number, required: gap entre condutores (mm)
    - `D` number, required: distância de trabalho (mm)
    - `T_p` number, required: tempo de eliminação na Iarc plena (ms)
    - `T_r` number, nullable: tempo na Iarc reduzida (ms); default = T_p
    - `W` number
    - `H` number
    - `P` number
    - `cfg` string
    - `lang` string
  - `equipamento` string
  - `responsavel` string
  - `ciencia` CienciaIn: O que a tela declara ao pedir um documento assinável: o Termo aceito e o `hash` do conjunto de alertas de que deu ciência.
    - `termo_aceito` boolean
    - `hash` string
  - `declaracoes` DeclaracoesPonto: O que o engenheiro declarou ter feito FORA desta tela — os `getattr(ss, …)` que o checklist IA-1 consulta, como campos EXPLÍCITOS. **Ausente = não feito**, que é o default seguro: item não verificado nunca sai como conforme.
    - `lineside_avaliado` boolean: o engenheiro declarou ter avaliado o lado line-side (CK-01)
    - `t_coordenograma_ms` number, nullable: tempo de eliminação lido no coordenograma (CK-03)
    - `curto_calculado` boolean: há estudo de curto para este ponto (CK-02)
    - `lote_rodado` boolean: houve estudo em lote (CK-06)

## Response `200`

Successful Response

- EtiquetaPreviaOut: A PRÉ-VISUALIZAÇÃO da etiqueta (o layout do PDF, em HTML do núcleo) e o trabalhador equipado — o que a aba do app mostra ao lado do cálculo. Não é o documento: o PDF que se afixa no painel continua em `arc/label`.
  - `etiqueta_html` string, required
  - `boneco_svg` string, required
  - `categoria` integer, required
  - `Ei_cal` number, required
  - `tier` string, required

## Other responses

- `422`: entrada fora do domínio

---

[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)