README

Validador, formatador e gerador de documentos para Laraver by SertSoft

安装

Laravel ^5.x

执行composer在您的laravel应用中安装此包

composer require sertsoft/laradations

如果您打算使用SertAPI集成，请使用artisan发布配置

php artisan vendor:publish --tag=config

现在只需在项目中使用Laradations包的便捷性。

工具

文档验证

使用方法

public function store(Request $request)
{
    //Realiza a validação dos campos
    $request->validate([
        'cpf'       => 'cpf',
        'cnpj'      => 'cnpj',
        'placa'     => 'placa',
        'documento' => 'cpfCnpj'
    ]);
}

字段掩码

使用方法

要使用掩码，您首先需要导入Laradator类

use SertSoft\Laradations\Laradator;

导入后，只需使用laraMask()方法即可

public function show(){

    //Laradator::laraMask('cnpj', '11999888000110');
    //Laradator::laraMask('telefone', '81988523611');
    //Laradator::laraMask('telefone', '5581988523611');
    //Laradator::laraMask('telefone', '988523611');
    $cpf = Laradator::laraMask('cpf', '12345678988');

    echo $cpf;
}

结果将是123.456.789-88

如果您想使用上面表格中不可用的掩码，请按照以下方式操作

public function show(){

    $mascara = Laradator::laraMask('### ###-###', '123456789');

    echo $mascara;
}

结果将是123 456-789

SertAPI

首先，您需要在库中定义您的Token，为此，请进入项目Laravel中的config/sertapi.php文件并更改文件中的两行

    'use_api' => true, //Troque para TRUE para que seja ativa a API no seu projeto laravel.
    'api_token' => 'SEU_TOKEN_AQUI',//Informe seu token gerado no site para autenticar a aplicação.

对于使用SertAPI的用户，我们与包完全集成，因此安装和发布后，您只需在前面步骤中设置Token和激活API，然后只需使用类SertApi的方法consultas

 SertApi::consultas();

方法consultas仅接受一个参数，即一个数组，该数组以静态方式结构化，并且必须始终遵循此模型

索引0可以包含值anv、cep、cnpj、ebct、sus和prod，它们表示将由库执行的查询类型。
索引1将包含过滤值，对于anv => nome、categoria、classe、registro
对于sus => codigo、nome
对于prod => gtin、nome、marca，对于其他类型，索引1应保留为空值
索引2具有要过滤的值，可以是药品的名称、商品GTIN或快递追踪代码，具体取决于您如何使用前面的索引。
索引3用于过滤Anvisa药品的结果，仅限已取消或仅限有效的记录，相应值为cancelado和valido。

使用方法

最初，您需要在将使用API的Controller中导入SertApi类

use SertSoft\Laradations\SertApi;

现在让我们通过药品名称为dorflex且仅限有效记录进行Anvisa查询

echo SertApi::consultas([
        'anv',
        'nome',
        'dorflex',
        'valido'
    ]);

返回将是数组

[
  0 => {
    "nome": "DORFLEX",
    "numero_registro": 183260354,
    "vencimento_registro": "01/08/2026",
    "classe": "RELAXANTES MUSCULARES CENTRAIS-ASSOCIACOES MEDICAMENTOSAS",
    "categoria": "NOVO",
    "detentora_registro": "10588595001092 - SANOFI MEDLEY FARMACÊUTICA LTDA.",
    "situacao_registro": "VÁLIDO"
  }
]

现在如果我们想通过GTIN 7891000103364查询商品，这是Nestlé的巧克力

echo SertApi::consultas([
    'prod',
    'gtin',
    '7891000103364',    
]);

响应将是

[
  "produto": {
    "gtin": 7891000103364,
    "descricao": "CHOCOLATE CLASSIC NESTLÉ AO LEITE",
    "fabricante": "NESTLE",
    "preco_min": "5,49",
    "preco_med": "6,72",
    "preco_max": "7,95",
    "embalagem": "Unidade",
    "qtd_embalagem": 1,
    "categoria": "NÃO SE APLICA"
  },
  "ncm": {
    "codigo": 18063210,
    "descricao": "Cacau e suas preparações - Chocolate e outras preparações alimentícias que contenham cacau. - Outros, em tabletes, barras e paus: - Não recheados - Chocolate"
  },
  "cest": {
    "codigo": 1700300,
    "descricao": "Chocolate em barras, tabletes ou blocos ou no estado líquido, em pasta, em pó, grânulos ou formas semelhantes, em recipientes ou embalagens imediatas de conteúdo inferior ou igual a 2 kg"
  }
]

最后，如果我们想追踪快递商品，我们应该这样做

echo SertApi::consultas([
    'ebct',
    '',
    'SEU_COD_RASTREIO',    
]);

[
    "0": {
      "dia": "05/01/2022",
      "hora": "15:22",
      "local": "Sao Paulo/SP",
      "acao": "Objeto postado",
      "mensagem": "Objeto postado ",
      "modificado": "há 8 dias"
    }
]

如果您还不知道API，请查阅文档。如有疑问或问题，请使用问题或通过WhatsApp联系支持