---
title: "Caderno Da Planta"
method: POST
path: "/api/v1/tools/caderno"
tags: ["ferramentas"]
---

# Caderno Da Planta

`POST /api/v1/tools/caderno`

## 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/tools/caderno`
- Auth: none declared

O Caderno de Estudos da Planta: capa, índice e os memoriais concatenados.

Cada estudo é gerado pelo MESMO handler da rota avulsa — o caderno não
reimplementa documento nenhum. Estudo cujo corpo o contrato da ferramenta
recusa derruba o caderno com 422 NOMEANDO o slug: um caderno a que falta um
memorial em silêncio seria um documento que mente sobre a planta.

## Request body

- CadernoIn: O caderno aceita white-label desde a G150 — e é o caso que mais o exige: ele CONCATENA os memoriais das ferramentas, então uma marca que valesse só para a capa deixaria o miolo com a marca de outro dono. A marca desce para cada memorial que entra no caderno, e não apenas para a folha de rosto.
  - `estudos` EstudoDoCaderno[], required
    - `slug` string, required: o slug do catálogo (`GET /tools`)
    - `corpo` object, required: o corpo da rota `/tools/<slug>/memorial`
    - `veredito` string: o que a tela mostrou
    - `resultado` string: a manchete do estudo
  - `ident` Ident: Identificação do memorial — o que o expander do app pede antes do PDF.
    - `tag` string: circuito/instalação
    - `empresa` string
    - `resp` string: responsável técnico
  - `white_label` WhiteLabel: A marca do PARCEIRO no documento (S19/M1). Sob white-label a marca da plataforma some do documento INTEIRO, inclusive do Termo de Responsabilidade — resta só a versão do motor. Vale nos TRÊS documentos que o implementam (parecer de faturas, memorial de demanda e de recuperação — o "pacote do parceiro" da G106). Os memoriais das ferramentas e o caderno da planta ainda não o suportam, e por isso não o declaram: campo que o gerador ignora é promessa quebrada em silêncio.
    - `nome` string
    - `logo_png_b64` string, nullable: PNG em base64; passa pelo MESMO gate do upload do app
  - `lang` string

## Response `200`

Successful Response

## Other responses

- `402`: exige assinatura ativa
- `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)