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

ActiveLibrary

jerfeson/correios
=================

A library that facilitates integration with Brazilian postal services

1.0.0(4y ago)020↓100%MITPHP

Since Sep 18Pushed 4y ago1 watchersCompare

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

READMEChangelog (1)Dependencies (10)Versions (2)Used By (0)

Correios for PHP
================

[](#correios-for-php)

[![build](https://github.com/jerfeson/correios/actions/workflows/build.yml/badge.svg)](https://github.com/jerfeson/correios/actions/workflows/build.yml)[![Latest Version on Packagist](https://camo.githubusercontent.com/5bad334e8b7728a2bf0c86086648be6ee0f756452fefa1e26cef4fbf501a9472/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6a65726665736f6e2f636f727265696f732e737667)](https://img.shields.io/github/v/release/jerfeson/correios)[![Software License](https://camo.githubusercontent.com/074b89bca64d3edc93a1db6c7e3b1636b874540ba91d66367c0e5e354c56d0ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e737667)](LICENSE.md)[![Minimum PHP Version](https://camo.githubusercontent.com/905c670b6e3bc20026bddbc8923df4d38111e526b88f1252ac4ceb6643299d96/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344253230382e302d3838393242462e737667)](https://php.net/)[![GitHub all releases](https://camo.githubusercontent.com/1b52695c2760a0b6f8c5c87346db4a24d715082f6bd76a4e69aa9ebf68bb4cc0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f646f776e6c6f6164732f6a65726665736f6e2f636f727265696f732f746f74616c)](https://camo.githubusercontent.com/1b52695c2760a0b6f8c5c87346db4a24d715082f6bd76a4e69aa9ebf68bb4cc0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f646f776e6c6f6164732f6a65726665736f6e2f636f727265696f732f746f74616c)

This library facilitates the integration with the Correios delivery services of Brazil on php

Functionalities
---------------

[](#functionalities)

- [Consult address by zip code](#find-address)
- [Calculate Prices and Deadlines](#calculate-prices-and-deadlines)

Installation
------------

[](#installation)

- Using composer

```
    $ composer require jerfeson/correios
```

How to use
----------

[](#how-to-use)

### Consult address by zip code

[](#consult-address-by-zip-code)

```
use Jerfeson\Correios;

require 'vendor/autoload.php';

$correios = new Correios();
$repsonse = $correios->address()->find("73100‑020");

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

**/
```

### Calculate Prices and Deadlines

[](#calculate-prices-and-deadlines)

Calculate prices and terms of delivery services (Sedex, PAC and etc), with `support for multiple objects` in the same query.

```
use Jerfeson\Correios;

require 'vendor/autoload.php';

$correios = new Correios();

$response = $correios->freight()
    ->origin('01001-000')
    ->destination('73100‑020')
    ->services(FreightType::SEDEX, FreightType::PAC)
    ->item(16, 16, 16, .3, 1)->calculate();

/** result
[
    0 =>
        [
            'name' => 'Sedex',
            'code' => '4014',
            'price' => 35.1,
            'deadline' => 4,
            'error' => [],
        ],
    1 =>
        [
            'name' => 'PAC',
            'code' => '4510',
            'price' => 24.8,
            'deadline' => 8,
            'error' =>[],
        ],
]
*/
```

How to test
-----------

[](#how-to-test)

```
    $ composer test
```

Roadmap
-------

[](#roadmap)

- CodeCoverage

License
-------

[](#license)

jerfeson/correios is release under the MIT license.

Thanks
------

[](#thanks)

This project is based on the project in flyingluscas/correios-php feel free to contribute to this and the other project.

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

1695d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f318ad28c5ab51c42da3afbfac025a6fbcf5f5d04866fcd533b55e2005f0b267?d=identicon)[jerfeson](/maintainers/jerfeson)

---

Top Contributors

[![jerfeson](https://avatars.githubusercontent.com/u/2961357?v=4)](https://github.com/jerfeson "jerfeson (16 commits)")

---

Tags

correioscepbrazilfreterastreiocalculoRastreamentojerfeson

###  Code Quality

TestsCodeception

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[flyingluscas/correios-php

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

141362.4k3](/packages/flyingluscas-correios-php)[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)[claudsonm/cep-promise-php

Busca por CEP utilizando Promises nos serviços dos Correios, ViaCEP, CepAberto e outros.

3120.0k](/packages/claudsonm-cep-promise-php)[lsnepomuceno/laravel-brazilian-ceps

A package for querying zip codes for Brazilian addresses.

322.4k](/packages/lsnepomuceno-laravel-brazilian-ceps)[adereldo/correios

Consulta de cep,rastreio em site do correios

121.4k](/packages/adereldo-correios)

PHPackages © 2026

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