Download the PHP package lucasbrito-wdt/correios without Composer
On this page you can find all versions of the php package lucasbrito-wdt/correios. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Table of contents
Download lucasbrito-wdt/correios
More information about lucasbrito-wdt/correios
Files in lucasbrito-wdt/correios
Download lucasbrito-wdt/correios
More information about lucasbrito-wdt/correios
Files in lucasbrito-wdt/correios
Vendor lucasbrito-wdt
Package correios
Short Description Pacote Laravel para integração com as APIs do CWS (Correios Web Services) — Token, CEP, Preço, Prazo, Rastro e Pré-Postagem.
License MIT
Package correios
Short Description Pacote Laravel para integração com as APIs do CWS (Correios Web Services) — Token, CEP, Preço, Prazo, Rastro e Pré-Postagem.
License MIT
Please rate this library. Is it a good library?
Informations about the package correios
Laravel Correios — Pacote de integração com o CWS
Pacote Laravel para integrar com as APIs do CWS (Correios Web Services): Token, CEP, Preço, Prazo, Rastro e Pré-Postagem.
Arquitetura limpa com classe abstrata base, services especializados, DTOs, Form Requests para validação, token JWT cacheado no Redis e retry automático em 401.
Requisitos
- PHP 8.2+
- Laravel 11 ou 12
- Contrato ativo com os Correios + cartão de postagem
- Credenciais geradas no portal
cws.correios.com.br
Instalação
Publique a config:
Configuração
Adicione no .env:
Estrutura do pacote
Fluxo de autenticação (resumo)
TokenManagercheca o Redis pela chavecorreios:token- Se não existir, faz
POST /token/v1/autentica/cartaopostagemcom Basic Auth - Cacheia o JWT por 23h (1h de margem antes do vencimento real de 24h)
- Toda chamada subsequente injeta
Authorization: Bearer {jwt}automaticamente - Se algum endpoint devolver
401, o cache é invalidado e o token regenerado em retry
Como usar
Via Facade
Via injeção de dependência (recomendado)
Cotação em lote (até 100)
Pré-Postagem (gerar etiqueta)
Pontos de extensão
Criando um service novo
Estenda AbstractCorreiosService:
Registre no seu AppServiceProvider:
Pronto — autenticação, retry, logging e tratamento de erros já vêm de graça.
Testes
Use Http::fake() pra simular as respostas do CWS.
Boas práticas
- Sempre comece em homologação (
apihom.correios.com.br) antes de mudar pra produção - Cacheie cotações de frete por CEP+peso — os Correios cobram por consulta em alguns contratos
- Use jobs em fila pro polling de rastreio — não consulte sob demanda do usuário
- Faça webhook ou polling agendado — armazene histórico no seu banco pra timeline rica no painel
- Monitore o status code 401 — se aparecer com frequência, sua chave de acesso pode ter sido revogada (validade de 180 dias para subdelegações)
Códigos de serviço comuns
| Código | Serviço |
|---|---|
| 03220 | SEDEX (contrato) |
| 03298 | PAC (contrato) |
| 04162 | SEDEX (varejo) |
| 04510 | PAC (varejo) |
| 04669 | SEDEX 12 |
| 04227 | SEDEX 10 |
Códigos de eventos de rastreio mais relevantes
| Código | Significado |
|---|---|
| BDE/BDI/BDR | Objeto entregue |
| OEC | Saiu para entrega |
| LDI | Aguardando retirada |
| RO | Encaminhado |
| PO | Postado |
Licença
MIT
All versions of correios with dependencies
PHP Build Version
Package Version
Requires
php Version
^8.2
illuminate/support Version ^11.0|^12.0
illuminate/http Version ^11.0|^12.0
illuminate/cache Version ^11.0|^12.0
illuminate/validation Version ^11.0|^12.0
illuminate/support Version ^11.0|^12.0
illuminate/http Version ^11.0|^12.0
illuminate/cache Version ^11.0|^12.0
illuminate/validation Version ^11.0|^12.0
The package lucasbrito-wdt/correios contains the following files
Loading the files please wait ...