CorreiosConsulta (Laravel 4/5 Package)
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] =>
)
)
)
*/