@treeunfe/types 1.0.3

package/dist/src/nfse/LayoutDPS.d.ts

@@ -0,0 +1,424 @@
+/**
+ * Layout do DPS (Documento de Prestação de Serviços)
+ * Similar ao LayoutNFe, mas para NFSe
+ */
+export interface LayoutDPS {
+    /**
+     * Informações do DPS
+     */
+    infDps: InfDPS;
+    /**
+     * Assinatura XML do DPS (gerada automaticamente)
+     */
+    Signature?: any;
+}
+/**
+ * Informações do DPS
+ */
+export type InfDPS = {
+    /**
+     * Identificador único do DPS (gerado automaticamente)
+     */
+    Id?: string;
+    /**
+     * Tipo de ambiente: 1 - Produção; 2 - Homologação
+     */
+    tpAmb: 1 | 2;
+    /**
+     * Data e hora da emissão do DPS (formato UTC: AAAA-MM-DDThh:mm:ssTZD)
+     */
+    dhEmi: string;
+    /**
+     * Versão do aplicativo que gerou o DPS
+     */
+    verAplic: string;
+    /**
+     * Série do DPS
+     */
+    serie: string;
+    /**
+     * Número do DPS
+     */
+    nDPS: string;
+    /**
+     * Data de competência (AAAAMMDD)
+     */
+    dCompet: string;
+    /**
+     * Tipo de emitente: 1 - Prestador; 2 - Tomador; 3 - Intermediário
+     */
+    tpEmit: 1 | 2 | 3;
+    /**
+     * Código do município emissor (IBGE)
+     */
+    cLocEmi: string;
+    /**
+     * Informações do prestador
+     */
+    prest: InfoPrestador;
+    /**
+     * Informações do tomador (opcional)
+     */
+    toma?: InfoPessoa;
+    /**
+     * Informações do intermediário (opcional)
+     */
+    interm?: InfoPessoa;
+    /**
+     * Informações do serviço
+     */
+    serv: InfoServico;
+    /**
+     * Valores do serviço
+     */
+    valores: InfoValores;
+    /**
+     * Motivo de emissão pelo Tomador/Intermediário (opcional)
+     */
+    cMotivoEmisTI?: 1 | 2 | 3 | 4;
+    /**
+     * Chave de acesso da NFSe rejeitada (opcional)
+     */
+    chNFSeRej?: string;
+    /**
+     * Informações de substituição (opcional)
+     */
+    subst?: InfoSubstituicao;
+    /**
+     * Informações de IBS/CBS (opcional)
+     */
+    IBSCBS?: any;
+};
+/**
+ * Informações do prestador
+ */
+export type InfoPrestador = {
+    /**
+     * CNPJ ou CPF ou NIF
+     */
+    CNPJ?: string;
+    CPF?: string;
+    NIF?: string;
+    cNaoNIF?: 0 | 1 | 2;
+    /**
+     * CAEPF (opcional)
+     */
+    CAEPF?: string;
+    /**
+     * Inscrição Municipal (opcional)
+     */
+    IM?: string;
+    /**
+     * Nome/Razão Social (opcional)
+     */
+    xNome?: string;
+    /**
+     * Endereço (opcional)
+     */
+    end?: Endereco;
+    /**
+     * Telefone (opcional)
+     */
+    fone?: string;
+    /**
+     * E-mail (opcional)
+     */
+    email?: string;
+    /**
+     * Regime de tributação
+     */
+    regTrib: RegTrib;
+};
+/**
+ * Informações de pessoa (tomador/intermediário)
+ */
+export type InfoPessoa = {
+    /**
+     * CNPJ ou CPF ou NIF
+     */
+    CNPJ?: string;
+    CPF?: string;
+    NIF?: string;
+    cNaoNIF?: 0 | 1 | 2;
+    /**
+     * CAEPF (opcional)
+     */
+    CAEPF?: string;
+    /**
+     * Inscrição Municipal (opcional)
+     */
+    IM?: string;
+    /**
+     * Nome/Razão Social
+     */
+    xNome: string;
+    /**
+     * Endereço (opcional)
+     */
+    end?: Endereco;
+    /**
+     * Telefone (opcional)
+     */
+    fone?: string;
+    /**
+     * E-mail (opcional)
+     */
+    email?: string;
+};
+/**
+ * Endereço
+ */
+export type Endereco = {
+    /**
+     * Endereço nacional ou exterior
+     */
+    endNac?: EnderecoNacional;
+    endExt?: any;
+    /**
+     * Logradouro
+     */
+    xLgr: string;
+    /**
+     * Número
+     */
+    nro: string;
+    /**
+     * Complemento (opcional)
+     */
+    xCpl?: string;
+    /**
+     * Bairro
+     */
+    xBairro: string;
+};
+/**
+ * Endereço nacional
+ */
+export type EnderecoNacional = {
+    /**
+     * CEP
+     */
+    CEP: string;
+    /**
+     * Código do município (IBGE)
+     */
+    cMun: string;
+    /**
+     * UF
+     */
+    UF: string;
+};
+/**
+ * Regime de tributação
+ */
+export type RegTrib = {
+    /**
+     * Situação perante o Simples Nacional:
+     * 1 - Não Optante;
+     * 2 - Optante - Microempreendedor Individual (MEI);
+     * 3 - Optante - Microempresa ou Empresa de Pequeno Porte (ME/EPP)
+     */
+    opSimpNac: 1 | 2 | 3;
+    /**
+     * Regime de apuração do Simples Nacional (opcional)
+     */
+    regApTribSN?: 1 | 2 | 3;
+    /**
+     * Regime especial de tributação: 0 - Nenhum; 1-9 - Outros
+     */
+    regEspTrib: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 9;
+};
+/**
+ * Informações do serviço
+ */
+export type InfoServico = {
+    /**
+     * Local da prestação do serviço (obrigatório - primeiro elemento)
+     */
+    locPrest: LocPrest;
+    /**
+     * Código do serviço prestado (obrigatório - segundo elemento)
+     */
+    cServ: CServ;
+    /**
+     * Comércio exterior (opcional)
+     */
+    comExt?: ComExterior;
+    /**
+     * Informações de obra (opcional)
+     */
+    obra?: any;
+    /**
+     * Atividade de evento (opcional)
+     */
+    atvEvento?: any;
+    /**
+     * Informações complementares (opcional)
+     */
+    infoCompl?: any;
+};
+/**
+ * Local da prestação do serviço
+ */
+export type LocPrest = {
+    /**
+     * Código do município onde o serviço foi prestado (IBGE) - OU
+     */
+    cLocPrestacao?: string;
+    /**
+     * Código do país onde o serviço foi prestado (ISO) - OU
+     */
+    cPaisPrestacao?: string;
+};
+/**
+ * Código do serviço prestado
+ */
+export type CServ = {
+    /**
+     * Código de tributação nacional do ISSQN (6 dígitos: 2 Item + 2 Subitem + 2 Desdobro)
+     */
+    cTribNac: string;
+    /**
+     * Código de tributação municipal do ISSQN (opcional)
+     */
+    cTribMun?: string;
+    /**
+     * Descrição completa do serviço prestado
+     */
+    xDescServ: string;
+    /**
+     * Código NBS (opcional)
+     */
+    cNBS?: string;
+    /**
+     * Código interno do contribuinte (opcional)
+     */
+    cIntContrib?: string;
+};
+/**
+ * Comércio exterior
+ */
+export type ComExterior = {
+    /**
+     * Modo de prestação: 0 - Desconhecido; 1 - Transfronteiriço; 2 - Consumo no Brasil; 3 - Presença física no exterior
+     */
+    mdPrestacao: 0 | 1 | 2 | 3;
+    /**
+     * Outras informações (opcional)
+     */
+    [key: string]: any;
+};
+/**
+ * Informações de valores
+ */
+export type InfoValores = {
+    /**
+     * Valores do serviço prestado (obrigatório - primeiro elemento)
+     */
+    vServPrest: VServPrest;
+    /**
+     * Descontos condicionados e incondicionados (opcional)
+     */
+    vDescCondIncond?: VDescCondIncond;
+    /**
+     * Dedução/redução (opcional)
+     */
+    vDedRed?: any;
+    /**
+     * Tributação (obrigatório)
+     */
+    trib: InfoTributacao;
+};
+/**
+ * Valores do serviço prestado
+ */
+export type VServPrest = {
+    /**
+     * Valor recebido pelo intermediário (opcional)
+     */
+    vReceb?: number;
+    /**
+     * Valor dos serviços em R$ (obrigatório)
+     */
+    vServ: number;
+};
+/**
+ * Descontos condicionados e incondicionados
+ */
+export type VDescCondIncond = {
+    /**
+     * Valor do desconto incondicionado (opcional)
+     */
+    vDescIncond?: number;
+    /**
+     * Valor do desconto condicionado (opcional)
+     */
+    vDescCond?: number;
+};
+/**
+ * Informações de tributação
+ */
+export type InfoTributacao = {
+    /**
+     * Tributação municipal (obrigatório)
+     */
+    tribMun: TribMunicipal;
+    /**
+     * Tributação federal (opcional)
+     */
+    tribFed?: any;
+    /**
+     * Totais de tributos (obrigatório)
+     */
+    totTrib: any;
+};
+/**
+ * Tributação municipal
+ */
+export type TribMunicipal = {
+    /**
+     * Tributação do ISSQN: 1 - Operação tributável; 2 - Imunidade; 3 - Exportação; 4 - Não Incidência
+     */
+    tribISSQN: 1 | 2 | 3 | 4;
+    /**
+     * Código do país de resultado (opcional)
+     */
+    cPaisResult?: string;
+    /**
+     * Tipo de imunidade (opcional)
+     */
+    tpImunidade?: number;
+    /**
+     * Exigibilidade suspensa (opcional)
+     */
+    exigSusp?: any;
+    /**
+     * Benefício municipal (opcional)
+     */
+    BM?: any;
+    /**
+     * Tipo de retenção do ISSQN: 1 - Não Retido; 2 - Retido pelo Tomador; 3 - Retido pelo Intermediário (obrigatório)
+     */
+    tpRetISSQN: 1 | 2 | 3;
+    /**
+     * Alíquota do ISSQN (%) (opcional)
+     */
+    pAliq?: number;
+};
+/**
+ * Informações de substituição
+ */
+export type InfoSubstituicao = {
+    /**
+     * Chave de acesso da NFSe a ser substituída
+     */
+    chSubstda: string;
+    /**
+     * Código do motivo da substituição
+     */
+    cMotivo: string;
+    /**
+     * Descrição do motivo (opcional)
+     */
+    xMotivo?: string;
+};

