@pairus/product-data 1.15.0 → 1.17.0

package/README.md

@@ -110,8 +110,8 @@ console.log(trib.avisos_fiscais);
 #### Saneamento Fiscal em Lote
 ```typescript
 const lote = await client.fiscal.sanitize([
-  { NCM: '22021000', xProd: 'Refrigerante Cola', id: 'SKU-001' },
-  { NCM: '22030000', CEST: '0302100', xProd: 'Cerveja Pilsen' },
+  { ncm: '22021000', xProd: 'Refrigerante Cola', id: 'SKU-001' },
+  { ncm: '22030000', cest: '0302100', xProd: 'Cerveja Pilsen' },
 ]);
 
 for (const item of lote.itens) {
@@ -277,6 +277,25 @@ const inut = await client.emissao.inutilizar({
 console.log('Inutilização homologada:', inut.sucesso);
 ```
 
+#### Consulta da Nota Emitida e Referência da Venda
+Informe `referencia_externa` na emissão. Ela volta na resposta e em todo webhook, junto com `cnpj_emitente`, e localiza a nota mesmo quando a resposta da emissão se perdeu:
+```typescript
+const notas = await client.emissao.buscarPorReferencia('12345678000195', 'pedido-8841');
+if (notas.length === 0) {
+  // nenhuma nota gravada para a venda: é seguro emitir
+}
+const nota = await client.emissao.consultar(notas[0].chave_acesso, { incluirXml: true });
+const pdf = await client.emissao.baixarDanfe(nota.chave_acesso);
+```
+
+#### CSC da NFC-e
+```typescript
+const status = await client.empresas.configurarCsc('12345678000195', {
+  ambiente: 'producao', csc_id: '000001', csc_codigo: 'SEU_CSC_DA_SEFAZ',
+});
+console.log(status.producao.configurado); // o código nunca é devolvido
+```
+
 ### 6. 📥 DF-e Inbound & Captura SEFAZ Nacional (Gestão de Compras)
 
 Capture ativamente as notas fiscais emitidas por fornecedores contra o seu CNPJ via WebService `NFeDistribuicaoDFe` da SEFAZ Nacional, com controle incremental de NSU, descompactação automática de lotes `docZip` e Manifestação do Destinatário.

package/dist/index.d.mts

@@ -271,6 +271,8 @@ interface EmissaoNFeInput {
         cnpj: string;
         id_cadastro: string;
     };
+    /** Identificador da venda no seu sistema; volta nos webhooks e localiza a nota em `buscarPorReferencia`. */
+    referencia_externa?: string;
     [key: string]: any;
 }
 /** Opções de envio da emissão. */
