@bitize/bitmde 0.18.0 → 0.20.0

package/dist/apis/manifestacaoNFSe-api.d.ts

@@ -0,0 +1,130 @@
+export = ManifestacaoNFSe;
+declare class ManifestacaoNFSe {
+    /**
+     * Manifestação do tomador da NFS-e Nacional (Confirmação e Rejeição), na
+     * SEFIN Nacional. Cada chamada registra um evento fiscal: em produção
+     * (`tpAmb` `'1'`), ele não se desfaz.
+     *
+     * @param {Object} config
+     * @param {Buffer} [config.pfx]
+     * @param {string} [config.passphrase]
+     * @param {Buffer | string} [config.cert]
+     * @param {Buffer | string} [config.key]
+     * @param {string} config.cnpj CNPJ do tomador, enviado como `CNPJAutor`. Precisa ter a mesma raiz do CNPJ do certificado.
+     * @param {'1' | '2'} config.tpAmb `'1'` produção, `'2'` produção restrita.
+     * @param {'America/Araguaina' | 'America/Bahia' | 'America/Belem' | 'America/Boa_Vista' | 'America/Campo_Grande' | 'America/Cuiaba' | 'America/Fortaleza' | 'America/Maceio' | 'America/Manaus' | 'America/Noronha' | 'America/Porto_Velho' | 'America/Recife' | 'America/Rio_Branco' | 'America/Sao_Paulo'} [config.timezone = 'America/Sao_Paulo']
+     * @param {Object} [config.options]
+     * @param {import('axios').AxiosRequestConfig} [config.options.requestOptions]
+     * @param {import('https').AgentOptions} [config.options.httpsOptions] Mesclado por cima do padrão `{ ca: CA_PADRAO, rejectUnauthorized: true }`. Informar `ca` substitui a cadeia inteira; para somar uma AC, use `[...CA_PADRAO, minhaCa]`.
+     */
+    constructor(config: {
+        pfx?: Buffer;
+        passphrase?: string;
+        cert?: Buffer | string;
+        key?: Buffer | string;
+        cnpj: string;
+        tpAmb: "1" | "2";
+        timezone?: "America/Araguaina" | "America/Bahia" | "America/Belem" | "America/Boa_Vista" | "America/Campo_Grande" | "America/Cuiaba" | "America/Fortaleza" | "America/Maceio" | "America/Manaus" | "America/Noronha" | "America/Porto_Velho" | "America/Recife" | "America/Rio_Branco" | "America/Sao_Paulo";
+        options?: {
+            requestOptions?: import("axios").AxiosRequestConfig;
+            httpsOptions?: import("https").AgentOptions;
+        };
+    });
+    config: Readonly<{
+        cnpj: string;
+        tpAmb: "1" | "2";
+        timezone: "America/Araguaina" | "America/Bahia" | "America/Belem" | "America/Boa_Vista" | "America/Campo_Grande" | "America/Cuiaba" | "America/Fortaleza" | "America/Maceio" | "America/Manaus" | "America/Noronha" | "America/Porto_Velho" | "America/Recife" | "America/Rio_Branco" | "America/Sao_Paulo";
+        cert: string;
+        key: string;
+        requestOptions: Readonly<import("axios").AxiosRequestConfig<any, any>>;
+        httpsOptions: Readonly<import("node:https").AgentOptions>;
+    }>;
+    /**
+     * Confirmação do tomador (`e203202`). Depois dela, o prestador não
+     * consegue mais cancelar a NFS-e, só substituí-la.
+     *
+     * @param {string} chNFSe Chave de acesso de 50 dígitos.
+     */
+    confirmar(chNFSe: string): Promise<{
+        data: {
+            tipoAmbiente: string;
+            versaoAplicativo: string;
+            dataHoraProcessamento: string;
+            alertas: Array<{
+                codigo: string;
+                descricao: string;
+                complemento: string;
+            }>;
+            erros: Array<{
+                codigo: string;
+                descricao: string;
+                complemento: string;
+            }>;
+            evento: {
+                xml?: string;
+                json?: any;
+            };
+        };
+        error?: string;
+        transportError?: {
+            code: string;
+            message: string;
+        };
+        reqXml: string;
+        resBody: string;
+        status: number;
+    }>;
+    /**
+     * Rejeição do tomador (`e203206`).
+     *
+     * @param {string} chNFSe Chave de acesso de 50 dígitos.
+     * @param {Object} motivo
+     * @param {MotivoRejeicaoNFSe} motivo.cMotivo
+     * @param {string} [motivo.xMotivo] De 15 a 255 caracteres; obrigatório com `cMotivo` `'9'`.
+     */
+    rejeitar(chNFSe: string, motivo: {
+        cMotivo: MotivoRejeicaoNFSe;
+        xMotivo?: string;
+    }): Promise<{
+        data: {
+            tipoAmbiente: string;
+            versaoAplicativo: string;
+            dataHoraProcessamento: string;
+            alertas: Array<{
+                codigo: string;
+                descricao: string;
+                complemento: string;
+            }>;
+            erros: Array<{
+                codigo: string;
+                descricao: string;
+                complemento: string;
+            }>;
+            evento: {
+                xml?: string;
+                json?: any;
+            };
+        };
+        error?: string;
+        transportError?: {
+            code: string;
+            message: string;
+        };
+        reqXml: string;
+        resBody: string;
+        status: number;
+    }>;
+}
+declare namespace ManifestacaoNFSe {
+    export { MotivoRejeicaoNFSe };
+}
+/**
+ * Motivo da Rejeição do tomador (`cMotivo`):
+ * - `'1'` NFS-e em duplicidade;
+ * - `'2'` NFS-e já emitida pelo tomador;
+ * - `'3'` não ocorrência do fato gerador;
+ * - `'4'` erro quanto à responsabilidade tributária;
+ * - `'5'` erro quanto ao valor do serviço, valor das deduções, serviço prestado ou data do fato gerador;
+ * - `'9'` outros — exige `xMotivo`.
+ */
+type MotivoRejeicaoNFSe = "1" | "2" | "3" | "4" | "5" | "9";

