termo_core 0.1.3 → 0.1.5

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.
@@ -1,13 +1,6 @@
1
1
  import type * as tipos from "./tipos.js";
2
2
  import type { CredencialDeAcesso } from "../base/credencial.js";
3
3
  import { type OpcoesDaChamada } from "../base/requisicao.js";
4
- /**
5
- * Parâmetros de consulta e de cabeçalho de `/arquivo/{caminho}`.
6
- */
7
- export interface ParametrosDeBuscarPeloIdArquivo {
8
- baixar?: string;
9
- nome?: string;
10
- }
11
4
  /**
12
5
  * Parâmetros de consulta e de cabeçalho de `/boletim_tecnico`.
13
6
  */
@@ -187,6 +180,7 @@ export interface ParametrosDeBuscarPeloFiltroContato {
187
180
  export interface ParametrosDeBuscarPaginadorCotacao {
188
181
  unidade_id?: string;
189
182
  status?: string;
183
+ origem?: string;
190
184
  busca?: string;
191
185
  inicio?: string;
192
186
  fim?: string;
@@ -206,8 +200,8 @@ export interface ParametrosDeBuscarAutoCompleteCotacao {
206
200
  */
207
201
  export interface ParametrosDeBuscarPeloFiltroCotacao {
208
202
  unidade_id?: string;
209
- autor_cliente_id?: string;
210
203
  status?: string;
204
+ origem?: string;
211
205
  pagina?: number;
212
206
  }
213
207
  /**
@@ -216,6 +210,7 @@ export interface ParametrosDeBuscarPeloFiltroCotacao {
216
210
  export interface ParametrosDeBuscarInformacoesPaginadorCotacao {
217
211
  unidade_id?: string;
218
212
  status?: string;
213
+ origem?: string;
219
214
  busca?: string;
220
215
  inicio?: string;
221
216
  fim?: string;
@@ -313,6 +308,26 @@ export interface ParametrosDeBuscarPeloFiltroIndicadorVenda {
313
308
  inicio?: string;
314
309
  fim?: string;
315
310
  }
311
+ /**
312
+ * Parâmetros de consulta e de cabeçalho de `/nao_conformidade`.
313
+ */
314
+ export interface ParametrosDeBuscarPaginadorNaoConformidade {
315
+ unidade_id?: string;
316
+ situacao?: string;
317
+ tipo?: string;
318
+ busca?: string;
319
+ pagina?: number;
320
+ }
321
+ /**
322
+ * Parâmetros de consulta e de cabeçalho de `/nao_conformidade/paginador`.
323
+ */
324
+ export interface ParametrosDeBuscarInformacoesPaginadorNaoConformidade {
325
+ unidade_id?: string;
326
+ situacao?: string;
327
+ tipo?: string;
328
+ busca?: string;
329
+ pagina?: number;
330
+ }
316
331
  /**
317
332
  * Parâmetros de consulta e de cabeçalho de `/nota_fiscal`.
318
333
  */
@@ -353,48 +368,6 @@ export interface ParametrosDeBuscarInformacoesPaginadorNotaFiscal {
353
368
  export interface ParametrosDeBuscarPeloIdNotaFiscal {
354
369
  xml?: string;
355
370
  }
356
- /**
357
- * Parâmetros de consulta e de cabeçalho de `/painel_produto`.
358
- */
359
- export interface ParametrosDeBuscarPaginadorPainelProduto {
360
- busca?: string;
361
- cursor?: string;
362
- ultima_sincronizacao?: string;
363
- categoria_tiny?: string;
364
- marca_tiny?: string;
365
- tipo_tiny?: string;
366
- unidade?: string;
367
- ncm?: string;
368
- garantia?: string;
369
- cor?: string;
370
- embalagem_rotulo?: string;
371
- sku_categoria?: string;
372
- sku_medida?: string;
373
- sku_cor?: string;
374
- na_vitrine?: boolean;
375
- com_estoque?: boolean;
376
- }
377
- /**
378
- * Parâmetros de consulta e de cabeçalho de `/painel_produto/paginador`.
379
- */
380
- export interface ParametrosDeBuscarInformacoesPaginadorPainelProduto {
381
- busca?: string;
382
- cursor?: string;
383
- ultima_sincronizacao?: string;
384
- categoria_tiny?: string;
385
- marca_tiny?: string;
386
- tipo_tiny?: string;
387
- unidade?: string;
388
- ncm?: string;
389
- garantia?: string;
390
- cor?: string;
391
- embalagem_rotulo?: string;
392
- sku_categoria?: string;
393
- sku_medida?: string;
394
- sku_cor?: string;
395
- na_vitrine?: boolean;
396
- com_estoque?: boolean;
397
- }
398
371
  /**
399
372
  * Parâmetros de consulta e de cabeçalho de `/pedido`.
400
373
  */
@@ -420,6 +393,14 @@ export interface ParametrosDeBuscarPeloFiltroPedido {
420
393
  entregue?: boolean;
421
394
  pagina?: number;
422
395
  }
396
+ /**
397
+ * Parâmetros de consulta e de cabeçalho de `/pedido_inteligente/filtro`.
398
+ */
399
+ export interface ParametrosDeBuscarPeloFiltroPedidoInteligente {
400
+ unidade_id?: string;
401
+ status?: string;
402
+ pagina?: number;
403
+ }
423
404
  /**
424
405
  * Parâmetros de consulta e de cabeçalho de `/pedido_venda`.
425
406
  */
@@ -491,30 +472,6 @@ export interface ParametrosDeBuscarPeloFiltroPedidoVendaTiny {
491
472
  export interface ParametrosDeBuscarPeloIdPedidoVendaTiny {
492
473
  unidade_id?: string;
493
474
  }
494
- /**
495
- * Parâmetros de consulta e de cabeçalho de `/perfil`.
496
- */
497
- export interface ParametrosDeBuscarPaginadorPerfil {
498
- pagina?: number;
499
- }
500
- /**
501
- * Parâmetros de consulta e de cabeçalho de `/perfil/autocomplete`.
502
- */
503
- export interface ParametrosDeBuscarAutoCompletePerfil {
504
- busca?: string;
505
- pagina?: number;
506
- tamanho?: number;
507
- }
508
- /**
509
- * Parâmetros de consulta e de cabeçalho de `/perfil/filtro`.
510
- */
511
- export interface ParametrosDeBuscarPeloFiltroPerfil {
512
- nome?: string;
513
- slug?: string;
514
- base?: boolean;
515
- tipo?: string;
516
- pagina?: number;
517
- }
518
475
  /**
519
476
  * Parâmetros de consulta e de cabeçalho de `/produto`.
520
477
  */
@@ -590,51 +547,12 @@ export interface ParametrosDeBuscarPeloFiltroProduto {
590
547
  ordem?: string;
591
548
  pagina?: number;
592
549
  }
593
- /**
594
- * Parâmetros de consulta e de cabeçalho de `/produto_conflito_sincronizacao`.
595
- */
596
- export interface ParametrosDeBuscarPaginadorProdutoConflitoSincronizacao {
597
- resolvido?: boolean;
598
- pagina?: number;
599
- }
600
- /**
601
- * Parâmetros de consulta e de cabeçalho de `/produto_conflito_sincronizacao/autocomplete`.
602
- */
603
- export interface ParametrosDeBuscarAutoCompleteProdutoConflitoSincronizacao {
604
- busca?: string;
605
- pagina?: number;
606
- tamanho?: number;
607
- }
608
- /**
609
- * Parâmetros de consulta e de cabeçalho de `/produto_conflito_sincronizacao/filtro`.
610
- */
611
- export interface ParametrosDeBuscarPeloFiltroProdutoConflitoSincronizacao {
612
- produto_id?: string;
613
- campo?: string;
614
- resolvido?: boolean;
615
- pagina?: number;
616
- }
617
550
  /**
618
551
  * Parâmetros de consulta e de cabeçalho de `/produto_estrutura/filtro`.
619
552
  */
620
553
  export interface ParametrosDeBuscarPeloFiltroProdutoEstrutura {
621
554
  sku: string;
622
555
  }
623
- /**
624
- * Parâmetros de consulta e de cabeçalho de `/produto_termotubos/filtro`.
625
- */
626
- export interface ParametrosDeBuscarPeloFiltroProdutoTermotubos {
627
- busca?: string;
628
- apenas_ativos?: boolean;
629
- pagina?: number;
630
- por_pagina?: number;
631
- }
632
- /**
633
- * Parâmetros de consulta e de cabeçalho de `/produto_termotubos/sincronizacao`.
634
- */
635
- export interface ParametrosDeIniciarSincronizacaoProdutoTermotubos {
636
- apenas_ativos?: boolean;
637
- }
638
556
  /**
639
557
  * Parâmetros de consulta e de cabeçalho de `/produto_tiny/filtro`.
640
558
  */
@@ -684,33 +602,6 @@ export interface ParametrosDeBuscarInformacoesPaginadorRastreamento {
684
602
  auxiliar_transportadora?: string;
685
603
  auxiliar_situacao?: string;
686
604
  }
687
- /**
688
- * Parâmetros de consulta e de cabeçalho de `/tabela_auxiliar`.
689
- */
690
- export interface ParametrosDeBuscarPaginadorTabelaAuxiliar {
691
- tabela?: string;
692
- campo?: string;
693
- pagina?: number;
694
- }
695
- /**
696
- * Parâmetros de consulta e de cabeçalho de `/tabela_auxiliar/autocomplete`.
697
- */
698
- export interface ParametrosDeBuscarAutoCompleteTabelaAuxiliar {
699
- tabela: string;
700
- campo: string;
701
- busca?: string;
702
- pagina?: number;
703
- tamanho?: number;
704
- }
705
- /**
706
- * Parâmetros de consulta e de cabeçalho de `/tabela_auxiliar/filtro`.
707
- */
708
- export interface ParametrosDeBuscarPeloFiltroTabelaAuxiliar {
709
- tabela?: string;
710
- campo?: string;
711
- label?: string;
712
- pagina?: number;
713
- }
714
605
  /**
715
606
  * Parâmetros de consulta e de cabeçalho de `/unidade`.
716
607
  */
@@ -737,34 +628,10 @@ export interface ParametrosDeBuscarPeloFiltroUnidade {
737
628
  cliente_id?: string;
738
629
  pagina?: number;
739
630
  }
740
- /**
741
- * Envia um arquivo (imagem ou PDF de boletim)
742
- *
743
- * Exige uma sessão válida; as pastas (`produtos` e `boletins`) exigem a permissão `criar` ou `editar` no módulo `Configuracoes`. Formulário `multipart/form-data` com os campos `pasta` e `arquivo`. Imagem de produto (`produtos`, até 5 MB, PNG, JPG, WEBP ou GIF) vai para o TermoBucket (bucket público, app `portal-b2b`, pelo token do próprio app) e a `url` devolvida é o endereço público permanente dela, que vai nas `imagens` do produto (até 15). PDF de boletim (`boletins`, até 20 MB) fica no disco da API e a `url` é relativa (`/arquivo/boletins/<uuid>.pdf`).
744
- *
745
- * `POST /arquivo`
746
- */
747
- export declare function criar_arquivo(credencial_de_acesso: CredencialDeAcesso, formulario: FormData, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Arquivo>;
748
- /**
749
- * Lê um arquivo enviado
750
- *
751
- * Exige só uma sessão válida (qualquer pessoa logada no portal). Devolve o conteúdo do arquivo com o `Content-Type` dele (imagem ou PDF). `caminho` é o que vem depois de `/arquivo/` na `url` devolvida pelo envio (ex.: `produtos/<uuid>.png`). Campos: `baixar` com o valor `1` força o download (Content-Disposition attachment); `nome` é o nome sugerido para o download (só letras, números, ponto, hífen e `_`).
752
- *
753
- * `GET /arquivo/{caminho}`
754
- */
755
- export declare function buscar_pelo_id_arquivo(credencial_de_acesso: CredencialDeAcesso, caminho: string, parametros?: ParametrosDeBuscarPeloIdArquivo, opcoes_da_chamada?: OpcoesDaChamada): Promise<Uint8Array>;
756
- /**
757
- * Apaga um arquivo enviado
758
- *
759
- * Exige a permissão `excluir` no módulo `Configuracoes` do perfil de quem chama (administrador e master têm tudo). Apaga o arquivo do disco de verdade (não há exclusão lógica para arquivos). `caminho` é o que vem depois de `/arquivo/` na `url`.
760
- *
761
- * `DELETE /arquivo/{caminho}`
762
- */
763
- export declare function deletar_pelo_id_arquivo(credencial_de_acesso: CredencialDeAcesso, caminho: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
764
631
  /**
765
632
  * Lista as categorias com a situação do boletim
766
633
  *
767
- * Exige sessão. Uma linha por categoria do SKU (`sku_categoria` da tabela auxiliar, mais as que já têm boletim), tenha ela boletim ou não: `boletim_tecnico_id` e `atualizado_em` vêm nulos quando ainda não tem. `total_medidas` junta as medidas dos produtos da categoria e as já descritas; `situacao` é `vazio` (sem descrição e sem medida descrita), `completo` (com descrição e todas as medidas descritas) ou `incompleto`. `busca` procura no código e na descrição; `situacao` filtra. Ordem pelo código, 50 por página, por cursor: `cursor` é o `sku_categoria` da última linha recebida. As categorias saem de um cache em memória, descartado a cada gravação em boletim, medida, tabela auxiliar ou produto (e recarregado do banco no máximo a cada 10 minutos).
634
+ * Exige sessão. Uma linha por categoria do SKU (`sku_categoria` da tabela auxiliar, mais as que já têm boletim), tenha ela boletim ou não: `boletim_tecnico_id` e `atualizado_em` vêm nulos quando ainda não tem. `total_medidas` junta as medidas dos produtos da categoria e as já descritas; `situacao` é `vazio` (sem nome e sem descrição), `completo` (com nome e descrição) ou `incompleto` (só um dos dois); as medidas não contam. `busca` procura no código e na descrição; `situacao` filtra. Ordem pelo código, 50 por página, por cursor: `cursor` é o `sku_categoria` da última linha recebida. As categorias saem de um cache em memória, descartado a cada gravação em boletim, medida, tabela auxiliar ou produto (e recarregado do banco no máximo a cada 10 minutos).
768
635
  *
769
636
  * `GET /boletim_tecnico`
770
637
  */
@@ -1025,14 +892,6 @@ export declare function buscar_pelo_filtro_cliente(credencial_de_acesso: Credenc
1025
892
  * `GET /cliente/paginador`
1026
893
  */
1027
894
  export declare function buscar_informacoes_paginador_cliente(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarInformacoesPaginadorCliente, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ClientePaginador>;
1028
- /**
1029
- * Sincroniza um lote de clientes do Tiny
1030
- *
1031
- * Só colaborador interno com `editar` no módulo `Configuracoes`. Traz 10 páginas (500 clientes) do TermoIntranetAPI pelo `termo_core` (token do próprio app no TermoAuth) e grava na tabela `cliente`: cliente que já entra no portal é casado pelo CNPJ da unidade dele e só recebe os campos do Tiny (`id_api`, `codigo`, `id_tiny`, `cpf_cnpj`, `tipo_pessoa`, `nome_fantasia`, `email_tiny`, `telefone_tiny`, `celular`, `cidade`, `uf`, `vendedor`, `situacao_tiny`); os demais entram sem login (`email` nulo, `status` `inativo`). A listagem de lá é por cursor: a primeira chamada vai sem `cursor` e a seguinte manda o `proximo_cursor` recebido (nulo no fim). `total` é o total de clientes ativos na intranet. O backend também sincroniza sozinho (`SINCRONIZACAO_CLIENTE_MINUTOS`, `_PAGINAS` e `_COMPLETA_HORAS`).
1032
- *
1033
- * `POST /cliente/sincronizar`
1034
- */
1035
- export declare function sincronizar_cliente(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.ClienteSincronizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.SincronizacaoClientes>;
1036
895
  /**
1037
896
  * Busca o cliente pelo id
1038
897
  *
@@ -1116,7 +975,7 @@ export declare function deletar_pelo_id_contato(credencial_de_acesso: Credencial
1116
975
  /**
1117
976
  * Lista uma página de cotações
1118
977
  *
1119
- * 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; `cursor` é o id da última cotação da página anterior.
978
+ * 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.
1120
979
  *
1121
980
  * `GET /cotacao`
1122
981
  */
@@ -1124,7 +983,7 @@ export declare function buscar_paginador_cotacao(credencial_de_acesso: Credencia
1124
983
  /**
1125
984
  * Cria uma cotação (carrinho enviado)
1126
985
  *
1127
- * Exige a permissão `criar` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Monta a cotação no servidor a partir dos itens (`produto_id`, `quantidade` acima de zero e até 9999, `embalagem_fechada`, `preco_unitario` visto pelo cliente), com 1 a 200 itens e sem produto repetido. Recalcula preços por faixa, confere `total_esperado` e grava com o status inicial. A unidade precisa ser da sessão (colaborador interno acessa todas) e, para quem não é colaborador interno, o autor é sempre quem chama. `acima_do_limite` indica que a cotação passa o limite de faturamento da unidade. Campos: `unidade_id` (uuid) é a unidade compradora, da sessão; `autor_cliente_id` é a pessoa autora (uuid; para quem não é colaborador interno vale sempre a própria pessoa); `itens` é a lista de 1 a 200 itens, cada um com `produto_id`, `quantidade`, `embalagem_fechada` e `preco_unitario`; `economia_tier` é a economia do grupo de cliente vista no carrinho (decimal, informativo); `carrinho_id` (opcional) é o carrinho aberto da unidade de onde os itens saíram: todo item precisa estar nele, o carrinho fecha junto com a cotação e os itens que não foram cotados seguem num carrinho novo; `endereco_id` (opcional) é um endereço de entrega da unidade, copiado para `endereco_entrega`; `observacao` (opcional) tem até 1000 caracteres. A cotação nasce com `numero` sequencial (exibido como C-1001) e `valida_ate` = hoje em Brasília + `cotacao_validade_dias` de Configurações (15 sem a chave).
986
+ * Exige a permissão `criar` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Monta a cotação no servidor a partir dos itens (`produto_id`, `quantidade` acima de zero e até 9999, `embalagem_fechada`, `preco_unitario` visto pelo cliente), com 1 a 200 itens e sem produto repetido. Recalcula preços por faixa, confere `total_esperado` e grava com o status inicial. A unidade precisa ser da sessão (colaborador interno acessa todas) e, para quem não é colaborador interno, o autor é sempre quem chama. `acima_do_limite` indica que a cotação passa o limite de faturamento da unidade. Campos: `unidade_id` (uuid) é a unidade compradora, da sessão, e o cliente da cotação é sempre o cliente dessa unidade (o nome dele fica em `autor_nome`); `itens` é a lista de 1 a 200 itens, cada um com `produto_id`, `quantidade`, `embalagem_fechada` e `preco_unitario`; `economia_tier` é a economia do grupo de cliente vista no carrinho (decimal, informativo); `carrinho_id` (opcional) é o carrinho aberto da unidade de onde os itens saíram: todo item precisa estar nele, o carrinho fecha junto com a cotação e os itens que não foram cotados seguem num carrinho novo; `pedido_inteligente_id` (opcional, nunca junto com `carrinho_id`) é o pedido inteligente revisado de onde os itens saíram: ele precisa estar `pronto`, todo item precisa ser um produto confirmado na revisão, a cotação sai com `origem` `pedido_inteligente` e o pedido vira `cotado`; sem ele, `origem` é `carrinho`; `endereco_id` (opcional) é um endereço de entrega da unidade, copiado para `endereco_entrega`; `observacao` (opcional) tem até 1000 caracteres. A cotação nasce com `numero` sequencial (exibido como C-1001) e `valida_ate` = hoje em Brasília + `cotacao_validade_dias` de Configurações (15 sem a chave).
1128
987
  *
1129
988
  * `POST /cotacao`
1130
989
  */
@@ -1140,7 +999,7 @@ export declare function buscar_auto_complete_cotacao(credencial_de_acesso: Crede
1140
999
  /**
1141
1000
  * Busca cotações por filtro
1142
1001
  *
1143
- * 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. `autor_cliente_id` e `status` (`rascunho`, `esperando_aprovacao`, `concluido`, `nao_aprovado`, `em_transporte`) são exatos.
1002
+ * 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.
1144
1003
  *
1145
1004
  * `GET /cotacao/filtro`
1146
1005
  */
@@ -1324,7 +1183,7 @@ export declare function deletar_pelo_id_fatura(credencial_de_acesso: CredencialD
1324
1183
  /**
1325
1184
  * Indicadores de compra de uma unidade
1326
1185
  *
1327
- * Exige a permissão `ver` no módulo `Dashboard` do perfil de quem chama (administrador e master têm tudo). Soma na hora as compras (notas emitidas pelo Tiny) do CNPJ da unidade `unidade_id`: total comprado, comparação com o período anterior (períodos de até 731 dias), notas, produtos diferentes, última compra, compras por mês, por tipo e os produtos mais comprados (até 6). `unidade_id` é obrigatório e precisa ser uma unidade da sessão (colaborador interno acessa todas). `inicio` e `fim` em AAAA-MM-DD (padrão: últimos 365 dias). `amostra: true` indica soma parcial. Até 30 chamadas por minuto por pessoa.
1186
+ * Exige a permissão `ver` no módulo `Dashboard` do perfil de quem chama (administrador e master têm tudo). Soma na hora as compras (notas emitidas pelo Tiny) do CNPJ da unidade `unidade_id`: total comprado, comparação com o período anterior (períodos de até 731 dias), notas, produtos diferentes, última compra, compras por mês, por tipo e os produtos mais comprados (até 10). `unidade_id` é obrigatório e precisa ser uma unidade da sessão (colaborador interno acessa todas). `inicio` e `fim` em AAAA-MM-DD (padrão: últimos 365 dias). `amostra: true` indica soma parcial. Até 30 chamadas por minuto por pessoa.
1328
1187
  *
1329
1188
  * `GET /indicador_compra/filtro`
1330
1189
  */
@@ -1338,45 +1197,45 @@ export declare function buscar_pelo_filtro_indicador_compra(credencial_de_acesso
1338
1197
  */
1339
1198
  export declare function buscar_pelo_filtro_indicador_venda(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroIndicadorVenda, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.IndicadoresDeVenda>;
1340
1199
  /**
1341
- * Uma página das notas fiscais, por cursor
1200
+ * Lista as RNCs e ocorrências da qualidade de uma unidade
1342
1201
  *
1343
- * Exige a permissão `ver` no módulo `Financeiro` do perfil de quem chama (administrador e master têm tudo). Lê a tabela `nota_fiscal`, que o backend sincroniza sozinho com as notas emitidas no Tiny (pela API da Termotubos), com parcelas e situação financeira; a emissão mais recente vem primeiro e a resposta é só o array das 50 notas da página. Quem não é colaborador interno precisa informar `unidade_id` de uma unidade da sessão e só vê as notas do CNPJ dela; colaborador interno pode omitir e ver todas. Filtros: `filtro` (`todas`, `hoje`, `mes`; padrão `todas`; `hoje` e `mes` trocam o período), `busca` (CPF/CNPJ, número da nota ou nome do cliente), `inicio` e `fim` (AAAA-MM-DD) e `vendedor` (id no Tiny, só colaborador). A paginação é por cursor: a primeira página vai sem `cursor` e a seguinte manda em `cursor` o `id` da última nota recebida. Total, páginas e contagens vêm de `GET /nota_fiscal/paginador`, com o mesmo filtro.
1202
+ * Só colaborador interno. Consulta na hora a API de qualidade da Termotubos (intranet) pelo CNPJ da unidade (`unidade_id`, obrigatório), da mais recente para a mais antiga. Filtros: `situacao` (`todas`, `abertas`, `fechadas`, `rascunho`; padrão `todas`), `tipo` (`todos`, `rnc`, `ocorrencia`; padrão `todos`) e `busca` (número, nota fiscal, documento, código do produto, lote, problema, motivo, objetivo, responsável ou emitente). 50 por página; `pagina` começa em 1. Totais e contagens em `GET /nao_conformidade/paginador`.
1344
1203
  *
1345
- * `GET /nota_fiscal`
1204
+ * `GET /nao_conformidade`
1346
1205
  */
1347
- export declare function buscar_paginador_nota_fiscal(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorNotaFiscal, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.NotaFiscal>>;
1206
+ export declare function buscar_paginador_nao_conformidade(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorNaoConformidade, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.NaoConformidadeTermotubos>>;
1348
1207
  /**
1349
- * Total, páginas e contagens das notas fiscais
1208
+ * Totais, contagens e resumo das RNCs de uma unidade
1350
1209
  *
1351
- * Mesma permissão, mesmos filtros e mesma regra de unidade de `GET /nota_fiscal` (o `cursor` é ignorado). Devolve `total` e `paginas` com o filtro escolhido, `tamanho` (50), `sincronizado_em` (a última sincronização; nulo se nunca houve) e `contagens` (`todas`, `hoje`, `mes`), que usam os outros filtros e trocam o período pelo do bloco.
1210
+ * Só colaborador interno. Mesmos filtros de `GET /nao_conformidade`. `total` e `paginas` seguem todos os filtros; `contagens` (todas, abertas, fechadas, rascunho, rnc, ocorrencias) seguem só a `busca`; o `resumo` (custo total, abertas com gravidade alta, abertura mais antiga ainda aberta, última abertura, média de dias para fechar e até 3 problemas que se repetem) olha todas as não conformidades da unidade.
1352
1211
  *
1353
- * `GET /nota_fiscal/paginador`
1212
+ * `GET /nao_conformidade/paginador`
1354
1213
  */
1355
- export declare function buscar_informacoes_paginador_nota_fiscal(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarInformacoesPaginadorNotaFiscal, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.NotaFiscalPaginador>;
1214
+ export declare function buscar_informacoes_paginador_nao_conformidade(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarInformacoesPaginadorNaoConformidade, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.NaoConformidadePaginador>;
1356
1215
  /**
1357
- * Status da sincronização das notas fiscais
1216
+ * Busca uma RNC ou ocorrência completa pelo id da intranet
1358
1217
  *
1359
- * Só colaborador interno com `ver` no módulo `Financeiro`. Devolve a sincronização em andamento ou a última que terminou: `rodando`, `pagina` de `total_paginas` (páginas da API), `progresso` (percentual), `gravados`, `cancelada`, `concluida`, `erro`, `iniciada_em` e `terminada_em`.
1218
+ * Só colaborador interno. Traz os dados da lista e mais as etapas do tratamento (descrição, ação imediata, análise da causa raiz, ação corretiva, evidência, eficácia, justificativa e observação geral), cada uma com os responsáveis e as mensagens em texto (o HTML da intranet é convertido e as imagens coladas como link vêm em `imagens`), além dos custos e anexos.
1360
1219
  *
1361
- * `GET /nota_fiscal/sincronizacao`
1220
+ * `GET /nao_conformidade/{id}`
1362
1221
  */
1363
- export declare function buscar_sincronizacao_nota_fiscal(credencial_de_acesso: CredencialDeAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.StatusSincronizacaoNotasFiscais>;
1222
+ export declare function buscar_pelo_id_nao_conformidade(credencial_de_acesso: CredencialDeAcesso, id: number, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.DetalheNaoConformidadeTermotubos>;
1364
1223
  /**
1365
- * Inicia a sincronização das notas fiscais em segundo plano
1224
+ * Uma página das notas fiscais, por cursor
1366
1225
  *
1367
- * Só colaborador interno com `ver` no módulo `Financeiro`. Traz as notas fiscais emitidas no Tiny (pela API de notas fiscais da Termotubos) para a tabela `nota_fiscal`, com as parcelas lidas do XML das notas válidas que ainda não as têm, sem filtro de data (histórico inteiro), lote por lote, em segundo plano no servidor: a tela pode ser fechada. Responde 202 com o status inicial; acompanhe por `GET /nota_fiscal/sincronizacao`. O status fica em memória e se perde se o servidor reiniciar.
1226
+ * Exige a permissão `ver` no módulo `Financeiro` do perfil de quem chama (administrador e master têm tudo). Lê a tabela `nota_fiscal`, que o backend sincroniza sozinho com as notas emitidas no Tiny (pela API da Termotubos), com parcelas e situação financeira; a emissão mais recente vem primeiro e a resposta é só o array das 50 notas da página. Quem não é colaborador interno precisa informar `unidade_id` de uma unidade da sessão e só vê as notas do CNPJ dela; colaborador interno pode omitir e ver todas. Filtros: `filtro` (`todas`, `hoje`, `mes`; padrão `todas`; `hoje` e `mes` trocam o período), `busca` (CPF/CNPJ, número da nota ou nome do cliente), `inicio` e `fim` (AAAA-MM-DD) e `vendedor` (id no Tiny, só colaborador). A paginação é por cursor: a primeira página vai sem `cursor` e a seguinte manda em `cursor` o `id` da última nota recebida. Total, páginas e contagens vêm de `GET /nota_fiscal/paginador`, com o mesmo filtro.
1368
1227
  *
1369
- * `POST /nota_fiscal/sincronizacao`
1228
+ * `GET /nota_fiscal`
1370
1229
  */
1371
- export declare function iniciar_sincronizacao_nota_fiscal(credencial_de_acesso: CredencialDeAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.StatusSincronizacaoNotasFiscais>;
1230
+ export declare function buscar_paginador_nota_fiscal(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorNotaFiscal, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.NotaFiscal>>;
1372
1231
  /**
1373
- * Cancela a sincronização das notas fiscais em andamento
1232
+ * Total, páginas e contagens das notas fiscais
1374
1233
  *
1375
- * Só colaborador interno com `ver` no módulo `Financeiro`. Para antes do próximo lote; o que já foi gravado fica.
1234
+ * Mesma permissão, mesmos filtros e mesma regra de unidade de `GET /nota_fiscal` (o `cursor` é ignorado). Devolve `total` e `paginas` com o filtro escolhido, `tamanho` (50), `sincronizado_em` (a última sincronização; nulo se nunca houve) e `contagens` (`todas`, `hoje`, `mes`), que usam os outros filtros e trocam o período pelo do bloco.
1376
1235
  *
1377
- * `DELETE /nota_fiscal/sincronizacao`
1236
+ * `GET /nota_fiscal/paginador`
1378
1237
  */
1379
- export declare function cancelar_sincronizacao_nota_fiscal(credencial_de_acesso: CredencialDeAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
1238
+ export declare function buscar_informacoes_paginador_nota_fiscal(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarInformacoesPaginadorNotaFiscal, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.NotaFiscalPaginador>;
1380
1239
  /**
1381
1240
  * Busca uma nota fiscal pelo id do Tiny
1382
1241
  *
@@ -1385,22 +1244,6 @@ export declare function cancelar_sincronizacao_nota_fiscal(credencial_de_acesso:
1385
1244
  * `GET /nota_fiscal/{id}`
1386
1245
  */
1387
1246
  export declare function buscar_pelo_id_nota_fiscal(credencial_de_acesso: CredencialDeAcesso, id: number, parametros?: ParametrosDeBuscarPeloIdNotaFiscal, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.NotaFiscal>;
1388
- /**
1389
- * Uma página da lista de Produtos do painel, por cursor
1390
- *
1391
- * Só colaborador interno (mesma regra da leitura de `produto_conflito_sincronizacao`). Lê a tabela `produto` inteira de um cache em memória (descartado a cada gravação em produto ou em conflito de sincronização, e recarregado do banco no máximo a cada 10 minutos), em ordem alfabética do nome (sem diferença de maiúscula; empate pelo id), e devolve só o array das 50 linhas da página. A paginação é por cursor: a primeira página vai sem `cursor`, e a seguinte manda em `cursor` o `id` da última linha recebida. `busca` (sem acento e sem maiúscula) procura o texto no nome ou no SKU. `ultima_sincronizacao` (data ISO, AAAA-MM-DD ou data e hora com fuso) é o início da última sincronização do painel: produto criado depois dela vem com `estado` `novo` e produto da API sincronizado depois dela, `mudou`; com conflito de sincronização pendente, `conflito`; senão, `em-dia`. Total e páginas vêm de `GET /painel_produto/paginador`, com a mesma `busca`.
1392
- *
1393
- * `GET /painel_produto`
1394
- */
1395
- export declare function buscar_paginador_painel_produto(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorPainelProduto, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.PainelProdutoLinha>>;
1396
- /**
1397
- * Total e páginas da lista de Produtos do painel
1398
- *
1399
- * Só colaborador interno (mesma regra da leitura de `produto_conflito_sincronizacao`). Recebe os mesmos parâmetros de `GET /painel_produto` (`cursor` e `ultima_sincronizacao` não mudam a conta) e devolve `total` (produtos com a `busca`), `paginas` (total dividido por `tamanho`, arredondado para cima, no mínimo 1) e `tamanho` (sempre 50).
1400
- *
1401
- * `GET /painel_produto/paginador`
1402
- */
1403
- export declare function buscar_informacoes_paginador_painel_produto(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarInformacoesPaginadorPainelProduto, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PainelProdutoPaginador>;
1404
1247
  /**
1405
1248
  * Lista os pedidos paginados
1406
1249
  *
@@ -1457,6 +1300,46 @@ export declare function atualizar_pelo_id_pedido(credencial_de_acesso: Credencia
1457
1300
  * `DELETE /pedido/{id}`
1458
1301
  */
1459
1302
  export declare function deletar_pelo_id_pedido(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
1303
+ /**
1304
+ * Envia um pedido para a IA montar
1305
+ *
1306
+ * Exige a permissão `criar` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Formulário `multipart/form-data` com `unidade_id` (uma unidade da sessão), `texto` (opcional, até 4000 caracteres) e até 5 campos `arquivo` (áudio MP3, M4A, OGG, OPUS, WAV ou WEBM; PDF; foto PNG, JPG ou WEBP; planilha XLSX ou CSV), cada um com até 20 MB e o envio inteiro com até 25 MB; é preciso mandar o texto ou ao menos um anexo. Grava o pedido com `status` `analisando` e responde na hora; a análise roda no servidor: os anexos vão para o TermoBucket (privados), tudo vira texto (PDF e planilha no próprio Portal, foto, PDF escaneado e áudio pelo TermoAI) e a IA de texto escolhida em Provedores procura cada item no catálogo e no boletim técnico. Os nomes que a unidade já vinculou na revisão (veja o `PATCH`) vão para a IA e fecham os itens com o mesmo nome. Se a IA falhar ou não achar nenhum item, cada linha do texto vira um item `nao_encontrado` para o cliente vincular, e `aviso` explica isso. Acompanhe por `GET /pedido_inteligente/{id}` até `status` virar `pronto` (com os `itens` para revisar) ou `erro` (com o motivo em `erro`). Cada unidade manda no máximo 20 pedidos por hora.
1307
+ *
1308
+ * `POST /pedido_inteligente`
1309
+ */
1310
+ export declare function criar_pedido_inteligente(credencial_de_acesso: CredencialDeAcesso, formulario: FormData, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PedidoInteligente>;
1311
+ /**
1312
+ * Busca pedidos inteligentes por filtro
1313
+ *
1314
+ * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Devolve os pedidos não excluídos, até 50 por página (`pagina`, a partir de 1, padrão 1), dos mais novos para os mais antigos. Quem não é colaborador interno precisa informar `unidade_id` de uma unidade da própria sessão; colaborador interno pode omitir e vê todos. `status` (`analisando`, `pronto`, `cotado`, `erro`) é exato; uma análise parada há mais de 10 minutos conta como `erro`.
1315
+ *
1316
+ * `GET /pedido_inteligente/filtro`
1317
+ */
1318
+ export declare function buscar_pelo_filtro_pedido_inteligente(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroPedidoInteligente, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.PedidoInteligente>>;
1319
+ /**
1320
+ * Busca um pedido inteligente pelo id
1321
+ *
1322
+ * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Pedido de uma unidade fora da sessão responde 404, como se não existisse. Depois da análise, cada anexo guardado traz `url`, um link de download do TermoBucket que vale 15 minutos. Cada item traz `pedido_do_cliente` (o trecho que o cliente escreveu), `situacao` (`encontrado`, `escolher`, `indisponivel` ou `nao_encontrado`), `quantidade`, `escolhido`, `opcoes` e `observacao` (como a IA entendeu o item); `aviso` aparece quando o pedido foi montado sem a IA; `cotacao_id` aparece quando o pedido já virou cotação.
1323
+ *
1324
+ * `GET /pedido_inteligente/{id}`
1325
+ */
1326
+ export declare function buscar_pelo_id_pedido_inteligente(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PedidoInteligente>;
1327
+ /**
1328
+ * Grava a revisão do cliente
1329
+ *
1330
+ * Exige a permissão `editar` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Só vale com `status` `pronto`. `itens` tem uma escolha por item do pedido, na mesma ordem: `produto_id` é o produto escolhido (nulo tira o item da cotação), `quantidade` vai de 0 a 9999 (acima de zero) e `remover` (opcional, padrão `false`) tira o item do pedido. O produto pode ser o `escolhido`, uma das `opcoes` ou qualquer produto ativo do catálogo; neste último caso a unidade guarda o vínculo entre o nome que o cliente escreveu e o produto, e os próximos pedidos com o mesmo nome já chegam com ele.
1331
+ *
1332
+ * `PATCH /pedido_inteligente/{id}`
1333
+ */
1334
+ export declare function atualizar_pelo_id_pedido_inteligente(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.PedidoInteligenteAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PedidoInteligente>;
1335
+ /**
1336
+ * Cancela um pedido inteligente
1337
+ *
1338
+ * Exige a permissão `excluir` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Exclusão lógica; uma análise em andamento para de gravar. O pedido que já virou cotação não sai (409).
1339
+ *
1340
+ * `DELETE /pedido_inteligente/{id}`
1341
+ */
1342
+ export declare function deletar_pelo_id_pedido_inteligente(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
1460
1343
  /**
1461
1344
  * Lista os pedidos de venda do ERP
1462
1345
  *
@@ -1484,19 +1367,11 @@ export declare function buscar_pelo_id_pedido_venda(credencial_de_acesso: Creden
1484
1367
  /**
1485
1368
  * Paginador dos pedidos de venda salvos no portal
1486
1369
  *
1487
- * Exige a permissão `ver` no módulo `Pedidos` do perfil de quem chama (administrador e master têm tudo). Quem não é colaborador interno precisa informar `unidade_id` de uma unidade da sessão e só recebe os pedidos do CNPJ dela, sem vendedor, canal e marcadores; colaborador interno pode omitir e ver todos. Lê a cópia dos pedidos de venda da Intranet salva no banco do portal (atualizada por `POST /pedido_venda_tiny`) e devolve só a paginação, sem os itens (eles vêm de `GET /pedido_venda_tiny/filtro`): `pagina`, `por_pagina` (sempre 50), `total_paginas`, `total_registros` da situação pedida, a contagem por situação e `sincronizado_em` (a última sincronização). Filtros iguais aos da lista: `situacao` (`todos`, `aberto`, `aprovado`, `faturado`, `pronto`, `enviado`, `entregue`, `cancelado`; padrão `todos`), `busca` (CNPJ/CPF, número do pedido ou nome do cliente), `inicio` e `fim` (AAAA-MM-DD, data do pedido) e `vendedor` (id do vendedor no Tiny, só para colaborador interno).
1370
+ * Exige a permissão `ver` no módulo `Pedidos` do perfil de quem chama (administrador e master têm tudo). Quem não é colaborador interno precisa informar `unidade_id` de uma unidade da sessão e só recebe os pedidos do CNPJ dela, sem vendedor, canal e marcadores; colaborador interno pode omitir e ver todos. Lê a cópia dos pedidos de venda da Intranet salva no banco do portal (atualizada pela sincronização do backend) e devolve só a paginação, sem os itens (eles vêm de `GET /pedido_venda_tiny/filtro`): `pagina`, `por_pagina` (sempre 50), `total_paginas`, `total_registros` da situação pedida, a contagem por situação e `sincronizado_em` (a última sincronização). Filtros iguais aos da lista: `situacao` (`todos`, `aberto`, `aprovado`, `faturado`, `pronto`, `enviado`, `entregue`, `cancelado`; padrão `todos`), `busca` (CNPJ/CPF, número do pedido ou nome do cliente), `inicio` e `fim` (AAAA-MM-DD, data do pedido) e `vendedor` (id do vendedor no Tiny, só para colaborador interno).
1488
1371
  *
1489
1372
  * `GET /pedido_venda_tiny`
1490
1373
  */
1491
1374
  export declare function buscar_paginador_pedido_venda_tiny(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorPedidoVendaTiny, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginadorPedidosVendaTiny>;
1492
- /**
1493
- * Sincroniza um lote de pedidos de venda com a Intranet
1494
- *
1495
- * Só colaborador interno com a permissão `ver` no módulo `Pedidos`. Lê 10 páginas (500 pedidos) da Intranet a partir de `pagina` (começa em 1) e grava no banco do portal, criando ou atualizando pelo id da Intranet. `modo`: `recentes` (padrão, os pedidos dos últimos 90 dias) ou `tudo` (todos os pedidos). Para sincronizar tudo, chame de novo com `proxima_pagina` até ela vir `null`. O backend também sincroniza sozinho: os últimos dias a cada 15 min e os últimos 90 dias a cada 6 h (`SINCRONIZACAO_*` no `.env`). Até 120 chamadas por minuto por pessoa.
1496
- *
1497
- * `POST /pedido_venda_tiny`
1498
- */
1499
- export declare function criar_pedido_venda_tiny(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.PedidoVendaTinySincronizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.SincronizacaoPedidosVendaTiny>;
1500
1375
  /**
1501
1376
  * Autocomplete dos pedidos de venda salvos no portal
1502
1377
  *
@@ -1521,62 +1396,6 @@ export declare function buscar_pelo_filtro_pedido_venda_tiny(credencial_de_acess
1521
1396
  * `GET /pedido_venda_tiny/{id}`
1522
1397
  */
1523
1398
  export declare function buscar_pelo_id_pedido_venda_tiny(credencial_de_acesso: CredencialDeAcesso, id: number, parametros?: ParametrosDeBuscarPeloIdPedidoVendaTiny, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PedidoVendaTiny>;
1524
- /**
1525
- * Lista os perfis paginados
1526
- *
1527
- * Exige só uma sessão válida (qualquer pessoa logada no portal). Ordem alfabética. Paginado com 50 itens por página (fixo); `pagina` começa em 1 (padrão 1). A resposta traz `itens`, `total` (registros que casam), `pagina` e `tamanho`.
1528
- *
1529
- * `GET /perfil`
1530
- */
1531
- export declare function buscar_paginador_perfil(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorPerfil, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaPerfil>;
1532
- /**
1533
- * Cadastra um perfil de acesso
1534
- *
1535
- * Exige perfil administrador ou master. Perfil de acesso (RBAC) das pessoas do portal. `nome` obrigatório, até 120 caracteres e único (o `slug` sai do nome); `resumo` até 500; `tipo` é `termotubos` ou `cliente`; `base: true` marca o perfil dado ao cliente novo (só um, só de cliente, nunca administrador); `permissoes` por módulo (`Dashboard`, `Pedidos`, `Financeiro`, `Catalogo`, `Cotacoes`, `Assistente`, `Configuracoes`) com `ver`, `criar`, `editar`, `excluir` e a exibição no menu; `permissoes_administrativas` entre `contexto_administrativo.entrar`, `unidades.ler`, `pedidos.ler_todos`, `cotacoes.ler_todas`, `financeiro.ler_todos` e `usuarios.gerenciar`. Cada item de `permissoes` tem `modulo`, `pagina` (página do módulo; `*` vale para o módulo inteiro, padrão), `ver`, `criar`, `editar`, `excluir` (booleanos) e `mostrar_na_sidebar` e `mostrar_nas_configuracoes` (booleanos, exibição no menu). Campos: `base` (booleano) marca o perfil dado ao cliente novo (só um, só de cliente).
1536
- *
1537
- * `POST /perfil`
1538
- */
1539
- export declare function criar_perfil(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.PerfilCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Perfil>;
1540
- /**
1541
- * Lista básica de perfis para seleção
1542
- *
1543
- * Exige só uma sessão válida (qualquer pessoa logada no portal). Devolve só id e nome, em ordem alfabética. `busca` procura no nome. `tamanho` tem padrão 10 e vai de 1 a 50; `pagina` começa em 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`.
1544
- *
1545
- * `GET /perfil/autocomplete`
1546
- */
1547
- export declare function buscar_auto_complete_perfil(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompletePerfil, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaPerfilAutoComplete>;
1548
- /**
1549
- * Busca perfis por filtro
1550
- *
1551
- * Exige só uma sessão válida (qualquer pessoa logada no portal). Devolve os perfis não excluídos que casam com o filtro, até 50 por página (`pagina`, a partir de 1, padrão 1), em ordem alfabética. `nome` procura o trecho; `slug`, `base` e `tipo` são exatos.
1552
- *
1553
- * `GET /perfil/filtro`
1554
- */
1555
- export declare function buscar_pelo_filtro_perfil(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroPerfil, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Perfil>>;
1556
- /**
1557
- * Busca um perfil pelo id
1558
- *
1559
- * Exige só uma sessão válida (qualquer pessoa logada no portal). Perfil excluído não é encontrado. Traz permissões e quantidade de pessoas.
1560
- *
1561
- * `GET /perfil/{id}`
1562
- */
1563
- export declare function buscar_pelo_id_perfil(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Perfil>;
1564
- /**
1565
- * Atualiza um perfil de acesso
1566
- *
1567
- * Exige perfil administrador ou master. Mesmas regras do cadastro; o tipo não muda. `permissoes` e `permissoes_administrativas`, quando enviados, substituem as anteriores. Cada item de `permissoes` tem `modulo`, `pagina` (página do módulo; `*` vale para o módulo inteiro, padrão), `ver`, `criar`, `editar`, `excluir` (booleanos) e `mostrar_na_sidebar` e `mostrar_nas_configuracoes` (booleanos, exibição no menu). Atualização parcial: campo ausente mantém o valor atual. Campos: `nome` é obrigatório quando enviado (mesmo limite do cadastro); `resumo` até 500 caracteres; `base` (booleano) marca o perfil dado ao cliente novo (só um, só de cliente).
1568
- *
1569
- * `PATCH /perfil/{id}`
1570
- */
1571
- export declare function atualizar_pelo_id_perfil(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.PerfilAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Perfil>;
1572
- /**
1573
- * Exclui um perfil de acesso
1574
- *
1575
- * Exige perfil administrador ou master. Recusa o perfil base e perfis com pessoas vinculadas. A exclusão é lógica: o registro some das leituras, mas a linha não é apagada.
1576
- *
1577
- * `DELETE /perfil/{id}`
1578
- */
1579
- export declare function deletar_pelo_id_perfil(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
1580
1399
  /**
1581
1400
  * Lista os produtos paginados
1582
1401
  *
@@ -1633,62 +1452,6 @@ export declare function atualizar_pelo_id_produto(credencial_de_acesso: Credenci
1633
1452
  * `DELETE /produto/{id}`
1634
1453
  */
1635
1454
  export declare function deletar_pelo_id_produto(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
1636
- /**
1637
- * Lista os conflitos de sincronização paginados
1638
- *
1639
- * Exige só uma sessão válida (qualquer pessoa logada no portal). Dos mais novos para os mais antigos; `resolvido` opcional filtra. Paginado com 50 itens por página (fixo); `pagina` começa em 1 (padrão 1). A resposta traz `itens`, `total` (registros que casam), `pagina` e `tamanho`.
1640
- *
1641
- * `GET /produto_conflito_sincronizacao`
1642
- */
1643
- export declare function buscar_paginador_produto_conflito_sincronizacao(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorProdutoConflitoSincronizacao, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaProdutoConflitoSincronizacao>;
1644
- /**
1645
- * Registra um conflito de sincronização de produto
1646
- *
1647
- * Exige a permissão `criar` no módulo `Configuracoes` do perfil de quem chama (administrador e master têm tudo). Conflito entre o valor do portal e o da API da Termotubos (Tiny) num campo monitorado do produto. `campo` é `preco`, `preco_a_vista` ou `estoque`; `valor_local` e `valor_api` em texto (o da API precisa ser numérico). Campos: `produto_id` (uuid) é o produto do conflito.
1648
- *
1649
- * `POST /produto_conflito_sincronizacao`
1650
- */
1651
- export declare function criar_produto_conflito_sincronizacao(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.ProdutoConflitoSincronizacaoCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ProdutoConflitoSincronizacao>;
1652
- /**
1653
- * Lista básica de conflitos de sincronização para seleção
1654
- *
1655
- * Exige só uma sessão válida (qualquer pessoa logada no portal). Devolve id e `rotulo` (`SKU - campo`), em ordem alfabética. `busca` procura no SKU e no campo; `resolvido` filtra. `tamanho` tem padrão 10 e vai de 1 a 50; `pagina` começa em 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`.
1656
- *
1657
- * `GET /produto_conflito_sincronizacao/autocomplete`
1658
- */
1659
- export declare function buscar_auto_complete_produto_conflito_sincronizacao(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteProdutoConflitoSincronizacao, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaProdutoConflitoSincronizacaoAutoComplete>;
1660
- /**
1661
- * Busca conflitos de sincronização por filtro
1662
- *
1663
- * Exige só uma sessão válida (qualquer pessoa logada no portal). Devolve os conflitos não excluídos que casam com o filtro, até 50 por página (`pagina`, a partir de 1, padrão 1), dos mais novos para os mais antigos. `produto_id` e `campo` são exatos; `resolvido` separa pendentes (`false`) e resolvidos (`true`).
1664
- *
1665
- * `GET /produto_conflito_sincronizacao/filtro`
1666
- */
1667
- export declare function buscar_pelo_filtro_produto_conflito_sincronizacao(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroProdutoConflitoSincronizacao, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.ProdutoConflitoSincronizacao>>;
1668
- /**
1669
- * Busca um conflito de sincronização pelo id
1670
- *
1671
- * Exige só uma sessão válida (qualquer pessoa logada no portal). Conflito excluído não é encontrado. Traz SKU e nome do produto.
1672
- *
1673
- * `GET /produto_conflito_sincronizacao/{id}`
1674
- */
1675
- export declare function buscar_pelo_id_produto_conflito_sincronizacao(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ProdutoConflitoSincronizacao>;
1676
- /**
1677
- * Resolve um conflito de sincronização
1678
- *
1679
- * Exige a permissão `editar` no módulo `Configuracoes` do perfil de quem chama (administrador e master têm tudo). Resolve um conflito pendente: `resolucao` `local` mantém o valor do portal e `api` aplica o valor da API no produto.
1680
- *
1681
- * `PATCH /produto_conflito_sincronizacao/{id}`
1682
- */
1683
- export declare function atualizar_pelo_id_produto_conflito_sincronizacao(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ProdutoConflitoSincronizacaoAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ProdutoConflitoSincronizacao>;
1684
- /**
1685
- * Exclui um conflito de sincronização
1686
- *
1687
- * Exige a permissão `excluir` no módulo `Configuracoes` do perfil de quem chama (administrador e master têm tudo). A exclusão é lógica: o registro some das leituras, mas a linha não é apagada.
1688
- *
1689
- * `DELETE /produto_conflito_sincronizacao/{id}`
1690
- */
1691
- export declare function deletar_pelo_id_produto_conflito_sincronizacao(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
1692
1455
  /**
1693
1456
  * Busca as embalagens e os componentes de um produto
1694
1457
  *
@@ -1697,46 +1460,6 @@ export declare function deletar_pelo_id_produto_conflito_sincronizacao(credencia
1697
1460
  * `GET /produto_estrutura/filtro`
1698
1461
  */
1699
1462
  export declare function buscar_pelo_filtro_produto_estrutura(credencial_de_acesso: CredencialDeAcesso, parametros: ParametrosDeBuscarPeloFiltroProdutoEstrutura, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ProdutoEstrutura>;
1700
- /**
1701
- * Importa ou sincroniza produtos do Tiny pelo SKU
1702
- *
1703
- * Exige a permissão `criar` no módulo `Configuracoes` do perfil de quem chama (administrador e master têm tudo). Importa no portal os produtos do Tiny pelos `skus` (1 a 100 por vez; vazios e repetidos são descartados). Produto novo é criado; produto que já existe é atualizado, e diferença de preço ou estoque em produto com preço definido no portal vira conflito de sincronização. Responde 200 com o resultado de cada SKU (`criado`, `atualizado`, `conflito` ou `falha`) e os totais. Até 10 chamadas por minuto por pessoa.
1704
- *
1705
- * `POST /produto_termotubos`
1706
- */
1707
- export declare function criar_produto_termotubos(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.ProdutoTermotubosCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ImportacaoProdutos>;
1708
- /**
1709
- * Busca produtos no catálogo da Termotubos (Tiny)
1710
- *
1711
- * Exige a permissão `ver` no módulo `Configuracoes` do perfil de quem chama (administrador e master têm tudo). Consulta o catálogo do Tiny pela API da Termotubos para importar produtos no portal. `busca` aceita SKUs separados por vírgula, ponto e vírgula ou espaço; termo terminado em `*` busca pelo prefixo (ex.: `B68*`). `apenas_ativos` filtra; `pagina` começa em 1 e `por_pagina` tem padrão 20 e vai de 1 a 50 (vale também para a busca por termos, paginada no servidor com `tem_mais`, `total_paginas` e `total_registros`). Cada item diz se já existe no portal (`ja_existe`). Termos inválidos voltam em `termos_invalidos`; `truncado: true` indica que a busca por prefixo foi cortada. Até 30 chamadas por minuto por pessoa.
1712
- *
1713
- * `GET /produto_termotubos/filtro`
1714
- */
1715
- export declare function buscar_pelo_filtro_produto_termotubos(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroProdutoTermotubos, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.BuscaTermotubos>;
1716
- /**
1717
- * Status da sincronização do catálogo com o Tiny
1718
- *
1719
- * Exige a permissão `ver` no módulo `Configuracoes`. Devolve a sincronização em andamento ou a última que terminou: `etapa` (`lendo` ou `gravando`), `gravados` de `total`, `cancelada`, `erro` e o `resumo` (conferidos, criados, atualizados, conflitos e falhas).
1720
- *
1721
- * `GET /produto_termotubos/sincronizacao`
1722
- */
1723
- export declare function buscar_sincronizacao_produto_termotubos(credencial_de_acesso: CredencialDeAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.StatusSincronizacaoCatalogo>;
1724
- /**
1725
- * Inicia a sincronização do catálogo com o Tiny em segundo plano
1726
- *
1727
- * Exige a permissão `criar` no módulo `Configuracoes`. Lê o catálogo do Tiny e grava no portal o que é novo ou mudou, em segundo plano no servidor: a tela pode ser fechada. `apenas_ativos` lê só os produtos ativos. Responde 202 com o status inicial; acompanhe por `GET /produto_termotubos/sincronizacao`. O status fica em memória e se perde se o servidor reiniciar.
1728
- *
1729
- * `POST /produto_termotubos/sincronizacao`
1730
- */
1731
- export declare function iniciar_sincronizacao_produto_termotubos(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeIniciarSincronizacaoProdutoTermotubos, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.StatusSincronizacaoCatalogo>;
1732
- /**
1733
- * Cancela a sincronização do catálogo em andamento
1734
- *
1735
- * Exige a permissão `excluir` no módulo `Configuracoes`. Para depois do lote em gravação; o que já foi gravado fica.
1736
- *
1737
- * `DELETE /produto_termotubos/sincronizacao`
1738
- */
1739
- export declare function cancelar_sincronizacao_produto_termotubos(credencial_de_acesso: CredencialDeAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
1740
1463
  /**
1741
1464
  * Busca os dados internos de um produto no Tiny
1742
1465
  *
@@ -1769,30 +1492,6 @@ export declare function buscar_auto_complete_rastreamento(credencial_de_acesso:
1769
1492
  * `GET /rastreamento/paginador`
1770
1493
  */
1771
1494
  export declare function buscar_informacoes_paginador_rastreamento(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarInformacoesPaginadorRastreamento, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.RastreamentoPaginador>;
1772
- /**
1773
- * Status da sincronização das entregas
1774
- *
1775
- * Só colaborador interno com `ver` no módulo `Pedidos`. Devolve a sincronização em andamento ou a última que terminou: `rodando`, `pagina` de `total_paginas` (páginas da API), `progresso` (percentual), `gravados`, `cancelada`, `concluida`, `erro`, `iniciada_em` e `terminada_em`.
1776
- *
1777
- * `GET /rastreamento/sincronizacao`
1778
- */
1779
- export declare function buscar_sincronizacao_rastreamento(credencial_de_acesso: CredencialDeAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.StatusSincronizacaoRastreamento>;
1780
- /**
1781
- * Inicia a sincronização das entregas em segundo plano
1782
- *
1783
- * Só colaborador interno com `ver` no módulo `Pedidos`. Traz as entregas (expedições) da API de logística da Termotubos para a tabela `rastreamento`, sem filtro de data (histórico inteiro), lote por lote, em segundo plano no servidor: a tela pode ser fechada. Responde 202 com o status inicial; acompanhe por `GET /rastreamento/sincronizacao`. O status fica em memória e se perde se o servidor reiniciar.
1784
- *
1785
- * `POST /rastreamento/sincronizacao`
1786
- */
1787
- export declare function iniciar_sincronizacao_rastreamento(credencial_de_acesso: CredencialDeAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.StatusSincronizacaoRastreamento>;
1788
- /**
1789
- * Cancela a sincronização das entregas em andamento
1790
- *
1791
- * Só colaborador interno com `ver` no módulo `Pedidos`. Para antes do próximo lote; o que já foi gravado fica.
1792
- *
1793
- * `DELETE /rastreamento/sincronizacao`
1794
- */
1795
- export declare function cancelar_sincronizacao_rastreamento(credencial_de_acesso: CredencialDeAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
1796
1495
  /**
1797
1496
  * Busca uma entrega pelo id da logística
1798
1497
  *
@@ -1801,62 +1500,6 @@ export declare function cancelar_sincronizacao_rastreamento(credencial_de_acesso
1801
1500
  * `GET /rastreamento/{id}`
1802
1501
  */
1803
1502
  export declare function buscar_pelo_id_rastreamento(credencial_de_acesso: CredencialDeAcesso, id: number, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Rastreamento>;
1804
- /**
1805
- * Lista os valores auxiliares paginados
1806
- *
1807
- * Exige sessão. Ordenado por tabela, campo e label. `tabela` e `campo` filtram (opcionais). Paginado com 50 itens por página (fixo); `pagina` começa em 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`.
1808
- *
1809
- * `GET /tabela_auxiliar`
1810
- */
1811
- export declare function buscar_paginador_tabela_auxiliar(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorTabelaAuxiliar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaTabelaAuxiliar>;
1812
- /**
1813
- * Cadastra um valor auxiliar
1814
- *
1815
- * Exige o módulo `Configuracoes` (criar). Valor de um campo que chega das integrações sem cadastro próprio (ex.: `tabela=produto`, `campo=marca_tiny`). `tabela`, `campo` e `label` obrigatórios; o trio é único. A sincronização do catálogo preenche a tabela sozinha.
1816
- *
1817
- * `POST /tabela_auxiliar`
1818
- */
1819
- export declare function criar_tabela_auxiliar(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.TabelaAuxiliarCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.TabelaAuxiliar>;
1820
- /**
1821
- * Lista básica de valores de um campo para seleção
1822
- *
1823
- * Exige sessão. `tabela` e `campo` obrigatórios (ex.: `produto` e `marca_tiny`). Devolve só id e label, em ordem alfabética. `busca` procura no label. `tamanho` tem padrão 10 e vai de 1 a 50; `pagina` começa em 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`.
1824
- *
1825
- * `GET /tabela_auxiliar/autocomplete`
1826
- */
1827
- export declare function buscar_auto_complete_tabela_auxiliar(credencial_de_acesso: CredencialDeAcesso, parametros: ParametrosDeBuscarAutoCompleteTabelaAuxiliar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaTabelaAuxiliarAutoComplete>;
1828
- /**
1829
- * Busca valores auxiliares por filtro
1830
- *
1831
- * Exige sessão. Até 50 por página (`pagina`, a partir de 1, padrão 1). `tabela` e `campo` são exatos; `label` procura o trecho.
1832
- *
1833
- * `GET /tabela_auxiliar/filtro`
1834
- */
1835
- export declare function buscar_pelo_filtro_tabela_auxiliar(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroTabelaAuxiliar, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.TabelaAuxiliar>>;
1836
- /**
1837
- * Busca um valor auxiliar pelo id
1838
- *
1839
- * Exige sessão. Registro excluído não é encontrado.
1840
- *
1841
- * `GET /tabela_auxiliar/{id}`
1842
- */
1843
- export declare function buscar_pelo_id_tabela_auxiliar(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.TabelaAuxiliar>;
1844
- /**
1845
- * Atualiza o label de um valor auxiliar
1846
- *
1847
- * Exige o módulo `Configuracoes` (editar). Muda só o `label`; campo ausente mantém o valor atual.
1848
- *
1849
- * `PATCH /tabela_auxiliar/{id}`
1850
- */
1851
- export declare function atualizar_pelo_id_tabela_auxiliar(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.TabelaAuxiliarAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.TabelaAuxiliar>;
1852
- /**
1853
- * Exclui um valor auxiliar
1854
- *
1855
- * Exige o módulo `Configuracoes` (excluir). A exclusão é lógica: o registro some das leituras, mas a linha não é apagada.
1856
- *
1857
- * `DELETE /tabela_auxiliar/{id}`
1858
- */
1859
- export declare function deletar_pelo_id_tabela_auxiliar(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
1860
1503
  /**
1861
1504
  * Lista as unidades paginadas
1862
1505
  *