@@ -301,6 +303,8 @@ interface EmissaoNFeResponse {
     data_emissao?: string | null;
     ambiente?: string;
     tipo_documento?: string;
+    /** Identificador da venda informado na emissão. */
+    referencia_externa?: string | null;
     autocura_aplicada?: boolean;
     xml_autorizado_base64?: string | null;
     danfe_pdf_base64?: string | null;
@@ -341,6 +345,48 @@ interface InutilizacaoInput {
     /** '55' (NF-e) ou '65' (NFC-e). */
     modelo?: '55' | '65' | 55 | 65;
 }
+/** Situação atual de uma nota emitida (`GET /v1/nfe/{chave}` e `GET /v1/nfe?referencia_externa=`). */
+interface NotaEmitidaResponse {
+    chave_acesso: string;
+    tipo_documento?: 'NFE' | 'NFCE' | null;
+    serie?: number | null;
+    numero?: number | null;
+    /** 'AUTORIZADA', 'PENDENTE_RETORNO', 'CONTINGENCIA', 'CANCELADA', 'REJEITADA'... */
+    status_sefaz?: string | null;
+    cStat?: number | null;
+    xMotivo?: string | null;
+    protocolo?: string | null;
+    data_emissao?: string | null;
+    ambiente?: string | null;
+    cnpj_emitente?: string | null;
+    referencia_externa?: string | null;
+    valor_total?: number | null;
+    qrcode_url?: string | null;
+    substituida_por?: string | null;
+    chave_substituida?: string | null;
+    prazo_transmissao?: string | null;
+    /** procNFe em Base64, só com `incluirXml: true`. */
+    xml_autorizado_base64?: string | null;
+}
+/** Situação do CSC em um ambiente. O código nunca é devolvido pela API. */
+interface CscAmbienteStatus {
+    configurado: boolean;
+    csc_id?: string | null;
+}
+/** Situação do CSC da NFC-e do estabelecimento (`/v1/empresas/{cnpj}/csc`). */
+interface CscNFCeStatus {
+    cnpj: string;
+    producao: CscAmbienteStatus;
+    homologacao: CscAmbienteStatus;
+}
+/** CSC gerado no portal da SEFAZ da UF, por ambiente. */
+interface CscNFCeInput {
+    ambiente: 'producao' | 'homologacao';
+    /** Identificador do CSC (ex: '000001'). */
+    csc_id: string;
+    /** Código do CSC (16 a 36 letras e números). */
+    csc_codigo: string;
+}
 
 declare class EmissaoResource extends BaseResource {
     /**
@@ -367,6 +413,35 @@ declare class EmissaoResource extends BaseResource {
      * Inutiliza uma faixa de numeração quebrada na SEFAZ (Ajuste SINIEF 07/05).
      */
     inutilizar(params: InutilizacaoInput): Promise<EventoNFeResponse>;
+    /**
+     * Consulta a situação atual de uma NF-e ou NFC-e emitida pela sua conta.
+     *
+     * @param chaveAcesso Chave de 44 dígitos da nota
+     * @param options `incluirXml` traz o procNFe em Base64
+     */
+    consultar(chaveAcesso: string, options?: {
+        incluirXml?: boolean;
+    }): Promise<NotaEmitidaResponse>;
+    /**
+     * Localiza as notas emitidas para uma venda pela `referencia_externa` informada na emissão.
+     * Lista vazia: nenhuma nota gravada para a venda, é seguro emitir.
+     */
+    buscarPorReferencia(cnpjEmitente: string, referenciaExterna: string): Promise<NotaEmitidaResponse[]>;
+    /**
+     * Baixa o DANFE em PDF de uma nota emitida (na contingência ainda não transmitida, com a tarja).
+     */
+    baixarDanfe(chaveAcesso: string): Promise<ArrayBuffer>;
+}
+
+/** Cadastro de empresas emitentes (CSC da NFC-e). */
+declare class EmpresasResource extends BaseResource {
+    /**
+     * Grava o CSC da NFC-e do estabelecimento (gerado no portal da SEFAZ da UF).
+     * O estabelecimento precisa de certificado próprio na conta; o código nunca é devolvido.
+     */
+    configurarCsc(cnpj: string, input: CscNFCeInput): Promise<CscNFCeStatus>;
+    /** Indica, por ambiente, se o CSC da NFC-e está configurado (sem devolver o código). */
+    consultarCsc(cnpj: string): Promise<CscNFCeStatus>;
 }
 
 /**
@@ -473,16 +548,22 @@ interface TaxPredictionData {
     beneficio_fiscal?: string;
 }
 interface TaxPredictionItemInput {
+    /** Identificador do item no ERP, devolvido no resultado. */
+    id?: string;
     xProd?: string;
     gtin?: string;
     ncm?: string;
     cest?: string;
+    /** Substitui a `finalidade` do topo neste item. */
+    finalidade?: 'revenda' | 'consumo_final' | 'industrializacao';
 }
 interface TaxPredictionParams {
     regimeTributario: 'simples_nacional' | 'lucro_presumido' | 'lucro_real' | string;
     ufOrigem: string;
     ufDestino?: string;
+    /** `revenda`: comprado para revender. `industrializacao`: fabricado pelo vendedor. `consumo_final`: o comprador usa e não revende. */
     finalidade?: 'revenda' | 'consumo_final' | 'industrializacao' | string;
+    /** Se o comprador é contribuinte do ICMS (`false` na venda a pessoa física). */
     destinatarioContribuinte?: boolean;
     /** Alíquota de crédito de ICMS do Simples Nacional (pCredSN). */
     aliquotaCreditoIcmsSn?: number;
@@ -496,6 +577,7 @@ interface TaxPredictionParams {
 }
 interface TaxPredictionItemResult {
     item_index: number;
+    id?: string | null;
     xProd?: string | null;
     dados_tributarios: TaxPredictionData;
 }
@@ -508,27 +590,28 @@ interface TaxPredictionResponse {
     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.
- */
+/** Item do saneamento, com os mesmos nomes do item da predição. `ncm` é obrigatório. */
 interface FiscalSanitizeItemInput {
-    NCM?: string;
-    CEST?: string;
-    xProd?: string;
-    id?: string;
-    /** @deprecated Use `NCM`. */
     ncm?: string;
-    /** @deprecated Use `CEST`. */
     cest?: string;
+    xProd?: string;
+    gtin?: string;
+    id?: string;
+    /** @deprecated Use `ncm`. */
+    NCM?: string;
+    /** @deprecated Use `cest`. */
+    CEST?: string;
     /** @deprecated Use `xProd`. */
     descricao?: string;
-    /** @deprecated Use `id`. */
-    gtin?: string;
+}
+interface FiscalSanitizeOptions {
+    /** UF de referência das alíquotas e da regra de ST. */
+    ufOrigem?: string;
 }
 interface FiscalSanitizeItemResult {
     id?: string;
     xProd?: string;
+    gtin?: string | null;
     NCM_informado?: string;
     CEST_informado?: string | null;
     auditoria_fiscal: Record<string, any>;
@@ -548,9 +631,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.
+     * Cada item precisa de `ncm`; `cest`, `xProd`, `gtin` e `id` são opcionais.
      */
-    sanitize(itens: FiscalSanitizeItemInput[]): Promise<FiscalSanitizeResponse>;
+    sanitize(itens: FiscalSanitizeItemInput[], opcoes?: FiscalSanitizeOptions): Promise<FiscalSanitizeResponse>;
 }
 
 interface EnderecoNFSeInput {
@@ -867,6 +950,7 @@ declare class PairusProductData {
     readonly emissao: EmissaoResource;
     readonly nfse: NFSeResource;
     readonly dfe: DFeResource;
+    readonly empresas: EmpresasResource;
     constructor(options?: PairusClientOptions);
 }
 
@@ -897,4 +981,4 @@ declare class NetworkError extends PairusError {
     constructor(message: string);
 }
 
-export { AuthenticationError, type CancelamentoInput, type CancelamentoNFSeInput, type CancelamentoNFSeResponse, type CartaCorrecaoInput, type CertificadoDFe, 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 EnviarCertificadoDFeInput, type EnviarCertificadoDFeResponse, 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 StatusCertificadoDFeResponse, 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, type CertificadoDFe, type CscAmbienteStatus, type CscNFCeInput, type CscNFCeStatus, 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, EmpresasResource, type EnderecoNFSeInput, type EnviarCertificadoDFeInput, type EnviarCertificadoDFeResponse, type EventoNFeResponse, FiscalResource, type FiscalSanitizeItemInput, type FiscalSanitizeItemResult, type FiscalSanitizeOptions, type FiscalSanitizeResponse, type FuelData, type IBSCBSData, type InutilizacaoInput, InvalidSignatureError, type ListarDocumentosDFeParams, type ListarDocumentosDFeResponse, type ManifestarDFeInput, type ManifestarDFeResponse, type NFSeEmissaoInput, type NFSeEmissaoResponse, NFSeResource, NetworkError, type NotaEmitidaResponse, 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 StatusCertificadoDFeResponse, type TaxPredictionData, type TaxPredictionItemInput, type TaxPredictionItemResult, type TaxPredictionParams, type TaxPredictionResponse, type TipoManifestacaoDFe, type TomadorNFSeInput, type WebhookEvent, Webhooks };

package/dist/index.d.ts

@@ -271,6 +271,8 @@ interface EmissaoNFeInput {
         cnpj: string;
         id_cadastro: string;
     };
+    /** Identificador da venda no seu sistema; volta nos webhooks e localiza a nota em `buscarPorReferencia`. */
+    referencia_externa?: string;
     [key: string]: any;
 }
 /** Opções de envio da emissão. */
@@ -301,6 +303,8 @@ interface EmissaoNFeResponse {
     data_emissao?: string | null;
     ambiente?: string;
     tipo_documento?: string;
+    /** Identificador da venda informado na emissão. */
+    referencia_externa?: string | null;
     autocura_aplicada?: boolean;
     xml_autorizado_base64?: string | null;
     danfe_pdf_base64?: string | null;
@@ -341,6 +345,48 @@ interface InutilizacaoInput {
     /** '55' (NF-e) ou '65' (NFC-e). */
     modelo?: '55' | '65' | 55 | 65;
 }
+/** Situação atual de uma nota emitida (`GET /v1/nfe/{chave}` e `GET /v1/nfe?referencia_externa=`). */
+interface NotaEmitidaResponse {
+    chave_acesso: string;
+    tipo_documento?: 'NFE' | 'NFCE' | null;
+    serie?: number | null;
+    numero?: number | null;
+    /** 'AUTORIZADA', 'PENDENTE_RETORNO', 'CONTINGENCIA', 'CANCELADA', 'REJEITADA'... */
+    status_sefaz?: string | null;
+    cStat?: number | null;
+    xMotivo?: string | null;
+    protocolo?: string | null;
+    data_emissao?: string | null;
+    ambiente?: string | null;
+    cnpj_emitente?: string | null;
+    referencia_externa?: string | null;
+    valor_total?: number | null;
+    qrcode_url?: string | null;
+    substituida_por?: string | null;
+    chave_substituida?: string | null;
+    prazo_transmissao?: string | null;
+    /** procNFe em Base64, só com `incluirXml: true`. */
+    xml_autorizado_base64?: string | null;
+}
+/** Situação do CSC em um ambiente. O código nunca é devolvido pela API. */
+interface CscAmbienteStatus {
+    configurado: boolean;
+    csc_id?: string | null;
+}
+/** Situação do CSC da NFC-e do estabelecimento (`/v1/empresas/{cnpj}/csc`). */
+interface CscNFCeStatus {
+    cnpj: string;
+    producao: CscAmbienteStatus;
+    homologacao: CscAmbienteStatus;
+}
+/** CSC gerado no portal da SEFAZ da UF, por ambiente. */
+interface CscNFCeInput {
+    ambiente: 'producao' | 'homologacao';
+    /** Identificador do CSC (ex: '000001'). */
+    csc_id: string;
+    /** Código do CSC (16 a 36 letras e números). */
+    csc_codigo: string;
+}
 
 declare class EmissaoResource extends BaseResource {
     /**
@@ -367,6 +413,35 @@ declare class EmissaoResource extends BaseResource {
      * Inutiliza uma faixa de numeração quebrada na SEFAZ (Ajuste SINIEF 07/05).
      */
     inutilizar(params: InutilizacaoInput): Promise<EventoNFeResponse>;
+    /**
+     * Consulta a situação atual de uma NF-e ou NFC-e emitida pela sua conta.
+     *
+     * @param chaveAcesso Chave de 44 dígitos da nota
+     * @param options `incluirXml` traz o procNFe em Base64
+     */
+    consultar(chaveAcesso: string, options?: {
+        incluirXml?: boolean;
+    }): Promise<NotaEmitidaResponse>;
+    /**
+     * Localiza as notas emitidas para uma venda pela `referencia_externa` informada na emissão.
+     * Lista vazia: nenhuma nota gravada para a venda, é seguro emitir.
+     */
+    buscarPorReferencia(cnpjEmitente: string, referenciaExterna: string): Promise<NotaEmitidaResponse[]>;
+    /**
+     * Baixa o DANFE em PDF de uma nota emitida (na contingência ainda não transmitida, com a tarja).
+     */
+    baixarDanfe(chaveAcesso: string): Promise<ArrayBuffer>;
+}
+
+/** Cadastro de empresas emitentes (CSC da NFC-e). */
+declare class EmpresasResource extends BaseResource {
+    /**
+     * Grava o CSC da NFC-e do estabelecimento (gerado no portal da SEFAZ da UF).
+     * O estabelecimento precisa de certificado próprio na conta; o código nunca é devolvido.
+     */
+    configurarCsc(cnpj: string, input: CscNFCeInput): Promise<CscNFCeStatus>;
+    /** Indica, por ambiente, se o CSC da NFC-e está configurado (sem devolver o código). */
+    consultarCsc(cnpj: string): Promise<CscNFCeStatus>;
 }
 
 /**
@@ -473,16 +548,22 @@ interface TaxPredictionData {
     beneficio_fiscal?: string;
 }
 interface TaxPredictionItemInput {
+    /** Identificador do item no ERP, devolvido no resultado. */
+    id?: string;
     xProd?: string;
     gtin?: string;
     ncm?: string;
     cest?: string;
+    /** Substitui a `finalidade` do topo neste item. */
+    finalidade?: 'revenda' | 'consumo_final' | 'industrializacao';
 }
 interface TaxPredictionParams {
     regimeTributario: 'simples_nacional' | 'lucro_presumido' | 'lucro_real' | string;
     ufOrigem: string;
     ufDestino?: string;
+    /** `revenda`: comprado para revender. `industrializacao`: fabricado pelo vendedor. `consumo_final`: o comprador usa e não revende. */
     finalidade?: 'revenda' | 'consumo_final' | 'industrializacao' | string;
+    /** Se o comprador é contribuinte do ICMS (`false` na venda a pessoa física). */
     destinatarioContribuinte?: boolean;
     /** Alíquota de crédito de ICMS do Simples Nacional (pCredSN). */
     aliquotaCreditoIcmsSn?: number;
@@ -496,6 +577,7 @@ interface TaxPredictionParams {
 }
 interface TaxPredictionItemResult {
     item_index: number;
+    id?: string | null;
     xProd?: string | null;
     dados_tributarios: TaxPredictionData;
 }
@@ -508,27 +590,28 @@ interface TaxPredictionResponse {
     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.
- */
+/** Item do saneamento, com os mesmos nomes do item da predição. `ncm` é obrigatório. */
 interface FiscalSanitizeItemInput {
-    NCM?: string;
-    CEST?: string;
-    xProd?: string;
-    id?: string;
-    /** @deprecated Use `NCM`. */
     ncm?: string;
-    /** @deprecated Use `CEST`. */
     cest?: string;
+    xProd?: string;
+    gtin?: string;
+    id?: string;
+    /** @deprecated Use `ncm`. */
+    NCM?: string;
+    /** @deprecated Use `cest`. */
+    CEST?: string;
     /** @deprecated Use `xProd`. */
     descricao?: string;
-    /** @deprecated Use `id`. */
-    gtin?: string;
+}
+interface FiscalSanitizeOptions {
+    /** UF de referência das alíquotas e da regra de ST. */
+    ufOrigem?: string;
 }
 interface FiscalSanitizeItemResult {
     id?: string;
     xProd?: string;
+    gtin?: string | null;
     NCM_informado?: string;
     CEST_informado?: string | null;
     auditoria_fiscal: Record<string, any>;
@@ -548,9 +631,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.
+     * Cada item precisa de `ncm`; `cest`, `xProd`, `gtin` e `id` são opcionais.
      */
-    sanitize(itens: FiscalSanitizeItemInput[]): Promise<FiscalSanitizeResponse>;
+    sanitize(itens: FiscalSanitizeItemInput[], opcoes?: FiscalSanitizeOptions): Promise<FiscalSanitizeResponse>;
 }
 
 interface EnderecoNFSeInput {
@@ -867,6 +950,7 @@ declare class PairusProductData {
     readonly emissao: EmissaoResource;
     readonly nfse: NFSeResource;
     readonly dfe: DFeResource;
+    readonly empresas: EmpresasResource;
     constructor(options?: PairusClientOptions);
 }
 
@@ -897,4 +981,4 @@ declare class NetworkError extends PairusError {
     constructor(message: string);
 }
 
-export { AuthenticationError, type CancelamentoInput, type CancelamentoNFSeInput, type CancelamentoNFSeResponse, type CartaCorrecaoInput, type CertificadoDFe, 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 EnviarCertificadoDFeInput, type EnviarCertificadoDFeResponse, 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 StatusCertificadoDFeResponse, 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, type CertificadoDFe, type CscAmbienteStatus, type CscNFCeInput, type CscNFCeStatus, 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, EmpresasResource, type EnderecoNFSeInput, type EnviarCertificadoDFeInput, type EnviarCertificadoDFeResponse, type EventoNFeResponse, FiscalResource, type FiscalSanitizeItemInput, type FiscalSanitizeItemResult, type FiscalSanitizeOptions, type FiscalSanitizeResponse, type FuelData, type IBSCBSData, type InutilizacaoInput, InvalidSignatureError, type ListarDocumentosDFeParams, type ListarDocumentosDFeResponse, type ManifestarDFeInput, type ManifestarDFeResponse, type NFSeEmissaoInput, type NFSeEmissaoResponse, NFSeResource, NetworkError, type NotaEmitidaResponse, 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 StatusCertificadoDFeResponse, type TaxPredictionData, type TaxPredictionItemInput, type TaxPredictionItemResult, type TaxPredictionParams, type TaxPredictionResponse, type TipoManifestacaoDFe, type TomadorNFSeInput, type WebhookEvent, Webhooks };

package/dist/index.js

@@ -36,6 +36,7 @@ __export(index_exports, {
   DEFAULT_TIMEOUT_MS: () => DEFAULT_TIMEOUT_MS,
   DFeResource: () => DFeResource,
   EmissaoResource: () => EmissaoResource,
+  EmpresasResource: () => EmpresasResource,
   FiscalResource: () => FiscalResource,
   InvalidSignatureError: () => InvalidSignatureError,
   NFSeResource: () => NFSeResource,
@@ -125,7 +126,7 @@ var BaseResource = class {
     const reqHeaders = {
       "Accept": "application/json",
       "X-API-Key": this.apiKey,
-      "User-Agent": "Pairus-NodeJS-SDK/1.15.0",
+      "User-Agent": "Pairus-NodeJS-SDK/1.17.0",
       ...options.headers || {}
     };
     const isFormData = typeof FormData !== "undefined" && options.body instanceof FormData;
@@ -196,7 +197,7 @@ var BaseResource = class {
     const reqHeaders = {
       "Accept": "*/*",
       "X-API-Key": this.apiKey,
-      "User-Agent": "Pairus-NodeJS-SDK/1.15.0",
+      "User-Agent": "Pairus-NodeJS-SDK/1.17.0",
       ...options.headers || {}
     };
     let lastError = null;
@@ -255,7 +256,7 @@ var BaseResource = class {
     const reqHeaders = {
       "Accept": "*/*",
       "X-API-Key": this.apiKey,
-      "User-Agent": "Pairus-NodeJS-SDK/1.15.0",
+      "User-Agent": "Pairus-NodeJS-SDK/1.17.0",
       ...options.headers || {}
     };
     let lastError = null;
@@ -503,6 +504,51 @@ var EmissaoResource = class extends BaseResource {
       }
     });
   }
+  /**
+   * Consulta a situação atual de uma NF-e ou NFC-e emitida pela sua conta.
+   *
+   * @param chaveAcesso Chave de 44 dígitos da nota
+   * @param options `incluirXml` traz o procNFe em Base64
+   */
+  async consultar(chaveAcesso, options) {
+    return this.request({
+      method: "GET",
+      path: `/v1/nfe/${chaveAcesso}`,
+      params: { incluir_xml: String(options?.incluirXml ?? false) }
+    });
+  }
+  /**
+   * Localiza as notas emitidas para uma venda pela `referencia_externa` informada na emissão.
+   * Lista vazia: nenhuma nota gravada para a venda, é seguro emitir.
+   */
+  async buscarPorReferencia(cnpjEmitente, referenciaExterna) {
+    return this.request({
+      method: "GET",
+      path: "/v1/nfe",
+      params: { cnpj_emitente: cnpjEmitente, referencia_externa: referenciaExterna }
+    });
+  }
+  /**
+   * Baixa o DANFE em PDF de uma nota emitida (na contingência ainda não transmitida, com a tarja).
+   */
+  async baixarDanfe(chaveAcesso) {
+    return this.requestBinary({ method: "GET", path: `/v1/nfe/${chaveAcesso}/danfe` });
+  }
+};
+
+// src/resources/empresas.ts
+var EmpresasResource = class extends BaseResource {
+  /**
+   * Grava o CSC da NFC-e do estabelecimento (gerado no portal da SEFAZ da UF).
+   * O estabelecimento precisa de certificado próprio na conta; o código nunca é devolvido.
+   */
+  async configurarCsc(cnpj, input) {
+    return this.request({ method: "PUT", path: `/v1/empresas/${cnpj}/csc`, body: input });
+  }
+  /** Indica, por ambiente, se o CSC da NFC-e está configurado (sem devolver o código). */
+  async consultarCsc(cnpj) {
+    return this.request({ method: "GET", path: `/v1/empresas/${cnpj}/csc` });
+  }
 };
 
 // src/resources/fiscal.ts
@@ -526,10 +572,11 @@ function itemDeSaneamento(item) {
   const { NCM, CEST, xProd, id, ncm, cest, descricao, gtin, ...extras } = item;
   const convertido = {
     ...extras,
-    NCM: NCM ?? ncm,
-    CEST: CEST ?? cest,
+    ncm: ncm ?? NCM,
+    cest: cest ?? CEST,
     xProd: xProd ?? descricao,
-    id: id ?? gtin
+    gtin,
+    id
   };
   return Object.fromEntries(Object.entries(convertido).filter(([, v]) => v !== void 0 && v !== null));
 }
@@ -566,13 +613,13 @@ var FiscalResource = class extends BaseResource {
   }
   /**
    * 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.
+   * Cada item precisa de `ncm`; `cest`, `xProd`, `gtin` e `id` são opcionais.
    */
-  async sanitize(itens) {
+  async sanitize(itens, opcoes = {}) {
     return this.request({
       method: "POST",
       path: "/v2/fiscal/sanitize",
-      body: { itens: itens.map(itemDeSaneamento) }
+      body: { ...opcoes.ufOrigem ? { uf_origem: opcoes.ufOrigem } : {}, itens: itens.map(itemDeSaneamento) }
     });
   }
 };
@@ -825,6 +872,7 @@ var PairusProductData = class {
   emissao;
   nfse;
   dfe;
+  empresas;
   constructor(options) {
     const apiKey = options?.apiKey || (typeof process !== "undefined" ? process.env.PAIRUS_API_KEY : void 0);
     if (!apiKey) {
@@ -840,6 +888,7 @@ var PairusProductData = class {
     this.emissao = new EmissaoResource(apiKey, baseUrl, timeoutMs, maxRetries);
     this.nfse = new NFSeResource(apiKey, baseUrl, timeoutMs, maxRetries);
     this.dfe = new DFeResource(apiKey, baseUrl, timeoutMs, maxRetries);
+    this.empresas = new EmpresasResource(apiKey, baseUrl, timeoutMs, maxRetries);
   }
 };
 // Annotate the CommonJS export names for ESM import in node:
@@ -850,6 +899,7 @@ var PairusProductData = class {
   DEFAULT_TIMEOUT_MS,
   DFeResource,
   EmissaoResource,
+  EmpresasResource,
   FiscalResource,
   InvalidSignatureError,
   NFSeResource,