flyingluscas/correios-php

Uma maneira fácil de interagir com as principais funcionalidades dos Correios.

Correios PHP SDK

![CircleCI][icon-circleci] ![Software License][ico-license] , _(*1)

Uma maneira fácil de interagir com as principais funcionalidades dos Correios., _(*2)

Funcionalidades

• Consultar CEP
• Calcular Preços e Prazos

Instalação

Via Composer, _(*3)

``` bash $ composer require flyingluscas/correios-php, <sub>(*4)</sub>

## Uso

### Consultar CEP

Encontrar endereço pelo CEP consultando diretamente o [WebService][correios-sigep] dos Correios.

``` php
use FlyingLuscas\Correios\Client;

require 'vendor/autoload.php';

$correios = new Client;

$correios->zipcode()
    ->find('01001-000');

/*

Resultado:

[
    'zipcode' => '01001-000',
    'street' => 'Praça da Sé',
    'complement' => [
        'lado ímpar',
    ],
    'district' => 'Sé',
    'city' => 'São Paulo',
    'uf' => 'SP',
]
*/

Calcular Preços e Prazos

Calcular preços e prazos de serviços de entrega (Sedex, PAC e etc), com suporte a multiplos objetos na mesma consulta., <sub>(*5)</sub>

``` php use FlyingLuscas\Correios\Client; use FlyingLuscas\Correios\Service;, <sub>(*6)</sub>

require 'vendor/autoload.php';, <sub>(*7)</sub>

$correios = new Client;, <sub>(*8)</sub>

$correios->freight() ->origin('01001-000') ->destination('87047-230') ->services(Service::SEDEX, Service::PAC) ->item(16, 16, 16, .3, 1) // largura, altura, comprimento, peso e quantidade ->item(16, 16, 16, .3, 3) // largura, altura, comprimento, peso e quantidade ->item(16, 16, 16, .3, 2) // largura, altura, comprimento, peso e quantidade ->calculate();, <sub>(*9)</sub>

/*, <sub>(*10)</sub>

Resultados:, <sub>(*11)</sub>

[ [ 'name' => 'Sedex', 'code' => 40010, 'price' => 51, 'deadline' => 4, 'error' => [], ], [ 'name' => 'PAC', 'code' => 41106, 'price' => 22.5, 'deadline' => 9, 'error' => [], ], ] */, <sub>(*12)</sub>

## Change log

Consulte [CHANGELOG](.github/CHANGELOG.md) para obter mais informações sobre o que mudou recentemente.

## Testando

``` bash
$ composer test

Contribuindo

Consulte CONTRIBUTING para obter mais detalhes., <sub>(*13)</sub>

Segurança

Se você descobrir quaisquer problemas relacionados à segurança, envie um e-mail para lucas.pires.mattos@gmail.com em vez de usar as issues., <sub>(*14)</sub>

Créditos

• Lucas Pires
• Todos os contribuidores

Licença

A Licença MIT (MIT). Consulte o arquivo de licença para obter mais informações., <sub>(*15)</sub>