termo_core 0.1.0 → 0.1.2

package/dist/bucket/tipos.d.ts

@@ -1,38 +1,3 @@
-export interface AcessoAtual {
-    email: string;
-    id: string;
-    master: boolean;
-    nome: string;
-    perfil: string;
-    perfil_acesso?: string | null;
-    permissoes: Permissoes;
-}
-export interface Acoes {
-    criar?: boolean;
-    deletar?: boolean;
-    editar?: boolean;
-    ler?: boolean;
-}
-export interface Aplicativo {
-    arquivos_privados: number;
-    arquivos_publicos: number;
-    ativo: boolean;
-    atualizado_em: string;
-    bytes_privados: number;
-    bytes_publicos: number;
-    criado_em: string;
-    id: string;
-    nome: string;
-    slug: string;
-    tamanho_maximo: number;
-    tipos_permitidos: Array<string>;
-}
-export interface AplicativoAtualizar {
-    ativo?: boolean | null;
-    nome?: string | null;
-    tamanho_maximo?: number | null;
-    tipos_permitidos?: Array<string> | null;
-}
 export interface ArmazenamentoDoMes {
     arquivos: number;
     arquivos_enviados: number;
@@ -70,49 +35,6 @@ export interface ArquivoCriar {
     tamanho: number;
     tipo: string;
 }
-export interface ArquivosApagados {
-    objetos_apagados: number;
-    registros_apagados: number;
-}
-export interface Auth {
-    ativo: boolean;
-    atualizado_em: string;
-    bloqueado_ate?: string | null;
-    criado_em: string;
-    email: string;
-    id: string;
-    master: boolean;
-    nome?: string | null;
-    perfil: string;
-    termoauth_id?: string | null;
-    ultimo_login_em?: string | null;
-    vinculado: boolean;
-}
-export interface AuthAtualizar {
-    ativo?: boolean | null;
-    email?: string | null;
-}
-export interface AuthCriar {
-    email: string;
-    perfil: string;
-}
-export interface Colaborador {
-    ativo: boolean;
-    atualizado_em: string;
-    auth_id: string;
-    cargo?: string | null;
-    criado_em: string;
-    email: string;
-    id: string;
-    master: boolean;
-    nome: string;
-    perfil_acesso?: string | null;
-    perfil_acesso_id?: string | null;
-    telefone?: string | null;
-}
-export interface ColaboradorVincularPerfilAcesso {
-    perfil_acesso_id?: string | null;
-}
 export interface ConsumoDoAplicativo {
     arquivos: number;
     bytes: number;
@@ -125,37 +47,6 @@ export interface EnviosDoDia {
     bytes: number;
     dia: string;
 }
-export interface PaginaAplicativoItensItem {
-    arquivos_privados: number;
-    arquivos_publicos: number;
-    ativo: boolean;
-    atualizado_em: string;
-    bytes_privados: number;
-    bytes_publicos: number;
-    criado_em: string;
-    id: string;
-    nome: string;
-    slug: string;
-    tamanho_maximo: number;
-    tipos_permitidos: Array<string>;
-}
-export interface PaginaAplicativo {
-    itens: Array<PaginaAplicativoItensItem>;
-    pagina: number;
-    tamanho: number;
-    total: number;
-}
-export interface PaginaAplicativoAutoCompleteItensItem {
-    id: string;
-    nome: string;
-    slug: string;
-}
-export interface PaginaAplicativoAutoComplete {
-    itens: Array<PaginaAplicativoAutoCompleteItensItem>;
-    pagina: number;
-    tamanho: number;
-    total: number;
-}
 export interface PaginaArquivoItensItem {
     app: string;
     atualizado_em: string;
@@ -174,136 +65,6 @@ export interface PaginaArquivo {
     tamanho: number;
     total: number;
 }
-export interface PaginaAuthItensItem {
-    ativo: boolean;
-    atualizado_em: string;
-    bloqueado_ate?: string | null;
-    criado_em: string;
-    email: string;
-    id: string;
-    master: boolean;
-    nome?: string | null;
-    perfil: string;
-    termoauth_id?: string | null;
-    ultimo_login_em?: string | null;
-    vinculado: boolean;
-}
-export interface PaginaAuth {
-    itens: Array<PaginaAuthItensItem>;
-    pagina: number;
-    tamanho: number;
-    total: number;
-}
-export interface PaginaAuthAutoCompleteItensItem {
-    email: string;
-    id: string;
-    perfil: string;
-}
-export interface PaginaAuthAutoComplete {
-    itens: Array<PaginaAuthAutoCompleteItensItem>;
-    pagina: number;
-    tamanho: number;
-    total: number;
-}
-export interface PaginaColaboradorItensItem {
-    ativo: boolean;
-    atualizado_em: string;
-    auth_id: string;
-    cargo?: string | null;
-    criado_em: string;
-    email: string;
-    id: string;
-    master: boolean;
-    nome: string;
-    perfil_acesso?: string | null;
-    perfil_acesso_id?: string | null;
-    telefone?: string | null;
-}
-export interface PaginaColaborador {
-    itens: Array<PaginaColaboradorItensItem>;
-    pagina: number;
-    tamanho: number;
-    total: number;
-}
-export interface PaginaColaboradorAutoCompleteItensItem {
-    email: string;
-    id: string;
-    nome: string;
-}
-export interface PaginaColaboradorAutoComplete {
-    itens: Array<PaginaColaboradorAutoCompleteItensItem>;
-    pagina: number;
-    tamanho: number;
-    total: number;
-}
-export interface PaginaLogItensItem {
-    cabecalhos: unknown;
-    caminho: string;
-    consulta?: string | null;
-    corpo_requisicao?: string | null;
-    corpo_resposta?: string | null;
-    criado_em: string;
-    duracao_ms: number;
-    id: string;
-    ip?: string | null;
-    metodo: string;
-    status: number;
-}
-export interface PaginaLog {
-    itens: Array<PaginaLogItensItem>;
-    pagina: number;
-    tamanho: number;
-    total: number;
-}
-export interface PaginaPerfilAcessoItensItem {
-    atualizado_em: string;
-    colaboradores: number;
-    criado_em: string;
-    descricao?: string | null;
-    id: string;
-    nome: string;
-    permissoes: Permissoes;
-}
-export interface PaginaPerfilAcesso {
-    itens: Array<PaginaPerfilAcessoItensItem>;
-    pagina: number;
-    tamanho: number;
-    total: number;
-}
-export interface PaginaPerfilAcessoAutoCompleteItensItem {
-    id: string;
-    nome: string;
-}
-export interface PaginaPerfilAcessoAutoComplete {
-    itens: Array<PaginaPerfilAcessoAutoCompleteItensItem>;
-    pagina: number;
-    tamanho: number;
-    total: number;
-}
-export interface PerfilAcesso {
-    atualizado_em: string;
-    colaboradores: number;
-    criado_em: string;
-    descricao?: string | null;
-    id: string;
-    nome: string;
-    permissoes: Permissoes;
-}
-export interface PerfilAcessoAtualizar {
-    descricao?: string | null;
-    nome?: string | null;
-    permissoes?: Permissoes | null;
-}
-export interface PerfilAcessoCriar {
-    descricao?: string | null;
-    nome: string;
-    permissoes?: Permissoes;
-}
-export interface Permissoes {
-    aplicativos?: Acoes;
-    colaboradores?: Acoes;
-    configuracoes?: Acoes;
-}
 export interface RespostaDeErro {
     erro: string;
 }
@@ -318,13 +79,3 @@ export interface Resumo {
     consumo_por_aplicativo: Array<ConsumoDoAplicativo>;
     envios_por_dia: Array<EnviosDoDia>;
 }
-export interface SaudeDoBackend {
-    mensagem: string;
-    sucesso: boolean;
-    versao: string;
-}
-export interface VersaoDoBackend {
-    sucesso: boolean;
-    versao: string;
-    versao_backend: string;
-}

package/dist/portal/rotas.d.ts

@@ -156,53 +156,6 @@ export interface ParametrosDeBuscarInformacoesPaginadorCliente {
     unidade_id?: string;
     cursor?: string;
 }
-/**
- * Parâmetros de consulta e de cabeçalho de `/colaborador`.
- */
-export interface ParametrosDeBuscarPaginadorColaborador {
-    pagina?: number;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/colaborador/autocomplete`.
- */
-export interface ParametrosDeBuscarAutoCompleteColaborador {
-    busca?: string;
-    status?: string;
-    pagina?: number;
-    tamanho?: number;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/colaborador/filtro`.
- */
-export interface ParametrosDeBuscarPeloFiltroColaborador {
-    nome?: string;
-    email?: string;
-    status?: string;
-    perfil_id?: string;
-    pagina?: number;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/configuracao`.
- */
-export interface ParametrosDeBuscarPaginadorConfiguracao {
-    pagina?: number;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/configuracao/autocomplete`.
- */
-export interface ParametrosDeBuscarAutoCompleteConfiguracao {
-    busca?: string;
-    pagina?: number;
-    tamanho?: number;
-}
-/**
- * Parâmetros de consulta e de cabeçalho de `/configuracao/filtro`.
- */
-export interface ParametrosDeBuscarPeloFiltroConfiguracao {
-    chave?: string;
-    prefixo?: string;
-    pagina?: number;
-}
 /**
  * Parâmetros de consulta e de cabeçalho de `/contato`.
  */
@@ -586,8 +539,6 @@ export interface ParametrosDeBuscarPaginadorProduto {
     enriquecido?: boolean;
     unidade?: string;
     cor?: string;
-    material?: string;
-    diametro?: string;
     categoria_tiny?: string;
     marca_tiny?: string;
     criado_desde?: string;
@@ -630,8 +581,6 @@ export interface ParametrosDeBuscarPeloFiltroProduto {
     enriquecido?: boolean;
     unidade?: string;
     cor?: string;
-    material?: string;
-    diametro?: string;
     categoria_tiny?: string;
     marca_tiny?: string;
     criado_desde?: string;
@@ -788,14 +737,6 @@ export interface ParametrosDeBuscarPeloFiltroUnidade {
     cliente_id?: string;
     pagina?: number;
 }
-/**
- * Versão da API
- *
- * Rota pública: não exige sessão. Confere se a API está no ar e devolve a versão publicada do backend.
- *
- * `GET /`
- */
-export declare function buscar_pelo_id_versao(opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.VersaoDaApi>;
 /**
  * Envia um arquivo (imagem ou PDF de boletim)
  *
@@ -1116,134 +1057,6 @@ export declare function atualizar_pelo_id_cliente(credencial_de_acesso: Credenci
  * `DELETE /cliente/{id}`
  */
 export declare function deletar_pelo_id_cliente(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
-/**
- * Lista colaboradores paginados
- *
- * Colaborador é o usuário da Termotubos: entra pela área `/painel` e também pode abrir o `/app`. Exige colaborador interno.
- *
- * `GET /colaborador`
- */
-export declare function buscar_paginador_colaborador(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorColaborador, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaColaborador>;
-/**
- * Cadastra o colaborador
- *
- * Colaborador é o usuário da Termotubos: entra pela área `/painel` e também pode abrir o `/app`. Exige colaborador interno com `usuarios.gerenciar`. `perfil_id` de colaborador (sem ele vale o perfil `acesso-inicial`, só leitura); só administrador atribui perfil de administrador.
- *
- * `POST /colaborador`
- */
-export declare function criar_colaborador(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.ColaboradorCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Colaborador>;
-/**
- * Lista básica de colaboradores para seleção
- *
- * Colaborador é o usuário da Termotubos: entra pela área `/painel` e também pode abrir o `/app`. Exige colaborador interno. Devolve id, nome e e-mail em ordem alfabética; `busca` procura no nome e no e-mail; `tamanho` de 1 a 50 (padrão 10).
- *
- * `GET /colaborador/autocomplete`
- */
-export declare function buscar_auto_complete_colaborador(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteColaborador, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaColaboradorAutoComplete>;
-/**
- * Busca colaboradores por filtro
- *
- * Colaborador é o usuário da Termotubos: entra pela área `/painel` e também pode abrir o `/app`. Exige colaborador interno. Até 50 por página (`pagina`, a partir de 1, padrão 1), em ordem alfabética; `nome` e `email` procuram o trecho, os demais são exatos.
- *
- * `GET /colaborador/filtro`
- */
-export declare function buscar_pelo_filtro_colaborador(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroColaborador, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Colaborador>>;
-/**
- * Busca o colaborador pelo id
- *
- * Colaborador é o usuário da Termotubos: entra pela área `/painel` e também pode abrir o `/app`. Exige colaborador interno.
- *
- * `GET /colaborador/{id}`
- */
-export declare function buscar_pelo_id_colaborador(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Colaborador>;
-/**
- * Atualiza o colaborador
- *
- * Colaborador é o usuário da Termotubos: entra pela área `/painel` e também pode abrir o `/app`. Atualização parcial. Exige colaborador interno com `usuarios.gerenciar`; o próprio colaborador só altera nome, telefone, cargo e `presente` (heartbeat que grava `ultimo_acesso_em`).
- *
- * `PATCH /colaborador/{id}`
- */
-export declare function atualizar_pelo_id_colaborador(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ColaboradorAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Colaborador>;
-/**
- * Exclui o colaborador
- *
- * Colaborador é o usuário da Termotubos: entra pela área `/painel` e também pode abrir o `/app`. Exige colaborador interno com `usuarios.gerenciar`. Exclusão lógica.
- *
- * `DELETE /colaborador/{id}`
- */
-export declare function deletar_pelo_id_colaborador(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
-/**
- * Lista as configurações paginadas
- *
- * Exige só uma sessão válida (qualquer pessoa logada no portal). Ordem de chave. 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`.
- *
- * `GET /configuracao`
- */
-export declare function buscar_paginador_configuracao(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorConfiguracao, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaConfiguracao>;
-/**
- * Grava uma configuração do portal
- *
- * Exige a permissão `criar` no módulo `Configuracoes` do perfil de quem chama (administrador e master têm tudo). Configuração chave/valor do portal (vitrine). `chave` precisa ser uma das chaves conhecidas (ex.: `produtos_mostrar_preco`) e `valor` (texto) segue o tipo da chave: booleano `true`/`false`, hora `HH:MM`, decimal ou texto com limite. Cada chave existe uma vez só.
- *
- * `POST /configuracao`
- */
-export declare function criar_configuracao(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.ConfiguracaoCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Configuracao>;
-/**
- * Lista básica de configurações para seleção
- *
- * Exige só uma sessão válida (qualquer pessoa logada no portal). Devolve só id e chave, em ordem de chave. `busca` procura o trecho na chave. `tamanho` tem padrão 10 e vai de 1 a 50; `pagina` começa em 1. A resposta traz `itens`, `total`, `pagina` e `tamanho`.
- *
- * `GET /configuracao/autocomplete`
- */
-export declare function buscar_auto_complete_configuracao(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteConfiguracao, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaConfiguracaoAutoComplete>;
-/**
- * Busca configurações por filtro
- *
- * Exige só uma sessão válida (qualquer pessoa logada no portal). Devolve as configurações não excluídas que casam com o filtro, até 50 por página (`pagina`, a partir de 1, padrão 1), em ordem de chave. `chave` é exata; `prefixo` pega as chaves que começam com o texto (ex.: `produtos_`).
- *
- * `GET /configuracao/filtro`
- */
-export declare function buscar_pelo_filtro_configuracao(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroConfiguracao, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Configuracao>>;
-/**
- * Busca uma configuração pelo id
- *
- * Exige só uma sessão válida (qualquer pessoa logada no portal). Configuração excluída não é encontrada.
- *
- * `GET /configuracao/{id}`
- */
-export declare function buscar_pelo_id_configuracao(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Configuracao>;
-/**
- * Atualiza o valor de uma configuração
- *
- * Exige a permissão `editar` no módulo `Configuracoes` do perfil de quem chama (administrador e master têm tudo). Troca o `valor`, validado pelo tipo da chave.
- *
- * `PATCH /configuracao/{id}`
- */
-export declare function atualizar_pelo_id_configuracao(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ConfiguracaoAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Configuracao>;
-/**
- * Exclui uma configuração
- *
- * 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.
- *
- * `DELETE /configuracao/{id}`
- */
-export declare function deletar_pelo_id_configuracao(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
-/**
- * Mostra a situação do segredo do app gerado no TermoAuth
- *
- * Só um master do TermoAuth (e-mail `@termotubos.com.br`) lê. Nunca devolve o valor: `segredo_do_app_gerado_no_termo_auth` traz só `configurado` e o final mascarado (`final_visivel`). `criptografia_disponivel` é falso quando o servidor está sem a `GLOBAL_SECRET_CRIPTOGRAFIA`; nesse caso o segredo aparece como não configurado.
- *
- * `GET /configuracao_provedor`
- */
-export declare function buscar_pelo_id_configuracao_provedor(credencial_de_acesso: CredencialDeAcesso, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ConfiguracaoProvedor>;
-/**
- * Grava ou limpa o segredo do app gerado no TermoAuth
- *
- * Só um master do TermoAuth (e-mail `@termotubos.com.br`) grava. O segredo do app `portal-b2b` é guardado cifrado (AES-256-GCM com a `GLOBAL_SECRET_CRIPTOGRAFIA`) e entregue na hora ao `termo_core`, sem deploy. Campo ausente não muda nada, texto troca o segredo e `null` (ou texto vazio) limpa. No máximo 2.000 caracteres, sem quebra de linha.
- *
- * `PATCH /configuracao_provedor`
- */
-export declare function atualizar_pelo_id_configuracao_provedor(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.ConfiguracaoProvedorAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ConfiguracaoProvedor>;
 /**
  * Lista os contatos paginados
  *
@@ -1524,6 +1337,22 @@ export declare function buscar_pelo_filtro_indicador_compra(credencial_de_acesso
  * `GET /indicador_venda/filtro`
  */
 export declare function buscar_pelo_filtro_indicador_venda(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroIndicadorVenda, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.IndicadoresDeVenda>;
+/**
+ * Gera um link de envio de imagem para o produto do SKU
+ *
+ * Exige colaborador interno com a permissão `editar` no módulo `Configuracoes`. Serve para enviar a imagem de um arquivo local (ex.: uma pasta do computador) sem passar o conteúdo pela ferramenta: gere um link por imagem e envie o arquivo direto para a `url_envio` com `curl -X PATCH -F "arquivo=@<caminho do arquivo>" <url_envio>` (sem token: o link já autoriza). O envio grava a imagem no TermoBucket e já a acrescenta ao fim das `imagens` do produto (a primeira continua a principal); a resposta traz a `url` da imagem e a lista de `imagens` do produto. O link é de uso único e vence em 15 minutos (`expira_em`). Campos: `sku` do produto, sem diferenciar maiúsculas. Na resposta, `imagens_no_produto` e `vagas_de_imagem` dizem quantas imagens ele já tem e quantas ainda cabem (até 15). Imagem PNG, JPG, WEBP ou GIF até 5 MB. Dica: com o nome do arquivo começando pelo SKU (`<SKU>.png`, `<SKU>_2.png`), dá para enviar uma pasta inteira descobrindo o produto pelo nome.
+ *
+ * `POST /link_envio_imagem`
+ */
+export declare function criar_link_envio_imagem(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.LinkEnvioImagemCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.LinkEnvioImagem>;
+/**
+ * Envia a imagem pelo link e a acrescenta ao produto
+ *
+ * Rota pública: quem autoriza é o próprio link (`id` de uso único gerado pelo `POST /link_envio_imagem`, válido por 15 minutos). Formulário `multipart/form-data` com o campo `arquivo` (PNG, JPG, WEBP ou GIF até 5 MB; o tipo sai dos bytes). Grava a imagem no TermoBucket e a acrescenta ao fim das `imagens` do produto. Se o envio falha (formato, tamanho, TermoBucket fora do ar), o link continua valendo até vencer.
+ *
+ * `PATCH /link_envio_imagem/{id}`
+ */
+export declare function atualizar_pelo_id_link_envio_imagem(id: string, formulario: FormData, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ImagemEnviada>;
 /**
  * Uma página das notas fiscais, por cursor
  *
@@ -1767,7 +1596,7 @@ export declare function deletar_pelo_id_perfil(credencial_de_acesso: CredencialD
 /**
  * Lista os produtos paginados
  *
- * Exige só uma sessão válida (qualquer pessoa logada no portal). `ordem` aceita `relevancia` (padrão: relevância, depois nome), `menor-preco`/`maior-preco` (preço à vista, ou o preço base quando o à vista é zero), `az`/`za` (nome), `mais-novo`/`mais-antigo` (data de cadastro); o desempate é sempre nome e id; outro valor responde 400 `Ordem inválida`. Filtros opcionais (todos combinam com E): `sku` exato e `skus` vários separados por vírgula (sem diferenciar maiúsculas); `nome` procura o trecho no nome, no SKU e no nome comercial, sem diferenciar maiúsculas nem acentos; `ativo`, `lancamento`, `importado_da_api`, `demonstracao` são exatos; `tem_preco_portal_b2b` (`true` só os que têm Preço Portal B2B); `tem_imagem` (ao menos uma imagem), `tem_estoque` (estoque maior que zero), `tem_descricao`, `tem_nome_comercial`, `tem_heuristica_pendente` e `enriquecido` (já enriquecido pelo Tiny) aceitam `true` ou `false`; `estoque_minimo`/`estoque_maximo` e `preco_minimo`/`preco_maximo` são faixas inclusivas; `unidade` é exata e `cor`, `material`, `diametro`, `categoria_tiny` e `marca_tiny` procuram o trecho; `criado_desde`/`criado_ate` e `atualizado_desde`/`atualizado_ate` são datas AAAA-MM-DD inclusivas. Para quem não é colaborador interno, os dados do Tiny vêm vazios. 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`. Para quem não é colaborador interno, `estoque` vem `null` (a quantidade nunca é mostrada ao cliente) e `disponivel` diz se há estoque.
+ * Exige só uma sessão válida (qualquer pessoa logada no portal). `ordem` aceita `relevancia` (padrão: relevância, depois nome), `menor-preco`/`maior-preco` (preço à vista, ou o preço base quando o à vista é zero), `az`/`za` (nome), `mais-novo`/`mais-antigo` (data de cadastro); o desempate é sempre nome e id; outro valor responde 400 `Ordem inválida`. Filtros opcionais (todos combinam com E): `sku` exato e `skus` vários separados por vírgula (sem diferenciar maiúsculas); `nome` procura o trecho no nome, no SKU e no nome comercial, sem diferenciar maiúsculas nem acentos; `ativo`, `lancamento`, `importado_da_api`, `demonstracao` são exatos; `tem_preco_portal_b2b` (`true` só os que têm Preço Portal B2B); `tem_imagem` (ao menos uma imagem), `tem_estoque` (estoque maior que zero), `tem_descricao`, `tem_nome_comercial`, `tem_heuristica_pendente` e `enriquecido` (já enriquecido pelo Tiny) aceitam `true` ou `false`; `estoque_minimo`/`estoque_maximo` e `preco_minimo`/`preco_maximo` são faixas inclusivas; `unidade` é exata e `cor`, `categoria_tiny` e `marca_tiny` procuram o trecho; `criado_desde`/`criado_ate` e `atualizado_desde`/`atualizado_ate` são datas AAAA-MM-DD inclusivas. Para quem não é colaborador interno, os dados do Tiny vêm vazios. 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`. Para quem não é colaborador interno, `estoque` vem `null` (a quantidade nunca é mostrada ao cliente) e `disponivel` diz se há estoque.
  *
  * `GET /produto`
  */
@@ -1775,7 +1604,7 @@ export declare function buscar_paginador_produto(credencial_de_acesso: Credencia
 /**
  * Cadastra um produto
  *
- * Exige a permissão `criar` no módulo `Configuracoes` do perfil de quem chama (administrador e master têm tudo). Produto do catálogo. `sku` até 32 letras, números, ponto, hífen e `_`, único; `nome` de 2 a 200 caracteres; `preco` e `preco_a_vista` maiores que zero (à vista não maior que o base); `unidade` de venda obrigatória; `estoque` não negativo; `incremento_minimo` e `quantidade_minima` maiores que zero; até 15 `imagens` (URLs; a primeira é a principal). Campos: `aplicacao` é o texto de onde o produto é usado; `embalagem` é o texto da embalagem de venda; `unidade_medida` é a unidade das quantidades (ex.: `m`, `un`); `embalagem_rotulo` é o nome da embalagem fechada (ex.: caixa); `embalagem_quantidade` é quantas unidades vêm na embalagem fechada (não negativa); `embalagem_preco` é o preço da embalagem fechada (não negativo); `diametro`, `material`, `cor` e `temperatura` são atributos técnicos em texto; `material` é atributo técnico em texto; `temperatura` é atributo técnico em texto; `lancamento` (booleano) marca o produto como lançamento; `relevancia` (inteiro) ordena a vitrine, da maior para a menor; `descricao` é o texto longo da vitrine (até 5000 caracteres); `especificacoes_texto` é a ficha técnica em texto (até 5000 caracteres); `outras_informacoes` é texto livre extra (até 2000 caracteres); `demonstracao` (booleano) marca produto de demonstração; `importado_da_api` (booleano) marca produto vindo do Tiny; `heuristica_pendente` é a lista de campos que ainda precisam de revisão manual.
+ * Exige a permissão `criar` no módulo `Configuracoes` do perfil de quem chama (administrador e master têm tudo). Produto do catálogo. `sku` até 32 letras, números, ponto, hífen e `_`, único; `nome` de 2 a 200 caracteres; `preco` e `preco_a_vista` maiores que zero (à vista não maior que o base); `unidade` de venda obrigatória; `estoque` não negativo; `incremento_minimo` e `quantidade_minima` maiores que zero; até 15 `imagens` (URLs; a primeira é a principal). Campos: `embalagem` é o texto da embalagem de venda; `unidade_medida` é a unidade das quantidades (ex.: `m`, `un`); `embalagem_rotulo` é o nome da embalagem fechada (ex.: caixa); `embalagem_quantidade` é quantas unidades vêm na embalagem fechada (não negativa); `embalagem_preco` é o preço da embalagem fechada (não negativo); `cor` é atributo em texto; `lancamento` (booleano) marca o produto como lançamento; `relevancia` (inteiro) ordena a vitrine, da maior para a menor; `descricao` é o texto longo da vitrine (até 5000 caracteres); `especificacoes_texto` é a ficha técnica em texto (até 5000 caracteres); `outras_informacoes` é texto livre extra (até 2000 caracteres); `demonstracao` (booleano) marca produto de demonstração; `importado_da_api` (booleano) marca produto vindo do Tiny; `heuristica_pendente` é a lista de campos que ainda precisam de revisão manual.
  *
  * `POST /produto`
  */
@@ -1791,7 +1620,7 @@ export declare function buscar_auto_complete_produto(credencial_de_acesso: Crede
 /**
  * Busca produtos por filtro
  *
- * Exige só uma sessão válida (qualquer pessoa logada no portal). Devolve os produtos não excluídos que casam com o filtro, até 50 por página (`pagina`, a partir de 1, padrão 1). `ordem` aceita `relevancia` (padrão: relevância, depois nome), `menor-preco`/`maior-preco` (preço à vista, ou o preço base quando o à vista é zero), `az`/`za` (nome), `mais-novo`/`mais-antigo` (data de cadastro); o desempate é sempre nome e id; outro valor responde 400 `Ordem inválida`. Filtros opcionais (todos combinam com E): `sku` exato e `skus` vários separados por vírgula (sem diferenciar maiúsculas); `nome` procura o trecho no nome, no SKU e no nome comercial, sem diferenciar maiúsculas nem acentos; `ativo`, `lancamento`, `importado_da_api`, `demonstracao` são exatos; `tem_preco_portal_b2b` (`true` só os que têm Preço Portal B2B); `tem_imagem` (ao menos uma imagem), `tem_estoque` (estoque maior que zero), `tem_descricao`, `tem_nome_comercial`, `tem_heuristica_pendente` e `enriquecido` (já enriquecido pelo Tiny) aceitam `true` ou `false`; `estoque_minimo`/`estoque_maximo` e `preco_minimo`/`preco_maximo` são faixas inclusivas; `unidade` é exata e `cor`, `material`, `diametro`, `categoria_tiny` e `marca_tiny` procuram o trecho; `criado_desde`/`criado_ate` e `atualizado_desde`/`atualizado_ate` são datas AAAA-MM-DD inclusivas. Para quem não é colaborador interno, os dados do Tiny vêm vazios. Para quem não é colaborador interno, `estoque` vem `null` (a quantidade nunca é mostrada ao cliente) e `disponivel` diz se há estoque.
+ * Exige só uma sessão válida (qualquer pessoa logada no portal). Devolve os produtos não excluídos que casam com o filtro, até 50 por página (`pagina`, a partir de 1, padrão 1). `ordem` aceita `relevancia` (padrão: relevância, depois nome), `menor-preco`/`maior-preco` (preço à vista, ou o preço base quando o à vista é zero), `az`/`za` (nome), `mais-novo`/`mais-antigo` (data de cadastro); o desempate é sempre nome e id; outro valor responde 400 `Ordem inválida`. Filtros opcionais (todos combinam com E): `sku` exato e `skus` vários separados por vírgula (sem diferenciar maiúsculas); `nome` procura o trecho no nome, no SKU e no nome comercial, sem diferenciar maiúsculas nem acentos; `ativo`, `lancamento`, `importado_da_api`, `demonstracao` são exatos; `tem_preco_portal_b2b` (`true` só os que têm Preço Portal B2B); `tem_imagem` (ao menos uma imagem), `tem_estoque` (estoque maior que zero), `tem_descricao`, `tem_nome_comercial`, `tem_heuristica_pendente` e `enriquecido` (já enriquecido pelo Tiny) aceitam `true` ou `false`; `estoque_minimo`/`estoque_maximo` e `preco_minimo`/`preco_maximo` são faixas inclusivas; `unidade` é exata e `cor`, `categoria_tiny` e `marca_tiny` procuram o trecho; `criado_desde`/`criado_ate` e `atualizado_desde`/`atualizado_ate` são datas AAAA-MM-DD inclusivas. Para quem não é colaborador interno, os dados do Tiny vêm vazios. Para quem não é colaborador interno, `estoque` vem `null` (a quantidade nunca é mostrada ao cliente) e `disponivel` diz se há estoque.
  *
  * `GET /produto/filtro`
  */
@@ -1807,7 +1636,7 @@ export declare function buscar_pelo_id_produto(credencial_de_acesso: CredencialD
 /**
  * Atualiza um produto
  *
- * Exige a permissão `editar` no módulo `Configuracoes` do perfil de quem chama (administrador e master têm tudo). Mesmas validações do cadastro (o SKU não muda). `embalagem_quantidade` e `embalagem_preco` aceitam `null` para apagar. Produto do Tiny não aceita `preco` nem `preco_a_vista` (400): o preço próprio do portal vai em `preco_portal_b2b`, maior que zero e até o preço a prazo do Tiny, e vira o preço à vista usado no portal; `null` apaga e o preço à vista volta ao do Tiny. A sincronização com o Tiny nunca muda o `preco_portal_b2b`. Produto que não veio do Tiny não aceita `preco_portal_b2b` (400). Atualização parcial: campo ausente mantém o valor atual. Campos: `nome` de 2 a 200 caracteres; `aplicacao` é o texto de onde o produto é usado; `unidade` é a unidade de venda (obrigatória quando enviada); `embalagem` é o texto da embalagem de venda; `unidade_medida` é a unidade das quantidades (ex.: `m`, `un`); `embalagem_rotulo` é o nome da embalagem fechada (ex.: caixa); `incremento_minimo` maior que zero; `diametro`, `material`, `cor` e `temperatura` são atributos técnicos em texto; `material` é atributo técnico em texto; `temperatura` é atributo técnico em texto; `lancamento` (booleano) marca o produto como lançamento; `relevancia` (inteiro) ordena a vitrine, da maior para a menor; `imagens` até 15 URLs, sem itens vazios; `descricao` é o texto longo da vitrine (até 5000 caracteres); `especificacoes_texto` é a ficha técnica em texto (até 5000 caracteres); `outras_informacoes` é texto livre extra (até 2000 caracteres); `heuristica_pendente` é a lista de campos que ainda precisam de revisão manual. `nome_comercial` é o nome mostrado ao cliente e `resumo_caracteristicas` a linha curta de características do card; os dois aceitam texto ou `null` para limpar (vazio também limpa).
+ * Exige a permissão `editar` no módulo `Configuracoes` do perfil de quem chama (administrador e master têm tudo). Mesmas validações do cadastro (o SKU não muda). `embalagem_quantidade` e `embalagem_preco` aceitam `null` para apagar. Produto do Tiny não aceita `preco` nem `preco_a_vista` (400): o preço próprio do portal vai em `preco_portal_b2b`, maior que zero e até o preço a prazo do Tiny, e vira o preço à vista usado no portal; `null` apaga e o preço à vista volta ao do Tiny. A sincronização com o Tiny nunca muda o `preco_portal_b2b`. Produto que não veio do Tiny não aceita `preco_portal_b2b` (400). Atualização parcial: campo ausente mantém o valor atual. Campos: `nome` de 2 a 200 caracteres; `unidade` é a unidade de venda (obrigatória quando enviada); `embalagem` é o texto da embalagem de venda; `unidade_medida` é a unidade das quantidades (ex.: `m`, `un`); `embalagem_rotulo` é o nome da embalagem fechada (ex.: caixa); `incremento_minimo` maior que zero; `cor` é atributo em texto; `lancamento` (booleano) marca o produto como lançamento; `relevancia` (inteiro) ordena a vitrine, da maior para a menor; `imagens` até 15 URLs, sem itens vazios; `descricao` é o texto longo da vitrine (até 5000 caracteres); `especificacoes_texto` é a ficha técnica em texto (até 5000 caracteres); `outras_informacoes` é texto livre extra (até 2000 caracteres); `heuristica_pendente` é a lista de campos que ainda precisam de revisão manual. `nome_comercial` é o nome mostrado ao cliente e `resumo_caracteristicas` a linha curta de características do card; os dois aceitam texto ou `null` para limpar (vazio também limpa).
  *
  * `PATCH /produto/{id}`
  */