package/dist/src/nfse/LayoutPedRegEvento.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Layout do Pedido de Registro de Evento (pedRegEvento)
+ */
+export interface LayoutPedRegEvento {
+    infPedReg: InfPedReg;
+    Signature?: any;
+}
+export type InfPedReg = {
+    tpAmb: 1 | 2;
+    verAplic: string;
+    dhEvento: string;
+    CNPJAutor?: string;
+    CPFAutor?: string;
+    chNFSe: string;
+    e101101?: EventoCancelamento;
+    e105102?: EventoCancelamentoSubstituicao;
+    e101103?: any;
+    e105104?: any;
+    e105105?: any;
+    e202201?: any;
+    e203202?: any;
+    e204203?: any;
+    e205204?: any;
+    e202205?: any;
+    e203206?: any;
+    e204207?: any;
+    e205208?: any;
+    e305101?: any;
+    e305102?: any;
+    e305103?: any;
+    e907201?: any;
+    e907209?: any;
+};
+/**
+ * Evento de Cancelamento (e101101)
+ */
+export type EventoCancelamento = {
+    xDesc: 'Cancelamento de NFS-e';
+    cMotivo: 1 | 2 | 9;
+    xMotivo: string;
+};
+/**
+ * Evento de Cancelamento por Substituição (e105102)
+ */
+export type EventoCancelamentoSubstituicao = {
+    xDesc: 'Cancelamento de NFS-e por Substituição';
+    chNFSeSubst: string;
+};