package/dist/apis/recepcaoEvento-api.d.ts

@@ -12,7 +12,7 @@ declare class RecepcaoEvento {
      * @param {'America/Araguaina' | 'America/Bahia' | 'America/Belem' | 'America/Boa_Vista' | 'America/Campo_Grande' | 'America/Cuiaba' | 'America/Fortaleza' | 'America/Maceio' | 'America/Manaus' | 'America/Noronha' | 'America/Porto_Velho' | 'America/Recife' | 'America/Rio_Branco' | 'America/Sao_Paulo'} [config.timezone = 'America/Sao_Paulo']
      * @param {Object} [config.options]
      * @param {import('axios').AxiosRequestConfig} [config.options.requestOptions]
-     * @param {import('https').AgentOptions} [config.options.httpsOptions]
+     * @param {import('https').AgentOptions} [config.options.httpsOptions] Mesclado por cima do padrão `{ ca: CA_PADRAO, rejectUnauthorized: true }`. Informar `ca` substitui a cadeia inteira; para somar uma AC, use `[...CA_PADRAO, minhaCa]`.
      */
     constructor(config: {
         pfx?: Buffer;
@@ -74,6 +74,10 @@ declare class RecepcaoEvento {
             }];
         };
         error: string;
+        transportError?: {
+            code: string;
+            message: string;
+        };
         reqXml: string;
         resXml: string;
         status: number;

package/dist/controllers/distribuicaoDFe-controller.d.ts

@@ -4,7 +4,7 @@ declare class DistribuicaoController {
     /**
      *
      * @param {Object} opts
-     * @returns {Promise<{data:{tpAmb: string,verAplic: string,cStat: string,xMotivo: string,dhResp: string,ultNSU: string,maxNSU: string, docZip:[{xml: string,json: Object,nsu: string,schema: string}], docZipErrors:[{nsu: string,schema: string,error: string}]}, error: string, reqXml: string, resXml: string, status: number}>}
+     * @returns {Promise<{data:{tpAmb: string,verAplic: string,cStat: string,xMotivo: string,dhResp: string,ultNSU: string,maxNSU: string, docZip:[{xml: string,json: Object,nsu: string,schema: string}], docZipErrors:[{nsu: string,schema: string,error: string}]}, error: string, transportError?: {code: string, message: string}, reqXml: string, resXml: string, status: number}>}
      */
     static enviar(opts: any): Promise<{
         data: {
@@ -28,6 +28,10 @@ declare class DistribuicaoController {
             }];
         };
         error: string;
+        transportError?: {
+            code: string;
+            message: string;
+        };
         reqXml: string;
         resXml: string;
         status: number;

package/dist/controllers/distribuicaoNFSe-controller.d.ts

@@ -0,0 +1,50 @@
+declare const _exports: typeof DistribuicaoNFSeController;
+export = _exports;
+declare class DistribuicaoNFSeController {
+    /**
+     *
+     * @param {Object} opts
+     * @returns {Promise<{data:{statusProcessamento: string,tipoAmbiente: string,versaoAplicativo: string,dataHoraProcessamento: string, alertas: Array<{codigo: string,descricao: string,complemento: string}>, erros: Array<{codigo: string,descricao: string,complemento: string}>, documentos: Array<{nsu: string,chaveAcesso: string,tipoDocumento: string,tipoEvento: string,dataHoraGeracao: string,papel: '' | 'tomador' | 'prestador' | 'intermediario',xml: string,json: Object}>, documentosErros: Array<{nsu: string,chaveAcesso: string,tipoDocumento: string,error: string}>}, error?: string, transportError?: {code: string, message: string}, resBody: string, status: number}>}
+     */
+    static enviar(opts: any): Promise<{
+        data: {
+            statusProcessamento: string;
+            tipoAmbiente: string;
+            versaoAplicativo: string;
+            dataHoraProcessamento: string;
+            alertas: Array<{
+                codigo: string;
+                descricao: string;
+                complemento: string;
+            }>;
+            erros: Array<{
+                codigo: string;
+                descricao: string;
+                complemento: string;
+            }>;
+            documentos: Array<{
+                nsu: string;
+                chaveAcesso: string;
+                tipoDocumento: string;
+                tipoEvento: string;
+                dataHoraGeracao: string;
+                papel: "" | "tomador" | "prestador" | "intermediario";
+                xml: string;
+                json: any;
+            }>;
+            documentosErros: Array<{
+                nsu: string;
+                chaveAcesso: string;
+                tipoDocumento: string;
+                error: string;
+            }>;
+        };
+        error?: string;
+        transportError?: {
+            code: string;
+            message: string;
+        };
+        resBody: string;
+        status: number;
+    }>;
+}

package/dist/controllers/index.d.ts

@@ -24,11 +24,91 @@ declare const controller: Readonly<{
                 }];
             };
             error: string;
