@4success/nfse-campinas NPM

NFSe Campinas

Pacote de integração que abstrai os webservices da prefeitura de Campinas (Padrão DSFNET).

Outras cidades atendidas

Se o você for de um município que seja atendido pelo Padrão DSFNET, esse pacote também funcionará. Abaixo alguns exemplos de cidades com padrão DSFNET:

Belém (PA)
Campo Grande (MS)
Campinas (SP)
Nova Iguaçu (RJ)
São Luís (MA)
Sorocaba (SP)
Teresina (PI)
Uberlândia (MG)

Para emitir nota fiscal no Padrão DSFNET, é necessário a utilização do Certificado Digital A1

Instalação

Instalar via NPM ou Yarn:

npm install @4success/nfse-campinas
yarn add @4success/nfse-campinas

Detalhes sobre onde o código será executado

Este projeto é compilado especificamente para AWS Lambda (Linux x64) usando o pacote chrome-aws-lambda. Por conta disso, o binário do browser não irá estar presente, pois é esperado que ele esteja em uma Lambda Layer. Para o deploy na AWS, é necessário adicionar a lambda layer (mais detalhes na seção abaixo).

Para executar em seu ambiente local, instale o pacote puppeteer localmente com o comando:

yarn add --dev puppeteer@^10.1.0

Com isso o binário será adicionado conforme o seu sistema operacional e irá funcionar.

Caso você não esteja executando em um ambiente AWS Lambda, o pacote deve ser adicionado as dependências produtivas:

yarn add puppeteer@^10.1.0

Instruções de uso

Com a biblioteca instalada, basta criar uma instância apontando para a URL do webservice, passando também um Buffer com o arquivo do certificado e a senha do certificado

import { NfseCampinas } from '@4success/nfse-campinas';

const cert = fs.readFileSync(`/caminho/para/certificado.pfx`);
const nfse = new NfseCampinas(
  'https://issdigital.campinas.sp.gov.br/WsNFe2/LoteRps.jws?wsdl',
  cert,
  'senhaCertificado',
);

Com a instância criada, basta chamar o método passando os parâmetros especificados no tipo:

  const response = await nfse.consultarNota({
      CodCidade: 6291,
      CPFCNPJRemetente: '9999999999999',
      InscricaoMunicipalPrestador: '002163896',
      'dtInicio': '2022-03-01',
      'dtFim': '2022-03-31',
      Versao: parseInt('1'),
  });

O editor da sua IDE irá avisar sobre os campos obrigatórios.

Exemplos de chamadas

Consulta de lotes:

  const response = await nfse.consultarLote({
      CodCidade: '6291',
      CPFCNPJRemetente: '9999999999999',
      Versao: 1,
      NumeroLote: 286604087
  });

Consulta de próxima sequência numérica de RPS:

  const response = await nfse.consultaSequenciaRps({
      CodCid: 6291,
      CPFCNPJRemetente: '9999999999999',
      IMPrestador: '999999999',
      Versao: '1',
      SeriePrestacao: '99'
  });

Envio de lote RPS:

  const response = await nfse.enviarLoteSincrono({
      Cabecalho: {
        CodCidade: 6291,
        CPFCNPJRemetente: "9999999999999",
        RazaoSocialRemetente: "EMPRESA DE TESTE",
        transacao: "",
        dtInicio: "2022-02-28",
        dtFim: "2022-02-28",
        QtdRPS: 1,
        ValorTotalServicos: "448.00",
        ValorTotalDeducoes: 0,
        Versao: 1,
        MetodoEnvio: "WS"
      },
      Lote: {
        "@Id": "20220228090209015",
        RPS: [
          {
            "@Id": `rps:1`,
            InscricaoMunicipalPrestador: "9999999",
            RazaoSocialPrestador: "EMPRESA DE TESTE",
            TipoRPS: "RPS",
            SerieRPS: "NF",
            NumeroRPS: 1,
            DataEmissaoRPS: "2022-02-28T09:00:09",
            SituacaoRPS: "N",
            SeriePrestacao: "99",
            InscricaoMunicipalTomador: "0000000",
            CPFCNPJTomador: "000000000000000",
            RazaoSocialTomador: "CLIENTE DE TESTE",
            TipoLogradouroTomador: "Rua",
            LogradouroTomador: "dos Testes",
            NumeroEnderecoTomador: "755",
            ComplementoEnderecoTomador: "SL TESTE",
            TipoBairroTomador: "Bairro",
            BairroTomador: "Consolação",
            CidadeTomador: "7107",
            CidadeTomadorDescricao: "São Paulo",
            CEPTomador: "01415000",
            EmailTomador: "emaildocliente@teste.com.br",
            CodigoAtividade: "620400001",
            AliquotaAtividade: 2,
            TipoRecolhimento: "A",
            MunicipioPrestacao: 6291,
            MunicipioPrestacaoDescricao: "CAMPINAS",
            Operacao: "A",
            Tributacao: "T",
            ValorPIS: "2.91",
            ValorCOFINS: "13.44",
            ValorINSS: 0,
            ValorIR: 0,
            ValorCSLL: "4.48",
            AliquotaPIS: 0.65,
            AliquotaCOFINS: 3,
            AliquotaINSS: 0,
            AliquotaIR: 0,
            AliquotaCSLL: 1,
            DescricaoRPS: "Mensalidade",
            DDDPrestador: "19",
            TelefonePrestador: "999999999",
            DDDTomador: "11",
            TelefoneTomador: "999999999",
            Deducoes: [],
            Itens: {
              Item: [
                {
                  DiscriminacaoServico: "Mensalidade",
                  Quantidade: 1,
                  ValorUnitario: "448.00",
                  ValorTotal: "448.00"
                }
              ]
            }
          }
        ]
      }
  });

