README

从NFe (e NFCe)的4.00版本布局开始，产品GTIN变为必填项，当存在时。因此，在包含具有商业条码（GTIN 8、12、13或14）的产品所有NFe (e NFCe)中，都必须在他们的发票中指明这些代码。

确保这些GTIN在插入系统之前正确且经过验证非常重要，以避免SEFAZ的拒绝。

NT 2021.003_v1_00 GTIN验证

本技术规范自九月起生效，规定只能使用国内GTIN，即以789或790开头的GTIN，此外，只能使用在全国产品注册 - CNP注册的产品。

需要强调的是，集中注册也将比较其他信息，如

GTIN
品牌
GTIN类型（8、12、13或14位）
产品描述
品牌所有者标识（CNPJ或CPF）
产品分类数据（部门、系列、类别和子类别/块）
NCM
CEST（如有）
毛重和净重
毛重和净重的计量单位

这些数据必须与NFe或NFCe中提供的信息相兼容。

请检查 https://gepir.gs1.org/index.php/search-by-gtin

注意：如果制造商/进口商未能正确注册其产品，则可能会出现拒绝，但这不会影响商家，因为将无法发出NFe的将是制造商/进口商。

这个类正是为了这个目的，它检查GTIN号码的正确性，包括其结构、前缀、地区和校验位。

SEFAZ将对全国产品注册 - CNP进行额外查询。但目前还没有API可用，因此如果您的数据与CNP不符，仍然可能发生拒绝。

使用方法

use NFePHP\Gtin\Gtin;

try {
    $gtin = new Gtin('78935761');
    $region = $gtin->region;
    $prefix = $gtin->prefix;
    $digitoVerificador = $gtin->checkDigit;

    if ($gtin->isValid()) {
        echo "Valido";
    }
} catch (\Exception $e) {
    echo $e->getMessage();
}

Gtin类有几个属性

region - (字符串) 表示数字的使用区域，例如GS1巴西

prefix - (字符串) 表示区域的前缀，例如789

checkDigit - (整数) 表示特定数字序列的校验位（计算得出）

restricted - (布尔值) 表示前缀是否为限制使用

type - (整数) 表示GTIN类型（8、12、13或14）

类的主要功能是

function isValid()

该函数不接受参数，如果GTIN号码原则上有效，则返回TRUE。

类也可以静态实例化。

use NFePHP\Gtin\Gtin;

try {
    $gtin = Gtin::check('78935761');
    $region = $gtin->region;
    $prefix = $gtin->prefix;
    $digitoVerificador = $gtin->checkDigit;

    if ($gtin->isValid()) {
        echo "Válido";
    }
} catch (\Exception $e) {
    echo $e->getMessage();
}

或者

use NFePHP\Gtin\Gtin;

$gtin = "78935761";

try {
    if (Gtin::check($gtin)->isValid()) {
        echo "Válido";
    }
} catch (\Exception $e) {
    echo $e->getMessage();
}

注意：如果GTIN是“没有GTIN”的，将返回TRUE（有效），形式恰好如此，使用大写字母，任何其他形式都会导致拒绝。

验证和异常

如果提供的数字不满足某些限制，将返回一个异常

本包符合PSR-1、PSR-2和PSR-4标准。如果您发现不符合规范的地方，请通过pull request提交补丁。

不要忘记注册NFePHP讨论组，以便跟踪开发进度，参与讨论和答疑！

安装

本包在Packgist上有记录，是为Composer使用的，因此不会提供其他安装方式。

应使用以下命令安装：

composer require ads-system/sped-gtin

或者修改您的应用中的composer.json文件，添加以下内容：

"require": {
    "ads-system/sped-gtin" : "^1.0"
}

为了在开发分支（master）中使用本包，应使用以下命令安装：

composer require ads-system/sped-gtin:dev-master

或者修改您的应用中的composer.json文件，添加以下内容：

"require": {
    "ads-system/sped-gtin" : "dev-master"
}

注意：在使用此包的开发版本时，不要忘记将您的应用中的composer.json文件的"minimum-stability"属性从"stable"更改为"dev"，以接受开发包。
"minimum-stability": "dev"

要求

为了使本包正常运行，需要以下PHP和依赖包的要求。

PHP >= 7.x（推荐PHP 7.2.x）（已包含PHP 8.0.x的支持）

贡献

若要贡献BUG修正、代码改进、文档编写、测试编写或其他技术或编程方面的帮助，请参考CONTRIBUTING和行为准则以获取更多详细信息。

变更日志

有关最新变更的详细信息，请参阅CHANGELOG。

测试

所有测试均使用PHPUNIT进行开发。

安全

如果您发现与安全相关的任何问题，请直接向包维护者发送电子邮件，而不是创建ISSUE。

致谢

Roberto L. Machado（所有者和开发者） Gustavo Lidani（开发者）

许可协议

本包可在LGPLv3或MIT许可（MIT）下使用。有关更多信息，请参阅许可协议文件。

ads-system / sped-gtin

维护者

详情