PHPackages                             sprained/calculo-frete - 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 &amp; Helpers](/categories/utility)
4. /
5. sprained/calculo-frete

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

sprained/calculo-frete
======================

1.1.0(5y ago)615MITPHPCI failing

Since Feb 8Pushed 4y ago1 watchersCompare

[ Source](https://github.com/Sprained/calculo-frete)[ Packagist](https://packagist.org/packages/sprained/calculo-frete)[ RSS](/packages/sprained-calculo-frete/feed)WikiDiscussions main Synced today

READMEChangelog (2)Dependencies (2)Versions (3)Used By (0)

Calculo Frete Correios PHP
==========================

[](#calculo-frete-correios-php)

[![Latest Version on Packagist](https://camo.githubusercontent.com/7b456060d7369345381a6b4b051cb813a6ae33e223f035c4cd3e2b5abe7c291d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73707261696e65642f63616c63756c6f2d66726574652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sprained/calculo-frete)[![Total Downloads](https://camo.githubusercontent.com/5c042961a6e37f7b47d8f09a4ab356173c407319ba81bd5179b2b304534a7f7b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73707261696e65642f63616c63756c6f2d66726574652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sprained/calculo-frete)

Biblioteca para a facilitação do cálculo de preços e prazos de entregas, usando a API disponibilizada pelos Correios. E realização de consultas de endereços por CEP, através do VIACEP.

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

[](#funcionalidades)

- [CEP](#consulta-pelo-cep)
- [Frete](#calculo-frete)
- [Rastreio de encomenda](#rastreio-de-encomenda)

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

[](#instalação)

Via Composer

```
$ composer require sprained/calculo-frete
```

Uso
---

[](#uso)

### Consulta pelo CEP

[](#consulta-pelo-cep)

Encontra endereço pelo CEP, consultando diretamente no VIACEP;

```
require 'vendor/autoload.php';

use Sprained\Correios\Cep;

$cep = new Cep();

/*
    Retorna endereço pelo CEP
    Parâmetro: CEP com hífen ou sem o mesmo
*/
$retorno = $cep->cep('51021-020');

/*
stdClass Object
(
    [cep] => 51021-020
    [logradouro] => Avenida Conselheiro Aguiar
    [complemento] => de 3812/3813 ao fim
    [bairro] => Boa Viagem
    [localidade] => Recife
    [uf] => PE
    [ibge] => 2611606
    [gia] =>
    [ddd] => 81
    [siafi] => 2531
)
*/
```

### Calculo frete

[](#calculo-frete)

Calcula o prazo e preço da entrega por meio da API disponibilizada pelos Correio.

```
require 'vendor/autoload.php';

use Sprained\Correios\Frete;
use Sprained\Correios\Service;

$frete = new Frete();

/*
    Array de itens para cálculo do frete
    Parâmetros em ordem:
    largura, altura, comprimento, peso, quantidade (caso conter mais de um item)
*/
$items = [
    [16, 16, 16, 16],
    [16, 16, 16, 16]
];

/*
    Cálculo frete e prazo para entrega

    Campos Obrigatórios
    origem: cep de origem da encomenda
    destino: cep de destino para entrega da encomenda
    items: array de itens a enviar
    servico: tipo do serviço utilizado para entrega dos itens
    calculo: faz o cálculo e retorna o valor

    Campos Não Obrigatórios
    pacote: informa tipo de pacote (caixa, prisma, envelope), por padrão se encontra em caixa
    entregaEmMaos: informa que a encomenda será entregue com serviço mão propria
    valorDeclarado: informa que encomenda será entregue com serviço valor declarado
    credenciais: código administrativo junto à ECT, disponivel no corpo do contrato do Correios

    Serviços de Entregas
    Service::PAC
    Service::SEDEX
    Service::SEDEX_10
    Service::SEDEX_12
    Service::SEDEX_HOJE
    Para serviços de entregas adicionais, passar numeração do serviço informado no contrato com correios
*/
$retorno = $frete->origem('51021020')
                ->destino('50060230')
                ->servico(Service::SEDEX, Service::PAC)
                ->items($items)
                ->calculo();

/*
Array
(
    [0] => Array
        (
            [codigo] => 4
            [valor] => 169,30
            [prazo] => 1 Dias
        )

    [1] => Array
        (
            [codigo] => 4
            [valor] => 151,70
            [prazo] => 5 Dias
        )
)
*/
```

### Rastreio de encomenda

[](#rastreio-de-encomenda)

Rastreia a encomenda retornando as informações de rastreio.

```
require 'vendor/autoload.php';

use Sprained\Correios\Tracking;
use Sprained\Correios\Exceptions\TrackingException;

try {
    $track = new Tracking();

    print_r($track->tracking('LB208326091SG'));
} catch(TrackingException $e) {
    http_response_code($e->getCode());
    echo $e->getMessage();
}

/*
{
    "code": "LB208326091SG",
    "last_status": "Objeto em trânsito - por favor aguarde",
    "last_date": "03/02/2021 14:49",
    "last_locale": "CTCE FORTALEZA - Fortaleza / CE",
    "tracking": [
        {
        "status": "Objeto em trânsito - por favor aguarde",
        "date": "03/02/2021 14:49",
        "local": "CTCE FORTALEZA - Fortaleza / CE",
        "destino": "CTE RECIFE - Recife / PE"
        },
        {
        "status": "Objeto em trânsito - por favor aguarde",
        "date": "29/01/2021 14:26",
        "local": "UNIDADE INTERNACIONAL CURITIBA - Curitiba / PR",
        "destino": "CTE CAJAMAR - Cajamar / SP"
        },
        {
        "status": "Fiscalização aduaneira finalizada",
        "date": "29/01/2021 14:24",
        "local": "UNIDADE INTERNACIONAL CURITIBA - Curitiba / PR"
        },
        {
        "status": "Objeto recebido pelos Correios do Brasil",
        "date": "29/01/2021 10:44",
        "local": "UNIDADE INTERNACIONAL CURITIBA - Curitiba / PR"
        },
        {
        "status": "Objeto em trânsito - por favor aguarde",
        "date": "09/01/2021 11:47",
        "local": "CINGAPURA -  /",
        "destino": "Unidade de Tratamento Internacional -  / BR"
        }
    ]
}
*/
```

Créditos
--------

[](#créditos)

- [Gabriel Resende](https://github.com/sprained)
- [Vitoria Camila](https://github.com/itsvickie)

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity54

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

Every ~1 days

Total

2

Last Release

1914d ago

### Community

Maintainers

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

---

Top Contributors

[![Sprained](https://avatars.githubusercontent.com/u/22457076?v=4)](https://github.com/Sprained "Sprained (10 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/sprained-calculo-frete/health.svg)

```
[![Health](https://phpackages.com/badges/sprained-calculo-frete/health.svg)](https://phpackages.com/packages/sprained-calculo-frete)
```

###  Alternatives

[magequest/magento2-module-lite-youtube

A Magento 2 module that adds Paul Irish's Lite YouTube implementation support.

4059.9k](/packages/magequest-magento2-module-lite-youtube)

PHPackages © 2026

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