{"id":16065113,"url":"https://github.com/hedii/colissimo-api","last_synced_at":"2025-03-17T16:32:43.180Z","repository":{"id":34560755,"uuid":"38506244","full_name":"hedii/colissimo-api","owner":"hedii","description":"A php package to track Colissimo (La Poste) parcels","archived":false,"fork":false,"pushed_at":"2021-12-11T09:44:55.000Z","size":47,"stargazers_count":22,"open_issues_count":0,"forks_count":12,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-10-16T05:48:37.815Z","etag":null,"topics":["api","colissimo","colissimo-api","la-poste","php"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hedii.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-07-03T18:42:56.000Z","updated_at":"2024-07-19T07:04:58.000Z","dependencies_parsed_at":"2022-09-08T15:01:10.542Z","dependency_job_id":null,"html_url":"https://github.com/hedii/colissimo-api","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hedii%2Fcolissimo-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hedii%2Fcolissimo-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hedii%2Fcolissimo-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hedii%2Fcolissimo-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hedii","download_url":"https://codeload.github.com/hedii/colissimo-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221697199,"owners_count":16865560,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","colissimo","colissimo-api","la-poste","php"],"created_at":"2024-10-09T05:11:11.156Z","updated_at":"2024-10-27T15:19:10.648Z","avatar_url":"https://github.com/hedii.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://github.com/hedii/colissimo-api/workflows/Build/badge.svg)](https://github.com/hedii/colissimo-api/actions)\n\n# colissimo-api\nA php package to track Colissimo (La Poste) parcels\n\n### Requirements\n- PHP \u003e=8.0\n- Curl PHP Extension\n- Json PHP Extension\n\n### Installation\n````bash\ncomposer require hedii/colissimo-api\n````\n\n### Usage\n````php\nrequire 'vendor/autoload.php';\n\n$colissimo = new \\Hedii\\ColissimoApi\\ColissimoApi();\n\ntry {\n    $result = $colissimo-\u003eget('your_colissimo_id_here');\n} catch (\\Hedii\\ColissimoApi\\ColissimoApiException $e) {\n    // ...\n}\n````\n\nThe result is an array of data provided by api.laposte.fr:\n````\narray(4) {\n  [\"lang\"]=\u003e\n  string(5) \"fr_FR\"\n  [\"scope\"]=\u003e\n  string(8) \"timeline\"\n  [\"shipment\"]=\u003e\n  array(13) {\n    [\"idShip\"]=\u003e\n    string(13) \"6H002911xxxxx\"\n    [\"notifAvailable\"]=\u003e\n    bool(true)\n    [\"holder\"]=\u003e\n    int(4)\n    [\"product\"]=\u003e\n    string(9) \"colissimo\"\n    [\"isFinal\"]=\u003e\n    bool(true)\n    [\"deliveryDate\"]=\u003e\n    string(25) \"2019-04-05T14:28:00+02:00\"\n    [\"entryDate\"]=\u003e\n    string(25) \"2019-04-04T21:22:52+02:00\"\n    [\"timeline\"]=\u003e\n    array(5) {\n      [0]=\u003e\n      array(6) {\n        [\"shortLabel\"]=\u003e\n        string(30) \"Votre colis est pris en charge\"\n        [\"id\"]=\u003e\n        int(1)\n        [\"date\"]=\u003e\n        string(25) \"2019-04-04T21:22:52+02:00\"\n        [\"country\"]=\u003e\n        string(0) \"\"\n        [\"status\"]=\u003e\n        bool(true)\n        [\"type\"]=\u003e\n        int(1)\n      }\n      [1]=\u003e\n      array(6) {\n        [\"shortLabel\"]=\u003e\n        string(17) \"Il est en chemin.\"\n        [\"longLabel\"]=\u003e\n        string(0) \"\"\n        [\"id\"]=\u003e\n        int(2)\n        [\"country\"]=\u003e\n        string(0) \"\"\n        [\"status\"]=\u003e\n        bool(true)\n        [\"type\"]=\u003e\n        int(1)\n      }\n      [2]=\u003e\n      array(5) {\n        [\"shortLabel\"]=\u003e\n        string(11) \"Il arrive !\"\n        [\"id\"]=\u003e\n        int(3)\n        [\"country\"]=\u003e\n        string(0) \"\"\n        [\"status\"]=\u003e\n        bool(true)\n        [\"type\"]=\u003e\n        int(1)\n      }\n      [3]=\u003e\n      array(6) {\n        [\"shortLabel\"]=\u003e\n        string(51) \"Votre colis vous attend dans votre point de retrait\"\n        [\"longLabel\"]=\u003e\n        string(0) \"\"\n        [\"id\"]=\u003e\n        int(4)\n        [\"country\"]=\u003e\n        string(0) \"\"\n        [\"status\"]=\u003e\n        bool(true)\n        [\"type\"]=\u003e\n        int(1)\n      }\n      [4]=\u003e\n      array(7) {\n        [\"shortLabel\"]=\u003e\n        string(27) \"Votre colis a été retiré\"\n        [\"longLabel\"]=\u003e\n        string(0) \"\"\n        [\"id\"]=\u003e\n        int(5)\n        [\"date\"]=\u003e\n        string(25) \"2019-04-05T14:28:00+02:00\"\n        [\"country\"]=\u003e\n        string(0) \"\"\n        [\"status\"]=\u003e\n        bool(true)\n        [\"type\"]=\u003e\n        int(1)\n      }\n    }\n    [\"event\"]=\u003e\n    array(5) {\n      [0]=\u003e\n      array(4) {\n        [\"order\"]=\u003e\n        int(100)\n        [\"status\"]=\u003e\n        string(6) \"LIVCFM\"\n        [\"label\"]=\u003e\n        string(23) \"Votre colis est livré.\"\n        [\"date\"]=\u003e\n        string(25) \"2019-04-05T14:28:00+02:00\"\n      }\n      [1]=\u003e\n      array(4) {\n        [\"order\"]=\u003e\n        int(99)\n        [\"status\"]=\u003e\n        string(6) \"AARBPR\"\n        [\"label\"]=\u003e\n        string(195) \"Votre colis est disponible dans votre point de retrait pendant un délai de 10 jours ouvrables. Ne tardez pas à aller le chercher ! Il vous sera remis sur présentation d'une pièce d'identité.\"\n        [\"date\"]=\u003e\n        string(25) \"2019-04-05T12:07:00+02:00\"\n      }\n      [2]=\u003e\n      array(4) {\n        [\"order\"]=\u003e\n        int(98)\n        [\"status\"]=\u003e\n        string(6) \"PRELIV\"\n        [\"label\"]=\u003e\n        string(116) \"Votre colis est dans le site de livraison qui dessert votre adresse. Nous le préparons pour le mettre en livraison.\"\n        [\"date\"]=\u003e\n        string(25) \"2019-04-05T09:27:28+02:00\"\n      }\n      [3]=\u003e\n      array(4) {\n        [\"order\"]=\u003e\n        int(97)\n        [\"status\"]=\u003e\n        string(6) \"PCHTRI\"\n        [\"label\"]=\u003e\n        string(110) \"Votre colis est en transit sur nos plateformes logistiques pour vous être livré le plus rapidement possible.\"\n        [\"date\"]=\u003e\n        string(25) \"2019-04-04T21:22:52+02:00\"\n      }\n      [4]=\u003e\n      array(4) {\n        [\"order\"]=\u003e\n        int(96)\n        [\"status\"]=\u003e\n        string(6) \"PCHMQT\"\n        [\"label\"]=\u003e\n        string(200) \"Votre Colissimo va bientôt nous être confié ! Il est en train d’être préparé chez votre expéditeur. Si vous avez des questions, vous pouvez contacter votre expéditeur ou son service clients.\"\n        [\"date\"]=\u003e\n        string(25) \"2019-04-04T16:46:30+02:00\"\n      }\n    }\n    [\"contextData\"]=\u003e\n    array(6) {\n      [\"isParcelBack\"]=\u003e\n      bool(false)\n      [\"removalPoint\"]=\u003e\n      array(4) {\n        [\"idPoint\"]=\u003e\n        string(6) \"319220\"\n        [\"type\"]=\u003e\n        string(3) \"A2P\"\n        [\"name\"]=\u003e\n        string(19) \"TOULOUSE ROQUELAINE\"\n        [\"isDiffPoint\"]=\u003e\n        bool(false)\n      }\n      [\"deliveryChoice\"]=\u003e\n      array(6) {\n        [\"deliveryChoice\"]=\u003e\n        int(0)\n        [\"accola\"]=\u003e\n        int(0)\n        [\"thirdParty\"]=\u003e\n        int(0)\n        [\"safePlace\"]=\u003e\n        int(0)\n        [\"BALCS\"]=\u003e\n        int(0)\n        [\"extensionBP\"]=\u003e\n        int(0)\n      }\n      [\"recipient\"]=\u003e\n      array(8) {\n        [\"name\"]=\u003e\n        string(14) \"M. JOHN DOE\"\n        [\"companyName\"]=\u003e\n        string(0) \"\"\n        [\"adr2\"]=\u003e\n        string(23) \"12 RUE DU PONT\"\n        [\"adr3\"]=\u003e\n        string(0) \"\"\n        [\"adr4\"]=\u003e\n        string(0) \"\"\n        [\"adr5\"]=\u003e\n        string(0) \"\"\n        [\"zipCode\"]=\u003e\n        string(5) \"31000\"\n        [\"city\"]=\u003e\n        string(8) \"TOULOUSE\"\n      }\n      [\"originCountry\"]=\u003e\n      string(2) \"FR\"\n      [\"arrivalCountry\"]=\u003e\n      string(2) \"FR\"\n    }\n    [\"estimDate\"]=\u003e\n    string(25) \"2019-04-05T02:00:00+02:00\"\n    [\"estimHourMin\"]=\u003e\n    string(25) \"2019-04-08T18:00:36+02:00\"\n    [\"estimHourMax\"]=\u003e\n    string(25) \"2019-04-08T18:00:36+02:00\"\n  }\n  [\"returnCode\"]=\u003e\n  int(200)\n}\n````\n\n### Testing\n\nUpdate the id in `phpunit.xml` file and run:\n\n````bash\ncomposer test\n````\n\n## License\n\ncolissimo-api is released under the MIT Licence. See the bundled [LICENSE](https://github.com/hedii/colissimo-api/blob/master/LICENSE.md) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhedii%2Fcolissimo-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhedii%2Fcolissimo-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhedii%2Fcolissimo-api/lists"}