Download the PHP package budgetlens/intrapost without Composer
On this page you can find all versions of the php package budgetlens/intrapost. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download budgetlens/intrapost
More information about budgetlens/intrapost
Files in budgetlens/intrapost
Package intrapost
Short Description Fluent PHP client for the Intrapost API (mail, parcels, track & trace)
License MIT
Informations about the package intrapost
Intrapost PHP Client
Fluent PHP client for the Intrapost API — create shipments, generate labels, track parcels, and manage daily mail orders for PostNL, DHL, and GLS.
Requirements
Installation
Configuration
Standalone PHP
Laravel
The package includes auto-discovery, so the service provider and facade are registered automatically.
Publish the config file:
Add to your .env:
Use via dependency injection or facade:
Welke API gebruik je wanneer?
De Intrapost API is opgedeeld in vier resources. Hieronder staat wanneer je welke gebruikt:
Mail Piece vs. Track & Trace
Dit is het belangrijkste onderscheid:
| Mail Piece | Track & Trace | |
|---|---|---|
| Wat | Brieven en ongeregistreerde poststukken | Pakketten met track & trace |
| Wanneer | Reguliere post versturen (brieven, kaarten, kleine poststukken tot 2kg) | Pakketten versturen die gevolgd moeten worden |
| Tracking | Geen volledige track & trace — alleen registratie en label | Volledige track & trace met VZ-code en trackinglink |
| Gewicht | In grammen (1-2000g) | In kilogrammen |
| Producten | Standard, FixedDays | 12 producttypen (standaard, verzekerd, aangetekend, brievenbuspakket, avondlevering, etc.) |
| Extra opties | Beperkt (afmetingen, projectcode) | Uitgebreid (afmetingen, afhaalpunt, customs, handtekening, leeftijdscheck, etc.) |
Vuistregel: Verstuur je een brief of ongeregistreerd poststuk? Gebruik mailPiece(). Verstuur je een pakket dat gevolgd moet worden? Gebruik trackTrace().
Overzicht van alle calls
| Methode | Gebruik wanneer... |
|---|---|
| Mail Piece | |
mailPiece()->create() |
Je een nieuw poststuk wilt registreren en een label wilt genereren |
mailPiece()->order() |
Je de dagelijkse bestelling van geregistreerde poststukken wilt ophalen (verzamelorder) |
mailPiece()->getLabel() |
Je het label van een eerder aangemaakt poststuk opnieuw wilt ophalen |
| Track & Trace | |
trackTrace()->create() |
Je een nieuw pakket wilt aanmelden met track & trace (de meest gebruikte call) |
trackTrace()->createMailboxParcel() |
Je specifiek een brievenbuspakket wilt aanmaken met ZPL-label |
trackTrace()->createLabels() |
Je labels voor meerdere zendingen in 1 bestand wilt genereren |
trackTrace()->getRetourLabel() |
Je een retourlabel wilt aanmaken voor een bestaande zending |
trackTrace()->cancel() |
Je een zending wilt annuleren (voordat deze is verwerkt) |
trackTrace()->search() |
Je zendingen wilt zoeken op datum, postcode, referentie, etc. |
trackTrace()->getFromId() |
Je zendingen wilt ophalen op basis van hun Piece ID (max. 50 per keer) |
trackTrace()->getFromVz() |
Je zendingen wilt ophalen op basis van hun VZ-code (max. 50 per keer) |
| Order (Daily Mail) | |
order()->createDailyMailOption1() |
Dagelijkse postbestelling aanmaken (optie 1) |
order()->createDailyMailOption2() |
Dagelijkse postbestelling aanmaken (optie 2) |
order()->createDailyMailOption3() |
Dagelijkse postbestelling aanmaken (optie 3) |
| Utility | |
utility()->lookupAddress() |
Je een adres wilt valideren/opzoeken op basis van postcode + huisnummer |
utility()->productCodes() |
Je wilt opvragen welke productcodes beschikbaar zijn voor jouw account |
utility()->pickupPointsForAddress() |
Je afhaalpunten wilt zoeken bij een adres (voor ParcelViaPickupLocation) |
utility()->dropoffPointsForInternationalAddress() |
Je inleverpunten wilt zoeken voor internationale zendingen |
Typische flow
Usage
Mail Pieces
Create a mail piece:
Shorthand product methods:
Order mail pieces:
Get a label:
Track & Trace Parcels
Create a shipment:
Available product shorthand methods:
Create a mailbox parcel:
Generate labels:
Get a return label:
Cancel a shipment:
Search shipments:
Look up by ID or VZ code:
Pickup at a Service Point
International Shipments with Customs
Daily Mail Orders
Utilities
Address lookup:
Product codes:
Pickup & drop-off points:
Supported Carriers
| Carrier | Enum |
|---|---|
| PostNL | CarrierType::PostNL |
| DHL | CarrierType::DHL |
| GLS | CarrierType::GLS |
Label Formats
| Format | Enum |
|---|---|
| ZPL Zebra 150x100mm | LabelFormatType::ZplZebra150x100 |
| PDF 150x100mm | LabelFormatType::Pdf150x100 |
Error Handling
The client throws specific exceptions for different error scenarios:
Testing
Code Style
License
MIT License. See LICENSE for details.