Várias Classes em PHP para diversos serviços dos Correios.
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.
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.
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.
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.
Ivan Wilhelm
E-mail: [email protected]
Twitter: @ivanwhm
Skype: ivan.whm