@pairus/product-data 1.5.0 → 1.6.0

package/dist/index.d.ts

@@ -46,6 +46,12 @@ interface DocumentoDFe {
     tipo_documento?: string;
     manifestacao_status?: string;
     tem_xml_completo?: boolean;
+    /** Protocolo de autorização da NF-e (resNFe). */
+    protocolo?: string;
+    cnpj_destinatario?: string;
+    ie_emitente?: string;
+    ambiente?: string;
+    [campo: string]: any;
 }
 interface SincronizarDFeInput {
     cnpj: string;
@@ -72,12 +78,15 @@ interface ListarDocumentosDFeResponse {
     total: number;
     ult_nsu: string;
     max_nsu: string;
+    /** Data e hora da última sincronização com a SEFAZ. */
+    ultima_sincronizacao?: string | null;
     documentos: DocumentoDFe[];
 }
 interface ManifestarDFeInput {
     cnpj: string;
     chave_acesso: string;
     tipo_evento: TipoManifestacaoDFe | string;
+    /** Obrigatória apenas no 210240 (15 a 255 caracteres); a API a descarta nos demais eventos. */
     justificativa?: string;
     ambiente?: 'producao' | 'homologacao';
 }
@@ -87,6 +96,9 @@ interface ManifestarDFeResponse {
     xmotivo: string;
     protocolo?: string;
     tipo_evento?: string;
+    chave_acesso?: string;
+    /** 'ciencia', 'confirmada', 'desconhecida' ou 'nao_realizada'. */
+    manifestacao_status?: string;
     detalhes?: Record<string, any>;
 }
 
@@ -289,6 +301,12 @@ declare class EmissaoResource extends BaseResource {
     inutilizar(params: InutilizacaoInput): Promise<EventoNFeResponse>;
 }
 
+/**
+ * Tipos da predição fiscal (/v2/fiscal/predict) e do saneamento em lote (/v2/fiscal/sanitize).
+ *
+ * Espelham o contrato da API. Os nomes usados até a 1.5 (`cfop`, `avisos`, `imposto_seletivo` e
+ * `aliquota_efetiva_unificada` na raiz) continuam preenchidos pelo SDK a partir dos oficiais.
+ */
 interface IBSCBSData {
     cst: string;
     cClassTrib: string;
@@ -296,16 +314,29 @@ interface IBSCBSData {
     cbs_diferimento: number;
     cbs_reducao_aliquota: number;
     cbs_aliquota_efetiva: number;
+    aliquota_cbs_estimada?: number;
     ibs_aliquota_estadual: number;
     ibs_aliquota_municipal: number;
     ibs_diferimento: number;
     ibs_reducao_aliquota: number;
+    ibs_reducao_aliquota_estadual?: number;
+    ibs_reducao_aliquota_municipal?: number;
     ibs_aliquota_efetiva: number;
+    aliquota_ibs_estimada?: number;
+    aliquota_efetiva_unificada?: number;
+    vTotDFe_obrigatorio?: boolean;
 }
+/** Imposto Seletivo: chega na chave `is` de `dados_tributarios`. */
 interface SelectiveTaxData {
-    cst: string;
-    cClassTribIS: string;
-    aliquota: number;
+    incidencia?: boolean;
+    CSTIS?: string | null;
+    cClassTribIS?: string | null;
+    pIS?: number;
+    nota?: string | null;
+    /** @deprecated Use `CSTIS`. */
+    cst?: string | null;
+    /** @deprecated Use `pIS`. */
+    aliquota?: number;
 }
 interface FuelData {
     codigo_anp: string;
@@ -317,30 +348,55 @@ interface FuelData {
 }
 interface TaxPredictionData {
     ncm_sugerido: string;
-    cest_sugerido?: string;
-    cfop: string;
-    cfop_devolucao?: string;
+    cest_sugerido?: string | null;
+    origem_mercadoria?: string;
+    origem_mercadoria_descricao?: string;
+    cfop_interno?: string;
+    cfop_externo?: string;
+    cfop_devolucao_interno?: string | null;
+    cfop_devolucao_externo?: string | null;
     icms_cst_csosn: string;
     icms_aliquota: number;
-    icms_aliquota_st: number;
-    icms_mva_st: number;
     icms_reducao_bc: number;
+    icms_sujeito_st?: boolean;
+    icms_mva_st: number;
+    icms_aliquota_st: number;
     icms_reducao_bc_st: number;
-    icms_modalidade_bc: string;
-    icms_modalidade_bc_st: string;
+    icms_modalidade_bc?: string | null;
+    icms_modalidade_bc_st?: string | null;
+    icms_credito_aliquota_sn?: number;
+    dados_desoneracao_suframa?: Record<string, any> | null;
     pis_cst: string;
     pis_aliquota: number;
     cofins_cst: string;
     cofins_aliquota: number;
-    ipi_cst?: string;
+    ipi_cst?: string | null;
     ipi_aliquota?: number;
+    extipi?: string | null;
+    reforma_tributaria_nota?: string;
     ibscbs: IBSCBSData;
+    /** Imposto Seletivo (nome oficial da chave na API). */
+    is?: SelectiveTaxData;
+    combustivel_sujeito_anp?: boolean;
+    dados_combustivel?: FuelData | null;
+    diagnostico_anti_rejeicao?: Array<Record<string, string>>;
+    otimizacao_tributaria?: Record<string, any> | null;
+    difal?: Record<string, any> | null;
+    motor_ia: string;
+    avisos_fiscais?: string[];
+    disclaimer?: string;
+    /** @deprecated Use `cfop_interno` ou `cfop_externo` conforme a UF de destino (preenchido com `cfop_interno`). */
+    cfop?: string;
+    /** @deprecated Use `cfop_devolucao_interno` / `cfop_devolucao_externo`. */
+    cfop_devolucao?: string | null;
+    /** @deprecated Use `is`. */
     imposto_seletivo?: SelectiveTaxData;
-    dados_combustivel?: FuelData;
+    /** @deprecated Use `ibscbs.aliquota_efetiva_unificada`. */
+    aliquota_efetiva_unificada?: number;
+    /** @deprecated Use `avisos_fiscais`. */
+    avisos?: string[];
+    /** @deprecated Não é devolvido pela API. */
     beneficio_fiscal?: string;
-    aliquota_efetiva_unificada: number;
-    motor_ia: string;
-    avisos: string[];
 }
 interface TaxPredictionItemInput {
     xProd?: string;
@@ -354,6 +410,10 @@ interface TaxPredictionParams {
     ufDestino?: string;
     finalidade?: 'revenda' | 'consumo_final' | 'industrializacao' | string;
     destinatarioContribuinte?: boolean;
+    /** Alíquota de crédito de ICMS do Simples Nacional (pCredSN). */
+    aliquotaCreditoIcmsSn?: number;
+    destinatarioSuframa?: boolean;
+    inscricaoSuframa?: string;
     xProd?: string;
     gtin?: string;
     ncm?: string;
@@ -362,38 +422,49 @@ interface TaxPredictionParams {
 }
 interface TaxPredictionItemResult {
     item_index: number;
-    xProd?: string;
+    xProd?: string | null;
     dados_tributarios: TaxPredictionData;
 }
 interface TaxPredictionResponse {
     status: string;
     provider: string;
-    xProd?: string;
-    dados_tributarios?: TaxPredictionData;
-    resultados?: TaxPredictionItemResult[];
+    timestamp?: string;
+    motor_ia?: string | null;
+    xProd?: string | null;
+    dados_tributarios?: TaxPredictionData | null;
+    resultados?: TaxPredictionItemResult[] | null;
 }
+/**
+ * Item do saneamento. A API exige `NCM`/`CEST` em maiúsculas; os nomes `ncm`, `cest`,
+ * `descricao` e `gtin` da 1.5 continuam aceitos e são convertidos pelo SDK.
+ */
 interface FiscalSanitizeItemInput {
-    ncm: string;
+    NCM?: string;
+    CEST?: string;
+    xProd?: string;
+    id?: string;
+    /** @deprecated Use `NCM`. */
+    ncm?: string;
+    /** @deprecated Use `CEST`. */
     cest?: string;
+    /** @deprecated Use `xProd`. */
     descricao?: string;
+    /** @deprecated Use `id`. */
     gtin?: string;
 }
 interface FiscalSanitizeItemResult {
-    ncm: string;
-    ncm_valido: boolean;
-    descricao_ncm?: string;
-    cest_informado?: string;
-    cest_sugerido?: string;
-    sujeito_st: boolean;
-    aliquotas_sugeridas?: Record<string, any>;
-    avisos?: string[];
+    id?: string;
+    xProd?: string;
+    NCM_informado?: string;
+    CEST_informado?: string | null;
+    auditoria_fiscal: Record<string, any>;
 }
 interface FiscalSanitizeResponse {
     status: string;
     provider: string;
     timestamp?: string;
     total_itens: number;
-    itens: Array<Record<string, any>>;
+    itens: FiscalSanitizeItemResult[];
 }
 
 declare class FiscalResource extends BaseResource {
@@ -403,8 +474,9 @@ declare class FiscalResource extends BaseResource {
     predict(params: TaxPredictionParams): Promise<TaxPredictionResponse>;
     /**
      * Audita e higieniza uma lista de produtos em lote perante as tabelas fiscais vigentes.
+     * Cada item precisa de `NCM` (aceita também `ncm`); `CEST`, `xProd` e `id` são opcionais.
      */
-    sanitize(itens: Array<Record<string, any>>): Promise<any>;
+    sanitize(itens: FiscalSanitizeItemInput[]): Promise<FiscalSanitizeResponse>;
 }
 
 interface EnderecoNFSeInput {
@@ -450,6 +522,14 @@ interface RetencoesFederaisInput {
     aliquota_inss?: number;
     valor_inss?: number;
 }
+/** Campos da Reforma Tributária (IBS e CBS) sobre serviços (LC 214/2025). */
+interface ReformaTributariaServicoInput {
+    cst_ibs_cbs?: string;
+    cClassTrib?: string;
+    aliquota_ibs_estadual?: number;
+    aliquota_ibs_municipal?: number;
+    aliquota_cbs?: number;
+}
 interface ServicoNFSeInput {
     item_lista_servico: string;
     discriminacao: string;
@@ -462,8 +542,10 @@ interface ServicoNFSeInput {
     valor_desconto_condicionado?: number;
     iss_retido?: boolean;
     aliquota_iss?: number;
+    /** '1' Exigível, '2' Não incidência, '3' Isenção, '4' Exportação, '5' Imunidade, '6'/'7' Suspensa. */
     exigibilidade_iss?: string;
     retencoes_federais?: RetencoesFederaisInput;
+    reforma_tributaria?: ReformaTributariaServicoInput;
 }
 interface NFSeEmissaoInput {
     prestador: PrestadorNFSeInput | Record<string, any>;
@@ -486,6 +568,8 @@ interface NFSeEmissaoResponse {
     data_emissao?: string;
     link_visualizacao?: string;
     danfse_pdf_base64?: string;
+    /** Alias de danfse_pdf_base64 devolvido pela API. */
+    danfse_base64?: string;
     xml_nfse?: string;
     valor_servicos: number;
     valor_iss: number;
@@ -494,7 +578,13 @@ interface NFSeEmissaoResponse {
     valor_liquido: number;
     erros?: string[];
     alertas?: string[];
-    trilha_auditoria?: Record<string, any>[];
+    trilha_auditoria?: Array<{
+        autor: string;
+        acao: string;
+        justificativa_legal: string;
+        campos_alterados?: Record<string, any>;
+        timestamp: string;
+    }>;
     creditos_cobrados: number;
     tempo_processamento_ms: number;
 }
@@ -504,6 +594,7 @@ interface CancelamentoNFSeInput {
     inscricao_municipal: string;
     codigo_municipio_ibge: string;
     justificativa: string;
+    /** '1' Erro de emissão, '2' Serviço não prestado, '3' Duplicidade, '9' Outros. */
     motivo_codigo?: string;
     codigo_verificacao?: string;
     chave_acesso_nacional?: string;
@@ -535,6 +626,11 @@ declare class NFSeResource extends BaseResource {
     consultar(chaveOuNumero: string): Promise<Record<string, any>>;
 }
 
+/**
+ * Tipos de produto do SDK. A API devolve o produto no layout da NF-e (`GTIN`, `NCM`, `CEST`) com
+ * marca, categoria, imagem e pesos em `infoAdicional` e a IA em `enriquecimentoIA`/`tributacaoIA`;
+ * o `ProductsResource` converte esse contrato para os tipos abaixo.
+ */
 interface ProductDetails {
     gtin: string;
     xProd: string;
@@ -549,10 +645,16 @@ interface ProductDetails {
     quantidadeEmbalagem?: number;
     dataCadastro?: string;
     dataAtualizacao?: string;
+    tpGTIN?: string;
+    fonte?: string;
+    /** Bloco `infoAdicional` original da API. */
+    infoAdicional?: Record<string, any>;
 }
 interface ProductResponse {
     status: string;
     provider: string;
+    cStat?: string;
+    xMotivo?: string;
     produto?: ProductDetails;
     raw_data?: Record<string, any>;
 }
@@ -562,6 +664,8 @@ interface ProductSearchResultItem {
     marca?: string;
     categoria?: string;
     score?: number;
+    /** Explicação da correspondência semântica. */
+    justificativa?: string;
     ncm?: string;
     cest?: string;
     imagem_url?: string;
@@ -571,12 +675,17 @@ interface ProductSearchResponse {
     provider: string;
     total_encontrados: number;
     termo_buscado: string;
+    motor_busca?: string;
     produtos: ProductSearchResultItem[];
 }
 interface ProductEnrichedDetails {
     gtin: string;
     xProd: string;
+    /** Nome saneado pela IA. */
+    xProd_higienizado?: string;
+    /** Descrição otimizada para SEO (`enriquecimentoIA.descricao_seo`). */
     descricao_completa?: string;
+    /** Atributos técnicos extraídos pela IA (`enriquecimentoIA.atributos`). */
     ficha_tecnica?: Record<string, any>;
     palavras_chave?: string[];
     ncm?: string;
@@ -586,7 +695,13 @@ interface ProductEnrichedDetails {
     imagem_url?: string;
     peso_bruto?: number;
     peso_liquido?: number;
+    /** Nó `tributacaoIA` da API. */
     dados_tributarios_sugeridos?: Record<string, any>;
+    tpGTIN?: string;
+    fonte?: string;
+    infoAdicional?: Record<string, any>;
+    enriquecimentoIA?: Record<string, any>;
+    tributacaoIA?: Record<string, any>;
 }
 
 declare class ProductsResource extends BaseResource {
@@ -672,4 +787,4 @@ declare class NetworkError extends PairusError {
     constructor(message: string);
 }
 
-export { AuthenticationError, type CancelamentoInput, type CancelamentoNFSeInput, type CancelamentoNFSeResponse, type CartaCorrecaoInput, DEFAULT_BASE_URL, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT_MS, DFeResource, type DocumentoDFe, type EmissaoDestinatarioInput, type EmissaoItemInput, type EmissaoNFeInput, type EmissaoNFeResponse, type EmissaoOptions, type EmissaoPagamentoInput, EmissaoResource, type EnderecoNFSeInput, type EventoNFeResponse, FiscalResource, type FiscalSanitizeItemInput, type FiscalSanitizeItemResult, type FiscalSanitizeResponse, type FuelData, type IBSCBSData, type InutilizacaoInput, InvalidSignatureError, type ListarDocumentosDFeParams, type ListarDocumentosDFeResponse, type ManifestarDFeInput, type ManifestarDFeResponse, type NFSeEmissaoInput, type NFSeEmissaoResponse, NFSeResource, NetworkError, PairusAPIError, type PairusClientOptions, PairusError, PairusProductData, type PrestadorNFSeInput, type ProductDetails, type ProductEnrichedDetails, type ProductResponse, type ProductSearchResponse, type ProductSearchResultItem, ProductsResource, RateLimitError, type RetencoesFederaisInput, type SelectiveTaxData, type ServicoNFSeInput, type SincronizarDFeInput, type SincronizarDFeResponse, type TaxPredictionData, type TaxPredictionItemInput, type TaxPredictionItemResult, type TaxPredictionParams, type TaxPredictionResponse, type TipoManifestacaoDFe, type TomadorNFSeInput, type WebhookEvent, Webhooks };
+export { AuthenticationError, type CancelamentoInput, type CancelamentoNFSeInput, type CancelamentoNFSeResponse, type CartaCorrecaoInput, DEFAULT_BASE_URL, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT_MS, DFeResource, type DocumentoDFe, type EmissaoDestinatarioInput, type EmissaoItemInput, type EmissaoNFeInput, type EmissaoNFeResponse, type EmissaoOptions, type EmissaoPagamentoInput, EmissaoResource, type EnderecoNFSeInput, type EventoNFeResponse, FiscalResource, type FiscalSanitizeItemInput, type FiscalSanitizeItemResult, type FiscalSanitizeResponse, type FuelData, type IBSCBSData, type InutilizacaoInput, InvalidSignatureError, type ListarDocumentosDFeParams, type ListarDocumentosDFeResponse, type ManifestarDFeInput, type ManifestarDFeResponse, type NFSeEmissaoInput, type NFSeEmissaoResponse, NFSeResource, NetworkError, PairusAPIError, type PairusClientOptions, PairusError, PairusProductData, type PrestadorNFSeInput, type ProductDetails, type ProductEnrichedDetails, type ProductResponse, type ProductSearchResponse, type ProductSearchResultItem, ProductsResource, RateLimitError, type ReformaTributariaServicoInput, type RetencoesFederaisInput, type SelectiveTaxData, type ServicoNFSeInput, type SincronizarDFeInput, type SincronizarDFeResponse, type TaxPredictionData, type TaxPredictionItemInput, type TaxPredictionItemResult, type TaxPredictionParams, type TaxPredictionResponse, type TipoManifestacaoDFe, type TomadorNFSeInput, type WebhookEvent, Webhooks };

package/dist/index.js

@@ -125,7 +125,7 @@ var BaseResource = class {
     const reqHeaders = {
       "Accept": "application/json",
       "X-API-Key": this.apiKey,
-      "User-Agent": "Pairus-NodeJS-SDK/1.5.0",
+      "User-Agent": "Pairus-NodeJS-SDK/1.6.0",
       ...options.headers || {}
     };
     const isFormData = typeof FormData !== "undefined" && options.body instanceof FormData;
@@ -196,7 +196,7 @@ var BaseResource = class {
     const reqHeaders = {
       "Accept": "*/*",
       "X-API-Key": this.apiKey,
-      "User-Agent": "Pairus-NodeJS-SDK/1.3.0",
+      "User-Agent": "Pairus-NodeJS-SDK/1.6.0",
       ...options.headers || {}
     };
     let lastError = null;
@@ -255,7 +255,7 @@ var BaseResource = class {
     const reqHeaders = {
       "Accept": "*/*",
       "X-API-Key": this.apiKey,
-      "User-Agent": "Pairus-NodeJS-SDK/1.3.0",
+      "User-Agent": "Pairus-NodeJS-SDK/1.6.0",
       ...options.headers || {}
     };
     let lastError = null;
@@ -477,6 +477,33 @@ var EmissaoResource = class extends BaseResource {
 };
 
 // src/resources/fiscal.ts
+function comNomesLegados(dados) {
+  const is = dados.is ?? dados.imposto_seletivo;
+  const impostoSeletivo = is ? { ...is, CSTIS: is.CSTIS ?? is.cst, cst: is.cst ?? is.CSTIS, pIS: is.pIS ?? is.aliquota, aliquota: is.aliquota ?? is.pIS } : void 0;
+  return {
+    ...dados,
+    cfop_interno: dados.cfop_interno ?? dados.cfop,
+    cfop: dados.cfop ?? dados.cfop_interno,
+    cfop_devolucao_interno: dados.cfop_devolucao_interno ?? dados.cfop_devolucao,
+    cfop_devolucao: dados.cfop_devolucao ?? dados.cfop_devolucao_interno,
+    is: impostoSeletivo,
+    imposto_seletivo: impostoSeletivo,
+    aliquota_efetiva_unificada: dados.aliquota_efetiva_unificada ?? dados.ibscbs?.aliquota_efetiva_unificada ?? 0,
+    avisos_fiscais: dados.avisos_fiscais ?? dados.avisos ?? [],
+    avisos: dados.avisos ?? dados.avisos_fiscais ?? []
+  };
+}
+function itemDeSaneamento(item) {
+  const { NCM, CEST, xProd, id, ncm, cest, descricao, gtin, ...extras } = item;
+  const convertido = {
+    ...extras,
+    NCM: NCM ?? ncm,
+    CEST: CEST ?? cest,
+    xProd: xProd ?? descricao,
+    id: id ?? gtin
+  };
+  return Object.fromEntries(Object.entries(convertido).filter(([, v]) => v !== void 0 && v !== null));
+}
 var FiscalResource = class extends BaseResource {
   /**
    * Executa a predição fiscal completa da Reforma Tributária (IBS/CBS/IS) e NF-e.
@@ -489,25 +516,34 @@ var FiscalResource = class extends BaseResource {
       finalidade: params.finalidade || "revenda",
       destinatario_contribuinte: params.destinatarioContribuinte ?? true
     };
+    if (params.aliquotaCreditoIcmsSn !== void 0) payload.aliquota_credito_icms_sn = params.aliquotaCreditoIcmsSn;
+    if (params.destinatarioSuframa !== void 0) payload.destinatario_suframa = params.destinatarioSuframa;
+    if (params.inscricaoSuframa) payload.inscricao_suframa = params.inscricaoSuframa;
     if (params.xProd) payload.xProd = params.xProd;
     if (params.gtin) payload.gtin = params.gtin;
     if (params.ncm) payload.ncm = params.ncm;
     if (params.cest) payload.cest = params.cest;
     if (params.itens) payload.itens = params.itens;
-    return this.request({
+    const res = await this.request({
       method: "POST",
       path: "/v2/fiscal/predict",
       body: payload
     });
+    return {
+      ...res,
+      dados_tributarios: res.dados_tributarios ? comNomesLegados(res.dados_tributarios) : res.dados_tributarios,
+      resultados: res.resultados?.map((r) => ({ ...r, dados_tributarios: comNomesLegados(r.dados_tributarios) }))
+    };
   }
   /**
    * Audita e higieniza uma lista de produtos em lote perante as tabelas fiscais vigentes.
+   * Cada item precisa de `NCM` (aceita também `ncm`); `CEST`, `xProd` e `id` são opcionais.
    */
   async sanitize(itens) {
     return this.request({
       method: "POST",
       path: "/v2/fiscal/sanitize",
-      body: { itens }
+      body: { itens: itens.map(itemDeSaneamento) }
     });
   }
 };
@@ -556,6 +592,85 @@ var NFSeResource = class extends BaseResource {
 };
 
 // src/resources/products.ts
+function primeiro(...valores) {
+  return valores.find((v) => v !== void 0 && v !== null && v !== "");
+}
+function numero(valor) {
+  const n = valor === void 0 || valor === null || valor === "" ? NaN : Number(valor);
+  return Number.isFinite(n) ? n : void 0;
+}
+function produtoDaApi(data, gtinFallback = "") {
+  const prod = data?.produto || data || {};
+  const info = prod.infoAdicional || {};
+  return {
+    gtin: String(primeiro(prod.GTIN, prod.gtin, gtinFallback) ?? ""),
+    xProd: primeiro(prod.xProd, prod.descricao) || "Descri\xE7\xE3o Indispon\xEDvel",
+    ncm: primeiro(prod.NCM, prod.ncm),
+    cest: primeiro(prod.CEST, prod.cest),
+    marca: primeiro(prod.marca, info.xMarca),
+    fabricante: prod.fabricante,
+    categoria: primeiro(prod.categoria, info.xCategoria),
+    imagemUrl: primeiro(prod.imagem_url, prod.thumbnail, info.urlImagem),
+    pesoBruto: numero(primeiro(prod.peso_bruto, info.pesoBruto)),
+    pesoLiquido: numero(primeiro(prod.peso_liquido, info.pesoLiquido)),
+    quantidadeEmbalagem: Number(prod.quantidade_embalagem || 1),
+    tpGTIN: prod.tpGTIN ?? void 0,
+    fonte: prod.fonte ?? void 0,
+    infoAdicional: prod.infoAdicional ?? void 0
+  };
+}
+function produtoEnriquecidoDaApi(data, gtinFallback = "") {
+  const prod = data?.produto || data || {};
+  const base = produtoDaApi(prod, gtinFallback);
+  const enriquecimento = prod.enriquecimentoIA || {};
+  const atributos = enriquecimento.atributos || {};
+  const temAtributos = Object.keys(atributos).length > 0;
+  return {
+    gtin: base.gtin,
+    xProd: base.xProd,
+    xProd_higienizado: enriquecimento.xProd_higienizado,
+    descricao_completa: primeiro(prod.descricao_completa, enriquecimento.descricao_seo),
+    ficha_tecnica: prod.ficha_tecnica ?? (temAtributos ? atributos : void 0),
+    palavras_chave: prod.palavras_chave,
+    ncm: base.ncm,
+    cest: base.cest,
+    marca: primeiro(prod.marca, atributos.marca, base.marca),
+    categoria: primeiro(prod.categoria, enriquecimento.categoria_comercial, base.categoria),
+    imagem_url: base.imagemUrl,
+    peso_bruto: base.pesoBruto,
+    peso_liquido: primeiro(numero(prod.peso_liquido), numero(atributos.peso_liquido), base.pesoLiquido),
+    dados_tributarios_sugeridos: prod.dados_tributarios_sugeridos ?? prod.tributacaoIA ?? void 0,
+    tpGTIN: base.tpGTIN,
+    fonte: base.fonte,
+    infoAdicional: base.infoAdicional,
+    enriquecimentoIA: prod.enriquecimentoIA ?? void 0,
+    tributacaoIA: prod.tributacaoIA ?? void 0
+  };
+}
+function buscaDaApi(data, query) {
+  const itens = (data?.resultados || data?.produtos || []).map((item) => {
+    const prod = produtoEnriquecidoDaApi(item.produto || item);
+    return {
+      gtin: prod.gtin,
+      xProd: prod.xProd,
+      marca: prod.marca,
+      categoria: prod.categoria,
+      score: item.score !== void 0 && item.score !== null ? Number(item.score) : void 0,
+      justificativa: item.justificativa ?? void 0,
+      ncm: prod.ncm,
+      cest: prod.cest,
+      imagem_url: prod.imagem_url
+    };
+  });
+  return {
+    status: data?.status || "success",
+    provider: data?.provider || "PAIRUS",
+    total_encontrados: itens.length,
+    termo_buscado: data?.query || query,
+    motor_busca: data?.motor_busca,
+    produtos: itens
+  };
+}
 var ProductsResource = class extends BaseResource {
   /**
    * Consulta dados oficiais de um produto por código de barras GTIN/EAN (V1).
@@ -563,24 +678,8 @@ var ProductsResource = class extends BaseResource {
    */
   async get(gtin) {
     const gtinLimpo = gtin.replace(/\D/g, "");
-    const data = await this.request({
-      method: "GET",
-      path: `/v1/gtin/${gtinLimpo}`
-    });
-    const prod = data.produto || data;
-    return {
-      gtin: prod.GTIN || prod.gtin || gtinLimpo,
-      xProd: prod.xProd || prod.descricao || "Descri\xE7\xE3o Indispon\xEDvel",
-      ncm: prod.NCM || prod.ncm,
-      cest: prod.CEST || prod.cest,
-      marca: prod.marca,
-      fabricante: prod.fabricante,
-      categoria: prod.categoria,
-      imagemUrl: prod.imagem_url || prod.thumbnail,
-      pesoBruto: prod.peso_bruto ? Number(prod.peso_bruto) : void 0,
-      pesoLiquido: prod.peso_liquido ? Number(prod.peso_liquido) : void 0,
-      quantidadeEmbalagem: Number(prod.quantidade_embalagem || 1)
-    };
+    const data = await this.request({ method: "GET", path: `/v1/gtin/${gtinLimpo}` });
+    return produtoDaApi(data, gtinLimpo);
   }
   /**
    * Consulta dados enriquecidos por IA, com SEO e ficha técnica estruturada (V2).
@@ -588,54 +687,16 @@ var ProductsResource = class extends BaseResource {
    */
   async getEnriched(gtin) {
     const gtinLimpo = gtin.replace(/\D/g, "");
-    const data = await this.request({
-      method: "GET",
-      path: `/v2/gtin/${gtinLimpo}`
-    });
-    const prod = data.produto || data;
-    return {
-      gtin: prod.GTIN || prod.gtin || gtinLimpo,
-      xProd: prod.xProd || prod.descricao || "Descri\xE7\xE3o Indispon\xEDvel",
-      descricao_completa: prod.descricao_completa,
-      ficha_tecnica: prod.ficha_tecnica,
-      palavras_chave: prod.palavras_chave,
-      ncm: prod.NCM || prod.ncm,
-      cest: prod.CEST || prod.cest,
-      marca: prod.marca,
-      categoria: prod.categoria,
-      imagem_url: prod.imagem_url,
-      peso_bruto: prod.peso_bruto ? Number(prod.peso_bruto) : void 0,
-      peso_liquido: prod.peso_liquido ? Number(prod.peso_liquido) : void 0,
-      dados_tributarios_sugeridos: prod.dados_tributarios_sugeridos
-    };
+    const data = await this.request({ method: "GET", path: `/v2/gtin/${gtinLimpo}` });
+    return produtoEnriquecidoDaApi(data, gtinLimpo);
   }
   /**
    * Executa busca semântica por intenção/linguagem natural (V2).
    * @param query Termo livre de busca (ex: 'refrigerante zero lata').
    */
   async search(query) {
-    const data = await this.request({
-      method: "GET",
-      path: "/v2/gtin/search",
-      params: { q: query }
-    });
-    const itens = (data.produtos || []).map((item) => ({
-      gtin: String(item.GTIN || item.gtin),
-      xProd: String(item.xProd || item.descricao),
-      marca: item.marca,
-      categoria: item.categoria,
-      score: item.score !== void 0 ? Number(item.score) : void 0,
-      ncm: item.NCM || item.ncm,
-      cest: item.CEST || item.cest,
-      imagem_url: item.imagem_url
-    }));
-    return {
-      status: data.status || "success",
-      provider: data.provider || "PAIRUS",
-      total_encontrados: itens.length,
-      termo_buscado: query,
-      produtos: itens
-    };
+    const data = await this.request({ method: "GET", path: "/v2/gtin/search", params: { q: query } });
+    return buscaDaApi(data, query);
   }
   /**
    * Reconhece código de barras por visão computacional a partir de foto JPEG (OCR V2).
@@ -654,27 +715,8 @@ var ProductsResource = class extends BaseResource {
         formData.append("file", blob, "barcode.jpg");
       }
     }
-    const data = await this.request({
-      method: "POST",
-      path: "/v2/gtin/scan",
-      body: formData
-    });
-    const prod = data.produto || data;
-    return {
-      gtin: prod.GTIN || prod.gtin || "",
-      xProd: prod.xProd || prod.descricao || "Descri\xE7\xE3o Indispon\xEDvel",
-      descricao_completa: prod.descricao_completa,
-      ficha_tecnica: prod.ficha_tecnica,
-      palavras_chave: prod.palavras_chave,
-      ncm: prod.NCM || prod.ncm,
-      cest: prod.CEST || prod.cest,
-      marca: prod.marca,
-      categoria: prod.categoria,
-      imagem_url: prod.imagem_url,
-      peso_bruto: prod.peso_bruto ? Number(prod.peso_bruto) : void 0,
-      peso_liquido: prod.peso_liquido ? Number(prod.peso_liquido) : void 0,
-      dados_tributarios_sugeridos: prod.dados_tributarios_sugeridos
-    };
+    const data = await this.request({ method: "POST", path: "/v2/gtin/scan", body: formData });
+    return produtoEnriquecidoDaApi(data);
   }
 };