termo_core 0.1.6 → 0.1.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -228,10 +228,11 @@ export interface ContagemClientes {
228
228
  todos: number;
229
229
  }
230
230
  export interface ContagemCotacoes {
231
+ aguardando_importacao_tiny: number;
231
232
  concluido: number;
232
- em_transporte: number;
233
233
  esperando_aprovacao: number;
234
234
  nao_aprovado: number;
235
+ no_tiny: number;
235
236
  todas: number;
236
237
  }
237
238
  export interface ContagemExpedicoes {
@@ -304,6 +305,7 @@ export interface Cotacao {
304
305
  autor_nome: string;
305
306
  carrinho_id?: string | null;
306
307
  criado_em: string;
308
+ criado_por_colaborador_nome?: string | null;
307
309
  desconto: number;
308
310
  economia_tier?: number | null;
309
311
  endereco_entrega?: EnderecoEntrega | null;
@@ -313,6 +315,10 @@ export interface Cotacao {
313
315
  observacao?: string | null;
314
316
  origem: string;
315
317
  pedido_inteligente_id?: string | null;
318
+ proposta_tiny_conferida_em?: string | null;
319
+ proposta_tiny_id?: number | null;
320
+ proposta_tiny_numero?: number | null;
321
+ proposta_tiny_situacao?: string | null;
316
322
  quantidade_itens: number;
317
323
  status: string;
318
324
  subtotal: number;
@@ -322,9 +328,9 @@ export interface Cotacao {
322
328
  unidade_razao_social: string;
323
329
  valida_ate: string;
324
330
  valor_frete: number;
331
+ xls_gerado_em?: string | null;
325
332
  }
326
333
  export interface CotacaoAtualizar {
327
- confirmar_acima_do_limite?: boolean | null;
328
334
  status?: string | null;
329
335
  }
330
336
  export interface CotacaoAutoComplete {
@@ -348,6 +354,7 @@ export interface CotacaoItem {
348
354
  nome: string;
349
355
  preco_unitario: number;
350
356
  produto_id: string;
357
+ produto_id_tiny?: number | null;
351
358
  quantidade: number;
352
359
  quantidade_minima: number;
353
360
  sku: string;
@@ -102,6 +102,10 @@ export interface ParametrosDeBuscarPeloFiltroHistorico {
102
102
  tarefa_id?: string;
103
103
  ticket_id?: string;
104
104
  }
105
+ /**
106
+ * Só para a documentação: os valores aceitos em `tipo` (`TIPOS_DE_NOTIFICACAO`).
107
+ */
108
+ export type BuscarPaginadorNotificacaoTipo = "ATRIBUICAO" | "COMENTARIO" | "MENCAO" | "STATUS" | "PRAZO" | "TICKET";
105
109
  /**
106
110
  * Parâmetros de consulta e de cabeçalho de `/notificacao`.
107
111
  */
@@ -109,13 +113,24 @@ export interface ParametrosDeBuscarPaginadorNotificacao {
109
113
  pagina?: number;
110
114
  tamanho?: number;
111
115
  lida?: boolean;
116
+ /**
117
+ * Um dos tipos da notificação; vazio é sem filtro, outro valor responde `400`.
118
+ */
119
+ tipo?: BuscarPaginadorNotificacaoTipo;
112
120
  }
121
+ /**
122
+ * Só para a documentação: os valores aceitos em `tipo` (`TIPOS_DE_NOTIFICACAO`).
123
+ */
124
+ export type BuscarPeloFiltroNotificacaoTipo = "ATRIBUICAO" | "COMENTARIO" | "MENCAO" | "STATUS" | "PRAZO" | "TICKET";
113
125
  /**
114
126
  * Parâmetros de consulta e de cabeçalho de `/notificacao/filtro`.
115
127
  */
116
128
  export interface ParametrosDeBuscarPeloFiltroNotificacao {
117
129
  lida?: boolean;
118
- tipo?: string;
130
+ /**
131
+ * Um dos tipos da notificação; vazio é sem filtro, outro valor responde `400`.
132
+ */
133
+ tipo?: BuscarPeloFiltroNotificacaoTipo;
119
134
  }
120
135
  /**
121
136
  * Parâmetros de consulta e de cabeçalho de `/projeto`.
@@ -538,7 +553,7 @@ export declare function buscar_pelo_filtro_historico(credencial_de_acesso: Crede
538
553
  /**
539
554
  * Caixa de entrada paginada
540
555
  *
541
- * Livre para qualquer usuário autenticado: vale sempre para o colaborador de quem está logado. Lista as notificações da pessoa, da mais nova para a mais antiga, sempre 50 por página: `tamanho` é ignorado. `lida` filtra; `nao_lidas` traz o total ainda não lido (o número do sino), com qualquer filtro.
556
+ * Livre para qualquer usuário autenticado: vale sempre para o colaborador de quem está logado. Lista as notificações da pessoa, da mais nova para a mais antiga, sempre 50 por página: `tamanho` é ignorado. `lida` e `tipo` (`ATRIBUICAO`, `COMENTARIO`, `MENCAO`, `STATUS`, `PRAZO` ou `TICKET`; vazio é sem filtro) filtram; `nao_lidas` traz o total ainda não lido (o número do sino), com qualquer filtro.
542
557
  *
543
558
  * `GET /notificacao`
544
559
  */
@@ -690,7 +705,7 @@ export declare function buscar_pelo_id_secao(credencial_de_acesso: CredencialDeA
690
705
  /**
691
706
  * Atualiza uma seção pelo id
692
707
  *
693
- * Exige a permissão `editar` na área `projetos`. Renomeia (`nome`) ou reposiciona (`ordem`, decimal: para pôr entre duas colunas use a média das ordens delas).
708
+ * Exige a permissão `editar` na área `projetos`. Renomeia (`nome`) ou reposiciona (`ordem`, decimal: para pôr entre duas colunas use a média das ordens delas). `conclui_tarefa: true` faz dela a coluna que conclui do projeto (uma só): desliga a anterior, conclui as tarefas principais abertas dela e traz para o fim dela as concluídas das outras colunas, com a linha na atividade de cada tarefa; `false` só desliga, sem mexer em tarefa.
694
709
  *
695
710
  * `PATCH /secao/{id}`
696
711
  */
@@ -698,7 +713,7 @@ export declare function atualizar_pelo_id_secao(credencial_de_acesso: Credencial
698
713
  /**
699
714
  * Exclui uma seção pelo id
700
715
  *
701
- * Exige a permissão `deletar` na área `projetos`. Exclusão lógica: as tarefas da coluna vão para a primeira coluna que sobrar no projeto.
716
+ * Exige a permissão `deletar` na área `projetos`. Exclusão lógica: as tarefas da coluna vão para a primeira coluna que sobrar no projeto (a que conclui só se não sobrar outra, e aí as abertas são concluídas). A coluna que conclui não sai: desligue a opção antes.
702
717
  *
703
718
  * `DELETE /secao/{id}`
704
719
  */
@@ -714,7 +729,7 @@ export declare function buscar_paginador_tarefa(credencial_de_acesso: Credencial
714
729
  /**
715
730
  * Cadastra uma tarefa
716
731
  *
717
- * Exige a permissão `criar` na área `projetos`. Cria a tarefa no projeto. Sem `secao_id`, entra na primeira coluna; com `tarefa_pai_id`, vira subtarefa (sem coluna; subtarefa não tem subtarefas). `ticket_id` liga a tarefa ao ticket de suporte que a originou. `titulo` é obrigatório (até 300 caracteres); `descricao` até 20000; `prioridade` é `BAIXA`, `MEDIA`, `ALTA` ou `URGENTE`; `estimativa` de 0 a 10000 pontos; `inicio` não pode passar do `prazo`. Quem criou fica como criador, a atividade ganha a linha de criação e o responsável recebe uma notificação. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.
732
+ * Exige a permissão `criar` na área `projetos`. Cria a tarefa no projeto. Sem `secao_id`, entra na primeira coluna que não conclui tarefas (na que conclui, já nasce concluída); com `tarefa_pai_id`, vira subtarefa (sem coluna; subtarefa não tem subtarefas). `ticket_id` liga a tarefa ao ticket de suporte que a originou. `titulo` e `prazo` são obrigatórios (título até 300 caracteres); sem `inicio`, ele é hoje (São Paulo) e não pode passar do `prazo`; sem `responsavel_id`, quem criou vira o responsável. `descricao` até 20000; `prioridade` é `BAIXA`, `MEDIA`, `ALTA` ou `URGENTE`; `estimativa` de 0 a 10000 pontos. Quem criou fica como criador, a atividade ganha a linha de criação e o responsável recebe uma notificação. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.
718
733
  *
719
734
  * `POST /tarefa`
720
735
  */
@@ -746,7 +761,7 @@ export declare function buscar_pelo_id_tarefa(credencial_de_acesso: CredencialDe
746
761
  /**
747
762
  * Atualiza uma tarefa pelo id
748
763
  *
749
- * Exige a permissão `editar` na área `projetos`. Atualização parcial com as regras do cadastro. Mover no quadro é mandar `secao_id` (coluna do mesmo projeto) e `ordem` (decimal: a média entre os vizinhos). `null` em `responsavel_id`, `inicio`, `prazo`, `prioridade` ou `estimativa` apaga o valor; texto vazio em `descricao` apaga. `concluida` grava ou apaga `concluida_em`. `etiqueta_ids` substitui a lista. Cada mudança entra na atividade da tarefa; o novo responsável e, ao concluir, o criador recebem notificação. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.
764
+ * Exige a permissão `editar` na área `projetos`. Atualização parcial com as regras do cadastro. Mover no quadro é mandar `secao_id` (coluna do mesmo projeto) e `ordem` (decimal: a média entre os vizinhos). `null` em `responsavel_id`, `inicio`, `prazo`, `prioridade` ou `estimativa` apaga o valor; texto vazio em `descricao` apaga. `concluida` grava ou apaga `concluida_em`. Na tarefa principal, a coluna que conclui manda: entrar nela conclui e sair reabre (vence um `concluida` contraditório); marcar `concluida` fora dela leva a tarefa para o fim dela; desmarcar dentro dela devolve a tarefa para o fim da coluna anterior. `etiqueta_ids` substitui a lista. Cada mudança entra na atividade da tarefa; o novo responsável e, ao concluir, o criador recebem notificação. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.
750
765
  *
751
766
  * `PATCH /tarefa/{id}`
752
767
  */
@@ -505,7 +505,7 @@ export function buscar_pelo_filtro_historico(credencial_de_acesso, parametros =
505
505
  /**
506
506
  * Caixa de entrada paginada
507
507
  *
508
- * Livre para qualquer usuário autenticado: vale sempre para o colaborador de quem está logado. Lista as notificações da pessoa, da mais nova para a mais antiga, sempre 50 por página: `tamanho` é ignorado. `lida` filtra; `nao_lidas` traz o total ainda não lido (o número do sino), com qualquer filtro.
508
+ * Livre para qualquer usuário autenticado: vale sempre para o colaborador de quem está logado. Lista as notificações da pessoa, da mais nova para a mais antiga, sempre 50 por página: `tamanho` é ignorado. `lida` e `tipo` (`ATRIBUICAO`, `COMENTARIO`, `MENCAO`, `STATUS`, `PRAZO` ou `TICKET`; vazio é sem filtro) filtram; `nao_lidas` traz o total ainda não lido (o número do sino), com qualquer filtro.
509
509
  *
510
510
  * `GET /notificacao`
511
511
  */
@@ -823,7 +823,7 @@ export function buscar_pelo_id_secao(credencial_de_acesso, id, opcoes_da_chamada
823
823
  /**
824
824
  * Atualiza uma seção pelo id
825
825
  *
826
- * Exige a permissão `editar` na área `projetos`. Renomeia (`nome`) ou reposiciona (`ordem`, decimal: para pôr entre duas colunas use a média das ordens delas).
826
+ * Exige a permissão `editar` na área `projetos`. Renomeia (`nome`) ou reposiciona (`ordem`, decimal: para pôr entre duas colunas use a média das ordens delas). `conclui_tarefa: true` faz dela a coluna que conclui do projeto (uma só): desliga a anterior, conclui as tarefas principais abertas dela e traz para o fim dela as concluídas das outras colunas, com a linha na atividade de cada tarefa; `false` só desliga, sem mexer em tarefa.
827
827
  *
828
828
  * `PATCH /secao/{id}`
829
829
  */
@@ -840,7 +840,7 @@ export function atualizar_pelo_id_secao(credencial_de_acesso, id, corpo_da_requi
840
840
  /**
841
841
  * Exclui uma seção pelo id
842
842
  *
843
- * Exige a permissão `deletar` na área `projetos`. Exclusão lógica: as tarefas da coluna vão para a primeira coluna que sobrar no projeto.
843
+ * Exige a permissão `deletar` na área `projetos`. Exclusão lógica: as tarefas da coluna vão para a primeira coluna que sobrar no projeto (a que conclui só se não sobrar outra, e aí as abertas são concluídas). A coluna que conclui não sai: desligue a opção antes.
844
844
  *
845
845
  * `DELETE /secao/{id}`
846
846
  */
@@ -873,7 +873,7 @@ export function buscar_paginador_tarefa(credencial_de_acesso, parametros = {}, o
873
873
  /**
874
874
  * Cadastra uma tarefa
875
875
  *
876
- * Exige a permissão `criar` na área `projetos`. Cria a tarefa no projeto. Sem `secao_id`, entra na primeira coluna; com `tarefa_pai_id`, vira subtarefa (sem coluna; subtarefa não tem subtarefas). `ticket_id` liga a tarefa ao ticket de suporte que a originou. `titulo` é obrigatório (até 300 caracteres); `descricao` até 20000; `prioridade` é `BAIXA`, `MEDIA`, `ALTA` ou `URGENTE`; `estimativa` de 0 a 10000 pontos; `inicio` não pode passar do `prazo`. Quem criou fica como criador, a atividade ganha a linha de criação e o responsável recebe uma notificação. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.
876
+ * Exige a permissão `criar` na área `projetos`. Cria a tarefa no projeto. Sem `secao_id`, entra na primeira coluna que não conclui tarefas (na que conclui, já nasce concluída); com `tarefa_pai_id`, vira subtarefa (sem coluna; subtarefa não tem subtarefas). `ticket_id` liga a tarefa ao ticket de suporte que a originou. `titulo` e `prazo` são obrigatórios (título até 300 caracteres); sem `inicio`, ele é hoje (São Paulo) e não pode passar do `prazo`; sem `responsavel_id`, quem criou vira o responsável. `descricao` até 20000; `prioridade` é `BAIXA`, `MEDIA`, `ALTA` ou `URGENTE`; `estimativa` de 0 a 10000 pontos. Quem criou fica como criador, a atividade ganha a linha de criação e o responsável recebe uma notificação. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.
877
877
  *
878
878
  * `POST /tarefa`
879
879
  */
@@ -940,7 +940,7 @@ export function buscar_pelo_id_tarefa(credencial_de_acesso, id, opcoes_da_chamad
940
940
  /**
941
941
  * Atualiza uma tarefa pelo id
942
942
  *
943
- * Exige a permissão `editar` na área `projetos`. Atualização parcial com as regras do cadastro. Mover no quadro é mandar `secao_id` (coluna do mesmo projeto) e `ordem` (decimal: a média entre os vizinhos). `null` em `responsavel_id`, `inicio`, `prazo`, `prioridade` ou `estimativa` apaga o valor; texto vazio em `descricao` apaga. `concluida` grava ou apaga `concluida_em`. `etiqueta_ids` substitui a lista. Cada mudança entra na atividade da tarefa; o novo responsável e, ao concluir, o criador recebem notificação. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.
943
+ * Exige a permissão `editar` na área `projetos`. Atualização parcial com as regras do cadastro. Mover no quadro é mandar `secao_id` (coluna do mesmo projeto) e `ordem` (decimal: a média entre os vizinhos). `null` em `responsavel_id`, `inicio`, `prazo`, `prioridade` ou `estimativa` apaga o valor; texto vazio em `descricao` apaga. `concluida` grava ou apaga `concluida_em`. Na tarefa principal, a coluna que conclui manda: entrar nela conclui e sair reabre (vence um `concluida` contraditório); marcar `concluida` fora dela leva a tarefa para o fim dela; desmarcar dentro dela devolve a tarefa para o fim da coluna anterior. `etiqueta_ids` substitui a lista. Cada mudança entra na atividade da tarefa; o novo responsável e, ao concluir, o criador recebem notificação. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.
944
944
  *
945
945
  * `PATCH /tarefa/{id}`
946
946
  */
@@ -375,6 +375,10 @@ export interface PaginaProjetoAutoComplete {
375
375
  */
376
376
  export interface PaginaSecaoItensItem {
377
377
  atualizado_em: string;
378
+ /**
379
+ * A coluna que conclui as tarefas (uma por projeto): entrar nela conclui, sair reabre.
380
+ */
381
+ conclui_tarefa: boolean;
378
382
  criado_em: string;
379
383
  id: string;
380
384
  nome: string;
@@ -580,6 +584,10 @@ export interface RespostaDeErro {
580
584
  */
581
585
  export interface Secao {
582
586
  atualizado_em: string;
587
+ /**
588
+ * A coluna que conclui as tarefas (uma por projeto): entrar nela conclui, sair reabre.
589
+ */
590
+ conclui_tarefa: boolean;
583
591
  criado_em: string;
584
592
  id: string;
585
593
  nome: string;
@@ -587,6 +595,11 @@ export interface Secao {
587
595
  projeto_id: string;
588
596
  }
589
597
  export interface SecaoAtualizar {
598
+ /**
599
+ * `true` faz desta a coluna que conclui do projeto (desliga a anterior, conclui as tarefas
600
+ * abertas dela e traz as concluídas das outras colunas); `false` só desliga.
601
+ */
602
+ conclui_tarefa?: boolean | null;
590
603
  nome?: string | null;
591
604
  ordem?: number | null;
592
605
  }
@@ -140,23 +140,15 @@ export interface ParametrosDeBuscarPeloFiltroUso {
140
140
  /**
141
141
  * Lista os aplicativos paginados
142
142
  *
143
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Lista os aplicativos não excluídos da conta em ordem alfabética do nome. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens.
143
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Lista os aplicativos em ordem alfabética do nome. Os aplicativos vêm do TermoAuth: quando quem chama é master do TermoAuth, a lista é sincronizada antes da resposta (app novo ganha uma `chave` e app que saiu do TermoAuth some daqui); nome, setor e domínios não se alteram por aqui. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens.
144
144
  *
145
145
  * `GET /aplicativo`
146
146
  */
147
147
  export declare function buscar_paginador_aplicativo(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorAplicativo, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaAplicativo>;
148
- /**
149
- * Cadastra um aplicativo
150
- *
151
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Cadastra um site ou sistema que vai enviar eventos ao TermoTracing. `nome` é obrigatório. `dominios` precisa ter ao menos um domínio válido (host com ponto, `localhost` ou curinga `*.dominio.com`, porta opcional); `https://`, caminho e ponto final são removidos. `franquia_mensal` (eventos por ciclo mensal) tem padrão 100000 e precisa ser maior que zero. `comportamento_ao_estourar` aceita `COBRAR_EXCEDENTE` (padrão) ou `PARAR_INGESTAO`. O backend gera a `chave` pública (prefixo `pk_live_`) que o script do site usa na ingestão; ela não é segredo, porque a ingestão só aceita os domínios cadastrados. Campos do corpo: `nome`: nome do aplicativo (obrigatório, não pode ficar vazio); `dominios`: domínios autorizados a enviar eventos; precisa de ao menos um válido (host com ponto, `localhost` ou `*.dominio.com`, porta opcional). `https://`, caminho e ponto final são removidos; `franquia_mensal`: eventos incluídos por ciclo mensal, maior que zero (padrão 100000); `comportamento_ao_estourar`: `COBRAR_EXCEDENTE` (padrão) segue recebendo e conta o excedente; `PARAR_INGESTAO` recusa os lotes depois da franquia.
152
- *
153
- * `POST /aplicativo`
154
- */
155
- export declare function criar_aplicativo(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.AplicativoCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Aplicativo>;
156
148
  /**
157
149
  * Lista básica de aplicativos para seleção
158
150
  *
159
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve só id, nome e chave dos aplicativos não excluídos da conta, em ordem alfabética do nome. `busca` procura o trecho no nome, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do nome, sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
151
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve só id, nome e chave dos aplicativos não excluídos, em ordem alfabética do nome. `busca` procura o trecho no nome, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do nome, sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
160
152
  *
161
153
  * `GET /aplicativo/autocomplete`
162
154
  */
@@ -164,7 +156,7 @@ export declare function buscar_auto_complete_aplicativo(credencial_de_acesso: Cr
164
156
  /**
165
157
  * Busca aplicativos por filtro
166
158
  *
167
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve todos os aplicativos não excluídos da conta que casam com o filtro, sem paginação, em ordem alfabética do nome. `nome` procura o trecho no nome e `dominio` em qualquer domínio cadastrado (sem diferenciar maiúsculas); `chave` compara a chave exata e `comportamento_ao_estourar` o valor exato (`COBRAR_EXCEDENTE` ou `PARAR_INGESTAO`). Sem filtro, devolve todos. Parâmetros de consulta, todos opcionais: `nome`: trecho do nome, sem diferenciar maiúsculas; `dominio`: trecho de um dos domínios cadastrados, sem diferenciar maiúsculas; `chave`: chave pública exata; `comportamento_ao_estourar`: `COBRAR_EXCEDENTE` ou `PARAR_INGESTAO`.
159
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve todos os aplicativos não excluídos que casam com o filtro, sem paginação, em ordem alfabética do nome. `nome` procura o trecho no nome e `dominio` em qualquer domínio cadastrado (sem diferenciar maiúsculas); `chave` compara a chave exata e `comportamento_ao_estourar` o valor exato (`COBRAR_EXCEDENTE` ou `PARAR_INGESTAO`). Sem filtro, devolve todos. Parâmetros de consulta, todos opcionais: `nome`: trecho do nome, sem diferenciar maiúsculas; `dominio`: trecho de um dos domínios cadastrados, sem diferenciar maiúsculas; `chave`: chave pública exata; `comportamento_ao_estourar`: `COBRAR_EXCEDENTE` ou `PARAR_INGESTAO`.
168
160
  *
169
161
  * `GET /aplicativo/filtro`
170
162
  */
@@ -172,31 +164,15 @@ export declare function buscar_pelo_filtro_aplicativo(credencial_de_acesso: Cred
172
164
  /**
173
165
  * Busca um aplicativo pelo id
174
166
  *
175
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve o aplicativo pelo id; registro excluído não é encontrado.
167
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve o aplicativo pelo id; registro excluído não é encontrado.
176
168
  *
177
169
  * `GET /aplicativo/{id}`
178
170
  */
179
171
  export declare function buscar_pelo_id_aplicativo(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Aplicativo>;
180
- /**
181
- * Atualiza um aplicativo pelo id
182
- *
183
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Atualização parcial: só os campos enviados mudam. `nome` não pode ficar vazio; `dominios` substitui a lista inteira e precisa de ao menos um domínio válido; `franquia_mensal` precisa ser maior que zero; `comportamento_ao_estourar` aceita `COBRAR_EXCEDENTE` ou `PARAR_INGESTAO`. Com `rotacionar_chave: true` o backend gera uma `chave` nova e a antiga para de valer na ingestão. Campos do corpo, todos opcionais: `nome`: novo nome (não pode ficar vazio); `dominios`: nova lista de domínios, que substitui a atual; precisa de ao menos um válido; `franquia_mensal`: nova franquia mensal de eventos, maior que zero; `comportamento_ao_estourar`: `COBRAR_EXCEDENTE` ou `PARAR_INGESTAO`; `rotacionar_chave`: com `true`, gera uma chave nova e a antiga para de valer na ingestão.
184
- *
185
- * `PATCH /aplicativo/{id}`
186
- */
187
- export declare function atualizar_pelo_id_aplicativo(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.AplicativoAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Aplicativo>;
188
- /**
189
- * Exclui um aplicativo pelo id
190
- *
191
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Exclusão lógica: o aplicativo some das leituras e a chave dele deixa de ser aceita na ingestão.
192
- *
193
- * `DELETE /aplicativo/{id}`
194
- */
195
- export declare function deletar_pelo_id_aplicativo(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
196
172
  /**
197
173
  * Lista os erros paginados
198
174
  *
199
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Lista os grupos de erro não excluídos da conta, do que afetou mais usuários para o que afetou menos e, no empate, do que ocorreu mais vezes. `aplicativo_id` filtra pelo aplicativo e `status` pela situação (`ABERTO`, `RESOLVIDO` ou `IGNORADO`, sem diferenciar maiúsculas). `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `aplicativo_id`: id do aplicativo (opcional); `status`: `ABERTO`, `RESOLVIDO` ou `IGNORADO`, sem diferenciar maiúsculas (opcional).
175
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Lista os grupos de erro não excluídos, do que afetou mais usuários para o que afetou menos e, no empate, do que ocorreu mais vezes. `aplicativo_id` filtra pelo aplicativo e `status` pela situação (`ABERTO`, `RESOLVIDO` ou `IGNORADO`, sem diferenciar maiúsculas). `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `aplicativo_id`: id do aplicativo (opcional); `status`: `ABERTO`, `RESOLVIDO` ou `IGNORADO`, sem diferenciar maiúsculas (opcional).
200
176
  *
201
177
  * `GET /erro`
202
178
  */
@@ -204,7 +180,7 @@ export declare function buscar_paginador_erro(credencial_de_acesso: CredencialDe
204
180
  /**
205
181
  * Cadastra um erro
206
182
  *
207
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Registra a ocorrência de um erro num aplicativo da conta (os erros normalmente são agrupados sozinhos a partir dos eventos da ingestão). `aplicativo_id` precisa ser de um aplicativo da conta; `mensagem` é obrigatória; `tipo` aceita um dos tipos de evento (`ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`). Erros com o mesmo tipo, mensagem, arquivo e linha formam um só grupo na conta: se o grupo já existe, a ocorrência soma 1 e o grupo existente é devolvido. Campos do corpo: `aplicativo_id`: id de um aplicativo da conta (obrigatório); `tipo`: tipo do erro (obrigatório): `ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`; `mensagem`: mensagem do erro (obrigatória, não pode ficar vazia); `arquivo`: arquivo onde o erro ocorreu (opcional); `linha`: linha do erro (opcional); `pilha`: pilha de chamadas (opcional).
183
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Registra a ocorrência de um erro num aplicativo (os erros normalmente são agrupados sozinhos a partir dos eventos da ingestão). `aplicativo_id` precisa ser de um aplicativo; `mensagem` é obrigatória; `tipo` aceita um dos tipos de evento (`ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`). Erros com o mesmo tipo, mensagem, arquivo e linha formam um só grupo na conta: se o grupo já existe, a ocorrência soma 1 e o grupo existente é devolvido. Campos do corpo: `aplicativo_id`: id de um aplicativo (obrigatório); `tipo`: tipo do erro (obrigatório): `ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`; `mensagem`: mensagem do erro (obrigatória, não pode ficar vazia); `arquivo`: arquivo onde o erro ocorreu (opcional); `linha`: linha do erro (opcional); `pilha`: pilha de chamadas (opcional).
208
184
  *
209
185
  * `POST /erro`
210
186
  */
@@ -212,7 +188,7 @@ export declare function criar_erro(credencial_de_acesso: CredencialDeAcesso, cor
212
188
  /**
213
189
  * Lista básica de erros para seleção
214
190
  *
215
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve só id e rótulo (a mensagem do erro), em ordem alfabética da mensagem. `busca` procura o trecho na mensagem, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho da mensagem, sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
191
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve só id e rótulo (a mensagem do erro), em ordem alfabética da mensagem. `busca` procura o trecho na mensagem, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho da mensagem, sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
216
192
  *
217
193
  * `GET /erro/autocomplete`
218
194
  */
@@ -220,7 +196,7 @@ export declare function buscar_auto_complete_erro(credencial_de_acesso: Credenci
220
196
  /**
221
197
  * Busca erros por filtro
222
198
  *
223
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve todos os grupos de erro não excluídos da conta que casam com o filtro, sem paginação, do que afetou mais usuários para o que afetou menos. `aplicativo_id` filtra pelo aplicativo; `mensagem` procura o trecho na mensagem; `tipo`, `status` (`ABERTO`, `RESOLVIDO` ou `IGNORADO`) e `navegador` comparam o valor exato, sem diferenciar maiúsculas; `inicio` traz os que ocorreram de novo a partir dessa data e hora e `fim` os que começaram até ela (ISO 8601). Sem filtro, devolve todos. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `mensagem`: trecho da mensagem, sem diferenciar maiúsculas; `tipo`: tipo do erro (sem diferenciar maiúsculas): `ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`; `status`: `ABERTO`, `RESOLVIDO` ou `IGNORADO` (sem diferenciar maiúsculas); `navegador`: navegador onde ocorreu (valor exato, sem diferenciar maiúsculas); `inicio`: erros com ocorrência a partir desta data e hora ISO 8601, por exemplo 2026-10-07T00:00:00Z; `fim`: erros cuja primeira ocorrência foi até esta data e hora ISO 8601.
199
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve todos os grupos de erro não excluídos que casam com o filtro, sem paginação, do que afetou mais usuários para o que afetou menos. `aplicativo_id` filtra pelo aplicativo; `mensagem` procura o trecho na mensagem; `tipo`, `status` (`ABERTO`, `RESOLVIDO` ou `IGNORADO`) e `navegador` comparam o valor exato, sem diferenciar maiúsculas; `inicio` traz os que ocorreram de novo a partir dessa data e hora e `fim` os que começaram até ela (ISO 8601). Sem filtro, devolve todos. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `mensagem`: trecho da mensagem, sem diferenciar maiúsculas; `tipo`: tipo do erro (sem diferenciar maiúsculas): `ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`; `status`: `ABERTO`, `RESOLVIDO` ou `IGNORADO` (sem diferenciar maiúsculas); `navegador`: navegador onde ocorreu (valor exato, sem diferenciar maiúsculas); `inicio`: erros com ocorrência a partir desta data e hora ISO 8601, por exemplo 2026-10-07T00:00:00Z; `fim`: erros cuja primeira ocorrência foi até esta data e hora ISO 8601.
224
200
  *
225
201
  * `GET /erro/filtro`
226
202
  */
@@ -228,7 +204,7 @@ export declare function buscar_pelo_filtro_erro(credencial_de_acesso: Credencial
228
204
  /**
229
205
  * Busca um erro pelo id
230
206
  *
231
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve o erro pelo id; registro excluído não é encontrado.
207
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve o erro pelo id; registro excluído não é encontrado.
232
208
  *
233
209
  * `GET /erro/{id}`
234
210
  */
@@ -236,7 +212,7 @@ export declare function buscar_pelo_id_erro(credencial_de_acesso: CredencialDeAc
236
212
  /**
237
213
  * Atualiza um erro pelo id
238
214
  *
239
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Atualização parcial: só os campos enviados mudam. Muda o `status` do grupo de erro: `ABERTO`, `RESOLVIDO` ou `IGNORADO`. Campos do corpo, todos opcionais: `status`: nova situação: `ABERTO`, `RESOLVIDO` ou `IGNORADO`.
215
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Atualização parcial: só os campos enviados mudam. Muda o `status` do grupo de erro: `ABERTO`, `RESOLVIDO` ou `IGNORADO`. Campos do corpo, todos opcionais: `status`: nova situação: `ABERTO`, `RESOLVIDO` ou `IGNORADO`.
240
216
  *
241
217
  * `PATCH /erro/{id}`
242
218
  */
@@ -244,7 +220,7 @@ export declare function atualizar_pelo_id_erro(credencial_de_acesso: CredencialD
244
220
  /**
245
221
  * Exclui um erro pelo id
246
222
  *
247
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
223
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
248
224
  *
249
225
  * `DELETE /erro/{id}`
250
226
  */
@@ -252,7 +228,7 @@ export declare function deletar_pelo_id_erro(credencial_de_acesso: CredencialDeA
252
228
  /**
253
229
  * Lista os eventos paginados
254
230
  *
255
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Lista os eventos não excluídos da conta. Com `sessao_id`, devolve a linha do tempo da sessão do mais antigo para o mais recente; sem ele, do mais recente para o mais antigo. `aplicativo_id` filtra pelo aplicativo. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `sessao_id`: id da sessão: com ele, a lista vem do mais antigo para o mais recente (opcional); `aplicativo_id`: id do aplicativo (opcional).
231
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Lista os eventos não excluídos. Com `sessao_id`, devolve a linha do tempo da sessão do mais antigo para o mais recente; sem ele, do mais recente para o mais antigo. `aplicativo_id` filtra pelo aplicativo. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `sessao_id`: id da sessão: com ele, a lista vem do mais antigo para o mais recente (opcional); `aplicativo_id`: id do aplicativo (opcional).
256
232
  *
257
233
  * `GET /evento`
258
234
  */
@@ -260,7 +236,7 @@ export declare function buscar_paginador_evento(credencial_de_acesso: Credencial
260
236
  /**
261
237
  * Lista básica de eventos para seleção
262
238
  *
263
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve só id e rótulo (o nome do evento ou, sem nome, a mensagem ou o tipo), em ordem alfabética do rótulo. `busca` procura o trecho no rótulo, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do rótulo (nome, mensagem ou tipo), sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
239
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve só id e rótulo (o nome do evento ou, sem nome, a mensagem ou o tipo), em ordem alfabética do rótulo. `busca` procura o trecho no rótulo, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do rótulo (nome, mensagem ou tipo), sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
264
240
  *
265
241
  * `GET /evento/autocomplete`
266
242
  */
@@ -268,7 +244,7 @@ export declare function buscar_auto_complete_evento(credencial_de_acesso: Creden
268
244
  /**
269
245
  * Busca eventos por filtro
270
246
  *
271
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve todos os eventos não excluídos da conta que casam com o filtro, sem paginação, do mais antigo para o mais recente (`ocorrido_em`). `aplicativo_id` e `sessao_id` filtram pelo id; `tipo` compara o valor exato, sem diferenciar maiúsculas (`ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`); `nome` procura o trecho no nome; `inicio` e `fim` (data e hora ISO 8601) limitam o `ocorrido_em`. Sem filtro, devolve todos. Os eventos ficam guardados por 30 dias. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `sessao_id`: id da sessão; `tipo`: tipo do evento (sem diferenciar maiúsculas): `ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`; `nome`: trecho do nome, sem diferenciar maiúsculas; `inicio`: eventos ocorridos a partir desta data e hora ISO 8601, por exemplo 2026-10-07T00:00:00Z; `fim`: eventos ocorridos até esta data e hora ISO 8601.
247
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve todos os eventos não excluídos que casam com o filtro, sem paginação, do mais antigo para o mais recente (`ocorrido_em`). `aplicativo_id` e `sessao_id` filtram pelo id; `tipo` compara o valor exato, sem diferenciar maiúsculas (`ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`); `nome` procura o trecho no nome; `inicio` e `fim` (data e hora ISO 8601) limitam o `ocorrido_em`. Sem filtro, devolve todos. Os eventos ficam guardados por 30 dias. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `sessao_id`: id da sessão; `tipo`: tipo do evento (sem diferenciar maiúsculas): `ERRO_JS`, `PROMISE_REJEITADA`, `CONSOLE`, `REQUISICAO`, `NAVEGACAO`, `SAIDA`, `PULSO`, `CLIQUE`, `DESEMPENHO`, `IDENTIFICACAO` ou `PERSONALIZADO`; `nome`: trecho do nome, sem diferenciar maiúsculas; `inicio`: eventos ocorridos a partir desta data e hora ISO 8601, por exemplo 2026-10-07T00:00:00Z; `fim`: eventos ocorridos até esta data e hora ISO 8601.
272
248
  *
273
249
  * `GET /evento/filtro`
274
250
  */
@@ -276,7 +252,7 @@ export declare function buscar_pelo_filtro_evento(credencial_de_acesso: Credenci
276
252
  /**
277
253
  * Busca um evento pelo id
278
254
  *
279
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve o evento pelo id; registro excluído não é encontrado.
255
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve o evento pelo id; registro excluído não é encontrado.
280
256
  *
281
257
  * `GET /evento/{id}`
282
258
  */
@@ -284,7 +260,7 @@ export declare function buscar_pelo_id_evento(credencial_de_acesso: CredencialDe
284
260
  /**
285
261
  * Atualiza um evento pelo id
286
262
  *
287
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Atualização parcial: só os campos enviados mudam. Muda o `nome` (cortado em 120 caracteres) e o `payload` (JSON livre) do evento. Campos do corpo, todos opcionais: `nome`: novo nome do evento (cortado em 120 caracteres); `payload`: novos dados livres do evento (JSON), que substituem os atuais.
263
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Atualização parcial: só os campos enviados mudam. Muda o `nome` (cortado em 120 caracteres) e o `payload` (JSON livre) do evento. Campos do corpo, todos opcionais: `nome`: novo nome do evento (cortado em 120 caracteres); `payload`: novos dados livres do evento (JSON), que substituem os atuais.
288
264
  *
289
265
  * `PATCH /evento/{id}`
290
266
  */
@@ -292,7 +268,7 @@ export declare function atualizar_pelo_id_evento(credencial_de_acesso: Credencia
292
268
  /**
293
269
  * Exclui um evento pelo id
294
270
  *
295
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
271
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
296
272
  *
297
273
  * `DELETE /evento/{id}`
298
274
  */
@@ -300,7 +276,7 @@ export declare function deletar_pelo_id_evento(credencial_de_acesso: CredencialD
300
276
  /**
301
277
  * Lista as sessões paginadas
302
278
  *
303
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Lista as sessões não excluídas da conta, da mais recente para a mais antiga. `aplicativo_id` filtra pelo aplicativo. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `aplicativo_id`: id do aplicativo (opcional).
279
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Lista as sessões não excluídas, da mais recente para a mais antiga. `aplicativo_id` filtra pelo aplicativo. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `aplicativo_id`: id do aplicativo (opcional).
304
280
  *
305
281
  * `GET /sessao`
306
282
  */
@@ -308,7 +284,7 @@ export declare function buscar_paginador_sessao(credencial_de_acesso: Credencial
308
284
  /**
309
285
  * Cadastra uma sessão
310
286
  *
311
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Grava uma sessão de navegação de um aplicativo da conta (as sessões normalmente nascem sozinhas na ingestão). `aplicativo_id` precisa ser de um aplicativo da conta; `sessao_externa` e `anonimo_id` são obrigatórios e não podem ficar vazios. `navegador`, `sistema_operacional`, `dispositivo`, `resolucao` e `pais` têm padrão `DESCONHECIDO`; `pagina_inicial` tem padrão vazio. Campos do corpo: `aplicativo_id`: id de um aplicativo da conta (obrigatório); `sessao_externa`: identificador da sessão no navegador (obrigatório, não pode ficar vazio); `anonimo_id`: identificador anônimo do visitante (obrigatório, não pode ficar vazio); `usuario_id`: id do usuário logado no site (opcional); `navegador`: navegador (padrão `DESCONHECIDO`); `sistema_operacional`: sistema operacional (padrão `DESCONHECIDO`); `dispositivo`: tipo de dispositivo (padrão `DESCONHECIDO`); `resolucao`: resolução da tela (padrão `DESCONHECIDO`); `pais`: código do país com duas letras (padrão `DESCONHECIDO`); `pagina_inicial`: endereço da primeira página (padrão vazio).
287
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Grava uma sessão de navegação de um aplicativo (as sessões normalmente nascem sozinhas na ingestão). `aplicativo_id` precisa ser de um aplicativo; `sessao_externa` e `anonimo_id` são obrigatórios e não podem ficar vazios. `navegador`, `sistema_operacional`, `dispositivo`, `resolucao` e `pais` têm padrão `DESCONHECIDO`; `pagina_inicial` tem padrão vazio. Campos do corpo: `aplicativo_id`: id de um aplicativo (obrigatório); `sessao_externa`: identificador da sessão no navegador (obrigatório, não pode ficar vazio); `anonimo_id`: identificador anônimo do visitante (obrigatório, não pode ficar vazio); `usuario_id`: id do usuário logado no site (opcional); `navegador`: navegador (padrão `DESCONHECIDO`); `sistema_operacional`: sistema operacional (padrão `DESCONHECIDO`); `dispositivo`: tipo de dispositivo (padrão `DESCONHECIDO`); `resolucao`: resolução da tela (padrão `DESCONHECIDO`); `pais`: código do país com duas letras (padrão `DESCONHECIDO`); `pagina_inicial`: endereço da primeira página (padrão vazio).
312
288
  *
313
289
  * `POST /sessao`
314
290
  */
@@ -316,7 +292,7 @@ export declare function criar_sessao(credencial_de_acesso: CredencialDeAcesso, c
316
292
  /**
317
293
  * Lista básica de sessões para seleção
318
294
  *
319
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve só id e rótulo (`usuario_id` ou, sem ele, `anonimo_id`, mais a data e hora de início em UTC, no formato `DD/MM/AAAA HH:MM`), em ordem alfabética do rótulo. `busca` procura o trecho no rótulo, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do rótulo (usuário ou identificador anônimo e data de início), sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
295
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve só id e rótulo (`usuario_id` ou, sem ele, `anonimo_id`, mais a data e hora de início em UTC, no formato `DD/MM/AAAA HH:MM`), em ordem alfabética do rótulo. `busca` procura o trecho no rótulo, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do rótulo (usuário ou identificador anônimo e data de início), sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
320
296
  *
321
297
  * `GET /sessao/autocomplete`
322
298
  */
@@ -324,7 +300,7 @@ export declare function buscar_auto_complete_sessao(credencial_de_acesso: Creden
324
300
  /**
325
301
  * Busca sessões por filtro
326
302
  *
327
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve todas as sessões não excluídas da conta que casam com o filtro, sem paginação, da mais recente para a mais antiga (`iniciada_em`). `usuario_id`, `anonimo_id`, `navegador` e `pais` comparam o valor exato, sem diferenciar maiúsculas; `com_erro` filtra quem teve (ou não) ao menos um erro; `inicio` e `fim` (data e hora ISO 8601) limitam o `iniciada_em`. Sem filtro, devolve todas. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `usuario_id`: id do usuário logado no site (valor exato, sem diferenciar maiúsculas); `anonimo_id`: identificador anônimo do visitante (valor exato, sem diferenciar maiúsculas); `navegador`: navegador (valor exato, sem diferenciar maiúsculas); `pais`: código do país com duas letras (sem diferenciar maiúsculas); `com_erro`: `true` só sessões com algum erro; `false` só sessões sem erro; `inicio`: sessões iniciadas a partir desta data e hora ISO 8601, por exemplo 2026-10-07T00:00:00Z; `fim`: sessões iniciadas até esta data e hora ISO 8601.
303
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve todas as sessões não excluídas que casam com o filtro, sem paginação, da mais recente para a mais antiga (`iniciada_em`). `usuario_id`, `anonimo_id`, `navegador` e `pais` comparam o valor exato, sem diferenciar maiúsculas; `com_erro` filtra quem teve (ou não) ao menos um erro; `inicio` e `fim` (data e hora ISO 8601) limitam o `iniciada_em`. Sem filtro, devolve todas. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `usuario_id`: id do usuário logado no site (valor exato, sem diferenciar maiúsculas); `anonimo_id`: identificador anônimo do visitante (valor exato, sem diferenciar maiúsculas); `navegador`: navegador (valor exato, sem diferenciar maiúsculas); `pais`: código do país com duas letras (sem diferenciar maiúsculas); `com_erro`: `true` só sessões com algum erro; `false` só sessões sem erro; `inicio`: sessões iniciadas a partir desta data e hora ISO 8601, por exemplo 2026-10-07T00:00:00Z; `fim`: sessões iniciadas até esta data e hora ISO 8601.
328
304
  *
329
305
  * `GET /sessao/filtro`
330
306
  */
@@ -332,7 +308,7 @@ export declare function buscar_pelo_filtro_sessao(credencial_de_acesso: Credenci
332
308
  /**
333
309
  * Busca uma sessão pelo id
334
310
  *
335
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve a sessão pelo id; registro excluído não é encontrado.
311
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve a sessão pelo id; registro excluído não é encontrado.
336
312
  *
337
313
  * `GET /sessao/{id}`
338
314
  */
@@ -340,7 +316,7 @@ export declare function buscar_pelo_id_sessao(credencial_de_acesso: CredencialDe
340
316
  /**
341
317
  * Atualiza uma sessão pelo id
342
318
  *
343
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Atualização parcial: só os campos enviados mudam. Muda `usuario_id`, `pais` e `tempo_carregamento_ms` (em milissegundos) e marca a última atividade como agora. Campos do corpo, todos opcionais: `usuario_id`: novo id do usuário logado no site; `pais`: novo código do país com duas letras; `tempo_carregamento_ms`: tempo de carregamento da página inicial, em milissegundos.
319
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Atualização parcial: só os campos enviados mudam. Muda `usuario_id`, `pais` e `tempo_carregamento_ms` (em milissegundos) e marca a última atividade como agora. Campos do corpo, todos opcionais: `usuario_id`: novo id do usuário logado no site; `pais`: novo código do país com duas letras; `tempo_carregamento_ms`: tempo de carregamento da página inicial, em milissegundos.
344
320
  *
345
321
  * `PATCH /sessao/{id}`
346
322
  */
@@ -348,7 +324,7 @@ export declare function atualizar_pelo_id_sessao(credencial_de_acesso: Credencia
348
324
  /**
349
325
  * Exclui uma sessão pelo id
350
326
  *
351
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
327
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
352
328
  *
353
329
  * `DELETE /sessao/{id}`
354
330
  */
@@ -356,7 +332,7 @@ export declare function deletar_pelo_id_sessao(credencial_de_acesso: CredencialD
356
332
  /**
357
333
  * Lista os registros de uso paginados
358
334
  *
359
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Lista os registros de uso diário não excluídos da conta, do dia mais recente para o mais antigo. `ciclo` (`AAAA-MM`) filtra pelo mês e `aplicativo_id` pelo aplicativo. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `ciclo`: ciclo mensal exato, no formato AAAA-MM (opcional); `aplicativo_id`: id do aplicativo (opcional).
335
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Lista os registros de uso diário não excluídos, do dia mais recente para o mais antigo. `ciclo` (`AAAA-MM`) filtra pelo mês e `aplicativo_id` pelo aplicativo. `pagina` começa em 1 (padrão 1; menor que 1 vira 1). A página tem sempre 50 itens: o parâmetro `tamanho` é aceito, mas ignorado. A resposta traz `itens`, `total` (quantidade de registros que casam com os filtros), `pagina` e `tamanho` (50). Parâmetros de consulta, todos opcionais: `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: aceito, mas ignorado: a página tem sempre 50 itens; `ciclo`: ciclo mensal exato, no formato AAAA-MM (opcional); `aplicativo_id`: id do aplicativo (opcional).
360
336
  *
361
337
  * `GET /uso`
362
338
  */
@@ -364,7 +340,7 @@ export declare function buscar_paginador_uso(credencial_de_acesso: CredencialDeA
364
340
  /**
365
341
  * Cadastra um registro de uso
366
342
  *
367
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Soma eventos aceitos e recusados ao uso diário de um aplicativo da conta (o uso normalmente é contado sozinho pela ingestão). `aplicativo_id` precisa ser de um aplicativo da conta; `dia` é obrigatório, no formato `AAAA-MM-DD`; `eventos_aceitos` e `eventos_recusados` têm padrão 0. Se já existe o registro daquele aplicativo naquele dia, os valores enviados são somados aos atuais e o registro existente é devolvido. O `ciclo` é o mês do dia (`AAAA-MM`). Campos do corpo: `aplicativo_id`: id de um aplicativo da conta (obrigatório); `dia`: dia no formato AAAA-MM-DD (obrigatório); `eventos_aceitos`: eventos aceitos a somar (padrão 0); `eventos_recusados`: eventos recusados a somar (padrão 0).
343
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Soma eventos aceitos e recusados ao uso diário de um aplicativo (o uso normalmente é contado sozinho pela ingestão). `aplicativo_id` precisa ser de um aplicativo; `dia` é obrigatório, no formato `AAAA-MM-DD`; `eventos_aceitos` e `eventos_recusados` têm padrão 0. Se já existe o registro daquele aplicativo naquele dia, os valores enviados são somados aos atuais e o registro existente é devolvido. O `ciclo` é o mês do dia (`AAAA-MM`). Campos do corpo: `aplicativo_id`: id de um aplicativo (obrigatório); `dia`: dia no formato AAAA-MM-DD (obrigatório); `eventos_aceitos`: eventos aceitos a somar (padrão 0); `eventos_recusados`: eventos recusados a somar (padrão 0).
368
344
  *
369
345
  * `POST /uso`
370
346
  */
@@ -372,7 +348,7 @@ export declare function criar_uso(credencial_de_acesso: CredencialDeAcesso, corp
372
348
  /**
373
349
  * Lista básica de registros de uso para seleção
374
350
  *
375
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve só id e rótulo (nome do aplicativo e dia), ordenados por ciclo e dia. `busca` procura o trecho no ciclo (`AAAA-MM`), sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do ciclo (AAAA-MM), sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
351
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve só id e rótulo (nome do aplicativo e dia), ordenados por ciclo e dia. `busca` procura o trecho no ciclo (`AAAA-MM`), sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`. Parâmetros de consulta, todos opcionais: `busca`: trecho do ciclo (AAAA-MM), sem diferenciar maiúsculas (opcional); `pagina`: número da página, começando em 1 (padrão 1; menor que 1 vira 1); `tamanho`: itens por página (padrão 10, sem máximo; menor que 1 vira 1).
376
352
  *
377
353
  * `GET /uso/autocomplete`
378
354
  */
@@ -380,7 +356,7 @@ export declare function buscar_auto_complete_uso(credencial_de_acesso: Credencia
380
356
  /**
381
357
  * Busca registros de uso por filtro
382
358
  *
383
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve todos os registros de uso diário não excluídos da conta que casam com o filtro, sem paginação, do dia mais antigo para o mais recente. `aplicativo_id` filtra pelo aplicativo; `ciclo` (`AAAA-MM`) pelo mês; `dia_inicial` e `dia_final` (`AAAA-MM-DD`) limitam o dia. Sem filtro, devolve todos. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `ciclo`: ciclo mensal exato, no formato AAAA-MM; `dia_inicial`: primeiro dia, no formato AAAA-MM-DD; `dia_final`: último dia, no formato AAAA-MM-DD.
359
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve todos os registros de uso diário não excluídos que casam com o filtro, sem paginação, do dia mais antigo para o mais recente. `aplicativo_id` filtra pelo aplicativo; `ciclo` (`AAAA-MM`) pelo mês; `dia_inicial` e `dia_final` (`AAAA-MM-DD`) limitam o dia. Sem filtro, devolve todos. Parâmetros de consulta, todos opcionais: `aplicativo_id`: id do aplicativo; `ciclo`: ciclo mensal exato, no formato AAAA-MM; `dia_inicial`: primeiro dia, no formato AAAA-MM-DD; `dia_final`: último dia, no formato AAAA-MM-DD.
384
360
  *
385
361
  * `GET /uso/filtro`
386
362
  */
@@ -388,7 +364,7 @@ export declare function buscar_pelo_filtro_uso(credencial_de_acesso: CredencialD
388
364
  /**
389
365
  * Busca um registro de uso pelo id
390
366
  *
391
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Devolve o registro de uso pelo id; registro excluído não é encontrado.
367
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Devolve o registro de uso pelo id; registro excluído não é encontrado.
392
368
  *
393
369
  * `GET /uso/{id}`
394
370
  */
@@ -396,7 +372,7 @@ export declare function buscar_pelo_id_uso(credencial_de_acesso: CredencialDeAce
396
372
  /**
397
373
  * Atualiza um registro de uso pelo id
398
374
  *
399
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Atualização parcial: só os campos enviados mudam. Substitui `eventos_aceitos` e/ou `eventos_recusados` pelos valores enviados. Campos do corpo, todos opcionais: `eventos_aceitos`: novo total de eventos aceitos no dia; `eventos_recusados`: novo total de eventos recusados no dia.
375
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Atualização parcial: só os campos enviados mudam. Substitui `eventos_aceitos` e/ou `eventos_recusados` pelos valores enviados. Campos do corpo, todos opcionais: `eventos_aceitos`: novo total de eventos aceitos no dia; `eventos_recusados`: novo total de eventos recusados no dia.
400
376
  *
401
377
  * `PATCH /uso/{id}`
402
378
  */
@@ -404,7 +380,7 @@ export declare function atualizar_pelo_id_uso(credencial_de_acesso: CredencialDe
404
380
  /**
405
381
  * Exclui um registro de uso pelo id
406
382
  *
407
- * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Cada conta só enxerga e altera os próprios registros (os do `sub` do token): registro de outra conta responde como não encontrado. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
383
+ * Qualquer colaborador da Termotubos logado no TermoAuth (perfil `employee`); não há área de permissão própria. Os registros são da Termotubos inteira: todo colaborador com a permissão da área enxerga os mesmos. Exclusão lógica: o registro some das leituras, mas não é apagado na hora.
408
384
  *
409
385
  * `DELETE /uso/{id}`
410
386
  */