PHPackages                             betalabs/php-sigep - 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. [HTTP &amp; Networking](/categories/http)
4. /
5. betalabs/php-sigep

ActiveLibrary[HTTP &amp; Networking](/categories/http)

betalabs/php-sigep
==================

Integração com Web Service do Correios. Gera etiquetas, consulta preços e prazos, imprime etiquetas e PLP, etc.

0.0.5(7y ago)0483↓100%MITPHPPHP &gt;=5.4

Since Mar 30Pushed 1y ago5 watchersCompare

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

READMEChangelog (6)Dependencies (1)Versions (3)Used By (0)

### Ajude o projeto a crescer. Envie pull request de suas alterações no código fonte ou na documentação do projeto.

[](#ajude-o-projeto-a-crescer-envie-pull-request-de-suas-alterações-no-código-fonte-ou-na-documentação-do-projeto)

PHP SIGEP - Correios
====================

[](#php-sigep---correios)

- Baixe a última versão estável aqui:

Implementação do Web Service dos correios SIGEP Web.

### [Veja a demo online, exemplos e documentação em nossa página](https://phpsigep.stavarengo.me/).

[](#veja-a-demo-online-exemplos-e-documentação-em-nossa-página)

Integração com Web Service do Correios. Consulta preços e prazos, imprime etiquetas e PLP, etc. Esta API pode:

- Calcular preços e prazos de entrega da encomenda.
- Obter os dados de rastreamento das encomendas.
- Verificar se um tipo de serviço (Sedex, PAC, ...) é permitido entre dois endereços.
- Gerar e enviar o XML da pre-lista de postagem (PLP) para o Correios.
- Gerar novos números de etiquetas de postagem.
- Criar e/ou verificar validade do dígito verificador das etiquetas (através do web service ou não).
- Gerar o relatório da PLP no formato PDF.
- Gerar as etiquetas de postagem no formato PDF.
- Gerar em PDF as chancelas para cada tipo de serviço (logo de cada tipo de servico).
- Obter dados de PLP após postagem \[processamento pelo Sara\]
- \[Novo\] Suspender a entrega de postagem (Também chamado de Entrega Interativa)
- \[Novo\] Listagem de Agências (Necessário para o Clique e Retire)
- \[Novo\] Gerar as etiquetas de postagem no formato PDF para o Clique e Retire.

Requisitos
----------

[](#requisitos)

- PHP &gt;= 5.4.0
- Se você precisar imprimir as etiquetas e relatórios, baixe também o FPDF 1.7 [www.fpdf.org](http://www.fpdf.org/).
    Não esqueça de configurar o FPDF para ser auto carregado antes de tentar imprimir os relatórios.

Instalação com Composer (recomendado)
-------------------------------------

[](#instalação-com-composer-recomendado)

- Nós não controlamos versão através das tags, porem, a branch master só é atualizada quando o código está estável. Portanto, a versão estável mais atual sempre será a branch master.

Adicione as seguintes linha ao seu arquivo `composer.json`: "stavarengo/php-sigep": "dev-master"
"stavarengo/php-sigep-fpdf": "dev-master"

E então execute `composer update` via linha de comando.

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

[](#instalação-manual)

- Nós não controlamos versão através das tags, porem, a branch master só é atualizada quando o código está estável. Portanto, a versão estável mais atual sempre será a branch master.
- Faça o download da última versão.
- Para usar as classe do php-sigep, você só precisa carregar o arquivo "php-sigep/src/PhpSigep/Bootstrap.php". Isso fara com que o loader seja registrado.

Problemas Comuns
================

[](#problemas-comuns)

Autorização de acesso negada para o sistema
-------------------------------------------

[](#autorização-de-acesso-negada-para-o-sistema)

Antes de utilizar este projeto em modo produção, é necessário solicitar ao representante comercial dos correios habilitação e senha para o webservice dos correios.

Estou tendo problema ao utilizar o ambiente de homologação
----------------------------------------------------------

[](#estou-tendo-problema-ao-utilizar-o-ambiente-de-homologação)

Se você está recebendo a mensagem abaixo ao tentar utilizar o ambiente de homologação, significa que o webservice do correio está temporariamente indisponível. Não adianta criar *issue*, o melhor a fazer é aguardar ou tentar entrar em contato com o suporte técnico do correio.

**Mensagem de erro**: Parsing WSDL: Couldn't load from '' : failed to load external entity "

Problemas com o PHP 5.3
-----------------------

[](#problemas-com-o-php-53)

Este problema foi reportado aqui: [stavarengo#35](https://github.com/stavarengo/php-sigep/issues/35)Alguns usuarios tiveram problemas de conexão e autentificação com WebService do Correios em ambiente de produção devido a versão do PHP. Para resolver o problema, você pode ou utilizar uma versão masi rescente do PHP (&gt;=5.4) ou fazer o download do WSDL do Correios e utilizar ele no seu servidor para fazer conexão. Caso escolha fazer o download o WSDL, siga os passos abaixo:

1. Salve este arquivo em seu ambiente local
2. Altere as configurações do seu ambiente de produção para apotar para o arquivo que você baixou. Vejo exemplo abaixo.

```
$config = new \PhpSigep\Config();
$config->setEnv(\PhpSigep\Config::ENV_PRODUCTION);
$config->setWsdlAtendeCliente('CAMINHO-DO-SEU-ARQUIVO-LOCAL');
\PhpSigep\Bootstrap::start($config);
```

OBS: Não irá funcionar em um servidor local, como Wamp, Xammp entre outros.

Funções
-------

[](#funções)

Cache
-----

[](#cache)

O componente de cache do PhpSigep foi inspirado no [componente de cache do Zend Framework](http://framework.zend.com/manual/2.3/en/index.html#zend-cache).

Por padrão o cache do PhpSigep está desabilitado.
Este cache armazena algumas respostadas do WebService dos correios que podem ser reutilizadas posteriomente. Alem de aumentar a velocidade de respostas das requisições, também evitamos que os usuários fiquem impedidos de continuar mesmo quando o servidor do Correios esteja instavel (acredite: ele fica instável com muita frequencia).

Para habilitar o cache, use a chave "cacheOptions" ao criar a configuração do PhpSigep. Ex: `php new \PhpSigep\Config( array( 'cacheOptions' => array( 'storageOptions' => array( 'enabled' => true, 'ttl' => 60*60*24*7,// Uma semana ), ), ... ), ); `Dentro do `array` `storageOptions` você pode usar o nome de qualquer atributo da classe `PhpSigep\Cache\Storage\Adapter\AdapterOptions`.

Contribua
---------

[](#contribua)

Para executar a testsuite, execute `./vendor/bin/phpunit` via linha de comando.

1. Faça um fork
2. Crie sua branch para a funcionalidade (`git checkout -b nova-funcionalidade`)
3. Faça o commit suas modificações (`git commit -am 'Adiciona nova funcionalidade'`)
4. Faça o push para a branch (`git push origin nova-funcionalidade`)
5. Crie um novo Pull Request

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance30

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~433 days

Total

2

Last Release

2892d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5718a3a2c41de555560fde3279aaf122ce1584540c5f123e7661eaa3d79dba73?d=identicon)[diego-betalabs](/maintainers/diego-betalabs)

---

Top Contributors

[![stavarengo](https://avatars.githubusercontent.com/u/816369?v=4)](https://github.com/stavarengo "stavarengo (173 commits)")[![andersonls](https://avatars.githubusercontent.com/u/1561038?v=4)](https://github.com/andersonls "andersonls (38 commits)")[![marcelobetalabs](https://avatars.githubusercontent.com/u/2293700?v=4)](https://github.com/marcelobetalabs "marcelobetalabs (29 commits)")[![davidalves1](https://avatars.githubusercontent.com/u/12610236?v=4)](https://github.com/davidalves1 "davidalves1 (19 commits)")[![avlima](https://avatars.githubusercontent.com/u/13434925?v=4)](https://github.com/avlima "avlima (16 commits)")[![gustvao](https://avatars.githubusercontent.com/u/5428331?v=4)](https://github.com/gustvao "gustvao (15 commits)")[![crisnao2](https://avatars.githubusercontent.com/u/1977582?v=4)](https://github.com/crisnao2 "crisnao2 (11 commits)")[![alyssonajackson](https://avatars.githubusercontent.com/u/1284723?v=4)](https://github.com/alyssonajackson "alyssonajackson (9 commits)")[![jonyw4](https://avatars.githubusercontent.com/u/14056669?v=4)](https://github.com/jonyw4 "jonyw4 (9 commits)")[![willian-rosa](https://avatars.githubusercontent.com/u/17603785?v=4)](https://github.com/willian-rosa "willian-rosa (8 commits)")[![mauroagr](https://avatars.githubusercontent.com/u/5348884?v=4)](https://github.com/mauroagr "mauroagr (8 commits)")[![daviddgm](https://avatars.githubusercontent.com/u/3376402?v=4)](https://github.com/daviddgm "daviddgm (7 commits)")[![rblaurin](https://avatars.githubusercontent.com/u/19739263?v=4)](https://github.com/rblaurin "rblaurin (7 commits)")[![rafaelsiqueira](https://avatars.githubusercontent.com/u/1132274?v=4)](https://github.com/rafaelsiqueira "rafaelsiqueira (7 commits)")[![endel](https://avatars.githubusercontent.com/u/130494?v=4)](https://github.com/endel "endel (6 commits)")[![NewtonMan](https://avatars.githubusercontent.com/u/4259752?v=4)](https://github.com/NewtonMan "NewtonMan (5 commits)")[![RenanZanelato](https://avatars.githubusercontent.com/u/8648679?v=4)](https://github.com/RenanZanelato "RenanZanelato (5 commits)")[![lhpalacio](https://avatars.githubusercontent.com/u/2530250?v=4)](https://github.com/lhpalacio "lhpalacio (5 commits)")[![JessileyOliveira](https://avatars.githubusercontent.com/u/8670353?v=4)](https://github.com/JessileyOliveira "JessileyOliveira (4 commits)")[![rasnwebdev](https://avatars.githubusercontent.com/u/27329275?v=4)](https://github.com/rasnwebdev "rasnwebdev (4 commits)")

---

Tags

correiossigep

### Embed Badge

![Health badge](/badges/betalabs-php-sigep/health.svg)

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

###  Alternatives

[stavarengo/php-sigep

Integração com Web Service do Correios. Gera etiquetas, consulta preços e prazos, imprime etiquetas e PLP, etc.

364315.8k2](/packages/stavarengo-php-sigep)

PHPackages © 2026

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