NAME

WWW::ColiPoste - Fetch shipping status from ColiPoste

VERSION

Version 0.03

SYNOPSIS

    use WWW::ColiPoste;

    my $coliposte = WWW::ColiPoste->new;
    my $status = $coliposte->get_status(tracking_id => $id);

DESCRIPTION

This module allows you to fetch the status of packages shipped by ColiPoste, the service from the French national postal service.

Please note that this module works by web-scrapping, and doesn't do any transformation or parsing on the data apart from basic cleanup. Especially, the dates and messages are as given by the web site, in French.

IMPORTANT: Thanks to La Poste corporate thinking, this module is no longer useful (since 2009), because they replaced the texts in the result page with images (just in case their service was still usable).

METHODS

new()

Create a new objet.

get_status()

Fetch the tracking status of the given shipment ID. Returns the corresponding tracking data as an array reference with the following sub-structure:

    [
        {
            date    => STRING,
            site    => STRING,
            status  => STRING,
        },
        ...
    ]

Options

tracking_id - (mandatory) tracking ID of the package
from - (optional) source URI or file
using - (optional) use this LWP agent or code reference for fetching from the remote site

Example

    my $status = $coliposte->get_status(tracking_id => $id);

AUTHOR

Sébastien Aperghis-Tramoni, <sebastien at aperghis.net>

BUGS

Please report any bugs or feature requests to bug-www-coliposte at rt.cpan.org, or through the web interface at http://rt.cpan.org/Public/Dist/Display.html?Name=WWW-ColiPoste. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc WWW::ColiPoste

You can also look for information at:

* RT: CPAN's request tracker: http://rt.cpan.org/NoAuth/Bugs.html?Dist=WWW-ColiPoste
* AnnoCPAN: Annotated CPAN documentation: http://annocpan.org/dist/WWW-ColiPoste
* CPAN Ratings: http://cpanratings.perl.org/d/WWW-ColiPoste
* Search CPAN: http://search.cpan.org/dist/WWW-ColiPoste

COPYRIGHT & LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.