Cancelar nota:

  const response = await nfse.cancelarNotaFiscal({
      Lote: {
        "@Id": 'lote:286923780',
        Nota: [{
          "@Id": `nota:1090`,
          InscricaoMunicipalPrestador: '999999999',
          NumeroNota: '1090',
          CodigoVerificacao: 'avc9s84d',
          MotivoCancelamento: 'Motivo de cancelamento'
        }]
      },
      Cabecalho: {
        CodCidade: '6291',
        CPFCNPJRemetente: '99999999999',
        transacao: true,
        Versao: 1
      }
  });

Data Scraper para imprimir Danfe e buscar link da prefeitura e impressão de PDF

Após a emissão da NFSe via RPS, o sistema não possui um método para resgatar o link da NFSe para pegar a Danfe e enviar, quando necessário. Isso pode ser feito automaticamente usando automaçõa

import { DataScraper } from '@4success/nfse-campinas';

const response = await DataScraper.consultaLinkNfse({
    "cnpj": "9999999999999",
    "nfNum": 1000,
    "codVerificacao": "346ea2c2",
    "inscricaoMunicipal": "9999999"
  });

Se os dados forem válidos, será retornado uma resposta nesse padrão:

{
  "url": "https://nfse.campinas.sp.gov.br/NotaFiscal/visualizarNota.php?id_nota_fiscal=XXXXX&confirma=Tg==&temPrestador=Tg==&doc_prestador=XXXXXX=&numero_nota_fiscal=XXXXX==&inscricao_prestador=XXXXXX==&cod_verificacao=XXXX",
  "id_nota_fiscal": "511111111",
  "confirma": "N",
  "temPrestador": "N",
  "doc_prestador": "9999999999999",
  "numero_nota_fiscal": "1000",
  "inscricao_prestador": "9999999",
  "cod_verificacao": "346ea2c2"
}

Para imprimir o PDF com base no link, foi disponibilizado um método que já faz essa tarefa e retorna um base64:

import { DataScraper } from '@4success/nfse-campinas';
const response = await DataScraper.imprimePdfNfse("https://nfse.campinas.sp.gov.br/NotaFiscal/visualizarNota.php?id_nota_fiscal=XXXXX&confirma=Tg==&temPrestador=Tg==&doc_prestador=XXXXXX=&numero_nota_fiscal=XXXXX==&inscricao_prestador=XXXXXX==&cod_verificacao=XXXX");

Se os dados forem válidos, será retornado uma resposta nesse padrão:

{
  "nfse": "1000",
  "pdfBase64Content": "BASE64DOPDF=="
}

Rodando em AWS Lambda / Serverless Framework

Por ter em suas dependências o pacote chrome-aws-lambda, o projeto tem algumas pecularidades ao rodar usando AWS Lambda. Resumidamente, caso você estiver usando o serverless-bundle, você precisa forçar a exclusão desse pacote do bundle, importar via Lambda Layer e ter pelo menos 2GB de memória:

custom:
  bundle:
    forceExclude:
      - chrome-aws-lambda

Visto que o pacote foi excluído do bundle, é necessário usar uma Lambda Layer para ter os arquivos necessários para o processamento:

functions:
  imprimePdfNfse:
    handler: src/handlers/nfseDataScraper.imprimePdfNfse
    timeout: 30
    memorySize: 2048
    layers:
      - arn:aws:lambda:us-east-1:764866452798:layer:chrome-aws-lambda:25
    events:
      - http:
          path: v1/nfse/imprimePdfNfse
          method: post
          private: true
          cors: true