PHPackages                             nfephp-org/sped-ibpt - 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. nfephp-org/sped-ibpt

ActiveLibrary[API Development](/categories/api)

nfephp-org/sped-ibpt
====================

API para a comunicação com o servidor Restful do IBPT.

v2.0.2(1y ago)3079.2k—9.3%171GPL-3.0+PHPPHP >=7.0CI failing

Since Dec 9Pushed 1y ago7 watchersCompare

[ Source](https://github.com/nfephp-org/sped-ibpt)[ Packagist](https://packagist.org/packages/nfephp-org/sped-ibpt)[ Docs](https://github.com/nfephp-org/sped-ibpt)[ RSS](/packages/nfephp-org-sped-ibpt/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (5)Versions (12)Used By (1)

sped-ibpt
=========

[](#sped-ibpt)

Este repositório faz parte do framework [NFePHP](http://www.nfephp.org), como um auxilio na busca dos impostos incidentes sobre um determinado produto, utilizando o recurso gratuito oferecido pelo [IBPT](https://ibpt.com.br/).

*A Lei do Imposto na Nota (Lei nº 12.741/12, de 8 de dezembro de 2012) nasceu com o intuito de informar ao cidadão o quanto representa a parcela dos tributos que paga a cada compra realizada.*

*Assim, todo estabelecimento que efetuar vendas diretamente ao consumidor final **está obrigado** a incluir nos documentos fiscais ou equivalentes os impostos pagos, valores aproximados e percentuais.*

*Como consumidores finais incluem-se as pessoas físicas ou jurídicas que adquirem produtos ou serviços, por exemplo, para consumo próprio, materiais de uso ou consumo e ativo imobilizado.*

*As Microempresas e Empresas de Pequeno Porte optantes do Simples Nacional podem informar apenas a alíquota a que se encontram sujeitas nos termos do referido regime. Além disso, devem somar eventual incidência tributária anterior (IPI, substituição tributária, por exemplo).*

[![Join the chat at https://gitter.im/nfephp-org/sped-ibpt](https://camo.githubusercontent.com/91a21d4a7e040b46eaf2817994e787875b25095677bd9d882cb0959e9b347c1f/68747470733a2f2f6261646765732e6769747465722e696d2f6e66657068702d6f72672f737065642d696270742e737667)](https://gitter.im/nfephp-org/sped-ibpt?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

Esta é uma API simples para permitir o acesso ao recursos providos pelos serviços RestFul do [IBPT "Instituto Brasileiro de Planejamento e Tributação"](https://deolhonoimposto.ibpt.org.br/).

Para saber mais consulte a [documentação do IBPT](https://deolhonoimposto.ibpt.org.br/).

[![Actions Status](https://github.com/nfephp-org/sped-ibpt/actions/workflows/ci.yml/badge.svg?style=flat-square)](https://github.com/nfephp-org/sped-gtin/actions)

[![Latest Version on Packagist](https://camo.githubusercontent.com/925a0c3eb634c317225ec350cf79ab46bb60c9580e23187f046d62f06a3599b7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e66657068702d6f72672f737065642d696270742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfephp-org/sped-ibpt)[![License](https://camo.githubusercontent.com/e0273385d246b6a90332d858facac88177613ea018b9a21e402ffad0d613f302/68747470733a2f2f706f7365722e707567782e6f72672f6e66657068702d6f72672f6e66657068702f6c6963656e73652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfephp-org/sped-ibpt)[![Total Downloads](https://camo.githubusercontent.com/6c15575922c284f9918c027ab8a738af743270b61b9f6d5c8d12d0a101f93b3f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e66657068702d6f72672f737065642d696270742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfephp-org/sped-ibpt)

[![Issues](https://camo.githubusercontent.com/a541ec37d2525fe433beb8d458c7d070b660c73aa4dd8539350836e54b03c837/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6e66657068702d6f72672f737065642d696270742e7376673f7374796c653d666c61742d737175617265)](https://github.com/nfephp-org/sped-ibpt/issues)[![Forks](https://camo.githubusercontent.com/c357d390b124b7fb0109751b4cb3f7993afa037183eba1a47dc063341c9d5626/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f6e66657068702d6f72672f737065642d696270742e7376673f7374796c653d666c61742d737175617265)](https://github.com/nfephp-org/sped-ibpt/network)[![Stars](https://camo.githubusercontent.com/727333a015e8fa391e6a3207cacb9c9fd206cdf781b0543b064606363bd3f943/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e66657068702d6f72672f737065642d696270742e7376673f7374796c653d666c61742d737175617265)](https://github.com/nfephp-org/sped-ibpt/stargazers)

Esclarecimentos
---------------

[](#esclarecimentos)

1. Os cupons (mod.65, ECF e SAT) e notas fiscais (mod.55) referentes à venda de mercadoria e serviços **devem informar o valor aproximado dos tributos federais, estaduais e municipais**, cuja incidência influencia na formação do preço final;
2. A apuração do valor dos impostos deverá ser feita em 3 campos (um por ente) com a soma das cargas tributárias aproximadas que incidem sobre cada mercadoria ou serviço, separadamente, inclusive nas hipóteses de regimes jurídicos tributários diferenciados dos respectivos fabricantes, varejistas e prestadores de serviços, quando couber.
3. Alternativemente, no caso de lojas físicas, as informações podem estar em painel afixado em local visível do estabelecimento comercial. Elas serão em percentual sobre o preço a ser pago, quando se tratar de tributo com alíquota *"ad valorem"* (sobre valor) ou em valores monetários (no caso de alíquota específica).

> NOTA: Para maiores detalhes vide [NT2013.003](https://www.nfe.fazenda.gov.br/portal/exibirArquivo.aspx?conteudo=RrvyORm641k=)

Pré Requisitos
--------------

[](#pré-requisitos)

Antes de poder utilizar esta classe é necessário que você obtenha um TOKEN de acesso cadastrando a empresa no IBPT [página de Cadastro](https://deolhonoimposto.ibpt.org.br/Usuario/CriarConta)

- PHP >= 7.0
- php-curl
- php-json
- php-openssl

Intalação
---------

[](#intalação)

```
composer require nfephp-org/sped-ibpt

```

Ou adicione ao seu composer.json:

```
{
    "require": {
        "nfephp-org/sped-ibpt": "^2.0"
    }
}

```

Métodos
=======

[](#métodos)

productTaxes
------------

[](#producttaxes)

Este método consulta o webservice do IBPT e solicita os dados referentes aos impostos do produto solicitado. Sendo:

```
use NFePHP\Ibpt\Ibpt;

$token = ""; //OBRIGATÓRIO
$cnpj = ""; //OBRIGATÓRIO

$ncm = "60063210"; //OBRIGATÓRIO coloque o NCM do produto
$uf = 'SP'; //OBRIGATÓRIO coloque o estado que deseja saber os dados
$extarif = 0; //OBRIGATÓRIO indique o numero da exceção tarifaria, se existir ou deixe como zero
$codigoInterno = ''; //(OPCIONAL) indique o codigo interno do produto
$descricao = 'Tecido';//OBRIGATÓRIO
$unidadeMedida = 'kg'; //OBRIGATÓRIO
$valor = '60.00'; //OBRIGATÓRIO
$gtin = 'SEM GTIN'; //OBRIGATÓRIO

//instancia a classe
$ibpt = new Ibpt($cnpj, $token);

$resp = $ibpt->productTaxes(
    $uf,
    $ncm,
    $extarif,
    $descricao,
    $unidadeMedida,
    $valor,
    $gtin,
    $codigoInterno
);
```

Em caso de SUCESSO e com a localização do Produto solicitado irá retornar:

```
stdClass Object
(
    [Codigo] => 60063210
    [UF] => SP
    [EX] => 0
    [Descricao] => Tecidos de malha de fibras sinteticas, tintos, de náilon ou de outras poliamidas
    [Nacional] => 13.45
    [Estadual] => 18
    [Importado] => 36.08
    [Municipal] => 0
    [Tipo] => 0
    [VigenciaInicio] => 01/04/2018
    [VigenciaFim] => 30/06/2018
    [Chave] => F3W1D7
    [Versao] => 18.1.B
    [Fonte] => IBPT/empresometro.com.br
    [Valor] => 60
    [ValorTributoNacional] => 8.07
    [ValorTributoEstadual] => 10.8
    [ValorTributoImportado] => 21.65
    [ValorTributoMunicipal] => 0
)
```

Em caso de não encontrar o produto pelo NCM, ou qualquer outro erro na comunicação, retornará algo como:

```
stdClass Object
(
    [Codigo] =>
    [UF] =>
    [EX] => 0
    [Descricao] =>
    [Nacional] => 0
    [Estadual] => 0
    [Importado] => 0
    [Municipal] => 0
    [Tipo] =>
    [VigenciaInicio] =>
    [VigenciaFim] =>
    [Chave] =>
    [Versao] =>
    [Fonte] =>
    [Valor] => 60
    [ValorTributoNacional] => 0
    [ValorTributoEstadual] => 0
    [ValorTributoImportado] => 0
    [ValorTributoMunicipal] => 0
)
```

serviceTaxes
------------

[](#servicetaxes)

Este método consulta o webservice do IBPT e solicita os dados referentes aos impostos do serviço solicitado. Sendo:

```
use NFePHP\Ibpt\Ibpt;

$token = ""; //OBRIGATÓRIO
$cnpj = ""; //OBRIGATÓRIO

$codigo = '0107';  //OBRIGATÓRIO numero LV116 ou NBM
$uf = 'SP'; // //OBRIGATÓRIO
$descricao = 'Suporte técnico em informática';  //OBRIGATÓRIO
$unidadeMedida = 'un';  //OBRIGATÓRIO
$valor = '500.00';  //OBRIGATÓRIO

//instancia a classe
$ibpt = new Ibpt($cnpj, $token);

$resp = $ibpt->serviceTaxes(
    $uf,
    $codigo,
    $descricao,
    $unidadeMedida,
    $valor
);
```

Em caso de SUCESSO e com a localização do Serviço solicitado irá retornar:

```
stdClass Object
(
    [Codigo] => 0107
    [UF] => SP
    [Descricao] => Suporte técnico em informática, inclusive instalação, configuração e manutenção de programas de computação e bancos de dados.
    [Tipo] => 2
    [Nacional] => 13.45
    [Estadual] => 0
    [Municipal] => 2.7
    [Importado] => 15.45
    [VigenciaInicio] => 01/04/2018
    [VigenciaFim] => 30/06/2018
    [Chave] => F3W1D7
    [Versao] => 18.1.B
    [Fonte] => IBPT/empresometro.com.br
    [Valor] => 500
    [ValorTributoNacional] => 67.25
    [ValorTributoEstadual] => 0
    [ValorTributoImportado] => 77.25
    [ValorTributoMunicipal] => 13.5
)
```

Em caso de não encontrar o produto pelo NCM, ou qualquer outro erro na comunicação, retornará algo como:

```
stdClass Object
(
    [Codigo] =>
    [UF] =>
    [Descricao] =>
    [Tipo] =>
    [Nacional] => 0
    [Estadual] => 0
    [Municipal] => 0
    [Importado] => 0
    [VigenciaInicio] =>
    [VigenciaFim] =>
    [Chave] =>
    [Versao] =>
    [Fonte] =>
    [Valor] => 500
    [ValorTributoNacional] => 0
    [ValorTributoEstadual] => 0
    [ValorTributoImportado] => 0
    [ValorTributoMunicipal] => 0
)
```

Credits
-------

[](#credits)

- Roberto L. Machado (owner)

Change log
----------

[](#change-log)

Acompanhe o [CHANGELOG](CHANGELOG.md) para maiores informações sobre as alterações recentes.

Contributing
------------

[](#contributing)

Para contribuir por favor observe o [CONTRIBUTING](CONTRIBUTING.md) e o [Código de Conduta](CONDUCT.md) parea detalhes.

Security
--------

[](#security)

Caso você encontre algum problema relativo a segurança, por favor envie um email diretamente aos mantenedores do pacote ao invés de abrir um ISSUE.

License
-------

[](#license)

Este pacote está diponibilizado sob LGPLv3 ou MIT License (MIT). Leia [Arquivo de Licença](LICENSE.md) para maiores informações.

###  Health Score

46

—

FairBetter than 93% of packages

Maintenance42

Moderate activity, may be stable

Popularity44

Moderate usage in the ecosystem

Community21

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 95.2% 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.

###  Release Activity

Cadence

Every ~298 days

Recently: every ~680 days

Total

11

Last Release

462d ago

Major Versions

v1.0.x-dev → v2.0.02018-06-24

PHP version history (2 changes)v1.0.0PHP ~5.6|~7.0

v2.0.0PHP >=7.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/83b3feccdc04943c30ac9b785307cb73385c30d5b3ad8a7c700f7704416dc280?d=identicon)[robmachado](/maintainers/robmachado)

---

Top Contributors

[![robmachado](https://avatars.githubusercontent.com/u/1437008?v=4)](https://github.com/robmachado "robmachado (59 commits)")[![ricardoapaes](https://avatars.githubusercontent.com/u/38794747?v=4)](https://github.com/ricardoapaes "ricardoapaes (2 commits)")[![thmrdev](https://avatars.githubusercontent.com/u/41805723?v=4)](https://github.com/thmrdev "thmrdev (1 commits)")

---

Tags

nfenfephpnfceIBPT

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/nfephp-org-sped-ibpt/health.svg)

```
[![Health](https://phpackages.com/badges/nfephp-org-sped-ibpt/health.svg)](https://phpackages.com/packages/nfephp-org-sped-ibpt)
```

###  Alternatives

[nfephp-org/sped-nfe

API para geração e comunicação da NFe e NFCe com as SEFAZ autorizadoras.

1.4k1.4M10](/packages/nfephp-org-sped-nfe)[nfephp-org/sped-gtin

Classes for validation of GTIN codes.

17981.7k11](/packages/nfephp-org-sped-gtin)[nfephp-org/sped-nfse-ginfes

API para geração e comunicação de RPS e NFSe no padão Ginfes.

434.7k](/packages/nfephp-org-sped-nfse-ginfes)[cloud-dfe/sdk-php

SDK para comunicação com a API CloudDFe.

1718.5k](/packages/cloud-dfe-sdk-php)[mazinsw/nfe-api

API para geração e envio de notas fiscais eletrônicas brasileiras

591.4k](/packages/mazinsw-nfe-api)[nfephp-org/sped-efdreinf

API para geração e comunicação dos eventos relativos ao projeto EFD-Reinf da Receita Federal do Brasil.

3013.0k](/packages/nfephp-org-sped-efdreinf)

PHPackages © 2026

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