chico-rei/correios-php

correios-php

1.0.0 2026-06-15 23:57 UTC

Requires

• php: >=8.2
• ext-json: *
• guzzlehttp/guzzle: ^6.0||^7.0
• nesbot/carbon: ^2.0||^3.0
• psr/simple-cache: ^2.0||^3.0

Requires (Dev)

• php-coveralls/php-coveralls: ^2.7
• phpunit/phpunit: ^11.5
• squizlabs/php_codesniffer: ^3.11

MIT

• Chico Rei

• correios api
• Correios Web Service

README

This is a PHP client wrapper for Correios Web Service.

Install

Via Composer

$ composer require chico-rei/correios-php "dev-master"

Requires PHP 8.2 or newer.

Features

• Token
  • POST /v1/autentica getClient()->getToken()
  • POST /v1/autentica/contrato getClient()->getToken()
  • POST /v1/autentica/cartaopostagem getClient()->getToken()
• CEP
  • GET /v2/enderecos/{cep} cepHandler()->get()
  • ...
• Pré-Postagem
  • GET /v2/prepostagens prePostagemHandler()->query()
  • GET /v1/prepostagens/postada prePostagemHandler()->getPosted()
  • POST /v1/prepostagens prePostagemHandler()->create()
  • DELETE /v1/prepostagens/objeto/{codigoObjeto} prePostagemHandler()->deleteByCode()
  • ...
• ...

Usage

use \ChicoRei\Packages\Correios\Correios;
use \ChicoRei\Packages\Correios\Account;

try {
    $correios = new Correios(
        Account::create([
            'username' => '',
            'password' => '',
            'contract' => '',
            'postcard' => '',
        ])
    );

    $response = $correios->cepHandler()->get('36033-007');
    
    echo $response->getLogradouro() . PHP_EOL;
    echo $response->getUf() . PHP_EOL;
} catch (Exception $e) {
    echo 'Code: ' . $e->getCode() . PHP_EOL;
    echo 'Message: ' . $e->getMessage() . PHP_EOL;
}

See examples for more.

Testing

$ composer test

License

The MIT License (MIT). Please see License File for more information.