@pairus/product-data 1.3.1 → 1.5.0

package/dist/index.d.mts

@@ -128,106 +128,116 @@ declare class DFeResource extends BaseResource {
     baixarDanfe(chaveAcesso: string): Promise<ArrayBuffer>;
 }
 
+/**
+ * Item da nota fiscal. Os nomes espelham o contrato da API (/v1/nfe/emitir e /v1/nfce/emitir).
+ */
 interface EmissaoItemInput {
-    cProd: string;
-    xProd: string;
-    NCM: string;
-    CFOP: string;
-    uCom: string;
-    qCom: number;
-    vUnCom: number;
-    vProd: number;
-    cEAN?: string;
-    cEANTrib?: string;
-    uTrib?: string;
-    qTrib?: number;
-    vUnTrib?: number;
-    vDesc?: number;
-    vFrete?: number;
-    vSeg?: number;
-    vOutro?: number;
-    CEST?: string;
-    origem?: string;
-    cst_icms?: string;
-    csosn_icms?: string;
-    pICMS?: number;
-    cst_pis?: string;
-    pPIS?: number;
-    cst_cofins?: string;
-    pCOFINS?: number;
-    cst_ibscbs?: string;
-    cClassTrib?: string;
-    infAdProd?: string;
+    descricao: string;
+    valor_unitario: number;
+    quantidade?: number;
+    codigo_produto?: string;
+    /** Código de barras GTIN/EAN ou 'SEM GTIN'. */
+    gtin?: string;
+    ncm?: string;
+    cest?: string;
+    cfop?: string;
+    /** '0' Nacional, '1' Importada, etc. */
+    origem_mercadoria?: string;
+    unidade_comercial?: string;
+    /** Desconto concedido no item (R$). */
+    desconto?: number;
+    /** CST (Regime Normal) ou CSOSN (Simples Nacional) do ICMS. */
+    icms_cst_csosn?: string;
+    icms_aliquota?: number;
+    pis_cst?: string;
+    pis_aliquota?: number;
+    cofins_cst?: string;
+    cofins_aliquota?: number;
+    informacoes_adicionais?: string;
+    [key: string]: any;
 }
 interface EmissaoDestinatarioInput {
-    cpf_cnpj: string;
-    xNome: string;
-    indIEDest?: string;
-    IE?: string;
+    /** CPF (11 dígitos) ou CNPJ (14 dígitos). Obrigatório na NF-e; opcional na NFC-e. */
+    cpf_cnpj?: string;
+    razao_social?: string;
+    /** '1' Contribuinte, '2' Isento, '9' Não Contribuinte. */
+    indicador_ie?: string;
+    inscricao_estadual?: string;
+    consumidor_final?: boolean;
     email?: string;
-    telefone?: string;
     logradouro?: string;
     numero?: string;
+    complemento?: string;
     bairro?: string;
     codigo_municipio?: string;
-    nome_municipio?: string;
+    municipio?: string;
     uf?: string;
     cep?: string;
+    [key: string]: any;
+}
+/** Forma de pagamento; acima do total da nota, a API gera o troco (vTroco). */
+interface EmissaoPagamentoInput {
+    /** Código SEFAZ: '01' Dinheiro, '03' Crédito, '04' Débito, '17' PIX... */
+    forma_pagamento?: string;
+    valor: number;
 }
 interface EmissaoNFeInput {
-    natureza_operacao: string;
+    cnpj_emitente: string;
     itens: EmissaoItemInput[];
-    destinatario?: EmissaoDestinatarioInput;
+    tipo_documento?: 'NFE' | 'NFCE';
+    modo_emissao?: 'direto' | 'assistido' | 'simulacao';
+    ambiente?: 'producao' | 'homologacao';
+    natureza_operacao?: string;
     serie?: number;
+    /** Omitido: a API reserva o próximo número de forma atômica. */
     numero?: number;
-    tipo_documento?: number;
-    finalidade_emissao?: number;
-    consumidor_final?: number;
-    presenca_comprador?: number;
-    forma_pagamento?: string;
-    valor_pagamento?: number;
+    destinatario?: EmissaoDestinatarioInput;
+    /** Desconto sobre o total da nota (R$), rateado proporcionalmente entre os itens pela API. */
+    desconto_geral?: number;
+    pagamentos?: EmissaoPagamentoInput[];
     informacoes_complementares?: string;
-    autocura?: boolean;
-    modo_emissao?: 'producao' | 'homologacao' | 'simulacao';
     id_token_csc?: string;
     codigo_csc?: string;
     [key: string]: any;
 }
