-
Notifications
You must be signed in to change notification settings - Fork 0
/
rastrear.class.php
181 lines (164 loc) · 6.13 KB
/
rastrear.class.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
<?php
/**
* Classe de Rastreamento de Pedidos dos Correios. PHP + SOAP
* ----------------------------------------------------------
*
* Esta é uma classe estatica simples criada com intuito de rastrear objetos dos correios
* Utilizando para isso PHP e a API SOAP fornecida pelo sistema dos Correios.
* Fique a vontade para usar como desejar, em vosso sistema, seja
* ele pessoal ou comercial.
*
* O único intuito aqui é apresentar de forma simples o
* funcionamento da API fornecida pelos correios.
*
* Para mais detalhes verifique a documentação fornecida pelos Correios:
* @link - http://sooho.com.br/resources/Manual_RastreamentoObjetosWS.pdf
*
* @since - 2016.08.21 22:45
* @author Wanderlei Santana <[email protected]>
* @version 201705092234 - revisão
*/
class Rastrear
{
/**
* URL de acesso a API dos Correios.
* @var string
*/
private static $wsdl = null ;
/**
* Seu nome único de usuário para acesso a API
* Normalmente obtido na agência de sua cidade
* @var string
*/
private static $user = null ;
/**
* Sua senha unica de acesso a API dos correios.
* Deve ser obtida junto ao nome de usuario
* @var string
*/
private static $pass = null ;
/**
* L ou F - Sendo:
* L - usado para uma Lista de Objetos; e
* F - usado para um intervalo de Objetos.
* @var Char
*/
private static $tipo = null ;
/**
* Delimita o escopo de resposta de cada objeto.
* T - Retorna todos os eventos do Objeto
* U - Será retornado apenas o último evento do Objeto
* @var Char
*/
private static $resultado = null ;
/**
* Deve ser um valor do tipo integer, sendo
* 101 - para o retorno em idioma Portugues do Brasil
* 102 - para o retorno em idioma Inglês
* @var integer
*/
private static $idioma = null ;
/**
* flag que indica se este objeto foi ou nao inicializado.
* Apenas para uso interno desta classe
* @var boolean
*/
private static $inicializado = false ;
/**
* Inicializa este objeto.
*
* É obrigatorio a chamada deste metodo antes de iniciar
* o rastreamento de Objetos.
*
* Passe os parametros para login no sistema dos correios.
* Caso não possua dados de login, entre em contato com a
* agencia mais proxima e solicite as credências para utilizar
* o sistema.
*
* Mesmo que não tenha os dados de login, esta classe irpa funcionar
* com Credenciais que são utilizadas como teste.
*
* @param array $_param - Matriz contendo os dados de login e
* demais dados de acesso a API dos Correios.
* Caso nada seja informado, a Classe usará os dados Default.
*
* Dados Experados:
* array['wsdl'] - URL de acesso a API
* array['user'] - Nome do Seu usuario de acesso a API dos Correios
* array['pass'] - Sua senha de acesso a API
* array['tipo'] - L ou F (normalmente L)
* array['resultado'] - T ou U (normalmente T)
* array['idioma'] - Padrão é o 101, que indica o idioma Português do Brasil
*
* @return Void
*/
public static function init( $_params = array() )
{
self::$wsdl = isset($_params['wsdl']) ? $_params['wsdl'] : "http://webservice.correios.com.br/service/rastro/Rastro.wsdl" ;
self::$user = isset($_params['user']) ? $_params['user'] : "ECT" ;
self::$pass = isset($_params['pass']) ? $_params['pass'] : "SRO" ;
self::$tipo = isset($_params['tipo']) ? $_params['tipo'] : "L" ;
self::$resultado = isset($_params['resultado']) ? $_params['resultado'] : "T" ;
self::$idioma = isset($_params['idioma']) ? $_params['idioma'] : "101" ;
self::$inicializado= true;
}
/**
* Método que realiza o rastreamento de Objetos dos Correios
* espera receber como parametro um CODIGO de rastreamento
* devidamente Valido e existente na database dos Correios.
* EX: PJ012345678BR
*
* Para mais do que um Objeto, passaro todos os codigos um após
* o outro, sem simbolos especiais ou espaços.
* EX: PJ012345678BRPJ912345678BRPJ812345678BR
*
* @param string $__codigo__ - Codigo ou lista de codigos de objetos a ser(em) rastreado(s)
* @return Object
*/
public static function get( $__codigo__ = null )
{
# verificacoes simples para validar o codigo. Adicione
# outros metodos a seu gosto
if(!self::$inicializado)
return self::erro( "Primeiro acesse o metodo Rastrear::init() com os devidos parametros." );
if( is_null( $__codigo__ ) )
return self::erro( "Nenhum código de rastreamento recebido." );
if( ! self::soapExists() )
return self::erro( "Parece que o Modulo SOAP não esta ativo em seu servidor." );
$_evento = array(
'usuario' => self::$user,
'senha' => self::$pass,
'tipo' => self::$tipo,
'resultado' => self::$resultado,
'lingua' => self::$idioma,
'objetos' => trim($__codigo__)
);
$client = new SoapClient( self::$wsdl );
$eventos = $client->buscaEventos( $_evento );
// sempre retorna objeto por padrao, mesmo em caso de erros.
return ($eventos->return->qtd == 1) ?
$eventos->return->objeto:
$eventos->return;
}
/**
* Verifica se o Modulo SOAP esta ativo
* no servidor do usuario e funcionando.
*
* @return bool - true se tudo ok
*/
private static function soapExists() {
return extension_loaded('soap') && class_exists("SOAPClient") ;
}
/**
* Metodo para retorno de erros no formato de objetos
* para manter o padrao de retorno.
*
* @param string $__mensagem - Mensagem de erro a ser retornado
* @return stdClass Object
*/
private static function erro( $__mensagem = null ){
$obj = new stdClass;
$obj -> erro = $__mensagem ;
return $obj ;
}
} // fim da classe Rastrear