+            transportError?: {
+                code: string;
+                message: string;
+            };
             reqXml: string;
             resXml: string;
             status: number;
         }>;
     };
+    DistribuicaoNFSeController: {
+        new (): {};
+        enviar(opts: any): Promise<{
+            data: {
+                statusProcessamento: string;
+                tipoAmbiente: string;
+                versaoAplicativo: string;
+                dataHoraProcessamento: string;
+                alertas: Array<{
+                    codigo: string;
+                    descricao: string;
+                    complemento: string;
+                }>;
+                erros: Array<{
+                    codigo: string;
+                    descricao: string;
+                    complemento: string;
+                }>;
+                documentos: Array<{
+                    nsu: string;
+                    chaveAcesso: string;
+                    tipoDocumento: string;
+                    tipoEvento: string;
+                    dataHoraGeracao: string;
+                    papel: "" | "tomador" | "prestador" | "intermediario";
+                    xml: string;
+                    json: any;
+                }>;
+                documentosErros: Array<{
+                    nsu: string;
+                    chaveAcesso: string;
+                    tipoDocumento: string;
+                    error: string;
+                }>;
+            };
+            error?: string;
+            transportError?: {
+                code: string;
+                message: string;
+            };
+            resBody: string;
+            status: number;
+        }>;
+    };
+    ManifestacaoNFSeController: {
+        new (): {};
+        enviar(opts: any): Promise<{
+            data: {
+                tipoAmbiente: string;
+                versaoAplicativo: string;
+                dataHoraProcessamento: string;
+                alertas: Array<{
+                    codigo: string;
+                    descricao: string;
+                    complemento: string;
+                }>;
+                erros: Array<{
+                    codigo: string;
+                    descricao: string;
+                    complemento: string;
+                }>;
+                evento: {
+                    xml?: string;
+                    json?: any;
+                };
+            };
+            error?: string;
+            transportError?: {
+                code: string;
+                message: string;
+            };
+            reqXml: string;
+            resBody: string;
+            status: number;
+        }>;
+    };
     RecepcaoController: {
         new (): {};
         enviar(opts: any): Promise<{
@@ -55,6 +135,10 @@ declare const controller: Readonly<{
                 }];
             };
             error: string;
