termo_core 0.1.2 → 0.1.4

package/dist/portal/rotas.js

@@ -790,7 +790,7 @@ export function deletar_pelo_id_contato(credencial_de_acesso, id, opcoes_da_cham
 /**
  * Lista uma página de cotações
  *
- * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Devolve só o array da página, até 50 cotações, das mais novas para as mais antigas; o total, as páginas e as contagens por situação vêm de `GET /cotacao/paginador`, com os mesmos filtros. Quem não é colaborador interno precisa informar `unidade_id` de uma unidade da própria sessão; colaborador interno pode omitir e vê todas. Filtros opcionais: `status` (um dos 5 valores, senão 400 `Status inválido`); `busca` procura o número (C-1048 ou 1048), o SKU ou o nome de um item e a razão social da unidade; `inicio`/`fim` são datas AAAA-MM-DD do envio, em Brasília, inclusivas; `cursor` é o id da última cotação da página anterior.
+ * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Devolve só o array da página, até 50 cotações, das mais novas para as mais antigas; o total, as páginas e as contagens por situação vêm de `GET /cotacao/paginador`, com os mesmos filtros. Quem não é colaborador interno precisa informar `unidade_id` de uma unidade da própria sessão; colaborador interno pode omitir e vê todas. Filtros opcionais: `status` (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.
  *
  * `GET /cotacao`
  */
@@ -807,7 +807,7 @@ export function buscar_paginador_cotacao(credencial_de_acesso, parametros = {},
 /**
  * Cria uma cotação (carrinho enviado)
  *
- * 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).
+ * 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).
  *
  * `POST /cotacao`
  */
@@ -841,7 +841,7 @@ export function buscar_auto_complete_cotacao(credencial_de_acesso, parametros =
 /**
  * Busca cotações por filtro
  *
- * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Devolve as cotações não excluídas que casam com o filtro, até 50 por página (`pagina`, a partir de 1, padrão 1), das mais novas para as mais antigas. Quem não é colaborador interno precisa informar `unidade_id` de uma unidade da própria sessão; colaborador interno pode omitir e vê todas. `autor_cliente_id` e `status` (`rascunho`, `esperando_aprovacao`, `concluido`, `nao_aprovado`, `em_transporte`) são exatos.
+ * Exige a permissão `ver` no módulo `Cotacoes` do perfil de quem chama (administrador e master têm tudo). Devolve as cotações não excluídas que casam com o filtro, até 50 por página (`pagina`, a partir de 1, padrão 1), das mais novas para as mais antigas. Quem não é colaborador interno precisa informar `unidade_id` de uma unidade da própria sessão; colaborador interno pode omitir e vê todas. `origem` (`carrinho`, `pedido_inteligente`) e `status` (`rascunho`, `esperando_aprovacao`, `concluido`, `nao_aprovado`, `em_transporte`) são exatos.
  *
  * `GET /cotacao/filtro`
  */
@@ -1256,39 +1256,6 @@ export function buscar_pelo_filtro_indicador_venda(credencial_de_acesso, paramet
         formato_da_resposta: "json",
     }, opcoes_da_chamada);
 }
-/**
- * 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 function criar_link_envio_imagem(credencial_de_acesso, corpo_da_requisicao, opcoes_da_chamada) {
-    return chamar_servico({
-        servico: SERVICO_DESTA_API,
-        metodo_http: "POST",
-        caminho_da_rota: "/link_envio_imagem",
-        credencial_de_acesso,
-        corpo_json: corpo_da_requisicao,
-        formato_da_resposta: "json",
-    }, opcoes_da_chamada);
-}
-/**
- * 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 function atualizar_pelo_id_link_envio_imagem(id, formulario, opcoes_da_chamada) {
-    return chamar_servico({
-        servico: SERVICO_DESTA_API,
-        metodo_http: "PATCH",
-        caminho_da_rota: `/link_envio_imagem/${codificar_parametro_de_caminho(id)}`,
-        formulario,
-        formato_da_resposta: "json",
-    }, opcoes_da_chamada);
-}
 /**
  * Uma página das notas fiscais, por cursor
  *
@@ -1539,6 +1506,89 @@ export function deletar_pelo_id_pedido(credencial_de_acesso, id, opcoes_da_chama
         formato_da_resposta: "sem_conteudo",
     }, opcoes_da_chamada);
 }
+/**
+ * Envia um pedido para a IA montar
+ *
+ * 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. 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.
+ *
+ * `POST /pedido_inteligente`
+ */
+export function criar_pedido_inteligente(credencial_de_acesso, formulario, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: "/pedido_inteligente",
+        credencial_de_acesso,
+        formulario,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Busca pedidos inteligentes por filtro
+ *
+ * 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`.
+ *
+ * `GET /pedido_inteligente/filtro`
+ */
+export function buscar_pelo_filtro_pedido_inteligente(credencial_de_acesso, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: "/pedido_inteligente/filtro",
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Busca um pedido inteligente pelo id
+ *
+ * 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); `cotacao_id` aparece quando o pedido já virou cotação.
+ *
+ * `GET /pedido_inteligente/{id}`
+ */
+export function buscar_pelo_id_pedido_inteligente(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: `/pedido_inteligente/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Grava a revisão do cliente
+ *
+ * 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, entre o `escolhido` e as `opcoes` daquele item (nulo tira o item da cotação), e `quantidade` vai de 0 a 9999 (acima de zero).
+ *
+ * `PATCH /pedido_inteligente/{id}`
+ */
+export function atualizar_pelo_id_pedido_inteligente(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "PATCH",
+        caminho_da_rota: `/pedido_inteligente/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Cancela um pedido inteligente
+ *
+ * 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).
+ *
+ * `DELETE /pedido_inteligente/{id}`
+ */
+export function deletar_pelo_id_pedido_inteligente(credencial_de_acesso, id, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "DELETE",
+        caminho_da_rota: `/pedido_inteligente/${codificar_parametro_de_caminho(id)}`,
+        credencial_de_acesso,
+        formato_da_resposta: "sem_conteudo",
+    }, opcoes_da_chamada);
+}
 /**
  * Lista os pedidos de venda do ERP
  *

package/dist/portal/tipos.d.ts

@@ -1,3 +1,10 @@
+export interface AnexoDoPedido {
+    arquivo_id?: string | null;
+    nome: string;
+    tamanho: number;
+    tipo: string;
+    url?: string | null;
+}
 export interface Arquivo {
     url: string;
 }
@@ -93,7 +100,6 @@ export interface BuscaTermotubos {
 }
 export interface Carrinho {
     atualizado_em: string;
-    cliente_id?: string | null;
     criado_em: string;
     id: string;
     itens: Array<CarrinhoItem>;
@@ -294,7 +300,6 @@ export interface ContatoCriar {
 export interface Cotacao {
     acima_do_limite: boolean;
     atualizado_em: string;
-    autor_cliente_id: string;
     autor_nome: string;
     carrinho_id?: string | null;
     criado_em: string;
@@ -305,6 +310,8 @@ export interface Cotacao {
     itens: Array<CotacaoItem>;
     numero: number;
     observacao?: string | null;
+    origem: string;
+    pedido_inteligente_id?: string | null;
     quantidade_itens: number;
     status: string;
     subtotal: number;
@@ -324,12 +331,12 @@ export interface CotacaoAutoComplete {
     rotulo: string;
 }
 export interface CotacaoCriar {
-    autor_cliente_id: string;
     carrinho_id?: string | null;
     economia_tier?: number | null;
     endereco_id?: string | null;
     itens: Array<CotacaoItemCriar>;
     observacao?: string | null;
+    pedido_inteligente_id?: string | null;
     total_esperado?: number | null;
     unidade_id: string;
 }
@@ -436,6 +443,10 @@ export interface EnderecoEntrega {
     logradouro: string;
     numero?: string | null;
 }
+export interface EscolhaDoItem {
+    produto_id?: string | null;
+    quantidade: number;
+}
 export interface ExpedicaoTermotubos {
     atualizado_em?: string | null;
     cep?: string | null;
@@ -513,15 +524,6 @@ export interface HistoricoPrecoTermotubos {
     preco?: number | null;
     preco_promocional?: number | null;
 }
-export interface ImagemDoLink {
-    arquivo: string;
-}
-export interface ImagemEnviada {
-    imagens: Array<string>;
-    produto_id: string;
-    sku: string;
-    url: string;
-}
 export interface ImportacaoProdutos {
     atualizados: number;
     conflitos: number;
@@ -570,6 +572,14 @@ export interface ItemCatalogoTermotubos {
     tem_imagem: boolean;
     unidade?: string | null;
 }
+export interface ItemDoPedido {
+    escolhido?: OpcaoDoItem | null;
+    observacao?: string | null;
+    opcoes: Array<OpcaoDoItem>;
+    pedido_do_cliente: string;
+    quantidade: number;
+    situacao: string;
+}
 export interface ItemNotaFiscal {
     descricao?: string | null;
     preco_unitario?: number | null;
@@ -592,18 +602,6 @@ export interface ItemSincronizado {
     resultado: string;
     sku: string;
 }
-export interface LinkEnvioImagem {
-    expira_em: string;
-    id: string;
-    imagens_no_produto: number;
-    produto_id: string;
-    sku: string;
-    url_envio: string;
-    vagas_de_imagem: number;
-}
-export interface LinkEnvioImagemCriar {
-    sku: string;
-}
 export interface NotaFiscalParte2 {
     parcelas: Array<ParcelaNotaFiscal>;
     parcelas_lidas: boolean;
@@ -649,6 +647,15 @@ export interface OpcaoDeFiltro {
     rotulo: string;
     valor: string;
 }
+export interface OpcaoDoItem {
+    disponivel: boolean;
+    imagem_url?: string | null;
+    nome: string;
+    preco_unitario: number;
+    produto_id: string;
+    sku: string;
+    unidade: string;
+}
 export interface PaginaExpedicoes {
     contagens: ContagemExpedicoes;
     itens: Array<ExpedicaoTermotubos>;
@@ -1139,6 +1146,28 @@ export interface PedidoCriar {
 export interface PedidoDaEntrega {
     id: number;
 }
+export interface PedidoInteligente {
+    anexos: Array<AnexoDoPedido>;
+    atualizado_em: string;
+    cotacao_id?: string | null;
+    criado_em: string;
+    erro?: string | null;
+    id: string;
+    itens: Array<ItemDoPedido>;
+    provedor_ia?: string | null;
+    status: string;
+    texto_enviado?: string | null;
+    texto_interpretado?: string | null;
+    unidade_id: string;
+}
+export interface PedidoInteligenteAtualizar {
+    itens: Array<EscolhaDoItem>;
+}
+export interface PedidoInteligenteEnvio {
+    arquivo: Array<string>;
+    texto?: string | null;
+    unidade_id: string;
+}
 export interface PedidoItem {
     produto: string;
     quantidade: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termo_core",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Todos os clientes da Termotubos num pacote só: um módulo por serviço e cada rota da API como uma função com fetch, com o endereço resolvido pelo ambiente atual.",
   "license": "MIT",
   "author": "TI Termotubos <ti@termotubos.com.br>",