package/dist/src/nfse/NFSeAutorizacao.d.ts

@@ -0,0 +1,54 @@
+import { LayoutDPS } from './LayoutDPS.js';
+/**
+ * Estrutura principal para autorização de NFSe
+ * Aceita tanto JSON (DPS) quanto Base64 (dpsXmlGZipB64)
+ */
+export type NFSe = {
+    /**
+     * DPS (Documento de Prestação de Serviços) em formato JSON
+     * A biblioteca montará o XML, assinará, compactará e codificará automaticamente
+     */
+    DPS?: LayoutDPS | LayoutDPS[];
+    /**
+     * DPS (Documento de Prestação de Serviços) já compactado em GZip e codificado em Base64
+     * Use este campo se já tiver o DPS processado
+     */
+    dpsXmlGZipB64?: string;
+};
+/**
+ * Resposta de sucesso da autorização de NFSe
+ */
+export type NFSeAutorizacaoResponse = {
+    tipoAmbiente: 1 | 2;
+    versaoAplicativo: string;
+    dataHoraProcessamento: string;
+    idDps: string;
+    chaveAcesso: string;
+    nfseXmlGZipB64: string;
+    alertas?: MensagemProcessamento[];
+};
+/**
+ * Resposta de erro da autorização de NFSe
+ */
+export type NFSeAutorizacaoErroResponse = {
+    tipoAmbiente: 1 | 2;
+    versaoAplicativo: string;
+    dataHoraProcessamento: string;
+    idDPS?: string;
+    erros: MensagemProcessamento[];
+};
+/**
+ * Mensagem de processamento
+ */
+export type MensagemProcessamento = {
+    mensagem?: string;
+    codigo?: string;
+    descricao?: string;
+    complemento?: string;
+};
+/**
+ * Layout da NFSe (após descompactação e parsing)
+ */
+export type LayoutNFSe = {
+    [key: string]: any;
+};

