cagartner / correios-consulta
Package para pesquisa de serviços de busca por cep, calculo de frete e etc, diretamente nos serviços dos Correios.
Installs: 292 590
Dependents: 0
Suggesters: 0
Security: 0
Stars: 154
Watchers: 17
Forks: 75
Open Issues: 10
Requires
- php: >=7.3.0
- cagartner/phpquery: 0.9.12
README
Package para consulta de serviços diretamente no site dos correios, sem usar apis de terceiros.
Baseado nos seguintes repositórios:
Requerimentos:
- Soap Client
Para linux: sudo apt-get install php-soap
Consultas disponíveis:
- CEP
- Frete
- Rastreio
Instalação
Para PHP 7.4 usar:
"cagartner/correios-consulta": "0.3.*"
Para PHP 7.3 + usar:
"cagartner/correios-consulta": "0.2.*"
Para PHP 7/5.x usar:
In the require
key of composer.json
file add the following
"cagartner/correios-consulta": "0.1.*"
Run the Composer update comand
$ composer update
In your config/app.php
add 'Cagartner\CorreiosConsulta\ServiceProvider'
to the end of the $providers
array
'providers' => [ 'Illuminate\Foundation\Providers\ArtisanServiceProvider', 'Illuminate\Auth\AuthServiceProvider', // ... 'Cagartner\CorreiosConsulta\ServiceProvider', ],
Then at the end of config/app.php
add 'Correios' => 'Cagartner\CorreiosConsulta\Facade'
to the $aliases
array
'aliases' => [ 'App' => 'Illuminate\Support\Facades\App', 'Artisan' => 'Illuminate\Support\Facades\Artisan', // ... 'Correios' => 'Cagartner\CorreiosConsulta\Facade', ],
Utilização
CEP:
Passar apenas o valor do CEP, pode ser formatado, somente números e como string.
<?php echo Correios::cep('89062086'); /* Retorno: Array ( [cliente] => [logradouro] => Rua Lindolfo Kuhnen [bairro] => Itoupava Central [cep] => 89062086 [cidade] => Blumenau [uf] => SC ) */
Rastrear
Passar o código de rastreio informado pelos Correios
<?php echo Correios::rastrear('PI464134876BR'); /* Retorno: Array ( [0] => Array ( [data] => 08/06/2015 14:47 [local] => CDD CARAGUATATUBA - Caraguatatuba/SP [status] => Entrega Efetuada ) [1] => Array ( [data] => 08/06/2015 07:59 [local] => Caraguatatuba/SP [status] => Saiu para entrega ao destinat�rio ) [2] => Array ( [data] => 03/06/2015 11:48 [local] => CTE SAO JOSE DOS CAMPOS - Sao Jose Dos Campos/SP [status] => Encaminhado [encaminhado] => Em tr�nsito para CDD CARAGUATATUBA - Caraguatatuba/SP ) [3] => Array ( [data] => 02/06/2015 10:00 [local] => AGF DOUTOR JOAO MENDES - Sao Paulo/SP [status] => Encaminhado [encaminhado] => Em tr�nsito para CTE VILA MARIA - Sao Paulo/SP ) [4] => Array ( [data] => 01/06/2015 14:56 [local] => AGF DOUTOR JOAO MENDES - Sao Paulo/SP [status] => Postado ) ) */
Cálculo de Frete:
<?php $dados = [ 'tipo' => 'sedex', // Separar opções por vírgula (,) caso queira consultar mais de um (1) serviço. > Opções: `sedex`, `sedex_a_cobrar`, `sedex_10`, `sedex_hoje`, `pac`, 'pac_contrato', 'sedex_contrato' , 'esedex' 'formato' => 'caixa', // opções: `caixa`, `rolo`, `envelope` 'cep_destino' => '89062086', // Obrigatório 'cep_origem' => '89062080', // Obrigatorio //'empresa' => '', // Código da empresa junto aos correios, não obrigatório. //'senha' => '', // Senha da empresa junto aos correios, não obrigatório. 'peso' => '1', // Peso em kilos 'comprimento' => '16', // Em centímetros 'altura' => '11', // Em centímetros 'largura' => '11', // Em centímetros 'diametro' => '0', // Em centímetros, no caso de rolo // 'mao_propria' => '1', // Náo obrigatórios // 'valor_declarado' => '1', // Náo obrigatórios // 'aviso_recebimento' => '1', // Náo obrigatórios ]; echo Correios::frete($dados); /* Retorno para uma única consulta: Array ( [codigo] => 40010 [valor] => 14.9 [prazo] => 1 [mao_propria] => 0 [aviso_recebimento] => 0 [valor_declarado] => 0 [entrega_domiciliar] => 1 [entrega_sabado] => 1 [erro] => Array ( [codigo] => 0 [mensagem] => ) ) */ /* Retorno para várias consultas: Array ( 0 => Array ( [codigo] => 4510 [valor] => 14.9 [prazo] => 1 [mao_propria] => 0 [aviso_recebimento] => 0 [valor_declarado] => 0 [entrega_domiciliar] => 1 [entrega_sabado] => 1 [erro] => Array ( [codigo] => 0 [mensagem] => ) ), 1 => Array ( [codigo] => 4014 [valor] => 14.9 [prazo] => 1 [mao_propria] => 0 [aviso_recebimento] => 0 [valor_declarado] => 0 [entrega_domiciliar] => 1 [entrega_sabado] => 1 [erro] => Array ( [codigo] => 0 [mensagem] => ) ) ) */