nfephp-org / sped-ibpt
用于与IBPT Restful服务器通信的API。
Requires
- php: >=7.0
- ext-curl: *
- ext-json: *
- ext-mbstring: *
- ext-openssl: *
Requires (Dev)
- phpcompatibility/php-compatibility: ^9.3
- phpstan/phpstan: ^0.12.99
- phpunit/phpunit: ^6
- scrutinizer/ocular: ^1.3
- squizlabs/php_codesniffer: dev-master
README
此存储库是NFePHP框架的一部分,作为查找特定产品相关税收的辅助,利用IBPT提供的免费资源。
《商品和服务税收法》(第12,741/12号法律,2012年12月8日)旨在向公民说明每次购买所支付的税收部分。
因此,所有直接向最终消费者销售商品的商业机构都有义务在财务文件或等价文件中包含已支付的税收、近似值和百分比。
最终消费者包括个人或法人,例如,为自身消费、使用或消耗材料以及固定资产购买产品或服务。
选择简易国家制度的微型企业和小型企业可以只报告根据该制度所适用的税率。此外,他们还应加上之前的税收影响(例如,IPI、税收替代等)。
这是一个简单的API,允许访问IBPT "巴西计划与税收研究所"(Instituto Brasileiro de Planejamento e Tributação)提供的RestFul服务资源。
有关更多信息,请参阅IBPT文档。
说明
-
关于商品和服务的销售(65型收据、ECF和SAT)和发票(55型)应告知影响最终价格形成的联邦、州和地方税收的大致金额。
-
税收金额的确定应在3个字段中完成(每个实体一个),包括分别影响每种商品或服务的近似税收负担,包括在分别适用于制造商、零售商和服务提供者的不同税收制度的情况下。
-
在实体店的情况下,这些信息可以位于商店可见位置的广告牌上。当涉及按价值征收的税收时,它们将是支付价格的百分比;在特定税率的情况下,则是货币价值。
注意:有关更多详细信息,请参阅NT2013.003
先决条件
在使用此类之前,您需要通过在IBPT注册页面注册公司来获取一个访问令牌
- PHP >= 7.0
- php-curl
- php-json
- php-openssl
安装
composer require nfephp-org/sped-ibpt
或将以下内容添加到您的composer.json文件中
{
"require": {
"nfephp-org/sped-ibpt": "^2.0"
}
}
方法
productTaxes
此方法查询IBPT的webservice并请求关于请求产品税收的数据。是
use NFePHP\Ibpt\Ibpt; $token = "<indique seu token>"; //OBRIGATÓRIO $cnpj = "<indique seu 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 );
如果成功且找到了请求的产品位置,将返回
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 )
如果在通过NCM找不到产品或通信中出现任何其他错误,将返回类似以下内容
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
此方法查询IBPT的webservice,并请求与所请求服务相关的税务数据。
use NFePHP\Ibpt\Ibpt; $token = "<indique seu token>"; //OBRIGATÓRIO $cnpj = "<indique seu 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 );
在成功情况下,如果找到了所请求服务的位置,将返回
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 )
如果在通过NCM找不到产品或通信中出现任何其他错误,将返回类似以下内容
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 )
积分
- Roberto L. Machado(所有者)
变更日志
请关注变更日志以获取有关最近变更的更多信息。
贡献
安全性
如果您发现与安全相关的问题,请直接向软件包维护者发送电子邮件,而不是打开一个ISSUE。
许可协议
此软件包可在LGPLv3或MIT许可(MIT)下使用。阅读许可文件以获取更多信息。