PHPackages                             andreataide/nfsesaquarema-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. andreataide/nfsesaquarema-php

ActiveLibrary[API Development](/categories/api)

andreataide/nfsesaquarema-php
=============================

Lib to communicate with web services to generate NFS-e (Nota Fiscal de Serviços Eletrônica)

09PHP

Since Mar 13Pushed 1y agoCompare

[ Source](https://github.com/andreataide/nfsesaquarema-php)[ Packagist](https://packagist.org/packages/andreataide/nfsesaquarema-php)[ RSS](/packages/andreataide-nfsesaquarema-php/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Developed from the NFSePHP project - Nota Carioca by Pedro Casado.

NFSePHP - Saquarema
===================

[](#nfsephp---saquarema)

Lib to communicate with SOAP web services and generate NFS-e (Nota Fiscal de Serviços Eletrônica). Under development. Still not Working!

### Operations Supported

[](#operations-supported)

- Saquarema
    - GerarNfse
    - ConsultarNfsePorRps
    - ConsultarNfse
    - CancelarNfse

Install
=======

[](#install)

```
composer require andreataide/nfsesaquarema-php
```

Usage
=====

[](#usage)

Check examples/ folder

You must have a valid certificate to use NFSe staging environment.

### GerarNfse

[](#gerarnfse)

```
use NotaSaquarema\NotaSaquaremaFactory;
use NotaSaquarema\SoapHandler;

$rps = [
    'IdentificacaoRps' => [
        'Numero' => 119,
        'Serie' => 'A',
        'Tipo' => 1,
        // 1 - RPS
        // 2 – Nota Fiscal Conjugada (Mista)
        // 3 – Cupom
    ],
    'DataEmissao' => date('Y-m-d').'T'.date('H:i:s'),
    'NaturezaOperacao' => 1,
    // 1 – Tributação no município
    // 2 - Tributação fora do município
    // 3 - Isenção
    // 4 - Imune
    // 5 – Exigibilidade suspensa por decisão judicial
    // 6 – Exigibilidade suspensa por procedimento administrativo

    'RegimeEspecialTributacao' => 3, // optional
    // 1 – Microempresa municipal
    // 2 - Estimativa
    // 3 – Sociedade de profissionais
    // 4 – Cooperativa
    // 5 – MEI – Simples Nacional
    // 6 – ME EPP – Simples Nacional

    'OptanteSimplesNacional' => 2, // 1 - Sim 2 - Não
    'IncentivadorCultural' => 2, // 1 - Sim 2 - Não
    'Status' => 1, // 1 – Normal  2 – Cancelado

    'Prestador' => [
        'Cnpj' => '111111',
        'InscricaoMunicipal' => '11111', // optional
    ],

    'Tomador' => [
        'IdentificacaoTomador' => [ // optional
            'CpfCnpj' => [
                'Cpf' => '111',
                // 'Cnpj' => '111',
            ],
        ],
        'RazaoSocial' => 'Fulano de tal', // optional
        'Endereco' => [ // optional
            'Endereco' => 'Rua 1111', // optional
            'Numero' => '1', // optional
            'Complemento' => 'ap 1', // optional
            'Bairro' => '1', // optional
            'CodigoMunicipio' => 1111111, // optional
            'Uf' => 'RJ', // optional
            'Cep' => 11111111, // optional
        ],
    ],

    'Servico' => [
        'ItemListaServico' => '1002', // First 4 digits
        'CodigoTributacaoMunicipio' => '100203', // 6 digits
        'Discriminacao' => 'Pedido #1111 - Itens: #123 , #124',
        'CodigoMunicipio' => 1111111,
        'Valores' => [
            'ValorServicos' => 228.6,
            'ValorDeducoes' => 10.0, // optional
            'ValorPis' => 10.0, // optional
            'ValorCofins' => 10.0, // optional
            'ValorInss' => 10.0, // optional
            'ValorIr' => 10.0, // optional
            'ValorCsll' => 10.0, // optional
            'IssRetido' => 2, // 1 para ISS Retido - 2 para ISS não Retido,
            'ValorIss' => 10.0, // optional
            'OutrasRetencoes' => 10.0, // optional
            'Aliquota' => 5, // optional
            'DescontoIncondicionado' => 10.0, // optional
            'DescontoCondicionado' => 10.0, // optional
        ],
    ],

    'IntermediarioServico' => [ // optional
        'RazaoSocial' => 'Fulano de tal',
        'CpfCnpj' => [
            'Cnpj' => '11111',
            // 'Cpf' => '1111',
        ],
        'InscricaoMunicipal' => '11111', // optional
    ],

    'ConstrucaoCivil' => [ // optional
        'CodigoObra' => '111',
        'Art' => '111',
    ],
];

$env = 'dev'; // dev - prod
$notaCariocaFactory = new NotaCariocaFactory();
$gerarOperation = $notaCariocaFactory->createOperation('gerar-nfse', $env);
$gerarOperation->setRps($rps);

$soapHandler = new SoapHandler(['cert_path' => '/path/to/valid/cert.pfx', 'cert_pass' => 'certpassword']);

// Send SOAP xml
$response = $soapHandler->send($gerarOperation);

if ($soapHandler->isSuccess($response)) {
    $nfs = $gerarOperation->formatSuccessResponse($response);
    var_dump($nfs);
} else {
    var_dump($soapHandler->getErrors($response));
}

/* Response

array (size=1)
  'nfse' =>
    array (size=14)
      'Numero' => string '43' (length=2)
      'CodigoVerificacao' => string 'VZW2-EJIB' (length=9)
      'DataEmissao' => string '2020-02-28T09:09:55' (length=19)
      'IdentificacaoRps' =>
        array (size=3)
          'Numero' => string '1' (length=1)
          'Serie' => string 'A' (length=2)
          'Tipo' => string '1' (length=1)
      'DataEmissaoRps' => string '2020-02-28' (length=10)
      'NaturezaOperacao' => string '1' (length=1)
      'RegimeEspecialTributacao' => string '3' (length=1)
      'OptanteSimplesNacional' => string '2' (length=1)
      'IncentivadorCultural' => string '2' (length=1)
      'Competencia' => string '2020-02-28T00:00:00' (length=19)
      'Servico' =>
        array (size=5)
          'Valores' =>
            array (size=3)
              'ValorServicos' => string '228.6' (length=5)
              'IssRetido' => string '2' (length=1)
              'ValorLiquidoNfse' => string '228.6' (length=5)
          'ItemListaServico' => string '1002' (length=4)
          'CodigoTributacaoMunicipio' => string '100203' (length=6)
          'Discriminacao' => string 'Pedido #1111 - Itens: #123 , #124' (length=33)
          'CodigoMunicipio' => string '3304557' (length=7)
      'PrestadorServico' =>
        array (size=4)
          'IdentificacaoPrestador' =>
            array (size=2)
              'Cnpj' => string '11111111111111' (length=14)
              'InscricaoMunicipal' => string '1111111' (length=7)
          'RazaoSocial' => string '11111111' (length=48)
          'Endereco' =>
            array (size=7)
              'Endereco' => string '11111' (length=39)
              'Numero' => string '1111' (length=3)
              'Complemento' => string '11111' (length=15)
              'Bairro' => string '11111' (length=7)
              'CodigoMunicipio' => string '3304557' (length=7)
              'Uf' => string 'RJ' (length=2)
              'Cep' => string '1111111' (length=8)
          'Contato' => string '' (length=0)
      'TomadorServico' =>
        array (size=2)
          'IdentificacaoTomador' => string '' (length=0)
          'Endereco' => string '' (length=0)
      'OrgaoGerador' =>
        array (size=2)
          'CodigoMunicipio' => string '3304557' (length=7)
          'Uf' => string 'RJ' (length=2)
*/
```

TODO's
======

[](#todos)

- Add missing operations (ConsultarLoteRps, ConsultarSituacaoLoteRps, EnviarLoteRps)
- Add tests

###  Health Score

16

—

LowBetter than 5% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity15

Early-stage or recently created project

 Bus Factor1

Top contributor holds 68% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/87792f95a79b06025d388f42e7ab50f5b039e8aad777969a7295a5f88eed69c3?d=identicon)[andreataide](/maintainers/andreataide)

---

Top Contributors

[![pedrocasado](https://avatars.githubusercontent.com/u/354624?v=4)](https://github.com/pedrocasado "pedrocasado (34 commits)")[![andreataide](https://avatars.githubusercontent.com/u/89859362?v=4)](https://github.com/andreataide "andreataide (14 commits)")[![fgracalepsus](https://avatars.githubusercontent.com/u/7882648?v=4)](https://github.com/fgracalepsus "fgracalepsus (1 commits)")[![marcosandrade22](https://avatars.githubusercontent.com/u/4664235?v=4)](https://github.com/marcosandrade22 "marcosandrade22 (1 commits)")

### Embed Badge

![Health badge](/badges/andreataide-nfsesaquarema-php/health.svg)

```
[![Health](https://phpackages.com/badges/andreataide-nfsesaquarema-php/health.svg)](https://phpackages.com/packages/andreataide-nfsesaquarema-php)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M454](/packages/google-gax)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
