PHPackages                             flyingluscas/correios-php - 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. flyingluscas/correios-php

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

flyingluscas/correios-php
=========================

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

v2.4.0(5y ago)141362.4k↓13.4%44[4 issues](https://github.com/flyingluscas/correios-php/issues)[1 PRs](https://github.com/flyingluscas/correios-php/pulls)3MITPHPPHP ~5.6|~7.0CI failing

Since Nov 15Pushed 4y ago8 watchersCompare

[ Source](https://github.com/flyingluscas/correios-php)[ Packagist](https://packagist.org/packages/flyingluscas/correios-php)[ Docs](https://github.com/flyingluscas/correios-php)[ RSS](/packages/flyingluscas-correios-php/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (3)Versions (14)Used By (3)

Correios PHP SDK
================

[](#correios-php-sdk)

[![Latest Version on Packagist](https://camo.githubusercontent.com/944ac21288aeb3602f4fc71cd915e05d33af5d461acccbf87ce956d6c0f49aa8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f666c79696e676c75736361732f636f727265696f732d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/flyingluscas/correios-php)[![CircleCI](https://camo.githubusercontent.com/1cd7ea1ed00bd53fbfc3066aaa978723b2282df7f17869330705649994367cc4/68747470733a2f2f696d672e736869656c64732e696f2f636972636c6563692f70726f6a6563742f6769746875622f666c79696e676c75736361732f636f727265696f732d7068702e7376673f7374796c653d666c61742d737175617265)](https://circleci.com/gh/flyingluscas/correios-php)[![Codecov](https://camo.githubusercontent.com/8c74722978f6cdd63c6d679b1825c995cdd8de047893a092c7bfbd26b376a349/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f6769746875622f666c79696e676c75736361732f636f727265696f732d7068702e7376673f7374796c653d666c61742d737175617265)](https://codecov.io/gh/flyingluscas/correios-php)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Total Downloads](https://camo.githubusercontent.com/ea6984b66398efa178a5fa2bf1d8f1daa620f6cdc395d3de62fea84043de89a2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f666c79696e676c75736361732f636f727265696f732d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/flyingluscas/correios-php)

Uma maneira fácil de interagir com as principais funcionalidades dos [Correios](https://correios.com.br).

Funcionalidades
---------------

[](#funcionalidades)

- [Consultar CEP](#consultar-cep)
- [Calcular Preços e Prazos](#calcular-pre%C3%A7os-e-prazos)

Instalação
----------

[](#instalação)

Via Composer

```
$ composer require flyingluscas/correios-php
```

Uso
---

[](#uso)

### Consultar CEP

[](#consultar-cep)

Encontrar endereço pelo CEP consultando diretamente o [WebService](https://apps.correios.com.br/SigepMasterJPA/AtendeClienteService/AtendeCliente?wsdl) dos Correios.

```
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)

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

```
use FlyingLuscas\Correios\Client;
use FlyingLuscas\Correios\Service;

require 'vendor/autoload.php';

$correios = new Client;

$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();

/*

Resultados:

[
    [
        'name' => 'Sedex',
        'code' => 40010,
        'price' => 51,
        'deadline' => 4,
        'error' => [],
    ],
    [
        'name' => 'PAC',
        'code' => 41106,
        'price' => 22.5,
        'deadline' => 9,
        'error' => [],
    ],
]
*/
```

Change log
----------

[](#change-log)

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

Testando
--------

[](#testando)

```
$ composer test
```

Contribuindo
------------

[](#contribuindo)

Consulte [CONTRIBUTING](.github/CONTRIBUTING.md) para obter mais detalhes.

Segurança
---------

[](#segurança)

Se você descobrir quaisquer problemas relacionados à segurança, envie um e-mail para  em vez de usar as issues.

Créditos
--------

[](#créditos)

- [Lucas Pires](https://github.com/flyingluscas)
- [Todos os contribuidores](../../contributors)

Licença
-------

[](#licença)

A Licença MIT (MIT). Consulte o [arquivo de licença](LICENSE.md) para obter mais informações.

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity52

Moderate usage in the ecosystem

Community26

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 95.1% 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 ~131 days

Recently: every ~318 days

Total

12

Last Release

2025d ago

Major Versions

v0.1.1 → v1.1.12016-11-23

v1.1.1 → v2.0.02017-04-06

### Community

Maintainers

![](https://www.gravatar.com/avatar/8ba942efed17b9d3243112edc08235c3cd082729ab59397e6f9b12acd126f204?d=identicon)[flyingluscas](/maintainers/flyingluscas)

---

Top Contributors

[![flyingluscas](https://avatars.githubusercontent.com/u/6232791?v=4)](https://github.com/flyingluscas "flyingluscas (174 commits)")[![victorperin](https://avatars.githubusercontent.com/u/5847145?v=4)](https://github.com/victorperin "victorperin (6 commits)")[![julianobailao](https://avatars.githubusercontent.com/u/1957944?v=4)](https://github.com/julianobailao "julianobailao (1 commits)")[![lucascolette](https://avatars.githubusercontent.com/u/829381?v=4)](https://github.com/lucascolette "lucascolette (1 commits)")[![mklemersson](https://avatars.githubusercontent.com/u/4018735?v=4)](https://github.com/mklemersson "mklemersson (1 commits)")

---

Tags

calculocepcorreiosfretephprastreiocorreioscepfreterastreioflyingluscascorreios-phpcalculo

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/flyingluscas-correios-php/health.svg)

```
[![Health](https://phpackages.com/badges/flyingluscas-correios-php/health.svg)](https://phpackages.com/packages/flyingluscas-correios-php)
```

###  Alternatives

[cagartner/correios-consulta

Package para pesquisa de serviços de busca por cep, calculo de frete e etc, diretamente nos serviços dos Correios.

159301.8k](/packages/cagartner-correios-consulta)[flyingluscas/viacep-php

ViaCEP PHP SDK

3640.2k](/packages/flyingluscas-viacep-php)[jansenfelipe/cep-gratis

Com esse pacote você poderá realizar consultas de CEP gratuitamente.

689.4k](/packages/jansenfelipe-cep-gratis)[adereldo/correios

Consulta de cep,rastreio em site do correios

121.4k](/packages/adereldo-correios)[bubbstore/correios

Biblioteca que faz cálculo de frete, rastreamento de objetos e consulta de CEP diretamente do Webservice dos Correios.

2589.0k](/packages/bubbstore-correios)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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