termo_core 0.1.6 → 0.1.8

package/dist/base/servicos.d.ts

@@ -6,6 +6,7 @@ export declare const TERMO_FLOW: ServicoTermotubos;
 export declare const TERMO_INTRANET: ServicoTermotubos;
 export declare const TERMO_LEADS: ServicoTermotubos;
 export declare const TERMO_MCP: ServicoTermotubos;
+export declare const TERMO_MIRO: ServicoTermotubos;
 export declare const TERMO_PORTAL: ServicoTermotubos;
 export declare const TERMO_QUALITY: ServicoTermotubos;
 export declare const TERMO_STATUS: ServicoTermotubos;

package/dist/base/servicos.js

@@ -55,6 +55,14 @@ export const TERMO_MCP = {
     endereco_em_production: "https://api-mcp.termotubos.com.br",
     ativo: false,
 };
+export const TERMO_MIRO = {
+    nome_do_servico: "TermoMiro",
+    nome_do_modulo: "miro",
+    endereco_no_localhost: "http://localhost:51141",
+    endereco_no_sandbox: "https://sandbox-api-miro.termotubos.com.br",
+    endereco_em_production: "https://api-miro.termotubos.com.br",
+    ativo: true,
+};
 export const TERMO_PORTAL = {
     nome_do_servico: "TermoPortal",
     nome_do_modulo: "portal",
@@ -127,6 +135,7 @@ export const TODOS_OS_SERVICOS = [
     TERMO_INTRANET,
     TERMO_LEADS,
     TERMO_MCP,
+    TERMO_MIRO,
     TERMO_PORTAL,
     TERMO_QUALITY,
     TERMO_STATUS,

package/dist/flow/rotas.d.ts

@@ -4,7 +4,7 @@ import { type OpcoesDaChamada } from "../base/requisicao.js";
 /**
  * Cadastra um robô de atendimento
  *
- * Exige a permissão `criar` da área `configuracoes`. `nome` é obrigatório (até 80 caracteres, único entre os robôs); `modelo` é a IA preferida do gateway do TermoAI, um `provedor` de `GET /robo/modelos` (opcional, até 80; vazio deixa o TermoAI escolher); `descricao` vai até 200 e `prompt_base` até 4000 (padrão vazio). Sem `fluxo`, o robô nasce só com a etapa de início. O robô nasce ativo, na versão 1. `fluxo` é o caminho do atendimento: `nos` (até 40 etapas, exatamente uma do tipo `inicio`; os outros tipos são `inicio_contato_novo`, `instrucao`, `mensagem`, `botoes`, `atendimento` e `gatilho`) e `ligacoes` (`origem`, `destino` e `origem_saida`, que é o id do botão ou da regra de onde a ligação sai, `null` no início e na mensagem). Cada etapa fora o início precisa de `nome` (até 60 caracteres); `objetivo` vai até 200, `instrucao` até 2000 e `mensagem` até 1000; `ferramentas` lista até 20 ids de ferramentas do robô. A `instrucao` precisa de 1 a 10 `regras` de saída (`condicao` até 200 caracteres); `botoes` precisa de 1 a 10 botões (`rotulo` até 20 caracteres) e de texto fixo em `mensagem` ou, com `mensagem_por_ia`, da `instrucao` para a IA escrever; `mensagem` também exige texto fixo ou `mensagem_por_ia`; `atendimento` encerra o robô, passa a conversa para a equipe do Chatwoot em `equipe_id` (opcional, de `GET /robo/equipes`) e não tem saída; `gatilho` (no máximo um, sem ligação de entrada nem de saída) é o gatilho de cliente sem resposta: `minutos_sem_resposta` (1 a 1440) e `equipe_id` opcional, e uma varredura a cada minuto passa para essa equipe toda conversa com o robô em que o cliente ficou esse tempo sem responder. Ids de etapas, botões e regras são únicos; nenhuma ligação volta ao início nem liga a etapa nela mesma, e cada saída tem no máximo uma próxima etapa. `inicio_contato_novo` (no máximo um, sem ligação de entrada) é o início de quem não está na lista de clientes: só vale com `atender_contatos_novos` ligado e, sem ele ou sem ligação, o contato novo sai pelo `inicio`. O texto fixo aceita marcadores como `{{cliente.nome}}` e `{{ultimo_pedido.itens}}`.
+ * Exige a permissão `criar` da área `robos`. `nome` é obrigatório (até 80 caracteres, único entre os robôs); `modelo` é a IA preferida do gateway do TermoAI, um `provedor` de `GET /robo/modelos` (opcional, até 80; vazio deixa o TermoAI escolher); `descricao` vai até 200 e `prompt_base` até 4000 (padrão vazio). Sem `fluxo`, o robô nasce só com a etapa de início. O robô nasce ativo, na versão 1. `fluxo` é o caminho do atendimento: `nos` (até 40 etapas, exatamente uma do tipo `inicio`; os outros tipos são `inicio_contato_novo`, `instrucao`, `mensagem`, `botoes`, `atendimento` e `gatilho`) e `ligacoes` (`origem`, `destino` e `origem_saida`, que é o id do botão ou da regra de onde a ligação sai, `null` no início e na mensagem). Cada etapa fora o início precisa de `nome` (até 60 caracteres); `objetivo` vai até 200, `instrucao` até 2000 e `mensagem` até 1000; `ferramentas` lista até 20 ids de ferramentas do robô. A `instrucao` precisa de 1 a 10 `regras` de saída (`condicao` até 200 caracteres); `botoes` precisa de 1 a 10 botões (`rotulo` até 20 caracteres) e de texto fixo em `mensagem` ou, com `mensagem_por_ia`, da `instrucao` para a IA escrever; `mensagem` também exige texto fixo ou `mensagem_por_ia`; `atendimento` encerra o robô, passa a conversa para a equipe do Chatwoot em `equipe_id` (opcional, de `GET /robo/equipes`) e não tem saída; `gatilho` (no máximo um, sem ligação de entrada nem de saída) é o gatilho de cliente sem resposta: `minutos_sem_resposta` (1 a 1440) e `equipe_id` opcional, e uma varredura a cada minuto passa para essa equipe toda conversa com o robô em que o cliente ficou esse tempo sem responder. Ids de etapas, botões e regras são únicos; nenhuma ligação volta ao início nem liga a etapa nela mesma, e cada saída tem no máximo uma próxima etapa. `inicio_contato_novo` (no máximo um, sem ligação de entrada) é o início de quem não está na lista de clientes: só vale com `atender_contatos_novos` ligado e, sem ele ou sem ligação, o contato novo sai pelo `inicio`. O texto fixo aceita marcadores como `{{cliente.nome}}` e `{{ultimo_pedido.itens}}`.
  *
  * `POST /robo`
  */
@@ -12,7 +12,7 @@ export declare function criar_robo(credencial_de_acesso: CredencialDeAcesso, cor
 /**
  * Atualiza um robô pelo id
  *
- * Exige a permissão `editar` da área `configuracoes`. Atualização parcial: só os campos enviados mudam, com os mesmos limites do cadastro; `descricao` vazia apaga o valor `ativo` liga ou desliga o robô e `atender_contatos_novos` decide se o robô atende quem não está na lista de clientes (cliente cadastrado com o atendente desligado continua indo para a equipe). `fluxo`, quando enviado, substitui o fluxo inteiro. Enviar `prompt_base` ou `fluxo` sobe a `versao` em 1. `fluxo` é o caminho do atendimento: `nos` (até 40 etapas, exatamente uma do tipo `inicio`; os outros tipos são `inicio_contato_novo`, `instrucao`, `mensagem`, `botoes`, `atendimento` e `gatilho`) e `ligacoes` (`origem`, `destino` e `origem_saida`, que é o id do botão ou da regra de onde a ligação sai, `null` no início e na mensagem). Cada etapa fora o início precisa de `nome` (até 60 caracteres); `objetivo` vai até 200, `instrucao` até 2000 e `mensagem` até 1000; `ferramentas` lista até 20 ids de ferramentas do robô. A `instrucao` precisa de 1 a 10 `regras` de saída (`condicao` até 200 caracteres); `botoes` precisa de 1 a 10 botões (`rotulo` até 20 caracteres) e de texto fixo em `mensagem` ou, com `mensagem_por_ia`, da `instrucao` para a IA escrever; `mensagem` também exige texto fixo ou `mensagem_por_ia`; `atendimento` encerra o robô, passa a conversa para a equipe do Chatwoot em `equipe_id` (opcional, de `GET /robo/equipes`) e não tem saída; `gatilho` (no máximo um, sem ligação de entrada nem de saída) é o gatilho de cliente sem resposta: `minutos_sem_resposta` (1 a 1440) e `equipe_id` opcional, e uma varredura a cada minuto passa para essa equipe toda conversa com o robô em que o cliente ficou esse tempo sem responder. Ids de etapas, botões e regras são únicos; nenhuma ligação volta ao início nem liga a etapa nela mesma, e cada saída tem no máximo uma próxima etapa. `inicio_contato_novo` (no máximo um, sem ligação de entrada) é o início de quem não está na lista de clientes: só vale com `atender_contatos_novos` ligado e, sem ele ou sem ligação, o contato novo sai pelo `inicio`. O texto fixo aceita marcadores como `{{cliente.nome}}` e `{{ultimo_pedido.itens}}`.
+ * Exige a permissão `editar` da área `robos`. Atualização parcial: só os campos enviados mudam, com os mesmos limites do cadastro; `descricao` vazia apaga o valor `ativo` liga ou desliga o robô e `atender_contatos_novos` decide se o robô atende quem não está na lista de clientes (cliente cadastrado com o atendente desligado continua indo para a equipe). `fluxo`, quando enviado, substitui o fluxo inteiro. Enviar `prompt_base` ou `fluxo` sobe a `versao` em 1. `fluxo` é o caminho do atendimento: `nos` (até 40 etapas, exatamente uma do tipo `inicio`; os outros tipos são `inicio_contato_novo`, `instrucao`, `mensagem`, `botoes`, `atendimento` e `gatilho`) e `ligacoes` (`origem`, `destino` e `origem_saida`, que é o id do botão ou da regra de onde a ligação sai, `null` no início e na mensagem). Cada etapa fora o início precisa de `nome` (até 60 caracteres); `objetivo` vai até 200, `instrucao` até 2000 e `mensagem` até 1000; `ferramentas` lista até 20 ids de ferramentas do robô. A `instrucao` precisa de 1 a 10 `regras` de saída (`condicao` até 200 caracteres); `botoes` precisa de 1 a 10 botões (`rotulo` até 20 caracteres) e de texto fixo em `mensagem` ou, com `mensagem_por_ia`, da `instrucao` para a IA escrever; `mensagem` também exige texto fixo ou `mensagem_por_ia`; `atendimento` encerra o robô, passa a conversa para a equipe do Chatwoot em `equipe_id` (opcional, de `GET /robo/equipes`) e não tem saída; `gatilho` (no máximo um, sem ligação de entrada nem de saída) é o gatilho de cliente sem resposta: `minutos_sem_resposta` (1 a 1440) e `equipe_id` opcional, e uma varredura a cada minuto passa para essa equipe toda conversa com o robô em que o cliente ficou esse tempo sem responder. Ids de etapas, botões e regras são únicos; nenhuma ligação volta ao início nem liga a etapa nela mesma, e cada saída tem no máximo uma próxima etapa. `inicio_contato_novo` (no máximo um, sem ligação de entrada) é o início de quem não está na lista de clientes: só vale com `atender_contatos_novos` ligado e, sem ele ou sem ligação, o contato novo sai pelo `inicio`. O texto fixo aceita marcadores como `{{cliente.nome}}` e `{{ultimo_pedido.itens}}`.
  *
  * `PATCH /robo/{id}`
  */

package/dist/flow/rotas.js

@@ -4,7 +4,7 @@ import { TERMO_FLOW as SERVICO_DESTA_API } from "../base/servicos.js";
 /**
  * Cadastra um robô de atendimento
  *
- * Exige a permissão `criar` da área `configuracoes`. `nome` é obrigatório (até 80 caracteres, único entre os robôs); `modelo` é a IA preferida do gateway do TermoAI, um `provedor` de `GET /robo/modelos` (opcional, até 80; vazio deixa o TermoAI escolher); `descricao` vai até 200 e `prompt_base` até 4000 (padrão vazio). Sem `fluxo`, o robô nasce só com a etapa de início. O robô nasce ativo, na versão 1. `fluxo` é o caminho do atendimento: `nos` (até 40 etapas, exatamente uma do tipo `inicio`; os outros tipos são `inicio_contato_novo`, `instrucao`, `mensagem`, `botoes`, `atendimento` e `gatilho`) e `ligacoes` (`origem`, `destino` e `origem_saida`, que é o id do botão ou da regra de onde a ligação sai, `null` no início e na mensagem). Cada etapa fora o início precisa de `nome` (até 60 caracteres); `objetivo` vai até 200, `instrucao` até 2000 e `mensagem` até 1000; `ferramentas` lista até 20 ids de ferramentas do robô. A `instrucao` precisa de 1 a 10 `regras` de saída (`condicao` até 200 caracteres); `botoes` precisa de 1 a 10 botões (`rotulo` até 20 caracteres) e de texto fixo em `mensagem` ou, com `mensagem_por_ia`, da `instrucao` para a IA escrever; `mensagem` também exige texto fixo ou `mensagem_por_ia`; `atendimento` encerra o robô, passa a conversa para a equipe do Chatwoot em `equipe_id` (opcional, de `GET /robo/equipes`) e não tem saída; `gatilho` (no máximo um, sem ligação de entrada nem de saída) é o gatilho de cliente sem resposta: `minutos_sem_resposta` (1 a 1440) e `equipe_id` opcional, e uma varredura a cada minuto passa para essa equipe toda conversa com o robô em que o cliente ficou esse tempo sem responder. Ids de etapas, botões e regras são únicos; nenhuma ligação volta ao início nem liga a etapa nela mesma, e cada saída tem no máximo uma próxima etapa. `inicio_contato_novo` (no máximo um, sem ligação de entrada) é o início de quem não está na lista de clientes: só vale com `atender_contatos_novos` ligado e, sem ele ou sem ligação, o contato novo sai pelo `inicio`. O texto fixo aceita marcadores como `{{cliente.nome}}` e `{{ultimo_pedido.itens}}`.
+ * Exige a permissão `criar` da área `robos`. `nome` é obrigatório (até 80 caracteres, único entre os robôs); `modelo` é a IA preferida do gateway do TermoAI, um `provedor` de `GET /robo/modelos` (opcional, até 80; vazio deixa o TermoAI escolher); `descricao` vai até 200 e `prompt_base` até 4000 (padrão vazio). Sem `fluxo`, o robô nasce só com a etapa de início. O robô nasce ativo, na versão 1. `fluxo` é o caminho do atendimento: `nos` (até 40 etapas, exatamente uma do tipo `inicio`; os outros tipos são `inicio_contato_novo`, `instrucao`, `mensagem`, `botoes`, `atendimento` e `gatilho`) e `ligacoes` (`origem`, `destino` e `origem_saida`, que é o id do botão ou da regra de onde a ligação sai, `null` no início e na mensagem). Cada etapa fora o início precisa de `nome` (até 60 caracteres); `objetivo` vai até 200, `instrucao` até 2000 e `mensagem` até 1000; `ferramentas` lista até 20 ids de ferramentas do robô. A `instrucao` precisa de 1 a 10 `regras` de saída (`condicao` até 200 caracteres); `botoes` precisa de 1 a 10 botões (`rotulo` até 20 caracteres) e de texto fixo em `mensagem` ou, com `mensagem_por_ia`, da `instrucao` para a IA escrever; `mensagem` também exige texto fixo ou `mensagem_por_ia`; `atendimento` encerra o robô, passa a conversa para a equipe do Chatwoot em `equipe_id` (opcional, de `GET /robo/equipes`) e não tem saída; `gatilho` (no máximo um, sem ligação de entrada nem de saída) é o gatilho de cliente sem resposta: `minutos_sem_resposta` (1 a 1440) e `equipe_id` opcional, e uma varredura a cada minuto passa para essa equipe toda conversa com o robô em que o cliente ficou esse tempo sem responder. Ids de etapas, botões e regras são únicos; nenhuma ligação volta ao início nem liga a etapa nela mesma, e cada saída tem no máximo uma próxima etapa. `inicio_contato_novo` (no máximo um, sem ligação de entrada) é o início de quem não está na lista de clientes: só vale com `atender_contatos_novos` ligado e, sem ele ou sem ligação, o contato novo sai pelo `inicio`. O texto fixo aceita marcadores como `{{cliente.nome}}` e `{{ultimo_pedido.itens}}`.
  *
  * `POST /robo`
  */
@@ -21,7 +21,7 @@ export function criar_robo(credencial_de_acesso, corpo_da_requisicao, opcoes_da_
 /**
  * Atualiza um robô pelo id
  *
- * Exige a permissão `editar` da área `configuracoes`. Atualização parcial: só os campos enviados mudam, com os mesmos limites do cadastro; `descricao` vazia apaga o valor `ativo` liga ou desliga o robô e `atender_contatos_novos` decide se o robô atende quem não está na lista de clientes (cliente cadastrado com o atendente desligado continua indo para a equipe). `fluxo`, quando enviado, substitui o fluxo inteiro. Enviar `prompt_base` ou `fluxo` sobe a `versao` em 1. `fluxo` é o caminho do atendimento: `nos` (até 40 etapas, exatamente uma do tipo `inicio`; os outros tipos são `inicio_contato_novo`, `instrucao`, `mensagem`, `botoes`, `atendimento` e `gatilho`) e `ligacoes` (`origem`, `destino` e `origem_saida`, que é o id do botão ou da regra de onde a ligação sai, `null` no início e na mensagem). Cada etapa fora o início precisa de `nome` (até 60 caracteres); `objetivo` vai até 200, `instrucao` até 2000 e `mensagem` até 1000; `ferramentas` lista até 20 ids de ferramentas do robô. A `instrucao` precisa de 1 a 10 `regras` de saída (`condicao` até 200 caracteres); `botoes` precisa de 1 a 10 botões (`rotulo` até 20 caracteres) e de texto fixo em `mensagem` ou, com `mensagem_por_ia`, da `instrucao` para a IA escrever; `mensagem` também exige texto fixo ou `mensagem_por_ia`; `atendimento` encerra o robô, passa a conversa para a equipe do Chatwoot em `equipe_id` (opcional, de `GET /robo/equipes`) e não tem saída; `gatilho` (no máximo um, sem ligação de entrada nem de saída) é o gatilho de cliente sem resposta: `minutos_sem_resposta` (1 a 1440) e `equipe_id` opcional, e uma varredura a cada minuto passa para essa equipe toda conversa com o robô em que o cliente ficou esse tempo sem responder. Ids de etapas, botões e regras são únicos; nenhuma ligação volta ao início nem liga a etapa nela mesma, e cada saída tem no máximo uma próxima etapa. `inicio_contato_novo` (no máximo um, sem ligação de entrada) é o início de quem não está na lista de clientes: só vale com `atender_contatos_novos` ligado e, sem ele ou sem ligação, o contato novo sai pelo `inicio`. O texto fixo aceita marcadores como `{{cliente.nome}}` e `{{ultimo_pedido.itens}}`.
+ * Exige a permissão `editar` da área `robos`. Atualização parcial: só os campos enviados mudam, com os mesmos limites do cadastro; `descricao` vazia apaga o valor `ativo` liga ou desliga o robô e `atender_contatos_novos` decide se o robô atende quem não está na lista de clientes (cliente cadastrado com o atendente desligado continua indo para a equipe). `fluxo`, quando enviado, substitui o fluxo inteiro. Enviar `prompt_base` ou `fluxo` sobe a `versao` em 1. `fluxo` é o caminho do atendimento: `nos` (até 40 etapas, exatamente uma do tipo `inicio`; os outros tipos são `inicio_contato_novo`, `instrucao`, `mensagem`, `botoes`, `atendimento` e `gatilho`) e `ligacoes` (`origem`, `destino` e `origem_saida`, que é o id do botão ou da regra de onde a ligação sai, `null` no início e na mensagem). Cada etapa fora o início precisa de `nome` (até 60 caracteres); `objetivo` vai até 200, `instrucao` até 2000 e `mensagem` até 1000; `ferramentas` lista até 20 ids de ferramentas do robô. A `instrucao` precisa de 1 a 10 `regras` de saída (`condicao` até 200 caracteres); `botoes` precisa de 1 a 10 botões (`rotulo` até 20 caracteres) e de texto fixo em `mensagem` ou, com `mensagem_por_ia`, da `instrucao` para a IA escrever; `mensagem` também exige texto fixo ou `mensagem_por_ia`; `atendimento` encerra o robô, passa a conversa para a equipe do Chatwoot em `equipe_id` (opcional, de `GET /robo/equipes`) e não tem saída; `gatilho` (no máximo um, sem ligação de entrada nem de saída) é o gatilho de cliente sem resposta: `minutos_sem_resposta` (1 a 1440) e `equipe_id` opcional, e uma varredura a cada minuto passa para essa equipe toda conversa com o robô em que o cliente ficou esse tempo sem responder. Ids de etapas, botões e regras são únicos; nenhuma ligação volta ao início nem liga a etapa nela mesma, e cada saída tem no máximo uma próxima etapa. `inicio_contato_novo` (no máximo um, sem ligação de entrada) é o início de quem não está na lista de clientes: só vale com `atender_contatos_novos` ligado e, sem ele ou sem ligação, o contato novo sai pelo `inicio`. O texto fixo aceita marcadores como `{{cliente.nome}}` e `{{ultimo_pedido.itens}}`.
  *
  * `PATCH /robo/{id}`
  */

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export * as flow from "./flow/index.js";
 export * as intranet from "./intranet/index.js";
 export * as leads from "./leads/index.js";
 export * as mcp from "./mcp/index.js";
+export * as miro from "./miro/index.js";
 export * as portal from "./portal/index.js";
 export * as quality from "./quality/index.js";
 export * as status from "./status/index.js";

package/dist/index.js

@@ -7,6 +7,7 @@ export * as flow from "./flow/index.js";
 export * as intranet from "./intranet/index.js";
 export * as leads from "./leads/index.js";
 export * as mcp from "./mcp/index.js";
+export * as miro from "./miro/index.js";
 export * as portal from "./portal/index.js";
 export * as quality from "./quality/index.js";
 export * as status from "./status/index.js";

package/dist/miro/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Cliente tipado da API do TermoMiro, gerado a partir do `openapi.json` do serviço.
+ */
+export * from "./tipos.js";
+export * from "./rotas.js";
+export { CredencialDeAcesso, ErroAoChamarServico } from "../base/index.js";

package/dist/miro/index.js

@@ -0,0 +1,7 @@
+// Gerado pelo gerador do TermoCore (`cargo run -p gerador`). Não edite à mão: a próxima geração sobrescreve.
+/**
+ * Cliente tipado da API do TermoMiro, gerado a partir do `openapi.json` do serviço.
+ */
+export * from "./tipos.js";
+export * from "./rotas.js";
+export { CredencialDeAcesso, ErroAoChamarServico } from "../base/index.js";

package/dist/miro/rotas.d.ts

@@ -0,0 +1,108 @@
+import type * as tipos from "./tipos.js";
+import type { CredencialDeAcesso } from "../base/credencial.js";
+import { type OpcoesDaChamada } from "../base/requisicao.js";
+/**
+ * Parâmetros de consulta e de cabeçalho de `/board`.
+ */
+export interface ParametrosDeBuscarPaginadorBoard {
+    pagina?: number;
+    tamanho?: number;
+    nome?: string;
+    favoritos?: boolean;
+}
+/**
+ * Parâmetros de consulta e de cabeçalho de `/board/autocomplete`.
+ */
+export interface ParametrosDeBuscarAutoCompleteBoard {
+    busca?: string;
+    pagina?: number;
+    tamanho?: number;
+}
+/**
+ * Parâmetros de consulta e de cabeçalho de `/board/filtro`.
+ */
+export interface ParametrosDeBuscarPeloFiltroBoard {
+    nome?: string;
+    favoritos?: boolean;
+    dono_id?: string;
+}
+/**
+ * Lista os boards paginados
+ *
+ * Os boards que a pessoa enxerga, do mais recente para o mais antigo, sempre 50 por página: `tamanho` é ignorado. `pagina` começa em 1; aceita `nome` e `favoritos` como no filtro.
+ *
+ * `GET /board`
+ */
+export declare function buscar_paginador_board(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorBoard, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaBoard>;
+/**
+ * Cria um board
+ *
+ * Livre para todo colaborador logado; quem cria é o dono. `nome` é obrigatório (até 120 caracteres), `descricao` vai até 500, `cor` segue o formato `#00397c` (padrão `#00397c`) e `visibilidade` é `ORGANIZACAO` (padrão, todos veem e editam) ou `MEMBROS` (só o dono e os `membro_ids`). O canvas nasce vazio e é editado em tempo real em `GET /board/ws/{id}?token=<JWT>` (WebSocket no protocolo do Yjs).
+ *
+ * `POST /board`
+ */
+export declare function criar_board(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.BoardCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Board>;
+/**
+ * Lista básica de boards para seleção
+ *
+ * Id, nome e cor dos boards que a pessoa enxerga, em ordem alfabética. `busca` procura o trecho no nome. `pagina` começa em 1 e `tamanho` tem padrão 10.
+ *
+ * `GET /board/autocomplete`
+ */
+export declare function buscar_auto_complete_board(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteBoard, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaBoardAutoComplete>;
+/**
+ * Busca boards por filtro
+ *
+ * Todos os boards que a pessoa enxerga, do mais recente para o mais antigo. `nome` procura o trecho no nome sem diferenciar maiúsculas, `favoritos=true` traz só os favoritos de quem pediu e `dono_id` só os de um dono.
+ *
+ * `GET /board/filtro`
+ */
+export declare function buscar_pelo_filtro_board(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroBoard, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Board>>;
+/**
+ * Baixa uma imagem do canvas guardada no banco
+ *
+ * Pública (o `<img>` do canvas não manda token): devolve os bytes da imagem que ficou no banco porque o TermoBucket falhou, com cache longo.
+ *
+ * `GET /board/imagem/{id}`
+ */
+export declare function buscar_imagem_board(id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
+/**
+ * Busca um board pelo id
+ *
+ * Devolve o board com o dono, os membros, se é favorito de quem pediu e se essa pessoa pode gerenciá-lo (`pode_gerenciar`: dono ou master do TermoAuth). Board `MEMBROS` de que a pessoa não participa responde `404`, como se não existisse.
+ *
+ * `GET /board/{id}`
+ */
+export declare function buscar_pelo_id_board(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Board>;
+/**
+ * Atualiza um board pelo id
+ *
+ * Atualização parcial. `nome`, `descricao` (`null` apaga) e `cor` valem para quem enxerga o board; `visibilidade` e `membro_ids` (a lista inteira) só para o dono ou o master do TermoAuth. `favorito` marca ou desmarca o board como favorito de quem pediu, e `miniatura` é o SVG (até 200 KB) da prévia mostrada na lista; esses dois não mudam a ordem de recentes.
+ *
+ * `PATCH /board/{id}`
+ */
+export declare function atualizar_pelo_id_board(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.BoardAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Board>;
+/**
+ * Exclui um board pelo id
+ *
+ * Só o dono ou o master do TermoAuth. Exclusão lógica: o board some das listas e quem estava com ele aberto é desconectado.
+ *
+ * `DELETE /board/{id}`
+ */
+export declare function deletar_pelo_id_board(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
+/**
+ * Duplica um board
+ *
+ * Cria "Cópia de <nome>" com todo o conteúdo do canvas. Quem pediu vira o dono da cópia, que mantém a visibilidade do original, sem membros e sem favoritos.
+ *
+ * `POST /board/{id}/duplicar`
+ */
+export declare function duplicar_board(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Board>;
+/**
+ * Envia uma imagem para o canvas
+ *
+ * Guarda uma imagem PNG, JPG, GIF ou WEBP de até 10 MB (`arquivo_base64`, cru com `tipo` ou como data URL) e devolve o endereço público para o elemento de imagem do canvas. A imagem vai ao TermoBucket como arquivo público; se o bucket falhar, fica no banco e o endereço é relativo à API (`/board/imagem/{id}`).
+ *
+ * `POST /board/{id}/imagem`
+ */
+export declare function guardar_imagem_board(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ImagemEnviar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ImagemGuardada>;

package/dist/miro/rotas.js

@@ -0,0 +1,168 @@
+// Gerado pelo gerador do TermoCore (`cargo run -p gerador`). Não edite à mão: a próxima geração sobrescreve.
+import { chamar_servico, codificar_parametro_de_caminho } from "../base/requisicao.js";
+import { TERMO_MIRO as SERVICO_DESTA_API } from "../base/servicos.js";
+/**
+ * Lista os boards paginados
+ *
+ * Os boards que a pessoa enxerga, do mais recente para o mais antigo, sempre 50 por página: `tamanho` é ignorado. `pagina` começa em 1; aceita `nome` e `favoritos` como no filtro.
+ *
+ * `GET /board`
+ */
+export function buscar_paginador_board(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/board",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Cria um board
+ *
+ * Livre para todo colaborador logado; quem cria é o dono. `nome` é obrigatório (até 120 caracteres), `descricao` vai até 500, `cor` segue o formato `#00397c` (padrão `#00397c`) e `visibilidade` é `ORGANIZACAO` (padrão, todos veem e editam) ou `MEMBROS` (só o dono e os `membro_ids`). O canvas nasce vazio e é editado em tempo real em `GET /board/ws/{id}?token=<JWT>` (WebSocket no protocolo do Yjs).
+ *
+ * `POST /board`
+ */
+export function criar_board(credencial_de_acesso, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: "/board",
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Lista básica de boards para seleção
+ *
+ * Id, nome e cor dos boards que a pessoa enxerga, em ordem alfabética. `busca` procura o trecho no nome. `pagina` começa em 1 e `tamanho` tem padrão 10.
+ *
+ * `GET /board/autocomplete`
+ */
+export function buscar_auto_complete_board(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/board/autocomplete",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Busca boards por filtro
+ *
+ * Todos os boards que a pessoa enxerga, do mais recente para o mais antigo. `nome` procura o trecho no nome sem diferenciar maiúsculas, `favoritos=true` traz só os favoritos de quem pediu e `dono_id` só os de um dono.
+ *
+ * `GET /board/filtro`
+ */
+export function buscar_pelo_filtro_board(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/board/filtro",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Baixa uma imagem do canvas guardada no banco
+ *
+ * Pública (o `<img>` do canvas não manda token): devolve os bytes da imagem que ficou no banco porque o TermoBucket falhou, com cache longo.
+ *
+ * `GET /board/imagem/{id}`
+ */
+export function buscar_imagem_board(id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: `/board/imagem/${codificar_parametro_de_caminho(id)}`,
+        formato_da_resposta: "sem_conteudo",
+    }, opcoes_da_chamada);
+}
+/**
+ * Busca um board pelo id
+ *
+ * Devolve o board com o dono, os membros, se é favorito de quem pediu e se essa pessoa pode gerenciá-lo (`pode_gerenciar`: dono ou master do TermoAuth). Board `MEMBROS` de que a pessoa não participa responde `404`, como se não existisse.
+ *
+ * `GET /board/{id}`
+ */
+export function buscar_pelo_id_board(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: `/board/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Atualiza um board pelo id
+ *
+ * Atualização parcial. `nome`, `descricao` (`null` apaga) e `cor` valem para quem enxerga o board; `visibilidade` e `membro_ids` (a lista inteira) só para o dono ou o master do TermoAuth. `favorito` marca ou desmarca o board como favorito de quem pediu, e `miniatura` é o SVG (até 200 KB) da prévia mostrada na lista; esses dois não mudam a ordem de recentes.
+ *
+ * `PATCH /board/{id}`
+ */
+export function atualizar_pelo_id_board(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "PATCH",
+        caminho_da_rota: `/board/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Exclui um board pelo id
+ *
+ * Só o dono ou o master do TermoAuth. Exclusão lógica: o board some das listas e quem estava com ele aberto é desconectado.
+ *
+ * `DELETE /board/{id}`
+ */
+export function deletar_pelo_id_board(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "DELETE",
+        caminho_da_rota: `/board/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        formato_da_resposta: "sem_conteudo",
+    }, opcoes_da_chamada);
+}
+/**
+ * Duplica um board
+ *
+ * Cria "Cópia de <nome>" com todo o conteúdo do canvas. Quem pediu vira o dono da cópia, que mantém a visibilidade do original, sem membros e sem favoritos.
+ *
+ * `POST /board/{id}/duplicar`
+ */
+export function duplicar_board(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: `/board/${codificar_parametro_de_caminho(id)}/duplicar`,
+        credencial_de_acesso,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Envia uma imagem para o canvas
+ *
+ * Guarda uma imagem PNG, JPG, GIF ou WEBP de até 10 MB (`arquivo_base64`, cru com `tipo` ou como data URL) e devolve o endereço público para o elemento de imagem do canvas. A imagem vai ao TermoBucket como arquivo público; se o bucket falhar, fica no banco e o endereço é relativo à API (`/board/imagem/{id}`).
+ *
+ * `POST /board/{id}/imagem`
+ */
+export function guardar_imagem_board(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: `/board/${codificar_parametro_de_caminho(id)}/imagem`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}

package/dist/miro/tipos.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Board com tudo o que a tela precisa: o dono e os membros com nome, e o que vale para quem está
+ * olhando (`favorito` e `pode_gerenciar`). O conteúdo do canvas não vem aqui: ele chega pelo
+ * tempo real (`/board/ws/{id}`).
+ */
+export interface Board {
+    atualizado_em: string;
+    cor: string;
+    criado_em: string;
+    descricao?: string | null;
+    dono: ColaboradorResumo;
+    favorito: boolean;
+    id: string;
+    membros: Array<ColaboradorResumo>;
+    miniatura?: string | null;
+    nome: string;
+    pode_gerenciar: boolean;
+    visibilidade: string;
+}
+export interface BoardAtualizar {
+    cor?: string | null;
+    descricao?: string | null;
+    favorito?: boolean | null;
+    membro_ids?: Array<string> | null;
+    miniatura?: string | null;
+    nome?: string | null;
+    visibilidade?: string | null;
+}
+export interface BoardAutoComplete {
+    cor: string;
+    id: string;
+    nome: string;
+}
+export interface BoardCriar {
+    cor?: string | null;
+    descricao?: string | null;
+    membro_ids?: Array<string> | null;
+    nome: string;
+    visibilidade?: string | null;
+}
+/**
+ * Resumo do colaborador (id e nome) para mostrar autoria.
+ */
+export interface ColaboradorResumo {
+    id: string;
+    nome: string;
+}
+export interface ImagemEnviar {
+    /**
+     * O arquivo em base64 (pode vir como data URL: `data:image/png;base64,...`).
+     */
+    arquivo_base64: string;
+    nome?: string | null;
+    /**
+     * Tipo da imagem quando o base64 não é data URL (ex.: `image/png`).
+     */
+    tipo?: string | null;
+}
+export interface ImagemGuardada {
+    /**
+     * Endereço público da imagem; quando começa com `/`, é relativo à API.
+     */
+    url: string;
+}
+/**
+ * Board com tudo o que a tela precisa: o dono e os membros com nome, e o que vale para quem está
+ * olhando (`favorito` e `pode_gerenciar`). O conteúdo do canvas não vem aqui: ele chega pelo
+ * tempo real (`/board/ws/{id}`).
+ */
+export interface PaginaBoardItensItem {
+    atualizado_em: string;
+    cor: string;
+    criado_em: string;
+    descricao?: string | null;
+    dono: ColaboradorResumo;
+    favorito: boolean;
+    id: string;
+    membros: Array<ColaboradorResumo>;
+    miniatura?: string | null;
+    nome: string;
+    pode_gerenciar: boolean;
+    visibilidade: string;
+}
+export interface PaginaBoard {
+    itens: Array<PaginaBoardItensItem>;
+    pagina: number;
+    tamanho: number;
+    total: number;
+}
+export interface PaginaBoardAutoCompleteItensItem {
+    cor: string;
+    id: string;
+    nome: string;
+}
+export interface PaginaBoardAutoComplete {
+    itens: Array<PaginaBoardAutoCompleteItensItem>;
+    pagina: number;
+    tamanho: number;
+    total: number;
+}
+export interface RespostaDeErro {
+    erro: string;
+}

package/dist/miro/tipos.js

@@ -0,0 +1,2 @@
+// Gerado pelo gerador do TermoCore (`cargo run -p gerador`). Não edite à mão: a próxima geração sobrescreve.
+export {};

package/dist/portal/rotas.d.ts

@@ -975,7 +975,7 @@ export declare function deletar_pelo_id_contato(credencial_de_acesso: Credencial
 /**
  * Lista uma página de cotações
  *
- * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Devolve só o array da página, até 50 cotações, das mais novas para as mais antigas; o total, as páginas e as contagens por situação vêm de `GET /cotacao/paginador`, com os mesmos filtros. Quem não é colaborador interno precisa informar `unidade_id` de uma unidade da própria sessão; colaborador interno pode omitir e vê todas. Filtros opcionais: `status` (um dos 5 valores, senão 400 `Status inválido`); `busca` procura o número (C-1048 ou 1048), o SKU ou o nome de um item e a razão social da unidade; `inicio`/`fim` são datas AAAA-MM-DD do envio, em Brasília, inclusivas; `origem` (`carrinho`, `pedido_inteligente`) é exata; `cursor` é o id da última cotação da página anterior.
+ * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Devolve só o array da página, até 50 cotações, das mais novas para as mais antigas; o total, as páginas e as contagens por situação vêm de `GET /cotacao/paginador`, com os mesmos filtros. Quem não é colaborador interno precisa informar `unidade_id` de uma unidade da própria sessão; colaborador interno pode omitir e vê todas. Filtros opcionais: `status` (`esperando_aprovacao`, `aguardando_importacao_tiny`, `no_tiny`, `concluido`, `nao_aprovado`; outro valor dá 400 `Status inválido`); `busca` procura o número (C-1048 ou 1048), o SKU ou o nome de um item e a razão social da unidade; `inicio`/`fim` são datas AAAA-MM-DD do envio, em Brasília, inclusivas; `origem` (`carrinho`, `pedido_inteligente`) é exata; `cursor` é o id da última cotação da página anterior.
  *
  * `GET /cotacao`
  */
@@ -999,7 +999,7 @@ export declare function buscar_auto_complete_cotacao(credencial_de_acesso: Crede
 /**
  * Busca cotações por filtro
  *
- * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Devolve as cotações não excluídas que casam com o filtro, até 50 por página (`pagina`, a partir de 1, padrão 1), das mais novas para as mais antigas. Quem não é colaborador interno precisa informar `unidade_id` de uma unidade da própria sessão; colaborador interno pode omitir e vê todas. `origem` (`carrinho`, `pedido_inteligente`) e `status` (`rascunho`, `esperando_aprovacao`, `concluido`, `nao_aprovado`, `em_transporte`) são exatos.
+ * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Devolve as cotações não excluídas que casam com o filtro, até 50 por página (`pagina`, a partir de 1, padrão 1), das mais novas para as mais antigas. Quem não é colaborador interno precisa informar `unidade_id` de uma unidade da própria sessão; colaborador interno pode omitir e vê todas. `origem` (`carrinho`, `pedido_inteligente`) e `status` (`esperando_aprovacao`, `aguardando_importacao_tiny`, `no_tiny`, `concluido`, `nao_aprovado`) são exatos.
  *
  * `GET /cotacao/filtro`
  */
@@ -1007,7 +1007,7 @@ export declare function buscar_pelo_filtro_cotacao(credencial_de_acesso: Credenc
 /**
  * Total, páginas e contagens das cotações
  *
- * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Recebe os mesmos filtros de `GET /cotacao` (o `cursor` é ignorado) e devolve `total` (cotações que casam), `paginas`, `tamanho` (50) e `contagens` por situação (`todas`, `esperando_aprovacao`, `concluido`, `nao_aprovado`, `em_transporte`), que usam os outros filtros e ignoram o `status`. Mesma regra de unidade da lista.
+ * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Recebe os mesmos filtros de `GET /cotacao` (o `cursor` é ignorado) e devolve `total` (cotações que casam), `paginas`, `tamanho` (50) e `contagens` por situação (`todas`, `esperando_aprovacao`, `aguardando_importacao_tiny`, `no_tiny`, `concluido`, `nao_aprovado`), que usam os outros filtros e ignoram o `status`. Mesma regra de unidade da lista.
  *
  * `GET /cotacao/paginador`
  */
@@ -1015,15 +1015,15 @@ export declare function buscar_informacoes_paginador_cotacao(credencial_de_acess
 /**
  * Busca uma cotação pelo id
  *
- * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Cotação excluída, ou de unidade fora da sessão, responde 404. Traz itens e totais.
+ * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Cotação excluída, ou de unidade fora da sessão, responde 404. Traz itens (com `produto_id_tiny`, o ID do produto no Tiny quando a cotação foi gerada), totais e o caminho até o Tiny: `xls_gerado_em` (quando o XLS de proposta foi gerado) e a proposta achada no Tiny (`proposta_tiny_id`, `proposta_tiny_numero`, `proposta_tiny_situacao`, `proposta_tiny_conferida_em`), nulos enquanto não houver. `criado_por_colaborador_nome` é o colaborador da Termotubos que gerou a cotação pelo cliente (nulo quando foi o próprio cliente).
  *
  * `GET /cotacao/{id}`
  */
 export declare function buscar_pelo_id_cotacao(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Cotacao>;
 /**
- * Muda o status de uma cotação
+ * Muda a situação de uma cotação
  *
- * Exige a permissão `editar` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Muda `status` (`rascunho`, `esperando_aprovacao`, `concluido`, `nao_aprovado`, `em_transporte`). Só colaborador interno marca `concluido` ou `em_transporte`; aprovar cotação acima do limite de faturamento exige `confirmar_acima_do_limite: true`. Cotação de unidade fora da sessão responde 404. Atualização parcial: campo ausente mantém o valor atual. Campos: `confirmar_acima_do_limite` (booleano) confirma o aviso de limite de faturamento ao aprovar.
+ * Exige a permissão `editar` no módulo `Cotacoes` e ser colaborador interno: o cliente não muda a situação (403). Campo: `status` (`esperando_aprovacao`, `aguardando_importacao_tiny`, `no_tiny`, `concluido`, `nao_aprovado`). À mão só valem três passagens: `esperando_aprovacao` → `nao_aprovado` (recusar), `aguardando_importacao_tiny` → `esperando_aprovacao` (desfazer o XLS, que limpa `xls_gerado_em`) e `nao_aprovado` → `esperando_aprovacao` (reabrir, só se a cotação não tem proposta no Tiny). Ir para `aguardando_importacao_tiny` é pela geração do XLS e `no_tiny`, `concluido` e `nao_aprovado` vindos do Tiny são do próprio portal, lendo a proposta; qualquer outra passagem responde 409 `passagem_nao_permitida`. Pedir a situação atual devolve a cotação sem mudar nada. Se a situação mudou entre a leitura e a gravação, responde 409 `situacao_mudou`. Cotação de unidade fora da sessão responde 404. Campo ausente mantém o valor atual.
  *
  * `PATCH /cotacao/{id}`
  */

package/dist/portal/rotas.js

@@ -723,7 +723,7 @@ export function deletar_pelo_id_contato(credencial_de_acesso, id, opcoes_da_cham
 /**
  * Lista uma página de cotações
  *
- * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Devolve só o array da página, até 50 cotações, das mais novas para as mais antigas; o total, as páginas e as contagens por situação vêm de `GET /cotacao/paginador`, com os mesmos filtros. Quem não é colaborador interno precisa informar `unidade_id` de uma unidade da própria sessão; colaborador interno pode omitir e vê todas. Filtros opcionais: `status` (um dos 5 valores, senão 400 `Status inválido`); `busca` procura o número (C-1048 ou 1048), o SKU ou o nome de um item e a razão social da unidade; `inicio`/`fim` são datas AAAA-MM-DD do envio, em Brasília, inclusivas; `origem` (`carrinho`, `pedido_inteligente`) é exata; `cursor` é o id da última cotação da página anterior.
+ * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Devolve só o array da página, até 50 cotações, das mais novas para as mais antigas; o total, as páginas e as contagens por situação vêm de `GET /cotacao/paginador`, com os mesmos filtros. Quem não é colaborador interno precisa informar `unidade_id` de uma unidade da própria sessão; colaborador interno pode omitir e vê todas. Filtros opcionais: `status` (`esperando_aprovacao`, `aguardando_importacao_tiny`, `no_tiny`, `concluido`, `nao_aprovado`; outro valor dá 400 `Status inválido`); `busca` procura o número (C-1048 ou 1048), o SKU ou o nome de um item e a razão social da unidade; `inicio`/`fim` são datas AAAA-MM-DD do envio, em Brasília, inclusivas; `origem` (`carrinho`, `pedido_inteligente`) é exata; `cursor` é o id da última cotação da página anterior.
  *
  * `GET /cotacao`
  */
@@ -774,7 +774,7 @@ export function buscar_auto_complete_cotacao(credencial_de_acesso, parametros =
 /**
  * Busca cotações por filtro
  *
- * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Devolve as cotações não excluídas que casam com o filtro, até 50 por página (`pagina`, a partir de 1, padrão 1), das mais novas para as mais antigas. Quem não é colaborador interno precisa informar `unidade_id` de uma unidade da própria sessão; colaborador interno pode omitir e vê todas. `origem` (`carrinho`, `pedido_inteligente`) e `status` (`rascunho`, `esperando_aprovacao`, `concluido`, `nao_aprovado`, `em_transporte`) são exatos.
+ * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Devolve as cotações não excluídas que casam com o filtro, até 50 por página (`pagina`, a partir de 1, padrão 1), das mais novas para as mais antigas. Quem não é colaborador interno precisa informar `unidade_id` de uma unidade da própria sessão; colaborador interno pode omitir e vê todas. `origem` (`carrinho`, `pedido_inteligente`) e `status` (`esperando_aprovacao`, `aguardando_importacao_tiny`, `no_tiny`, `concluido`, `nao_aprovado`) são exatos.
  *
  * `GET /cotacao/filtro`
  */
@@ -791,7 +791,7 @@ export function buscar_pelo_filtro_cotacao(credencial_de_acesso, parametros = {}
 /**
  * Total, páginas e contagens das cotações
  *
- * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Recebe os mesmos filtros de `GET /cotacao` (o `cursor` é ignorado) e devolve `total` (cotações que casam), `paginas`, `tamanho` (50) e `contagens` por situação (`todas`, `esperando_aprovacao`, `concluido`, `nao_aprovado`, `em_transporte`), que usam os outros filtros e ignoram o `status`. Mesma regra de unidade da lista.
+ * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Recebe os mesmos filtros de `GET /cotacao` (o `cursor` é ignorado) e devolve `total` (cotações que casam), `paginas`, `tamanho` (50) e `contagens` por situação (`todas`, `esperando_aprovacao`, `aguardando_importacao_tiny`, `no_tiny`, `concluido`, `nao_aprovado`), que usam os outros filtros e ignoram o `status`. Mesma regra de unidade da lista.
  *
  * `GET /cotacao/paginador`
  */
@@ -808,7 +808,7 @@ export function buscar_informacoes_paginador_cotacao(credencial_de_acesso, param
 /**
  * Busca uma cotação pelo id
  *
- * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Cotação excluída, ou de unidade fora da sessão, responde 404. Traz itens e totais.
+ * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Cotação excluída, ou de unidade fora da sessão, responde 404. Traz itens (com `produto_id_tiny`, o ID do produto no Tiny quando a cotação foi gerada), totais e o caminho até o Tiny: `xls_gerado_em` (quando o XLS de proposta foi gerado) e a proposta achada no Tiny (`proposta_tiny_id`, `proposta_tiny_numero`, `proposta_tiny_situacao`, `proposta_tiny_conferida_em`), nulos enquanto não houver. `criado_por_colaborador_nome` é o colaborador da Termotubos que gerou a cotação pelo cliente (nulo quando foi o próprio cliente).
  *
  * `GET /cotacao/{id}`
  */
@@ -822,9 +822,9 @@ export function buscar_pelo_id_cotacao(credencial_de_acesso, id, opcoes_da_chama
     }, opcoes_da_chamada);
 }
 /**
- * Muda o status de uma cotação
+ * Muda a situação de uma cotação
  *
- * Exige a permissão `editar` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Muda `status` (`rascunho`, `esperando_aprovacao`, `concluido`, `nao_aprovado`, `em_transporte`). Só colaborador interno marca `concluido` ou `em_transporte`; aprovar cotação acima do limite de faturamento exige `confirmar_acima_do_limite: true`. Cotação de unidade fora da sessão responde 404. Atualização parcial: campo ausente mantém o valor atual. Campos: `confirmar_acima_do_limite` (booleano) confirma o aviso de limite de faturamento ao aprovar.
+ * Exige a permissão `editar` no módulo `Cotacoes` e ser colaborador interno: o cliente não muda a situação (403). Campo: `status` (`esperando_aprovacao`, `aguardando_importacao_tiny`, `no_tiny`, `concluido`, `nao_aprovado`). À mão só valem três passagens: `esperando_aprovacao` → `nao_aprovado` (recusar), `aguardando_importacao_tiny` → `esperando_aprovacao` (desfazer o XLS, que limpa `xls_gerado_em`) e `nao_aprovado` → `esperando_aprovacao` (reabrir, só se a cotação não tem proposta no Tiny). Ir para `aguardando_importacao_tiny` é pela geração do XLS e `no_tiny`, `concluido` e `nao_aprovado` vindos do Tiny são do próprio portal, lendo a proposta; qualquer outra passagem responde 409 `passagem_nao_permitida`. Pedir a situação atual devolve a cotação sem mudar nada. Se a situação mudou entre a leitura e a gravação, responde 409 `situacao_mudou`. Cotação de unidade fora da sessão responde 404. Campo ausente mantém o valor atual.
  *
  * `PATCH /cotacao/{id}`
  */