PHPackages                             zservices/query - 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. [Utility & Helpers](/categories/utility)
4. /
5. zservices/query

ActivePackage[Utility & Helpers](/categories/utility)

zservices/query
===============

Pacote para consultas em serviços do governo.

1.2.4(8y ago)131.1k1[1 PRs](https://github.com/juniorb2ss/zServices/pulls)MITPHPPHP >=5.5.9

Since May 2Pushed 5y ago3 watchersCompare

[ Source](https://github.com/juniorb2ss/zServices)[ Packagist](https://packagist.org/packages/zservices/query)[ RSS](/packages/zservices-query/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependencies (5)Versions (24)Used By (0)

zServices
=========

[](#zservices)

[![Laravel 5](https://camo.githubusercontent.com/2c9e794eadf9db5650f39617b9adb40d5b1574659ba0e8fa23659b55c6d89faa/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d352d677265656e2e737667)](https://laravel.com)[![Latest Stable Version](https://camo.githubusercontent.com/641b20893b60f3f5f2d96cd73d8e8d9c935049d43ceaea5951d8299eedd0d795/68747470733a2f2f706f7365722e707567782e6f72672f7a73657276696365732f71756572792f762f737461626c65)](https://packagist.org/packages/zservices/query) [![Total Downloads](https://camo.githubusercontent.com/4d69078d4a18f8427362f749724eee4f45de1a105ab47ebfb2dcd5fa490f77bb/68747470733a2f2f706f7365722e707567782e6f72672f7a73657276696365732f71756572792f646f776e6c6f616473)](https://packagist.org/packages/zservices/query) [![Latest Unstable Version](https://camo.githubusercontent.com/c7bd66511dd776c3a80d78cab426aae90952b580ef27dbb0a90bde8ec334ba98/68747470733a2f2f706f7365722e707567782e6f72672f7a73657276696365732f71756572792f762f756e737461626c65)](https://packagist.org/packages/zservices/query) [![License](https://camo.githubusercontent.com/29c47672154ff0d404c6e8d75c24a0fce01e5ed56b6b724e3ff2a1138ed3e113/68747470733a2f2f706f7365722e707567782e6f72672f7a73657276696365732f71756572792f6c6963656e7365)](https://packagist.org/packages/zservices/query)[![Build Status](https://camo.githubusercontent.com/cde52688417c2af519ebf12eb1d39e1369b7a44e092e5fd3b4d57ab81add6213/68747470733a2f2f6170692e7472617669732d63692e6f72672f6a756e696f72623273732f7a53657276696365732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/juniorb2ss/zServices)[![Dependency Status](https://camo.githubusercontent.com/3282a5214b6b39b0144f723d5e90b99be19d5c5cb10e621922b8f6e27b77d8c8/68747470733a2f2f67656d6e617369756d2e636f6d2f6261646765732f6769746875622e636f6d2f6a756e696f72623273732f7a53657276696365732e737667)](https://gemnasium.com/github.com/juniorb2ss/zServices)[![Issues Status](https://camo.githubusercontent.com/d264b9b4ebe0235861d336085894ca67cb28634f33f254c7d26a37a12bcbef62/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6a756e696f72623273732f7a53657276696365732e737667)](https://github.com/juniorb2ss/zServices/issues)[![Stars Status](https://camo.githubusercontent.com/d65c0dbf3f8b0817740afbad8e6a3f7d1cf0f90a01c90c3ed46eaeb68d454d8f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6a756e696f72623273732f7a53657276696365732e737667)](https://github.com/juniorb2ss/zServices/stargazers)[![Code Climate](https://camo.githubusercontent.com/8b58315fdedcd2ad589967092e39d5c4395fcfb25695a8b45e7f4ea208b5093e/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f6a756e696f72623273732f7a53657276696365732f6261646765732f6770612e737667)](https://codeclimate.com/github/juniorb2ss/zServices)[![Issue Count](https://camo.githubusercontent.com/0bc4d6e6c87776727e023fc6ee7ce03b6353a07495b4153d2c312f5c11e52403/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f6a756e696f72623273732f7a53657276696365732f6261646765732f69737375655f636f756e742e737667)](https://codeclimate.com/github/juniorb2ss/zServices)[![Test Coverage](https://camo.githubusercontent.com/a8a8697fb49196e6e834cf88a1b64011d1b09586f9e813500a5703d7968d5cd4/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f6a756e696f72623273732f7a53657276696365732f6261646765732f636f7665726167652e737667)](https://codeclimate.com/github/juniorb2ss/zServices/coverage)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/d6c099e27c39e6e91918965d6bcc605f70bd18678986f2b79321a47a4aa0401a/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6a756e696f72623273732f7a53657276696365732f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/juniorb2ss/zServices/?branch=master)

Pacote para buscar informações nos serviços federais e estaduais do Brasil

É feito uma requisição no serviço, retornando `cookie` e `captcha` do serviço. Após usuário informar o captcha é feito outra requisição, retornando informações do CNPJ.

Este pacote deverá ser usado com responsabilidade, o autor e contribuidores não devem responder pelas implementações/ações feita com este pacote.

### Atenção

[](#atenção)

Este pacote foi desenvolvido com o intuito de facilidade consultas através de ERP ou serviços que necessitam de consistência de dados. Não foi criado com o intuito de ser utilizado como `bot`

Toda implementação será de sua responsabilidade.

### Quebra Automática de Captcha

[](#quebra-automática-de-captcha)

Foi desenvolvido um pacote que facilita na resolução automática do captcha, faça o uso de sua responsabilidade.

Este pacote já possui referencia para tal.

Exemplo:

```
use zServices\ReceitaFederal\Search as ReceitaFederal;

$service = (new ReceitaFederal)->service();
$request = $service->request(); // inicia requisição na receita federal

$cookie = $request->cookie();
$captcha = $request->captcha();

$document = '54787138000101' // CNPJ
$decaptcher = (new \Captcha\DeathByCaptcha\Service)->credentials('yourLogin', 'yourPassword');
$service->decaptcher($decaptcher); // Passa o serviço que será usado para quebra do captcha
$array = $search->data($cnpj, $cookie, $captcha, [])->scraping(); // após alguns segundos ele retorna array com as informações da entidade.
```

O pacote por enquanto apenas possui implementação do `DeathByCaptcha`, que é um serviço pago, porém valor muito baixo por pacote de captcha resolvido. Visite o site e adquire um plano.

### Version Stable

[](#version-stable)

1.2.4

### Instalação

[](#instalação)

```
$ composer require zservices/query 1.*
```

### Laravel 5

[](#laravel-5)

Configure os providers e aliases em `config/app.php`

```
'providers' => [
    // ....
      zServices\Laravel\ServicesProvider::class,
    //...
];

'aliases' => [
    //...
    'Sintegra' => zServices\Laravel\SintegraFacade::class,
    'ReceitaFederal' => zServices\Laravel\ReceitaFederalFacade::class,
    //...
];
```

```
use ReceitaFederal;
$service = ReceitaFederal::service()->request();

return view('receitafederal.query.example',[
    'cookie' => $service->cookie(),
    'image'  => $service->captcha()
]);
```

### Exemplos

[](#exemplos)

#### Receita Federal

[](#receita-federal)

```
$rf = receitaFederal(); // retornará um array com cookie e base64 captcha
```

Para requisitar os dados

```
$rf = receitaFederal($cnpj, $cookie, $captcha); // retornará um array com os dados do CNPJ na Receita Federal
```

ou

```
use zServices\ReceitaFederal\Search as ReceitaFederal;
$search = (new ReceitaFederal)->service()->request(); // initialize

$captchaBase64Image = $search->captcha(); // captura base64_decode da imagem
$cookieRequest = $search->cookie(); // captura o cookie do request iniciado
```

Dados após o form

```
// Requisitar dados
use zServices\ReceitaFederal\Search as ReceitaFederal;

$search = (new ReceitaFederal)->service();
$crawler = $search->data($cnpj, $cookie, $captcha, []);
$arrayData = $crawler->scraping(); // array com as informações da entidade
```

Para consultar receita federal basta pegar o cookie e a imagem do captcha, após resolver o captcha é preciso retornar o cookie e a string resolvida para o serviço, ele deverá retornar um array associado com as informações do CNPJ informado.

#### Sintegra SP

[](#sintegra-sp)

Helper

```
$rf = sintegra(); // retornará um array com cookie e base64 captcha
```

Para requisitar os dados

```
$rf = sintegra($cnpj, $cookie, $captcha, $params); // retornará um array com os dados do documento no Sintegra
```

ou

```
use zServices\Sintegra\Search as Sintegra;
$search = (new Sintegra)->service('SP')->request(); // initialize

$captchaBase64Image = $search->captcha(); // captura base64_decode da imagem
$cookieRequest = $search->cookie(); // captura o cookie do request iniciado
$params = $search->params(); // captura o valor dos inputs
$paramBot = $params['parambot']; // captura parambot
```

Dados após o form

```
// Requisitar dados
use zServices\Sintegra\Search as Sintegra;

$search = (new Sintegra)->service('SP');
$crawler = $search->data($cnpj, $cookie, $captcha, $paramBot);
$arrayData = $crawler->scraping(); // array com as informações da entidade
```

O portal do sintega de SP além do captcha possui um valor no formulário com nome de `paramBot`. Este valor é único por requisição, não por cookie. Então para que a requisição funcione corretamente é preciso pegar e devolver ele nas requisições posteriores.

O método `$search->params()` devolve um array com os inputs que são necessários devolver, que no caso do sintegra de sp é apenas `paramBot`. Este valor deverá ser inserido em seu formulário e devolvido como array associado na requisição das informações da entidade.

### Retornos

[](#retornos)

Imagem de exemplo com as informações de retorno do serviço.

#### Receita Federal

[](#receita-federal-1)

[![Retorno](https://camo.githubusercontent.com/50a04fb56500e16b07deb7afceeccb16bfc3809a/687474703a2f2f7333322e706f7374696d672e6f72672f7236306775726467352f53637265656e73686f745f66726f6d5f323031365f30345f32385f31385f34335f31332e706e67)](https://camo.githubusercontent.com/50a04fb56500e16b07deb7afceeccb16bfc3809a/687474703a2f2f7333322e706f7374696d672e6f72672f7236306775726467352f53637265656e73686f745f66726f6d5f323031365f30345f32385f31385f34335f31332e706e67)

#### Sintegra SP

[](#sintegra-sp-1)

[![Retorno](https://camo.githubusercontent.com/2cd83c0fd8ab437ff892f95620aa1b6aef281543413c8f3c074adf011a6949b6/68747470733a2f2f75706c6f61646465696d6167656e732e636f6d2e62722f696d616765732f3030302f3631322f3335302f6f726967696e616c2f53637265656e73686f745f66726f6d5f323031362d30352d30315f31362d35312d35322e706e673f31343632313332333234)](https://camo.githubusercontent.com/2cd83c0fd8ab437ff892f95620aa1b6aef281543413c8f3c074adf011a6949b6/68747470733a2f2f75706c6f61646465696d6167656e732e636f6d2e62722f696d616765732f3030302f3631322f3335302f6f726967696e616c2f53637265656e73686f745f66726f6d5f323031362d30352d30315f31362d35312d35322e706e673f31343632313332333234)

### Desenvolvimento

[](#desenvolvimento)

Deseja contribuir com desenvolvimento? pull request :)

### To-do

[](#to-do)

License
-------

[](#license)

MIT

**Free Software, Hell Yeah!**

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity22

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 62.5% 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 ~31 days

Recently: every ~115 days

Total

16

Last Release

3203d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c688d73edf14d21b284a06a5bf330e130c6063bb7e473f34260069224b22b989?d=identicon)[juniorb2s](/maintainers/juniorb2s)

---

Top Contributors

[![juniorb2ss](https://avatars.githubusercontent.com/u/3980385?v=4)](https://github.com/juniorb2ss "juniorb2ss (10 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (6 commits)")

---

Tags

laraveliecnpjsintegraconsultareceitafederal

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/zservices-query/health.svg)

```
[![Health](https://phpackages.com/badges/zservices-query/health.svg)](https://phpackages.com/packages/zservices-query)
```

###  Alternatives

[barryvdh/laravel-ide-helper

Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.

14.9k123.0M687](/packages/barryvdh-laravel-ide-helper)[laravolt/avatar

Turn name, email, and any other string into initial-based avatar or gravatar.

2.0k5.4M31](/packages/laravolt-avatar)[jansenfelipe/cnpj-gratis

Com esse pacote você poderá consultar, gratuitamente, CNPJs diretamente no site da receita.

17620.9k](/packages/jansenfelipe-cnpj-gratis)[interaction-design-foundation/laravel-geoip

Support for multiple Geographical Location services.

17221.0k3](/packages/interaction-design-foundation-laravel-geoip)[nedwors/navigator

A Laravel package to ease defining navigation menus

433.1k](/packages/nedwors-navigator)[dcblogdev/laravel-junie

Install pre-configured guides for Jetbrains Junie

392.5k](/packages/dcblogdev-laravel-junie)

PHPackages © 2026

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