Skip to content

rgattermann/correios

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Correios

Várias Classes em PHP para diversos serviços dos Correios.

Estrutura das pastas

classes: Contém as classes necessárias para as consultas.

exemplos: Contém exemplos de cada uma das consultas disponíveis.

manuais: Contém os manuais oficiais dos Correios.

Cálculo Remoto de Preço e Prazo de entrega

O cálculo remoto de preços e prazos de encomendas dos Correios é destinado aos clientes que possuem contrato de Sedex, e-Sedex e PAC, que necessitam calcular, no seu website e de forma personalizada, o preço e o prazo de entrega de uma encomenda.

É possível também a um cliente que não possui contrato de encomenda com os Correios realizar o cálculo, porém, neste caso os preços apresentados serão aqueles praticados no balcão da agência.

Você pode baixar a especificação do webservice de preços e prazos aqui.

Os manuais de especificação serão salvos também na pasta manuais deste projeto, afim de manter um histórico.

A versão atual destas classes está trabalhando com a versão 1.9 do webservice dos Correios.

Histórico de alterações

  • 03/03/2014:
  • Ajustes para a versão 1.9 do manual dos Correios com a inclusão dos métodos para calcular somente o preço ou somente o prazo de forma a exibir os resultados separadamente.
  • Incluído chamada aos métodos CalcPrecoPrazoData, CalcPrecoData e CalcPrazoData, que realizam o cálculo a partir de uma database informada, podendo, em alguns casos retornar valores e/ou prazos diferentes.

Rastreamento de encomendas

Para automatizar o processo de retorno de informações sobre o rastreamento de objetos, o cliente pode conectar-se ao servidor do Sistema de Rastreamento de Objetos – SRO e obter detalhes (rastros) dos objetos postados fazendo uso do padrão XML (eXtensible Markup Language) para intercâmbio das informações.

Cada consulta ao sistema fornece informações sobre o rastreamento de até 50 objetos por conexão, sem limites de conexões.

O Cliente deverá informar os números dos objetos a rastrear através de uma conexão HTTP (HyperText Transfer Protocol).

Você pode baixar a especificação do webservice de preços e prazos aqui.

Os manuais de especificação serão salvos também na pasta manuais deste projeto, afim de manter um histórico.

A versão atual destas classes está trabalhando com a versão 1.5 do webservice dos Correios.

Histórico de alterações

  • 26/03/2014:
  • Inclusão dos novos tipos de eventos: BLQ, CMT, LDE e TRI na classe Correios.
  • Atualização dos status de rastreamento de acordo com nova tabela de eventos dos Correios http://www.correios.com.br/voce/acompanhar/rastreamento/atualizacaoSRO.cfm (Créditos ao Renato Bigliazzi)
  • Criação do método getAcaoStatus() no modelo CorreiosRastreamentoResultadoEvento para descrever a ação que deve ser realizada no status da encomenda.
  • Atualização do exemplo para o novo método getAcaoStatus().
  • 03/03/2014:
  • Inclusão de tratamento para obter o primeiro evento de entrega (Créditos ao Renato Bigliazzi)
  • Inclusão de retorno de destino para eventos que possuem esta informação (Créditos ao Luiz Marcio Dias Carneiro Marques)
  • Inclusão de descrição do status (para eventos de problemas) de acordo com tabela fornecidas pelos Correios.
  • Melhoria nas mensagens de erro para ficar mais claro quando um erro ocorre por alguma entrada incorreta.
  • Ajuste para validar um código de rastreamento informado através da classe CorreiosSro.

Validação/Identificação/Geração de dígito verificador de códigos de rastreio (SRO)

Conjunto de funções responsável por validar, identificar os parâmetros e gerar dígito de validação de código de rastreamento (ou número de objeto) SRO dos Correios. Pode ser útil quando se deseja obter informações a respeito de um objeto ou para entrada de dados externas em seus sistemas.

Histórico de alterações

  • 07/03/2014:
  • Inclusão da sigla LZ (Objeto Internacional) (Créditos ao Renato Bigliazzi)
  • 03/03/2014:
  • Inclusão da classe CorreiosSroDados que retorna as informações relacionadas a um código de rastreamento.

Contatos

Ivan Wilhelm

E-mail: ivan.whm@me.com

Twitter: @ivanwhm

Skype: ivan.whm

About

Várias Classes em PHP para diversos serviços dos Correios (Cálculo de preços e prazos de entrega, rastreamento de objetos e validação/geração de SRO)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • PHP 100.0%