WWW::Correios::SRO - Serviço de Rastreamento de Objetos (Brazilian Postal Object Tracking Service)
This module provides APIs in english and portuguese. Documentation is also shown in both languages.
Este módulo oferece APIs em inglês e português. Documentação também é mostrada em ambos os idiomas.
API em português:
use WWW::Correios::SRO 'sro'; my @historico_completo = sro( 'SS123456789BR' ); my $ultimo = sro( 'SS123456789BR' ); $ultimo->data; # '22/05/2010 12:10' $ultimo->local; # 'CEE JACAREPAGUA - RIO DE JANEIRO/RJ' $ultimo->status; # 'Destinatário ausente' $ultimo->extra; # 'Será realizada uma nova tentativa de entrega'
English API:
use WWW::Correios::SRO 'sro_en'; my @historico_completo = sro_en( 'SS123456789BR' ); my $ultimo = sro_en( 'SS123456789BR' ); $ultimo->date; # '22/05/2010 12:10' $ultimo->location; # 'CEE JACAREPAGUA - RIO DE JANEIRO/RJ' $ultimo->status; # 'No receiver at the address' $ultimo->extra; # 'Delivery will be retried'
Note: All messages are created by the brazilian post office website. Some messages might not be translated.
Note #2: the sro_en() function is experimental, and could be removed in future versions with no prior notice. If you care, or have any comments/suggestions on how to improve this, please let me know.
Este módulo não exporta nada por padrão. Você precisa explicitar 'sro' (para mensagens em português) ou 'sro_en' (para mensagens em inglês).
This module exports nothing by default. You have to explicitly ask for 'sro' (for the portuguese messages) or 'sro_en' (for the english messages).
Recebe o código identificador do objeto.
Em contexto escalar, retorna retorna um objeto WWW::Correios::SRO::Item contento a entrada mais recente no registro dos Correios. Em contexto de lista, retorna um array de objetos WWW::Correios::SRO::Item, da entrada mais recente à mais antiga. Em caso de falha, retorna undef. As mensagens do objeto retornado estarão em português.
--
Receives the item identification code.
In scalar context, returns a WWW::Correios::SRO::Item object containing the most recent log entry in the Postal service. In list context, returns a list of WWW::Correios::SRO::Item objects, from the most recent entry to the oldest. Returns undef upon failure. Messages on the returned object will be in portuguese.
O mesmo que sro(), mas com mensagens em inglês.
sro()
Same as sro(), but with messages in english.
Retorna a data/hora em que os dados de entrega foram recebidos pelo sistema, exceto no 'SEDEX 10' e no 'SEDEX Hoje', em que representa o horário real da entrega. Informação sobre onde encontrar o código para rastreamento estão disponíveis (em português) no link: http://www.correios.com.br/servicos/rastreamento/como_loc_objeto.cfm
Returns the date/time in which the delivery data got into the system, except on 'SEDEX 10' and 'SEDEX Hoje', where it corresponds to the actual delivery date. Information on how to find the tracking code is available in the link: http://www.correios.com.br/servicos/rastreamento/como_loc_objeto.cfm (follow the "English version" link on that page).
Retorna local em que o evento ocorreu. A string retornada é prefixada por uma sigla, como ACF (Agência de Correios Franqueada), CTE (Centro de Tratamento de Encomendas), CTCE (Centro de Tratamento de Cartas e Encomendas), CTCI (Centro de Tratamento de Correio Internacional), CDD (Centro de Distribuição Domiciliária), CEE (Centro de Entrega de Encomendas).
Returns the location where the event ocurred. The returned string is prefixed by an acronym like ACF (Franchised Postal Agency), CTE (Center for Item Assessment), CTCE (Center for Item and Mail Assessment), CTCI (Center for International Postal Assessment), CDD (Center for Domiciliary Distribution), CEE (Center for Item Delivery).
Retorna a situação registrada para o evento (postado, encaminhado, destinatário ausente, etc)
Returns the registered situation for the event (no receiver at the address, etc)
Contém informações adicionais a respeito do evento, ou undef. Exemplo: 'Será realizada uma nova tentativa de entrega'.
Contains additional information about the event, or undef. E.g.: 'Delivery will be retried'
Breno G. de Oliveira, <garu at cpan.org>
<garu at cpan.org>
Por favor envie bugs ou pedidos para bug-www-correios-sro at rt.cpan.org, ou pela interface web em http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WWW-Correios-SRO. Eu serei notificado, e então você será automaticamente notificado sobre qualquer progresso na questão.
bug-www-correios-sro at rt.cpan.org
Please report any bugs or feature requests to bug-www-correios-sro at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WWW-Correios-SRO. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
You can find documentation for this module with the perldoc command.
perldoc WWW::Correios::SRO
You can also look for information at:
RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=WWW-Correios-SRO
AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/WWW-Correios-SRO
CPAN Ratings
http://cpanratings.perl.org/d/WWW-Correios-SRO
Search CPAN
http://search.cpan.org/dist/WWW-Correios-SRO/
Este módulo não existiria sem o serviço gratuito de rastreamento online dos Correios.
http://www.correios.com.br/servicos/rastreamento/
Copyright 2010 Breno G. de Oliveira.
This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.
See http://dev.perl.org/licenses/ for more information.
To install WWW::Correios::SRO::Item, copy and paste the appropriate command in to your terminal.
cpanm
cpanm WWW::Correios::SRO::Item
CPAN shell
perl -MCPAN -e shell install WWW::Correios::SRO::Item
For more information on module installation, please visit the detailed CPAN module installation guide.