NAME

WWW::ColiPoste - Fetch shipping status from ColiPoste

VERSION

Version 0.02

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.

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

Copyright 2008 Sébastien Aperghis-Tramoni, all rights reserved.

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