-interface DetalheAutocura {
-    campo: string;
-    valor_original: any;
-    valor_corrigido: any;
-    motivo: string;
+/** Opções de envio da emissão. */
+interface EmissaoOptions {
+    /**
+     * Identificador único da venda (8 a 128 caracteres). Se omitido, o SDK gera um UUID e o reutiliza
+     * nas retentativas automáticas, impedindo que um timeout emita a mesma venda duas vezes.
+     */
+    idempotencyKey?: string;
 }
 interface EmissaoNFeResponse {
-    status: string;
-    cStat: string;
+    sucesso: boolean;
+    /** 'AUTORIZADA', 'REJEITADA', 'PENDENTE_RETORNO', 'DENEGADA' ou 'SIMULADA'. */
+    status_sefaz: string;
+    cStat: number;
     xMotivo: string;
-    chave_acesso?: string;
-    numero?: number;
-    serie?: number;
-    protocolo?: string;
-    xml_autorizado?: string;
-    danfe_url?: string;
-    qrcode_url?: string;
+    chave_acesso?: string | null;
+    protocolo?: string | null;
+    numero?: number | null;
+    serie?: number | null;
+    data_emissao?: string | null;
     ambiente?: string;
+    tipo_documento?: string;
     autocura_aplicada?: boolean;
-    detalhes_autocura?: DetalheAutocura[];
-    simulacao?: boolean;
+    xml_autorizado_base64?: string | null;
+    danfe_pdf_base64?: string | null;
+    qrcode_url?: string | null;
     consumo_creditos?: number;
-    avisos?: string[];
+    /** true quando é a repetição de uma emissão já processada com a mesma Idempotency-Key. */
+    repeticao_idempotente?: boolean;
     [key: string]: any;
 }
 interface EventoNFeResponse {
-    status: string;
     sucesso: boolean;
     cStat: string | number;
     xMotivo: string;
     tipo_evento: string;
-    protocolo?: string;
-    chave_acesso?: string;
-    data_evento?: string;
-    xml_evento_base64?: string;
+    protocolo_evento?: string | null;
+    data_registro?: string | null;
+    xml_evento_base64?: string | null;
     consumo_creditos?: number;
     [key: string]: any;
 }
@@ -248,18 +258,19 @@ interface InutilizacaoInput {
     numero_final: number;
     justificativa: string;
     ano?: number;
-    modelo?: number;
+    /** '55' (NF-e) ou '65' (NFC-e). */
+    modelo?: '55' | '65' | 55 | 65;
 }
 
 declare class EmissaoResource extends BaseResource {
     /**
      * Emite uma Nota Fiscal Eletrônica (NF-e Modelo 55) perante a SEFAZ.
      */
-    emitirNFe(payload: EmissaoNFeInput): Promise<EmissaoNFeResponse>;
+    emitirNFe(payload: EmissaoNFeInput, options?: EmissaoOptions): Promise<EmissaoNFeResponse>;
     /**
      * Emite uma Nota Fiscal de Consumidor Eletrônica (NFC-e Modelo 65) perante a SEFAZ.
      */
-    emitirNFCe(payload: EmissaoNFeInput): Promise<EmissaoNFeResponse>;
+    emitirNFCe(payload: EmissaoNFeInput, options?: EmissaoOptions): Promise<EmissaoNFeResponse>;
     /**
      * Simula uma emissão fiscal sem transmitir à SEFAZ (custo ZERO de créditos).
      */
@@ -661,4 +672,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 DetalheAutocura, type DocumentoDFe, type EmissaoDestinatarioInput, type EmissaoItemInput, type EmissaoNFeInput, type EmissaoNFeResponse, 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 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.d.ts

@@ -128,106 +128,116 @@ declare class DFeResource extends BaseResource {
     baixarDanfe(chaveAcesso: string): Promise<ArrayBuffer>;
 }
 
+/**
+ * Item da nota fiscal. Os nomes espelham o contrato da API (/v1/nfe/emitir e /v1/nfce/emitir).
+ */
 interface EmissaoItemInput {
-    cProd: string;
-    xProd: string;
-    NCM: string;
-    CFOP: string;
-    uCom: string;
-    qCom: number;
-    vUnCom: number;
-    vProd: number;
-    cEAN?: string;
-    cEANTrib?: string;
-    uTrib?: string;
-    qTrib?: number;
-    vUnTrib?: number;
-    vDesc?: number;
-    vFrete?: number;
-    vSeg?: number;
-    vOutro?: number;
-    CEST?: string;
-    origem?: string;
-    cst_icms?: string;
-    csosn_icms?: string;
-    pICMS?: number;
-    cst_pis?: string;
-    pPIS?: number;
-    cst_cofins?: string;
-    pCOFINS?: number;
-    cst_ibscbs?: string;
-    cClassTrib?: string;
-    infAdProd?: string;
+    descricao: string;
+    valor_unitario: number;
+    quantidade?: number;
+    codigo_produto?: string;
+    /** Código de barras GTIN/EAN ou 'SEM GTIN'. */
+    gtin?: string;
+    ncm?: string;
+    cest?: string;
+    cfop?: string;
+    /** '0' Nacional, '1' Importada, etc. */
+    origem_mercadoria?: string;
+    unidade_comercial?: string;
+    /** Desconto concedido no item (R$). */
+    desconto?: number;
+    /** CST (Regime Normal) ou CSOSN (Simples Nacional) do ICMS. */
+    icms_cst_csosn?: string;
+    icms_aliquota?: number;
+    pis_cst?: string;
+    pis_aliquota?: number;
+    cofins_cst?: string;
+    cofins_aliquota?: number;
+    informacoes_adicionais?: string;
+    [key: string]: any;
 }
 interface EmissaoDestinatarioInput {
-    cpf_cnpj: string;
-    xNome: string;
-    indIEDest?: string;
-    IE?: string;
+    /** CPF (11 dígitos) ou CNPJ (14 dígitos). Obrigatório na NF-e; opcional na NFC-e. */
+    cpf_cnpj?: string;
+    razao_social?: string;
+    /** '1' Contribuinte, '2' Isento, '9' Não Contribuinte. */
+    indicador_ie?: string;
+    inscricao_estadual?: string;
+    consumidor_final?: boolean;
     email?: string;
-    telefone?: string;
     logradouro?: string;
     numero?: string;
+    complemento?: string;
     bairro?: string;
     codigo_municipio?: string;
-    nome_municipio?: string;
+    municipio?: string;
     uf?: string;
     cep?: string;
+    [key: string]: any;
+}
+/** Forma de pagamento; acima do total da nota, a API gera o troco (vTroco). */
+interface EmissaoPagamentoInput {
+    /** Código SEFAZ: '01' Dinheiro, '03' Crédito, '04' Débito, '17' PIX... */
+    forma_pagamento?: string;
+    valor: number;
 }
 interface EmissaoNFeInput {
-    natureza_operacao: string;
+    cnpj_emitente: string;
     itens: EmissaoItemInput[];
-    destinatario?: EmissaoDestinatarioInput;
+    tipo_documento?: 'NFE' | 'NFCE';
+    modo_emissao?: 'direto' | 'assistido' | 'simulacao';
+    ambiente?: 'producao' | 'homologacao';
+    natureza_operacao?: string;
     serie?: number;
+    /** Omitido: a API reserva o próximo número de forma atômica. */
     numero?: number;
-    tipo_documento?: number;
-    finalidade_emissao?: number;
-    consumidor_final?: number;
-    presenca_comprador?: number;
-    forma_pagamento?: string;
-    valor_pagamento?: number;
+    destinatario?: EmissaoDestinatarioInput;
+    /** Desconto sobre o total da nota (R$), rateado proporcionalmente entre os itens pela API. */
+    desconto_geral?: number;
+    pagamentos?: EmissaoPagamentoInput[];
     informacoes_complementares?: string;
-    autocura?: boolean;
-    modo_emissao?: 'producao' | 'homologacao' | 'simulacao';
     id_token_csc?: string;
     codigo_csc?: string;
     [key: string]: any;
 }
-interface DetalheAutocura {
-    campo: string;
-    valor_original: any;
-    valor_corrigido: any;
-    motivo: string;
+/** Opções de envio da emissão. */
+interface EmissaoOptions {
+    /**
+     * Identificador único da venda (8 a 128 caracteres). Se omitido, o SDK gera um UUID e o reutiliza
+     * nas retentativas automáticas, impedindo que um timeout emita a mesma venda duas vezes.
+     */
+    idempotencyKey?: string;
 }
 interface EmissaoNFeResponse {
-    status: string;
-    cStat: string;
+    sucesso: boolean;
+    /** 'AUTORIZADA', 'REJEITADA', 'PENDENTE_RETORNO', 'DENEGADA' ou 'SIMULADA'. */
+    status_sefaz: string;
+    cStat: number;
     xMotivo: string;
-    chave_acesso?: string;
-    numero?: number;
-    serie?: number;
-    protocolo?: string;
-    xml_autorizado?: string;
-    danfe_url?: string;
-    qrcode_url?: string;
+    chave_acesso?: string | null;
+    protocolo?: string | null;
+    numero?: number | null;
+    serie?: number | null;
+    data_emissao?: string | null;
     ambiente?: string;
+    tipo_documento?: string;
     autocura_aplicada?: boolean;
-    detalhes_autocura?: DetalheAutocura[];
-    simulacao?: boolean;
+    xml_autorizado_base64?: string | null;
+    danfe_pdf_base64?: string | null;
+    qrcode_url?: string | null;
     consumo_creditos?: number;
-    avisos?: string[];
+    /** true quando é a repetição de uma emissão já processada com a mesma Idempotency-Key. */
+    repeticao_idempotente?: boolean;
     [key: string]: any;
 }
 interface EventoNFeResponse {
-    status: string;
     sucesso: boolean;
     cStat: string | number;
     xMotivo: string;
     tipo_evento: string;
-    protocolo?: string;
-    chave_acesso?: string;
-    data_evento?: string;
-    xml_evento_base64?: string;
+    protocolo_evento?: string | null;
+    data_registro?: string | null;
+    xml_evento_base64?: string | null;
     consumo_creditos?: number;
     [key: string]: any;
 }
@@ -248,18 +258,19 @@ interface InutilizacaoInput {
     numero_final: number;
     justificativa: string;
     ano?: number;
-    modelo?: number;
+    /** '55' (NF-e) ou '65' (NFC-e). */
+    modelo?: '55' | '65' | 55 | 65;
 }
 
 declare class EmissaoResource extends BaseResource {
     /**
      * Emite uma Nota Fiscal Eletrônica (NF-e Modelo 55) perante a SEFAZ.
      */
-    emitirNFe(payload: EmissaoNFeInput): Promise<EmissaoNFeResponse>;
+    emitirNFe(payload: EmissaoNFeInput, options?: EmissaoOptions): Promise<EmissaoNFeResponse>;
     /**
      * Emite uma Nota Fiscal de Consumidor Eletrônica (NFC-e Modelo 65) perante a SEFAZ.
      */
-    emitirNFCe(payload: EmissaoNFeInput): Promise<EmissaoNFeResponse>;
+    emitirNFCe(payload: EmissaoNFeInput, options?: EmissaoOptions): Promise<EmissaoNFeResponse>;
     /**
      * Simula uma emissão fiscal sem transmitir à SEFAZ (custo ZERO de créditos).
      */
@@ -661,4 +672,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 DetalheAutocura, type DocumentoDFe, type EmissaoDestinatarioInput, type EmissaoItemInput, type EmissaoNFeInput, type EmissaoNFeResponse, 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 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.2.0",
+      "User-Agent": "Pairus-NodeJS-SDK/1.5.0",
       ...options.headers || {}
     };
     const isFormData = typeof FormData !== "undefined" && options.body instanceof FormData;
@@ -165,7 +165,8 @@ var BaseResource = class {
           }
           throw new RateLimitError(retryAfterSec, errData.cStat, errData.xMotivo, errData);
         }
-        if ([502, 503, 504].includes(response.status) && attempt < this.maxRetries - 1) {
+        const vendaEmProcessamento = response.status === 409 && "Idempotency-Key" in reqHeaders;
+        if (([502, 503, 504].includes(response.status) || vendaEmProcessamento) && attempt < this.maxRetries - 1) {
           const delay = Math.pow(2, attempt) * 1e3 + Math.random() * 500;
           await new Promise((res) => setTimeout(res, delay));
           continue;
@@ -390,25 +391,31 @@ var DFeResource = class extends BaseResource {
 };
 
 // src/resources/emissao.ts
+var import_node_crypto = require("crypto");
+function cabecalhoIdempotencia(options) {
+  return { "Idempotency-Key": options?.idempotencyKey || (0, import_node_crypto.randomUUID)() };
+}
 var EmissaoResource = class extends BaseResource {
   /**
    * Emite uma Nota Fiscal Eletrônica (NF-e Modelo 55) perante a SEFAZ.
    */
-  async emitirNFe(payload) {
+  async emitirNFe(payload, options) {
     return this.request({
       method: "POST",
       path: "/v1/nfe/emitir",
-      body: payload
+      body: payload,
+      headers: cabecalhoIdempotencia(options)
     });
   }
   /**
    * Emite uma Nota Fiscal de Consumidor Eletrônica (NFC-e Modelo 65) perante a SEFAZ.
    */
-  async emitirNFCe(payload) {
+  async emitirNFCe(payload, options) {
     return this.request({
       method: "POST",
       path: "/v1/nfce/emitir",
-      body: payload
+      body: payload,
+      headers: cabecalhoIdempotencia(options)
     });
   }
   /**
@@ -463,7 +470,7 @@ var EmissaoResource = class extends BaseResource {
         numero_final: params.numero_final,
         justificativa: params.justificativa,
         ano: params.ano,
-        modelo: params.modelo ?? 55
+        modelo: String(params.modelo ?? "55")
       }
     });
   }