Nota Paulistana (NFS-e SP)

O conector da Nota Paulistana permite a integração com o Web Service da Prefeitura de São Paulo para emissão de Notas Fiscais de Serviços Eletrônicas (NFS-e).

Configuração

Para utilizar este conector, você precisará de um Certificado Digital (modelo A1) válido.

Campo	Descrição
Certificate (PFX/P12)	O arquivo do seu certificado digital (.pfx ou .p12).
Certificate Password	A senha para desbloquear o certificado digital.

Nota: O conector detecta automaticamente qual versão do Web Service utilizar (Legado/V1 ou Reforma Tributária/V2) com base na data de emissão ou início da prestação do serviço informada nos parâmetros da ação.

• Datas até 31/12/2025: Utilizam o ambiente Legado (V1).
• Datas a partir de 01/01/2026: Utilizam o ambiente da Reforma Tributária (V2).

Ações Disponíveis

envio_lote_rps

Envia um lote de Recibos Provisórios de Serviços (RPS) para serem convertidos em NFS-e.

Parâmetros de Entrada (Exemplo JSON)

O conector aceita um objeto JSON contendo o cabecalho e a lista de rps. O conector trata automaticamente as diferenças de campos entre as versões V1 e V2, bem como a assinatura digital e a comunicação SOAP.

{
  "cabecalho": {
    "cpf_cnpj_remetente": {
      "cnpj": "00000000000000"
    },
    "dt_inicio": "2025-12-05",
    "dt_fim": "2025-12-05",
    "qtd_rps": 1,
    "valor_total_servicos": 100.00,
    "valor_total_deducoes": 0.00,
    "transacao": true
  },
  "rps": [
    {
      "chave_rps": {
        "inscricao_prestador": 12345678,
        "serie_rps": "RPS",
        "numero_rps": 1001
      },
      "tipo_rps": "RPS",
      "data_emissao": "2025-12-05",
      "status_rps": "N",
      "tributacao_rps": "T",
      "valor_servicos": 100.00,
      "valor_deducoes": 0.00,
      "valor_pis": 0.00,
      "valor_cofins": 0.00,
      "valor_inss": 0.00,
      "valor_ir": 0.00,
      "valor_csll": 0.00,
      "codigo_servico": 2800,
      "aliquota": 0.029,
      "iss_retido": false,
      "discriminacao": "Descrição do serviço prestado...",
      "cpf_cnpj_tomador": {
        "cnpj": "11111111000111"
      },
      "razao_social_tomador": "Razão Social do Tomador",
      "endereco_tomador": {
        "tipo_logradouro": "R",
        "logradouro": "Nome da Rua",
        "numero": "123",
        "bairro": "Bairro",
        "cidade": 3550308,
        "uf": "SP",
        "cep": "01001000"
      },
      "email_tomador": "email@exemplo.com"
    }
  ]
}

Outras Ações

• consulta_cnpj: Consulta a situação de um CNPJ na prefeitura.
• consulta_lote: Consulta o status de processamento de um lote enviado.
• consulta_nfe: Consulta uma NFS-e específica.
• cancelamento_nfe: Cancela uma NFS-e emitida.

Observações Importantes

• Assinatura Digital: O conector realiza automaticamente a assinatura digital do RPS e do lote conforme exigido pela prefeitura (SHA1RSA), ajustando o formato da assinatura (padding de Inscrição Municipal) dependendo da versão do layout (V1 ou V2).
• Compatibilidade V1: Para emissões com data até 2025, o conector garante que campos obrigatórios na V1 (como ValorServicos) sejam enviados corretamente, mesmo que a estrutura interna de validação utilize schemas mais recentes.