garu/WWW-Correios-SRO — pull request #8 by rafaelol (2014-09-14 21:34:35+00:00)
Title: Novas funcoes no modulo

Um código de SRO é composto das seguintes partes:

prefixo - 2 caracteres entre A e Z
codigo - 8 numeros
codigo_verificador - Um número que confirma a validade de 'codigo'
codigo_pais - 2 caracteres que simbolizam o pais de procedencia

Um dos grandes problemas no módulo consiste na necessidade de
conhecimento prévio da listagem de prefixos. Infelizmente
os correios exibem publicamente uma tabela desatualizada, onde
alguns prefixos não estão incluídos na tabela de prefixos do site.

A consequência desta falta de informação é o retorno como undef
de códigos SRO que são usados, porém não têm prefixo conhecido.
As mais recentes versões do módulo tinham como função apenas
incluir prefixos conhecidos pelos usuários, mesmo sem saber o
significado dos mesmos (Ex: DG).

Para resolver este problema, estamos removendo a verificação
de prefixo da função "sro". Se código e codigo_verificador
estiverem corretos, vamos pesquisar no site dos Correios as
informações deste pacote, não importa o prefixo. Com isto,
pretendemos evitar necessidades posteriores de lançar novas
versões do módulo para apenas incluir um campo da hash 'siglas'.

Acreditamos que o comportamento desejado pelos usuários do módulo
é retornar as informações daquele código, não importa se o
prefixo é conhecido ou não. Porém, se algum usuário do módulo
deseja verificar informações de um código dos correios com
prefixo informado pelos correios, deve passar mais um
parâmetro em sro, com um valor acima de 0.