+            transportError?: {
+                code: string;
+                message: string;
+            };
             reqXml: string;
             resXml: string;
             status: number;

package/dist/controllers/manifestacaoNFSe-controller.d.ts

@@ -0,0 +1,38 @@
+declare const _exports: typeof ManifestacaoNFSeController;
+export = _exports;
+declare class ManifestacaoNFSeController {
+    /**
+     *
+     * @param {Object} opts
+     * @returns {Promise<{data:{tipoAmbiente: string,versaoAplicativo: string,dataHoraProcessamento: string, alertas: Array<{codigo: string,descricao: string,complemento: string}>, erros: Array<{codigo: string,descricao: string,complemento: string}>, evento: {xml?: string, json?: Object}}, error?: string, transportError?: {code: string, message: string}, reqXml: string, resBody: string, status: number}>}
+     */
+    static enviar(opts: any): Promise<{
+        data: {
+            tipoAmbiente: string;
+            versaoAplicativo: string;
+            dataHoraProcessamento: string;
+            alertas: Array<{
+                codigo: string;
+                descricao: string;
+                complemento: string;
+            }>;
+            erros: Array<{
+                codigo: string;
+                descricao: string;
+                complemento: string;
+            }>;
+            evento: {
+                xml?: string;
+                json?: any;
+            };
+        };
+        error?: string;
+        transportError?: {
+            code: string;
+            message: string;
+        };
+        reqXml: string;
+        resBody: string;
+        status: number;
+    }>;
+}

package/dist/controllers/recepcaoEvento-controller.d.ts

