PHPackages                             andrebian/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. [API Development](/categories/api)
4. /
5. andrebian/correios-php

ActiveLibrary[API Development](/categories/api)

andrebian/correios-php
======================

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

0231PHP

Since May 12Pushed 3y agoCompare

[ Source](https://github.com/andrebian/correios-php)[ Packagist](https://packagist.org/packages/andrebian/correios-php)[ RSS](/packages/andrebian-correios-php/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependenciesVersions (1)Used By (0)

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

17

—

LowBetter than 6% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity22

Early-stage or recently created project

 Bus Factor1

Top contributor holds 94.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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/97df5e6c6aeda1550e75a26b9614532cb5304961dea595f1aa1e4328a7d7cdff?d=identicon)[andrebian](/maintainers/andrebian)

---

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)")[![andrebian](https://avatars.githubusercontent.com/u/2091739?v=4)](https://github.com/andrebian "andrebian (2 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)")

### Embed Badge

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

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

###  Alternatives

[exsyst/swagger

A php library to manipulate Swagger specifications

35816.3M7](/packages/exsyst-swagger)[hubspot/api-client

Hubspot API client

24015.5M18](/packages/hubspot-api-client)[pocketmine/bedrock-protocol

An implementation of the Minecraft: Bedrock Edition protocol in PHP

172437.8k11](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram

Telegram driver for BotMan

93452.6k6](/packages/botman-driver-telegram)

PHPackages © 2026

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