Download the PHP package allekurier/api_v1 without Composer
On this page you can find all versions of the php package allekurier/api_v1. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package api_v1
AlleKurier API v1
- Wymagania
- Instalacja
- Użycie
- Przygotowanie API
- Utworzenie zamówienia
- Pobranie aktualnego statusu przesyłki
- Pobranie listu przewozowego
- Pobranie historii przesyłki
- Anulowanie zamówienia
- Pobranie usług
- Pobranie dodatkowych usług
- Pobranie godzin odbioru
- Pobranie punktów przewoźnika
- Modele
- Request
- Order
- Sender / Recipient
- Pickup
- Package
- Response
- Service
- DropoffPoint
- PickupDate
- Event
- Request
- Słownik
Wymagania
- PHP 5.4.0 lub wyższy;
- ext-json;
- ext-curl;
Instalacja
Composer:
Zip:
Użycie
Przygotowanie API
Utworzenie zamówienia
Funkcja zwraca HID zlecenia, numer listu przewozowego, aktualny status, koszt przesyłki.
Poprawnym wyjściem jest status ready. W sytuacji gdy zwrócony status będzie równał się processing należy zapisać HID zlecenia i w określonym interwale czasowym sprawdzać (funkcja getStatus) czy zlecenie zostało już przetworzone, aby kontynuować przetwarzanie (pobranie i wydruk dokumentów). Przyczyną stanu processing może np. być awaria systemu przewoźnika.
cURL:
Response:
Pobranie aktualnego statusu przesyłki
Zwraca podstawowe informacja o zleceniu na podstawie jego numeru. Służy do pobierania ostatniego zdarzenia z historii zlecenia (statusu), numeru przesyłki i śledzenia, oraz dat (utworzenie, nadanie, doręczenie).
cURL:
Response:
Pobranie listu przewozowego
Pobieranie dokumentów do wydruku. Funkcja zwraca zakodowany (base64) pdf z listami przewozowymi. W przypadku DPD domyślnie zwracany jest protokół przekazania towaru. Dokumenty można drukować tylko gdy status zlecenia ustawiony jest na ready.
cURL:
Response:
Pobranie historii przesyłki
Śledzenie przesyłki. Zwracana jest data każdego zdarzenia, kod oraz opis. Dodatkowo podawane są HID zlecenia, data utworzenia, faktycznego nadania oraz doręczenia (lub zwrotu do nadawcy). Zwraca tablicę zdarzeń Event
cURL:
Response:
Anulowanie zamówienia
Anulowanie zlecenia na podstawie numeru. Listy przewozowe UPS należy bezwzględnie anulować, nawet w sytuacji gdy kurier nie odbierze przesyłki (mimo to naliczana jest opłata za transport!). Przyjmujemy że bez względu na przewoźnika list przewozowy należy anulować. Anulowanie listu powoduje anulowanie zlecenia odbioru z danej lokalizacji.
cURL:
Response:
Pobranie usług
Metoda zwraca dostępne usługi wraz z kwotami dla podanych danych. Zwraca tablicę usług Service
Pobranie dodatkowych usług
Metoda zwraca dostępne dodatkowe usługi danej usługi wraz z kwotami dla podanych danych. Zwraca tablicę usług dodatkowych AdditionalService
cURL:
Response:
Pobranie godzin odbioru
Metoda zwraca możliwe godziny odbioru przesyłki przez danego przewoźnika dla zadanego kodu pocztowego. Tablica „from” określa godziny startowe okienka na odbiór, tablica „to” zawiera możliwe końce okienek, Wartości liczone w sekundach od północy np. godzina 11:00 = 11 * 3600 = 39600. Zwaraca tablicę dat PickupDate
cURL:
Response:
Pobranie punktów przewoźnika
Metoda zwraca punkty wybranego przewoźnika w okolicy od podanego kodu pocztowego. Zwraca tablicę punktów DropoffPoint
cURL:
Response:
Pobranie środków użytkownika
Metoda zwraca stan konta użytkownika
cURL:
Response:
Modele
Request
Order
Pole | Opis | Wymagane | Typ | Opis |
---|---|---|---|---|
service | Nazwa usługi | tak | string | dpdclassic, dhlstandard, upsexpresssaver, upsstandard, kexstandard, inpostcourier, paczkawruchu |
package | Typ opakowania | tak | string | parcel, envelope, europallet, isopallet, bigpallet |
description | Opis przesyłki | tak | string | |
delivery | Metoda odbioru | tak | string | register - Zamawiam kuriera po odbiór przesyłki, none - Dostarczę przesyłkę do punktu przewoźnika. |
cod | Kwota pobrania | nie | float | |
insurance | Kwota ubezpieczenia | nie | float | |
reference | Numer referencyjny | nie | string | np. numer faktury, zamówienia |
value | Wartość towaru | nie | float | Wymagane przy przesyłkach poza Unię Europejską |
voucher | Kod vouchera | nie | string |
Sender - S / Recipient - R
Pole | Opis | Model | Wymagane | Typ | Opis |
---|---|---|---|---|---|
name | Odbiorca / Nadawca | S & R | tak | string | imię nazwisko / nazwa firmy |
person | Osoba kontaktowa | S & R | tak | string | imię nazwisko osoby kontakowej |
postal_code | Kod pocztowy | S & R | tak | string | |
address | Adres | S & R | tak | string | ulica, numer domu / mieszkania |
city | Miasto | S & R | tak | string | |
phone | Telefon | S & R | tak | string | |
S & R | tak | string | |||
country | Kod kraju | S & R | tak | string | ISO 3166-1 alfa-2 |
dropoff_point | Kod punktu przewoźnika | S & R | nie | string | Punkty przewoźników |
bank_account | Numer konta bankowego | S | nie | string | wymagane gdy podano Order.cod |
state | Kod stanu | R | nie | string | wymagane dla USA i Kanady |
Pickup
Pole | Opis | Wymagane | Typ | Przykład |
---|---|---|---|---|
date | Data | tak | string | 2017-01-20 |
from | Od godz | tak | string | 12:00:00 |
to | Do godz | tak | string | 16:00:00 |
Package (Typ opakowania)
Pole | Opis | Wymagane | Typ | Opis |
---|---|---|---|---|
weight | Waga | tak | float | |
width | Szerokość | tak | float | |
height | Wysokość | tak | float | |
length | Długość | tak | float | |
custom | Czy standard | tak | bool | Paczka standardowa / niestandardowa |
Response
Service
Pole | Opis | Typ |
---|---|---|
carrierCode | Kod przewoźnika | string |
carrierName | Nazwa przewoźnika | string |
code | Kod usługi | string |
name | Nazwa usługi | string |
net | Koszt netto | float |
gross | Koszt brutto | float |
AdditionalService
Pole | Opis | Typ |
---|---|---|
code | Kod usługi | string |
name | Nazwa usługi | string |
net | Koszt netto | float |
DropoffPoint
Pole | Opis | Typ |
---|---|---|
id | Id punktu | int |
latitude | string | |
longitude | string | |
name | Nazwa punktu | string |
code | Kod punktu | string |
address | Adres punktu | string |
postalCode | Kod pocztowy | string |
image | Zdjęcie punktu | string |
openHours | Godziny otwarcia | string |
isSupportCod | Czy obsługuje pobrania | bool |
PickupDate
Pole | Opis | Typ |
---|---|---|
date | Data | string |
description | Opis | string |
from | Tablica godz podjazdu od godz | array |
to | Tablica godz podjazdu do godz | array |
Event
Pole | Opis | Typ |
---|---|---|
name | Nazwa zdarzenia | string |
date | Data zdarzenia | string |
status | Status zdarzenia | string |
Słownik
Typ opakowania - package
Kod | Nazwa | Max waga | Szerokość | Długość | Wysokość |
---|---|---|---|---|---|
parcel | Paczka | 70 | 1 > && < 270 | 1 > && < 300 | 1 > && < 270 |
envelope | List | 0,5 | - | - | - |
europallet | Paleta 120x80 cm | 900 | - | - | < 180 |
isopallet | Paleta 120x100 cm | 900 | - | - | < 180 |
bigpallet | Paleta 120x120 cm | 900 | - | - | < 180 |
Przewoźnicy
Kod | Nazwa | Kod usług |
---|---|---|
dpd | Dpd | dpdclassic |
ups | Ups | upsstandard, upsexpresssaver, upsexpress |
dhl | Dhl | dhlstandard |
inpostcourier | Inpost Kurier | inpostcourier |
ruch | Ruch | paczkawruchu |
poczta | Poczta Polska | |
inpost | Inpost Paczkomaty | paczkomat |
fedex | Fedex Polska | fedex |
geis | Geis Parcel | kexstandard |
All versions of api_v1 with dependencies
ext-json Version *
ext-curl Version *