@@ -4,7 +4,7 @@ declare class RecepcaoController {
     /**
      *
      * @param {Object} opts
-     * @returns {Promise<{data:{idLote: string,tpAmb: string,verAplic: string,cOrgao: string,cStat: string,xMotivo: string, infEvento:[{tpAmb: string,verAplic: string,cOrgao: string,cStat: string,xMotivo: string,chNFe: string,tpEvento: string,xEvento: string,nSeqEvento: string,CNPJDest: string,dhRegEvento: string,nProt: string}]}, error: string, reqXml: string, resXml: string, status: number}>}
+     * @returns {Promise<{data:{idLote: string,tpAmb: string,verAplic: string,cOrgao: string,cStat: string,xMotivo: string, infEvento:[{tpAmb: string,verAplic: string,cOrgao: string,cStat: string,xMotivo: string,chNFe: string,tpEvento: string,xEvento: string,nSeqEvento: string,CNPJDest: string,dhRegEvento: string,nProt: string}]}, error: string, transportError?: {code: string, message: string}, reqXml: string, resXml: string, status: number}>}
      */
     static enviar(opts: any): Promise<{
         data: {
@@ -30,6 +30,10 @@ declare class RecepcaoController {
             }];
         };
         error: string;
+        transportError?: {
+            code: string;
+            message: string;
+        };
         reqXml: string;
         resXml: string;
         status: number;

package/dist/env/ca.d.ts

@@ -1,6 +1,12 @@
 /**
- * Cadeia de Certificados da NF-e (www1.nfe.fazenda.gov.br)
- * Página Principal > Documentos > Diversos > Cadeia de Certificados do www1 (atualizada em 04/08/2021)
+ * Cadeia ICP-Brasil: AC Raiz Brasileira v10 e AC SERPRO SSLv1.
+ *
+ * Veio do portal da NF-e como "Cadeia de Certificados do www1 (atualizada em
+ * 04/08/2021)", mas deixou de ser a cadeia do www1/hom1: desde então o
+ * Ambiente Nacional serve AC SERPRO AR46 OV TLS CA 2025 ← GlobalSign Root R46,
+ * que só fecha com as raízes padrão do Node. Continua embarcada para quem
+ * fala com endpoint ICP-Brasil.
  * https://www.nfe.fazenda.gov.br/portal/exibirArquivo.aspx?conteudo=JuhROOiTOPA=
  */
 export const CA: string[];
+export const CA_PADRAO: string[];

package/dist/env/index.d.ts

@@ -1,8 +1,12 @@
 import { CA } from "./ca";
+import { CA_PADRAO } from "./ca";
 import { CODIGOS_UF } from "./uf";
 import { DISTRIBUICAO } from "./distribuicao";
 import { EVENTOS } from "./evento";
+import { EVENTOS_NFSE } from "./nfse";
+import { NFSE_ADN } from "./nfse";
+import { NFSE_SEFIN } from "./nfse";
 import { RECEPCAO } from "./recepcao";
 import { VERSION } from "./version";
 import { ZONES } from "./zone";
-export { CA, CODIGOS_UF, DISTRIBUICAO, EVENTOS, RECEPCAO, VERSION, ZONES };
+export { CA, CA_PADRAO, CODIGOS_UF, DISTRIBUICAO, EVENTOS, EVENTOS_NFSE, NFSE_ADN, NFSE_SEFIN, RECEPCAO, VERSION, ZONES };

package/dist/env/nfse.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Eventos de manifestação do tomador. O `xDesc` é literal do XSD
+ * (`enumeration`), com acento: alterar o texto rejeita o pedido por schema.
+ */
+export const EVENTOS_NFSE: {
+    203202: {
+        codigo: string;
+        elemento: string;
+        xDesc: string;
+    };
+    203206: {
+        codigo: string;
+        elemento: string;
+        xDesc: string;
+    };
+};
+/**
+ * URL base da API de distribuição para contribuintes da NFS-e Nacional
+ * Ambiente de Dados Nacional (ADN) — Manual dos Contribuintes, APIs do ADN v1.0
+ */
+export const NFSE_ADN: {
+    1: string;
+    2: string;
+};
+/**
+ * URL base da API da SEFIN Nacional, que recebe o pedido de registro de evento
+ * (manifestação do tomador) — Swagger SEFIN Nacional v1
+ */
+export const NFSE_SEFIN: {
+    1: string;
+    2: string;
+};

package/dist/helpers/distribuicaoDFe-helper.d.ts

@@ -10,6 +10,10 @@ declare class DistribuicaoHelper {
     static enviarConsulta(data: string, opts: any): Promise<{
         status: number;
         data: string;
+        transportError?: {
+            code: string;
+            message: string;
+        };
     }>;
     /**
      *

package/dist/helpers/distribuicaoNFSe-helper.d.ts

@@ -0,0 +1,107 @@
+declare const _exports: typeof DistribuicaoNFSeHelper;
+export = _exports;
+declare class DistribuicaoNFSeHelper {
+    /**
+     *
+     * @param {Object} config
+     * @param {Object} opts
+     * @returns {Promise<{status: number, data: string, transportError?: {code: string, message: string}}>}
+     */
+    static enviarConsulta(config: any, opts: any): Promise<{
+        status: number;
+        data: string;
+        transportError?: {
+            code: string;
+            message: string;
+        };
+    }>;
+    /**
+     * Config da requisição ao axios. Os headers vão na requisição, e não na
+     * instância, para o axios mesclá-los com o User-Agent.
+     *
+     * @param {Object} opts
+     * @returns {{method: string, url: string, params?: {lote: boolean, cnpjConsulta: string}, headers: Object, responseType: string}}
+     */
+    static montarRequest(opts: any): {
+        method: string;
+        url: string;
+        params?: {
+            lote: boolean;
+            cnpjConsulta: string;
+        };
+        headers: any;
+        responseType: string;
+    };
+    /**
+     * Interpreta o corpo cru do ADN. Nunca lança: corpo que não é JSON, ou
+     * JSON sem `StatusProcessamento`, devolve `null`.
+     *
+     * @param {string} corpo
+     * @param {string} cnpj CNPJ consultado, para o `papel` de cada NFS-e
+     * @returns {Promise<{statusProcessamento: string, tipoAmbiente: string, versaoAplicativo: string, dataHoraProcessamento: string, alertas: {codigo: string, descricao: string, complemento: string}[], erros: {codigo: string, descricao: string, complemento: string}[], documentos: {nsu: string, chaveAcesso: string, tipoDocumento: string, tipoEvento: string, dataHoraGeracao: string, papel: string, xml: string, json: Object}[], documentosErros: {nsu: string, chaveAcesso: string, tipoDocumento: string, error: string}[]} | null>}
+     */
+    static montarResponse(corpo: string, cnpj: string): Promise<{
+        statusProcessamento: string;
+        tipoAmbiente: string;
+        versaoAplicativo: string;
+        dataHoraProcessamento: string;
+        alertas: {
+            codigo: string;
+            descricao: string;
+            complemento: string;
+        }[];
+        erros: {
+            codigo: string;
+            descricao: string;
+            complemento: string;
+        }[];
+        documentos: {
+            nsu: string;
+            chaveAcesso: string;
+            tipoDocumento: string;
+            tipoEvento: string;
+            dataHoraGeracao: string;
+            papel: string;
+            xml: string;
+            json: any;
+        }[];
+        documentosErros: {
+            nsu: string;
+            chaveAcesso: string;
+            tipoDocumento: string;
+            error: string;
+        }[];
+    } | null>;
+    /**
+     * Descompacta e interpreta um item do `LoteDFe` sem nunca rejeitar: a
+     * falha vira um item com `error`, para não derrubar o restante do lote.
+     *
+     * @param {Object} item
+     * @param {string} cnpj
+     * @returns {Promise<{nsu: string, chaveAcesso: string, tipoDocumento: string, tipoEvento: string, dataHoraGeracao: string, papel: string, xml: string, json: Object} | {nsu: string, chaveAcesso: string, tipoDocumento: string, error: string}>}
+     */
+    static abrirArquivoXml(item: any, cnpj: string): Promise<{
+        nsu: string;
+        chaveAcesso: string;
+        tipoDocumento: string;
+        tipoEvento: string;
+        dataHoraGeracao: string;
+        papel: string;
+        xml: string;
+        json: any;
+    } | {
+        nsu: string;
+        chaveAcesso: string;
+        tipoDocumento: string;
+        error: string;
+    }>;
+    /**
+     * Papel do CNPJ consultado na NFS-e. Evento não traz as partes da nota.
+     *
+     * @param {string} tipoDocumento
+     * @param {Object} json
+     * @param {string} cnpj
+     * @returns {'' | 'tomador' | 'prestador' | 'intermediario'}
+     */
+    static calcularPapel(tipoDocumento: string, json: any, cnpj: string): "" | "tomador" | "prestador" | "intermediario";
+}