package/dist/src/nfse/NFSeConsulta.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Consulta de NFSe por chave de acesso
+ */
+export type NFSeConsultaPorChave = {
+    chaveAcesso: string;
+};
+/**
+ * Consulta de DPS por ID
+ */
+export type DpsConsultaPorId = {
+    id: string;
+};
+/**
+ * Resposta de consulta de NFSe
+ */
+export type NFSeConsultaResponse = {
+    tipoAmbiente: 1 | 2;
+    versaoAplicativo: string;
+    dataHoraProcessamento: string;
+    chaveAcesso: string;
+    nfseXmlGZipB64: string;
+};
+/**
+ * Resposta de consulta de DPS
+ */
+export type DpsConsultaResponse = {
+    tipoAmbiente: 1 | 2;
+    versaoAplicativo: string;
+    dataHoraProcessamento: string;
+    idDps: string;
+    chaveAcesso: string;
+};

package/dist/src/nfse/NFSeDanfeGenerator.d.ts

@@ -0,0 +1,10 @@
+export type NFSeGerarDanfeProps = {
+    /**
+     * @param {string} chaveAcesso - Chave de acesso da NFSe
+     */
+    chaveAcesso: string;
+    /**
+     * @param {string} outputPath - Local onde a DANFSe será gravada
+     */
+    outputPath: string;
+};

package/dist/src/nfse/NFSeDistribuicao.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Consulta de distribuição por NSU
+ */
+export type NFSeDistribuicaoPorNSU = {
+    nsu: number;
+    cnpjConsulta?: string;
+    lote?: boolean;
+};
+/**
+ * Consulta de eventos por chave de acesso
+ */
+export type NFSeEventosPorChave = {
+    chaveAcesso: string;
+};
+/**
+ * Item de distribuição
+ */
+export type DistribuicaoNSU = {
+    NSU?: number;
+    ChaveAcesso?: string;
+    TipoDocumento?: string;
+    TipoEvento?: string;
+    ArquivoXml?: string;
+    DataHoraGeracao?: string;
+};
+/**
+ * Resposta de distribuição
+ */
+export type NFSeDistribuicaoResponse = {
+    StatusProcessamento: 'REJEICAO' | 'NENHUM_DOCUMENTO_LOCALIZADO' | 'DOCUMENTOS_LOCALIZADOS';
+    LoteDFe?: DistribuicaoNSU[];
+    Alertas?: any[];
+    Erros?: any[];
+    TipoAmbiente: 'PRODUCAO' | 'HOMOLOGACAO';
+    VersaoAplicativo?: string;
+    DataHoraProcessamento: string;
+};

package/dist/src/nfse/NFSeEventos.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Tipos de eventos NFSe
+ */
+export declare enum TipoEventoNFSe {
+    CANCELAMENTO = 101101,
+    SOLICITACAO_CANCELAMENTO_ANALISE_FISCAL = 101103,
+    CANCELAMENTO_POR_SUBSTITUICAO = 105102,
+    CANCELAMENTO_DEFERIDO_ANALISE_FISCAL = 105104,
+    CANCELAMENTO_INDEFERIDO_ANALISE_FISCAL = 105105,
+    CONFIRMACAO_PRESTADOR = 202201,
+    REJEICAO_PRESTADOR = 202205,
+    CONFIRMACAO_TOMADOR = 203202,
+    REJEICAO_TOMADOR = 203206,
+    CONFIRMACAO_INTERMEDIARIO = 204203,
+    REJEICAO_INTERMEDIARIO = 204207,
+    CONFIRMACAO_TACITA = 205204,
+    ANULACAO_REJEICAO = 205208,
+    CANCELAMENTO_POR_OFICIO = 305101,
+    BLOQUEIO_POR_OFICIO = 305102,
+    DESBLOQUEIO_POR_OFICIO = 305103,
+    INCLUSAO_NFSE_DAN = 907201,
+    TRIBUTOS_NFSE_RECOLHIDOS = 907209
+}
+import { LayoutPedRegEvento } from './LayoutPedRegEvento.js';
+/**
+ * Requisição de registro de evento
+ */
+export type NFSeEventoRequest = {
+    chaveAcesso: string;
+    pedidoRegistroEventoXmlGZipB64?: string;
+    pedRegEvento?: LayoutPedRegEvento;
+};
+/**
+ * Consulta de evento
+ */
+export type NFSeEventoConsulta = {
+    chaveAcesso: string;
+    tipoEvento: TipoEventoNFSe;
+    numSeqEvento: number;
+};
+/**
+ * Resposta de sucesso de evento (registro)
+ */
+export type NFSeEventoResponse = {
+    tipoAmbiente: 1 | 2;
+    versaoAplicativo: string;
+    dataHoraProcessamento: string;
+    eventoXmlGZipB64?: string;
+    eventos?: Array<{
+        chaveAcesso: string;
+        tipoEvento: number;
+        numeroPedidoRegistroEvento: number;
+        dataHoraRecebimento: string;
+        arquivoXml: string;
+    }>;
+};