Introducere
Bine ai venit pe E-Commerce API Portal, acest serviciu este dezvoltat pentru a asigura o comunicare cu magazinele online și sistemul informatic a Poștei Moldovei în procesul de creare comenzi de livrare prin serviciul Curier Rapid.
Pentru orice întrebări vă rugăm să ne contactați folosind aceste date.
Derulați în jos pentru exemple de cod, solicitări și răspunsuri. Selectați o limbaj pentru exemplele de cod din filele de mai sus sau din meniul de navigare mobil.
Autentificare
Folositi antetul cererii de autorizare HTTP "Authorization" ce va conține acreditările pentru a autentifica un utilizator cu serviciul nostru, in caz de date pentru logare invalide serverul nostru va răspunde cu starea 401 Neautorizat
Exemplu:
Authorization: Token 00000000000000000000000000000000
Authorization: Token your-api-key
Obtinere date de access
Token-ul de access este disponibil spre vizualizare in Cabinetul personal pentru toate persoanele juridice care au incheiat un contract cu Posta Moldovei.
Pentru a obtine token-ul accesati acest link Cabinet personal sau luati legatura cu o persoana de la suport.
Prelucrare erori
Aici sunt enumerate câteva din cele mai populare erori care pot apărea în procesul de comunicare cu API. Vă recomandăm să dezvoltați integrarea sa suportă prelucrarea acestor erori.
Invalid token
Dacă datele trimise în header-ul nu sunt corecte atunci veți primi o eroare 401 cu mesajul "Datele de autentificare nu au fost furnizate"
Status code: HTTP/1.1 401 Unauthorized
Response
{
"detail": "Datele de autentificare nu au fost furnizate."
}
Parse error
Serverul suportă doar date în format JSON, dacă serviciul va expedia date în alt format sau json-ul nu va fi valid atunci veți primi o eroare despre imposibilitatea decodării informației.
Status code: HTTP/1.1 400 Bad Request
Response
{
"detail": "JSON parse error"
}
Internal error
Dacă serverul are o problemă tehnică atunci serverul va returna un răspuns 500 și în scurt timp problema va fi remediată
Status code: HTTP/1.1 500 Internal Server Error
Response
{
"exception": "division by zero",
"detail": "Ceva nu a mers bine. Contactați serviciul suport"
}
Not found
Daca o entitate nu poate fi gasita dupa identificatorul care il expediati atunci serverul va returna 404 error.
Status code: HTTP/1.1 404 Not Found
Response
{
"detail": "Nu a fost găsit(ă)."
}
Invalid request
Dacă o entitate expediată nu poate fi procesată deoarece nu corespunde regulilor de validare atunci veți primi un răspuns cu descifrare la greșeli.
Status code: HTTP/1.1 400 Bad Request
Response
{
"sender_address": {
"region": [
"Pk \"0\" nevalid - obiectul nu există."
],
"city": [
"Pk \"0\" nevalid - obiectul nu există."
]
},
"declared_amount": [
"Este necesar un număr valid."
]
}
Curier rapid
Listează, crează, anulează și urmărește comenzile.
Crează comandă
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.post('https://curier-rapid-api.posta.md/ecommerce/shipping', json={
"sender_address": {
"street": "bd. Ștefan cel Mare și Sfânt",
"block": "134",
"zip_code": "MD-2012",
"region": 2259,
"city": 14797
},
"receiver_address": {
"street": "bd. Ștefan cel Mare și Sfânt",
"block": "135",
"zip_code": "MD-2012",
"region": 2259,
"city": 14797
},
"items": [
{
"weight": 10,
"length": 200,
"width": 100,
"height": 300,
"quantity": 1,
"declared_amount": 0,
"description": "Aspirator",
"item_type": 1
}
],
"sender_name": "E Magazin SRL",
"sender_phone_number": 37368555666,
"sender_email": "info@emagazin.md",
"receiver_name": "Vasile Vasilescu",
"receiver_phone_number": 37368555777,
"receiver_email": "vasile@example.com",
"payment_type": "cash",
"cash_on_delivery_amount": "6000",
"declared_amount": "6000",
"payer": "receiver"
}, headers=headers)
print(r.json())
$curl = curl_init('https://curier-rapid-api.posta.md/ecommerce/shipping');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
"sender_address" => [
"street" => "bd. Ștefan cel Mare și Sfânt",
"block" => "134",
"zip_code" => "MD-2012",
"region" => 2259,
"city" => 14797
],
"receiver_address" => [
"street" => "bd. Ștefan cel Mare și Sfânt",
"block" => "135",
"zip_code" => "MD-2012",
"region" => 2259,
"city" => 14797
],
"items" => [
[
"weight" => 10,
"length" => 200,
"width" => 100,
"height" => 300,
"quantity" => 1,
"declared_amount" => 0,
"description" => "Aspirator",
"item_type" => 1
]
],
"sender_name" => "E Magazin SRL",
"sender_phone_number" => 37368555666,
"sender_email" => "info@emagazin.md",
"receiver_name" => "Vasile Vasilescu",
"receiver_phone_number" => 37368555777,
"receiver_email" => "vasile@example.com",
"payment_type" => "cash",
"cash_on_delivery_amount" => "6000",
"declared_amount" => "6000",
"payer" => "receiver"
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Exemplu obiect JSON expediat
{
"sender_address": {
"street": "bd. Ștefan cel Mare și Sfânt",
"block": "134",
"zip_code": "MD-2012",
"region": 2259,
"city": 14797
},
"receiver_address": {
"street": "bd. Ștefan cel Mare și Sfânt",
"block": "135",
"zip_code": "MD-2012",
"region": 2259,
"city": 14797
},
"items": [
{
"weight": 10,
"length": 200,
"width": 100,
"height": 300,
"quantity": 1,
"declared_amount": 0,
"description": "Aspirator",
"item_type": 1
}
],
"sender_name": "E Magazin SRL",
"sender_phone_number": 37368555666,
"sender_email": "info@emagazin.md",
"receiver_name": "Vasile Vasilescu",
"receiver_phone_number": 37368555777,
"receiver_email": "vasile@example.com",
"payment_type": "cash",
"cash_on_delivery_amount": "6000",
"declared_amount": "6000",
"payer": "receiver"
}
Exemplu de raspuns cu success
{
"id": 325,
"sender_address": {
"id": 819,
"region": {
"id": 2259,
"modified_at": "2022-01-08T16:39:14.957359Z",
"created_at": "2022-01-08T14:57:57.691795Z",
"name": "mun. Chişinău",
"code": "2034",
"country": 2097
},
"country": {
"id": 2097,
"modified_at": "2022-01-08T16:39:05.125188Z",
"created_at": "2022-01-08T14:51:10.882353Z",
"name": "Moldova, Republic of",
"code": "MD"
},
"city": {
"id": 14797,
"modified_at": "2022-01-08T16:39:17.298042Z",
"created_at": "2022-01-08T14:58:34.271429Z",
"name": "Chişinău",
"code": "659826",
"region": 2259
},
"modified_at": "2022-01-10T15:49:36.481974Z",
"created_at": "2022-01-10T15:49:36.480971Z",
"street": "bd. Ștefan cel Mare și Sfânt",
"block": "134",
"zip_code": "MD-2012",
"house": null,
"office": null,
"entrance": null,
"floor": null,
"entrance_code": null,
"geolocation": null
},
"receiver_address": {
"id": 820,
"region": {
"id": 2259,
"modified_at": "2022-01-08T16:39:14.957359Z",
"created_at": "2022-01-08T14:57:57.691795Z",
"name": "mun. Chişinău",
"code": "2034",
"country": 2097
},
"country": {
"id": 2097,
"modified_at": "2022-01-08T16:39:05.125188Z",
"created_at": "2022-01-08T14:51:10.882353Z",
"name": "Moldova, Republic of",
"code": "MD"
},
"city": {
"id": 14797,
"modified_at": "2022-01-08T16:39:17.298042Z",
"created_at": "2022-01-08T14:58:34.271429Z",
"name": "Chişinău",
"code": "659826",
"region": 2259
},
"modified_at": "2022-01-10T15:49:36.531972Z",
"created_at": "2022-01-10T15:49:36.530970Z",
"street": "bd. Ștefan cel Mare și Sfânt",
"block": "135",
"zip_code": "MD-2012",
"house": null,
"office": null,
"entrance": null,
"floor": null,
"entrance_code": null,
"geolocation": null
},
"items": [
{
"id": 343,
"item_type": {
"id": 1,
"modified_at": "2021-11-02T10:28:59.789379Z",
"created_at": "2021-11-02T10:28:59.788991Z",
"name": "Palet",
"code": "Palet",
"image_url": null
},
"modified_at": "2022-01-10T15:49:36.609970Z",
"created_at": "2022-01-10T15:49:36.608971Z",
"weight": 10,
"length": 200,
"width": 100,
"height": 300,
"quantity": 1,
"declared_amount": 0,
"description": "Aspirator",
"shipping": 325
}
],
"group": null,
"packages": [],
"additional_services": [],
"sender_postal_office": null,
"receiver_postal_office": null,
"current_courier": null,
"current_deposit": null,
"created_by": {
"id": 64,
"email": "resu11@example.com",
"first_name": "string",
"last_name": "string",
"phone_number": 123,
"account": {
"id": 74,
"name": "string string",
"is_company": false,
"registration_number": "string"
}
},
"modified_at": "2022-01-10T15:49:36.583970Z",
"created_at": "2022-01-10T15:49:36.568974Z",
"sender_name": "E Magazin SRL",
"sender_phone_number": 37368555666,
"sender_email": "info@emagazin.md",
"sender_pickup_location": "address",
"receiver_name": "Vasile Vasilescu",
"receiver_phone_number": 37368555777,
"receiver_email": "vasile@example.com",
"receiver_pickup_location": "address",
"receiver_document": {},
"receiver_signature_url": null,
"additional_info_general": null,
"additional_info_client": null,
"additional_info_awb": null,
"payment_type": "cash",
"base_cost": null,
"cost": null,
"recalculated_cost": null,
"cash_on_delivery_amount": "6000.00",
"declared_amount": "6000.00",
"payer": "receiver",
"status": "created",
"is_paid": false,
"awb_number": null,
"shipping_number": "LC0000000000400",
"pickup_date": null,
"estimated_reception_date": null,
"pickup_at": null,
"delivered_at": null,
"account": 74,
"management_user": null
}
POST https://curier-rapid-api.posta.md/ecommerce/shipping
Find companies based on search criteria
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| sender_address.save_address | boolean | Nu | Salveaza adresa in contul utilizatorului |
| sender_address.region | integer | Da | ID raion a expediatorului din nomenclatorul de raioane |
| sender_address.city | integer | Da | ID oras a expediatorului din nomenclatorul de orase |
| sender_address.street | string | Da | Strada expediatorului |
| sender_address.house | string | Nu | Numarul casei expediatorului |
| sender_address.zip_code | string | Nu | Codul postal a expediatorului |
| sender_address.block | string | Da | Numarul blocului de locuit a expediatorului |
| sender_address.office | string | Nu | Numarul oficiului expediatorului |
| sender_address.entrance | string | Nu | Scara expediatorului |
| sender_address.floor | string | Nu | Etajul expediatorului |
| sender_address.entrance_code | string | Nu | Codul de intrare a expediatorului |
| sender_address.geolocation | string | Nu | Pozitia geografica a expediatorului |
| receiver_address.save_address | boolean | Nu | Salveaza adresa in contul utilizatorului |
| receiver_address.region | integer | Da | ID raion a destinatarului din nomenclatorul de raioane |
| receiver_address.city | integer | Da | ID oras a destinatarului din nomenclatorul de orase |
| receiver_address.street | string | Da | Strada destinatarului |
| receiver_address.house | string | Nu | Numarul casei destinatarului |
| receiver_address.zip_code | string | Nu | Codul postal a destinatarului |
| receiver_address.block | string | Da | Numarul blocului de locuit a destinatarului |
| receiver_address.office | string | Nu | Numarul oficiului destinatarului |
| receiver_address.entrance | string | Nu | Scara destinatarului |
| receiver_address.floor | string | Nu | Etajul destinatarului |
| receiver_address.entrance_code | string | Nu | Codul de intrare a destinatarului |
| receiver_address.geolocation | string | Nu | Pozitia geografica a destinatarului |
| receiver_address.receiver_address_additional | string | Nu | Specificați numele orașului, strada, blocul și codul poștal împărțit prin virgulă, în acest caz completarea lor separată nu este obligatorie |
| items[].weight | integer | Nu | Greutate colet, kg |
| items[].length | integer | Nu | Lungime colet, cm |
| items[].width | integer | Nu | Latime colet, cm |
| items[].height | integer | Nu | Inaltime colet, cm |
| items[].quantity | integer | Nu | Cantitate |
| items[].declared_amount | number | Nu | Valoarea declarata |
| items[].description | string | Da | Descriere |
| items[].item_type | integer | Da | ID tip colet, din nomenclatorul de tipuri |
| packages[].quantity | integer | Nu | Cantitate ambalaj necesara |
| packages[].package | integer | Da | ID tip ambalaj din nomenclatorul de ambajale |
| additional_services[] | integer | Nu | Lista de ID-uri din servicii aditionale comandate |
| sender_name | string | Nu | Nume expediator |
| sender_phone_number | integer | Nu | Telefon de contact expediator (lungimea minima 7 cifre) |
| sender_email | string | Nu | Email de contact expediator |
| sender_pickup_location | string | Nu | Modalitate de preluare a coletului: address, postal_office, postal_terminal |
| receiver_name | string | Nu | Nume destinatar |
| receiver_phone_number | integer | Nu | Telefon de contact destinatar (lungimea minima 7 cifre) |
| receiver_email | string | Nu | Email de contact destinatar |
| receiver_pickup_location | string | Nu | Modalitate de primire a coletului: address, postal_office, postal_terminal |
| additional_info_general | string | Nu | Informatii aditionale generale |
| additional_info_client | string | Nu | Informatii aditionale client |
| additional_info_awb | string | Nu | Informatii aditionale AWB |
| payment_type | string | Nu | Modalitate de plata: credit_card, cash, receiver_cash, transfer |
| cash_on_delivery_amount | string | Nu | Suma ramburs |
| declared_amount | string | Nu | Valoare totala declarata |
| payer | string | Nu | Platitor: sender, receiver |
| awb_number | string | Nu | Numar AWB |
| pickup_date | string | Nu | Data recomandata de preluare a coletului |
| sender_postal_office | integer | Nu | ID oficiu postal expediator, necesar doar la tipul de preluare postal_office |
| receiver_postal_office | integer | Nu | ID oficiu postal destinatar, necesar doar la tipul de livarea postal_office |
| items_single_package | boolean | Nu | Prin activarea acestei opțiuni, toate produsele din comandă vor fi grupate într-un singur ambalaj |
Calculează tariful
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.post('https://curier-rapid-api.posta.md/ecommerce/tariffs/calculate', headers=headers,
json={
"sender_address": {
"street": "bd. Ștefan cel Mare și Sfânt",
"block": "134",
"zip_code": "MD-2012",
"region": 2259,
"city": 14797
},
"receiver_address": {
"street": "bd. Ștefan cel Mare și Sfânt",
"block": "135",
"zip_code": "MD-2012",
"region": 2259,
"city": 14797
},
"items": [
{
"weight": 10,
"length": 200,
"width": 100,
"height": 300,
"quantity": 1,
"declared_amount": 0,
"description": "Aspirator",
"item_type": 1
}
],
"sender_name": "E Magazin SRL",
"sender_phone_number": 37368555666,
"sender_email": "info@emagazin.md",
"receiver_name": "Vasile Vasilescu",
"receiver_phone_number": 37368555777,
"receiver_email": "vasile@example.com",
"payment_type": "cash",
"cash_on_delivery_amount": "6000",
"declared_amount": "6000",
"payer": "receiver"
})
print(r.json())
$curl = curl_init('https://curier-rapid-api.posta.md/ecommerce/tariffs/calculate');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
"sender_address" => [
"street" => "bd. Ștefan cel Mare și Sfânt",
"block" => "134",
"zip_code" => "MD-2012",
"region" => 2259,
"city" => 14797
],
"receiver_address" => [
"street" => "bd. Ștefan cel Mare și Sfânt",
"block" => "135",
"zip_code" => "MD-2012",
"region" => 2259,
"city" => 14797
],
"items" => [
[
"weight" => 10,
"length" => 200,
"width" => 100,
"height" => 300,
"quantity" => 1,
"declared_amount" => 0,
"description" => "Aspirator",
"item_type" => 1
]
],
"sender_name" => "E Magazin SRL",
"sender_phone_number" => 37368555666,
"sender_email" => "info@emagazin.md",
"receiver_name" => "Vasile Vasilescu",
"receiver_phone_number" => 37368555777,
"receiver_email" => "vasile@example.com",
"payment_type" => "cash",
"cash_on_delivery_amount" => "6000",
"declared_amount" => "6000",
"payer" => "receiver"
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Exemplu obiect JSON expediat
{
"sender_address": {
"street": "bd. Ștefan cel Mare și Sfânt",
"block": "134",
"zip_code": "MD-2012",
"region": 2259,
"city": 14797
},
"receiver_address": {
"street": "bd. Ștefan cel Mare și Sfânt",
"block": "135",
"zip_code": "MD-2012",
"region": 2259,
"city": 14797
},
"items": [
{
"weight": 10,
"length": 200,
"width": 100,
"height": 300,
"quantity": 1,
"declared_amount": 0,
"description": "Aspirator",
"item_type": 1
}
],
"sender_name": "E Magazin SRL",
"sender_phone_number": 37368555666,
"sender_email": "info@emagazin.md",
"receiver_name": "Vasile Vasilescu",
"receiver_phone_number": 37368555777,
"receiver_email": "vasile@example.com",
"payment_type": "cash",
"cash_on_delivery_amount": "6000",
"declared_amount": "6000",
"payer": "receiver"
}
Exemplu de raspuns cu success
{
"cost": 3,
"estimated_days": 3
}
POST https://curier-rapid-api.posta.md/ecommerce/tariffs/calculate
Find companies based on search criteria
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| sender_address.save_address | boolean | Nu | Salveaza adresa in contul utilizatorului |
| sender_address.region | integer | Da | ID raion a expediatorului din nomenclatorul de raioane |
| sender_address.city | integer | Da | ID oras a expediatorului din nomenclatorul de orase |
| sender_address.street | string | Da | Strada expediatorului |
| sender_address.geolocation | string | Nu | Pozitia geografica a expediatorului |
| receiver_address.save_address | boolean | Nu | Salveaza adresa in contul utilizatorului |
| receiver_address.region | integer | Da | ID raion a destinatarului din nomenclatorul de raioane |
| receiver_address.city | integer | Da | ID oras a destinatarului din nomenclatorul de orase |
| receiver_address.street | string | Da | Strada destinatarului |
| receiver_address.geolocation | string | Nu | Pozitia geografica a destinatarului |
| items[].weight | integer | Nu | Greutate colet, kg |
| items[].length | integer | Nu | Lungime colet, cm |
| items[].width | integer | Nu | Latime colet, cm |
| items[].height | integer | Nu | Inaltime colet, cm |
| items[].quantity | integer | Nu | Cantitate |
| items[].declared_amount | integer | Nu | Cantitate |
| packages[].quantity | integer | Nu | Cantitate ambalaj necesara |
| packages[].package | integer | Da | ID tip ambalaj din nomenclatorul de ambajale |
| additional_services[] | integer | Nu | Lista de ID-uri din servicii aditionale comandate |
| sender_pickup_location | string | Nu | Modalitate de preluare a coletului: address, postal_office, postal_terminal |
| receiver_pickup_location | string | Nu | Modalitate de primire a coletului: address, postal_office, postal_terminal |
| cash_on_delivery_amount | string | Nu | Suma ramburs |
| declared_amount | string | Nu | Valoare totala declarata |
| sender_postal_office | integer | Nu | ID oficiu postal expediator, necesar doar la tipul de preluare postal_office |
| receiver_postal_office | integer | Nu | ID oficiu postal destinatar, necesar doar la tipul de livarea postal_office |
Listă comenzi
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://curier-rapid-api.posta.md/ecommerce/shipping', params={
"page": 1,
"per_page": 50,
"ordering": "-created_at",
}, headers=headers)
print(r.json())
$curl = curl_init('https://curier-rapid-api.posta.md/ecommerce/shipping?' . http_build_query([
"page" => 1,
"per_page" => 50,
"ordering" => "-created_at",
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Exemplu de raspuns cu success
{
"count": 4,
"total_pages": 1,
"per_page": 10,
"current_page": 1,
"results": [
{
"id": 331,
"shipping_number": "LC0000000000403",
...
},
{
"id": 332,
"shipping_number": "LC0000000000404",
...
}
]
}
GET https://curier-rapid-api.posta.md/ecommerce/shipping
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| ordering | string | Nu | Filtrare dupa: -awb_number, -cost, -group__code, -is_paid, -items__weight, -receiver_name, -sender_name, -shipping_number, -status, awb_number, cost, group__code, is_paid, items__weight, receiver_name, sender_name, shipping_number, status |
| is_paid | boolean | Nu | Filtru platit sau nu |
| status | string | Nu | Filtru dupa statut |
| shipping_number | string | Nu | Filtru dupa numberul trimiterii |
| created_at_from | string | Nu | Filtru dupa data de creare incapand cu |
| created_at_to | string | Nu | Filtru dupa data de creare pana la |
| page | integer | Nu | Numarul paginii |
| per_page | integer | Nu | Numarul de rezultate returnate pe pagina |
Detalii comandă
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://curier-rapid-api.posta.md/ecommerce/shipping/LC0000000000404',
headers=headers)
print(r.json())
$curl = curl_init('https://curier-rapid-api.posta.md/ecommerce/shipping/LC0000000000404');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Obtine detalii comanda dupa numarul comenzii
GET https://curier-rapid-api.posta.md/ecommerce/shipping/{shipping_number}
Anulare comandă
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.post('https://curier-rapid-api.posta.md/ecommerce/shipping/LC0000000000404/cancel',
headers=headers)
print(r.json())
$curl = curl_init('https://curier-rapid-api.posta.md/ecommerce/shipping/LC0000000000404/cancel');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Anulare comanda dupa numarul comenzii
POST https://curier-rapid-api.posta.md/ecommerce/shipping/{shipping_number}/cancel
Tracking comandă
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://curier-rapid-api.posta.md/ecommerce/shipping/LC0000000000404/logs',
headers=headers)
print(r.json())
$curl = curl_init('https://curier-rapid-api.posta.md/ecommerce/shipping/LC0000000000404/logs');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Lista evenimente de expediere dupa numarul comenzii
GET https://curier-rapid-api.posta.md/ecommerce/shipping/{shipping_number}/logs
Export AWB
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get(
'https://curier-rapid-api.posta.md/ecommerce/shipping/LC0000000000404/export-awb?export_type=pdf',
headers=headers)
# Salvare fisier
with open('awb.pdf', 'wb') as f:
f.write(r.content)
$curl = curl_init('https://curier-rapid-api.posta.md/ecommerce/shipping/LC0000000000404/export-awb?export_type=pdf');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, 0);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
$fp = fopen('awb.pdf', 'w');
fwrite($fp, $response);
fclose($fp);
Exporta comanda in format AWB PDF, ZPL, ESC
GET https://curier-rapid-api.posta.md/ecommerce/shipping/{shipping_number}/export-awb
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| export_type | string | Da | Tip export: pdf, zpl, esc |
Raioane
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://curier-rapid-api.posta.md/ecommerce/nomenclatures/regions', headers=headers)
print(r.json())
$curl = curl_init('https://curier-rapid-api.posta.md/ecommerce/nomenclatures/regions');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, 0);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Lista de raioane din Republica Moldova
GET https://curier-rapid-api.posta.md/ecommerce/nomenclatures/regions
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| search | string | Nu | Cautare dupa text |
Exemplu de raspuns cu success
{
"results": [
{
"id": 2035,
"modified_at": "2023-03-20T00:00:01.052731Z",
"created_at": "2022-05-16T14:15:58.847334Z",
"name": "mun. Bălţi",
"code": "2035",
"country": 2097
},
{
"id": 2034,
"modified_at": "2023-03-20T00:00:01.054905Z",
"created_at": "2022-05-16T14:15:58.875668Z",
"name": "mun. Chişinău",
"code": "2034",
"country": 2097
}
]
}
Orase
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://curier-rapid-api.posta.md/ecommerce/nomenclatures/cities', headers=headers)
print(r.json())
$curl = curl_init('https://curier-rapid-api.posta.md/ecommerce/nomenclatures/cities');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, 0);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Lista de localitati din Republica Moldova
GET https://curier-rapid-api.posta.md/ecommerce/nomenclatures/cities
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| region | string | Nu | Filtrare dupa ID raion din nomenclatoare |
| search | string | Nu | Cautare dupa text |
Exemplu de raspuns cu success
{
"results": [
{
"id": 4671,
"modified_at": "2023-02-21T00:00:02.360649Z",
"created_at": "2022-05-16T14:16:02.104571Z",
"name": "Abaclia",
"code": "4671",
"region": 2003
},
{
"id": 5626,
"modified_at": "2023-02-21T00:00:03.659181Z",
"created_at": "2022-05-16T14:16:04.895949Z",
"name": "Acui",
"code": "5626",
"region": 2006
}
]
}
Străzi
Code samples
import requests
r = requests.get('https://main-api.posta.md/nomenclatures/streets')
print(r.json())
$curl = curl_init('https://main-api.posta.md/nomenclatures/streets');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, 0);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Lista de străzi din Republica Moldova
GET https://main-api.posta.md/nomenclatures/streets
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| city | string | Nu | Filtrare dupa ID orașului din nomenclatoare |
| city_name | string | Nu | Filtrare dupa numele orașului din nomenclatoare |
| ordering | string | Nu | ordonare după: -name, |
| search | string | Nu | Cautare dupa text |
| page | integer | Nu | Numarul paginii |
| per_page | integer | Nu | Numarul de rezultate returnate pe pagina |
Exemplu de raspuns cu success
{
"count": 27274,
"total_pages": 2728,
"per_page": 2,
"current_page": 1,
"results": [
{
"id": 586251,
"modified_at": "2023-07-18T19:26:01.530356Z",
"created_at": "2022-03-28T09:49:08.392923Z",
"name": "02 Iunie 1941",
"code": "586251",
"city": 14886
},
{
"id": 273946,
"modified_at": "2023-07-18T20:12:20.031473Z",
"created_at": "2022-03-28T09:55:29.302779Z",
"name": "10 A. Mateevici",
"code": "273946",
"city": 15463
}
]
}
Blocuri
Code samples
import requests
r = requests.get('https://main-api.posta.md/nomenclatures/blocks')
print(r.json())
$curl = curl_init('https://main-api.posta.md/nomenclatures/blocks');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, 0);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Lista de blocuri din Republica Moldova
GET https://main-api.posta.md/nomenclatures/blocks
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| city | string | Nu | Filtrare dupa ID orașului din nomenclatoare |
| street | string | Nu | Filtrare dupa ID străyii din nomenclatoare |
| city_name | string | Nu | Filtrare dupa numele orașului din nomenclatoare |
| ordering | string | Nu | ordonare după: -name, |
| search | string | Nu | Cautare dupa text |
| page | integer | Nu | Numarul paginii |
| per_page | integer | Nu | Numarul de rezultate returnate pe pagina |
Exemplu de raspuns cu success
{
"count": 680572,
"total_pages": 68058,
"per_page": 2,
"current_page": 1,
"results": [
{
"id": 1195708,
"modified_at": "2023-07-20T17:29:39.734169Z",
"created_at": "2023-03-01T07:31:26.412218Z",
"name": "1",
"description": "r-nul Fălești, com. Egorovca, sat. Ciuluc, str. Svobodî 1",
"code": "MD-5916",
"street": 1195596
},
{
"id": 1244353,
"modified_at": "2023-07-18T22:19:35.731024Z",
"created_at": "2023-03-01T06:06:19.508268Z",
"name": "1",
"description": "r-nul Soroca, com. Vasilcău, sat. Vasilcău, str. Sfatul Еўării 1",
"code": "MD-3046",
"street": 1242948
}
]
}
Ambalaje
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://curier-rapid-api.posta.md/ecommerce/nomenclatures/packages',
headers=headers)
print(r.json())
$curl = curl_init('https://curier-rapid-api.posta.md/ecommerce/nomenclatures/packages');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Lista de ambalaje disponibile
GET https://curier-rapid-api.posta.md/ecommerce/nomenclatures/packages
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| search | string | Nu | Cautare dupa text |
Oficii postale
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://curier-rapid-api.posta.md/ecommerce/nomenclatures/postal-offices',
headers=headers)
print(r.json())
$curl = curl_init('https://curier-rapid-api.posta.md/ecommerce/nomenclatures/postal-offices');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Listeaza oficii postale, post terminale, centre de colectare si depozite
GET https://curier-rapid-api.posta.md/ecommerce/nomenclatures/postal-offices
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| office_type | string | Nu | Filtrare dupa tip: post_office, post_agency, post_center, fast_courier_center, post_terminal, transit_center, deposit |
| search | string | Nu | Cautare dupa text |
| zip_code | string | Nu | Cautare dupa cod postal |
Tip trimiteri
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://curier-rapid-api.posta.md/ecommerce/nomenclatures/item-types',
headers=headers)
print(r.json())
$curl = curl_init('https://curier-rapid-api.posta.md/ecommerce/nomenclatures/item-types');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Tipurile de trimiteri disponibile
GET https://curier-rapid-api.posta.md/ecommerce/nomenclatures/item-types
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| search | string | Nu | Cautare dupa text |
Servicii Adiționale pentru Trimiteri
Exemple de cod
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://curier-rapid-api.posta.md/ecommerce/additional-services',
headers=headers)
print(r.json())
$curl = curl_init('https://curier-rapid-api.posta.md/ecommerce/additional-services');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Lista de servicii adiționale de transportare
GET https://curier-rapid-api.posta.md/ecommerce/additional-services
Parametri
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| search | string | Nu | Cautare dupa text |
Statuturile trimiterii
Statuturile posibile ale trimiterii
| Code | Description |
|---|---|
| draft | Trimiterea a fost creată, dar nu și finalizată |
| created | Trimiterea a fost finalizată și a început procesul de livrare |
| pickup_courier_assigned | A fost atribuit curier pentru trimiterea dată |
| pickup_courier_accepted | Curierul atribuit a acceptat trimiterea |
| pickup_courier_rejected | Curierul atribuit a refuzat trimiterea |
| price_recalculated | Prețul trimiterii a fost recalculat de către curier |
| pickup_confirm_shipment | Trimiterea a fost ridicată de către curier |
| pickup_failed | A apărut o problemă la ridicarea trimiterii |
| returned | Trimiterea a fost întoarsă expediatorului |
| failed | A apărut o eroare în procesul de livrare |
| delivered | Trimiterea a fost livrată cu succes |
| completed | Trimiterea sa finalizată cu succes |
| deposit_received | Trimiterea a fost primită la depozit |
| deposit_released | Trimiterea a fost trimisă de la deposit |
| abandoned | Trimiterea a fost abandonată |
| canceled | Trimiterea a fost anulată |
| destroyed | Trimiterea a fost distrusă |
Trimiteri postale
Listează, crează, anulează și urmărește comenzile.
Crează lista comenzi
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.post('https://trimiteri-api.posta.md/ecommerce/shipping', json={
"sender_address": {
"street": "bd. Ștefan cel Mare și Sfânt",
"block": "135",
"zip_code": "2001",
"country": 2097,
"region_name": "Budapest",
"city_name": "Budapest"
},
"sender_name": "E Magazin SRL",
"sender_phone_number": 37368555666,
"sender_email": "info@emagazin.md",
"payment_type": "transfer",
"cash_on_delivery_amount": 12,
"declared_amount": 100,
"ask_courier": True,
"shipping_type": "104",
"delivery_method": "02",
"delivery_region": "06",
"priority": "02",
"post_colet_return": True,
}, headers=headers)
print(r.json())
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/shipping');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
"sender_address" => [
"street" => "bd. Ștefan cel Mare și Sfânt",
"block" => "135",
"zip_code" => "2001",
"country" => 2097,
"region_name" => "Budapest",
"city_name" => "Budapest"
],
"sender_name" => "E Magazin SRL",
"sender_phone_number" => 37368555666,
"sender_email" => "info@emagazin.md",
"payment_type" => "transfer",
"cash_on_delivery_amount" => 12,
"declared_amount" => 100,
"ask_courier" => True,
"shipping_type" => "104",
"delivery_method" => "02",
"delivery_region" => "06",
"priority" => "02",
"post_colet_return" => True
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Exemplu obiect JSON expediat
{
"sender_address": {
"street": "bd. Ștefan cel Mare și Sfânt",
"block": "135",
"zip_code": "2001",
"country": 2097,
"region_name": "Budapest",
"city_name": "Budapest"
},
"sender_name": "E Magazin SRL",
"sender_phone_number": 37368555666,
"sender_email": "info@emagazin.md",
"payment_type": "transfer",
"cash_on_delivery_amount": 12,
"declared_amount": 100,
"ask_courier": true,
"shipping_type": "104",
"delivery_method": "02",
"delivery_region": "06",
"priority": "02",
"post_colet_return": true
}
Exemplu de raspuns cu success
{
"id": 114,
"sender_address": {
"id": 920,
"region": null,
"country": {
"id": 2097,
"modified_at": "2022-01-27T11:29:35.736922Z",
"created_at": "2022-01-27T11:29:35.734337Z",
"name": "Moldova, Republic of",
"code": "MD"
},
"city": null,
"modified_at": "2022-03-10T07:57:47.660220Z",
"created_at": "2022-03-10T07:57:47.659859Z",
"region_name": "Budapest",
"city_name": "Budapest",
"zip_code": "2001",
"street": "bd. Ștefan cel Mare și Sfânt",
"house": null,
"block": "135",
"office": null,
"entrance": null,
"floor": null,
"entrance_code": null,
"geolocation": null
},
"shipping_type": {
"code": "104",
"modified_at": "2022-01-20T16:19:43.243861Z",
"created_at": "2022-01-20T15:57:56.178939Z",
"name": "Pachete Mici",
"description": "Posta de scrisori Pachete Mici",
"is_active": true
},
"delivery_method": {
"code": "02",
"modified_at": "2022-01-20T16:21:57.328225Z",
"created_at": "2022-01-20T15:57:56.582258Z",
"name": "Recomandate",
"description": "Simplu/rec/VD Recomandate",
"is_active": true
},
"delivery_region": {
"code": "06",
"modified_at": "2022-01-20T16:22:43.089148Z",
"created_at": "2022-01-20T16:00:48.447399Z",
"name": "Internaționale ieșire",
"description": "loco/national/internațional Internaționale",
"is_active": true
},
"priority": {
"code": "02",
"modified_at": "2022-01-20T16:21:47.777208Z",
"created_at": "2022-01-20T16:00:48.194537Z",
"name": "Prioritar",
"description": "Prioritar/neprioritar prioritar",
"is_active": true
},
"is_international": false,
"total_declaration_cost": null,
"total_declared_amount": null,
"total_weight": null,
"fields": null,
"items_count": null,
"modified_at": "2022-03-10T07:57:51.894115Z",
"created_at": "2022-03-10T07:57:47.705543Z",
"sender_name": "E Magazin SRL",
"sender_phone_number": 37368555666,
"sender_email": "info@emagazin.md",
"payment_type": "transfer",
"cost": null,
"base_cost": null,
"recalculated_cost": null,
"is_paid": false,
"order_key": null,
"recalculation_order_key": null,
"cash_on_delivery_amount": 0,
"declared_amount": 0,
"status": "draft",
"group_number": null,
"pickup_at": null,
"delivered_at": null,
"declaration_type": "cn22",
"ask_courier": true,
"fast_courier_id": null,
"fast_courier_tariff": 3,
"customers_service_id": null,
"created_by": 186,
"account": 197,
"packages": [],
"post_colet_return": true
}
POST https://trimiteri-api.posta.md/ecommerce/shipping
Find companies based on search criteria
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| sender_address.save_address | boolean | Nu | Salveaza adresa in contul utilizatorului |
| sender_address.region | integer | Da | ID raion a expediatorului din nomenclatorul de raioane |
| sender_address.city | integer | Da | ID oras a expediatorului din nomenclatorul de orase |
| sender_address.street | string | Da | Strada expediatorului |
| sender_address.block | string | Da | Numarul blocului de locuit a expediatorului |
| sender_address.house | string | Nu | Numarul casei expediatorului |
| sender_address.zip_code | string | Nu | Codul postal a expediatorului |
| sender_address.office | string | Nu | Numarul oficiului expediatorului |
| sender_address.entrance | string | Nu | Scara expediatorului |
| sender_address.floor | string | Nu | Etajul expediatorului |
| sender_address.entrance_code | string | Nu | Codul de intrare a expediatorului |
| sender_address.geolocation | string | Nu | Pozitia geografica a expediatorului |
| sender_name | string | Da | Nume expediator |
| sender_phone_number | integer | Da | Telefon de contact expediator (lungimea minima 7 cifre) |
| sender_email | string | Da | Email de contact expediator |
| payment_type | string | Nu | Modalitate de plata: credit_card, cash, transfer |
| cash_on_delivery_amount | number | Nu | Suma ramburs |
| declared_amount | number | Nu | Valoare totala declarata |
| shipping_type | string | Da | Cod-ul tipului trimiterilor, din numenclator |
| delivery_method | string | Da | Cod-ul metodei de livrare a trimiterilor, din numenclator |
| delivery_region | string | Da | Cod-ul regiunii de livrare a trimiterilor, din numenclator |
| priority | string | Nu | Cod-ul regiunii de livrare a trimiterilor, din numenclator |
| ask_courier | boolean | Nu | In cazul in care va primi valoarea true va fi solicitat curier pentru ridicarea acestei liste de colete |
| post_colet_return | boolean | Nu | Marcheaza trimiterea ca fiind de tip retur. Este permisa trimiterea doar avand contract de tip Post Colet Retur semnat |
Adaugare trimitere in lista de trimiteri
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.post('https://trimiteri-api.posta.md/ecommerce/shipping/114/items', json={
"receiver_address": {
"street": "bd. Ștefan cel Mare și Sfânt",
"block": "134",
"zip_code": "2001",
"country": 2097,
"region_name": "Budapest",
"city_name": "Budapest"
},
"receiver_name": "Vasile Vasilescu",
"receiver_phone_number": 37368555777,
"receiver_email": "vasile@example.com",
"weight": 0.2,
"description": "Aspirator",
"additional_service": "92"
}, headers=headers)
print(r.json())
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/shipping/114/items');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
"receiver_address" => [
"street" => "bd. Ștefan cel Mare și Sfânt",
"block" => "134",
"zip_code" => "2001",
"country" => 2097,
"region_name" => "Budapest",
"city_name" => "Budapest"
],
"receiver_name" => "Vasile Vasilescu",
"receiver_phone_number" => 37368555777,
"receiver_email" => "vasile@example.com",
"weight" => 0.2,
"description" => "Aspirator",
"additional_service" => "92"
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Exemplu obiect JSON expediat
{
"receiver_address": {
"street": "bd. Ștefan cel Mare și Sfânt",
"block": "134",
"zip_code": "2001",
"country": 2097,
"region_name": "Budapest",
"city_name": "Budapest"
},
"receiver_name": "Vasile Vasilescu",
"receiver_phone_number": 37368555777,
"receiver_email": "vasile@example.com",
"weight": 0.2,
"description": "Aspirator",
"additional_service": "92"
}
Exemplu de raspuns cu success
{
"id": 167,
"receiver_address": {
"id": 921,
"region": null,
"country": {
"id": 2097,
"modified_at": "2022-01-27T11:29:35.736922Z",
"created_at": "2022-01-27T11:29:35.734337Z",
"name": "Moldova, Republic of",
"code": "MD"
},
"city": null,
"modified_at": "2022-03-10T07:58:03.016967Z",
"created_at": "2022-03-10T07:58:03.016248Z",
"region_name": "Budapest",
"city_name": "Budapest",
"zip_code": "2001",
"street": "bd. Ștefan cel Mare și Sfânt",
"house": null,
"block": "134",
"office": null,
"entrance": null,
"floor": null,
"entrance_code": null,
"geolocation": null
},
"declaration": {
"shipping_item": null,
"status": null,
"declaration_type": null,
"declared_amount": null,
"cash_on_delivery_amount": null,
"declared_amount_words": "",
"cash_on_delivery_amount_words": "",
"created_by": null,
"cost": null
},
"has_declaration": false,
"modified_at": "2022-03-10T07:58:03.053091Z",
"created_at": "2022-03-10T07:58:03.052375Z",
"status": "draft",
"weight": 0.2,
"length": 0,
"width": 0,
"height": 0,
"quantity": 1,
"declared_amount": 0,
"cash_on_delivery_amount": 0,
"description": "Aspirator",
"receiver_name": "Vasile Vasilescu",
"receiver_phone_number": 37368555777,
"receiver_email": "vasile@example.com",
"awb_number": null,
"tariff": 0,
"tariff_id": null,
"shipping": "114",
"additional_service": {
"code": "92",
"modified_at": "2022-01-20T16:22:39.129496Z",
"created_at": "2022-01-20T16:19:08.800742Z",
"name": "Cu confirmare de primire recomandata (CN-07)",
"description": "Servicii suplimentare Cu confirmare de primire recomandata (CN-07)",
"is_active": true,
"has_in_transfers": false
}
}
POST https://trimiteri-api.posta.md/ecommerce/shipping/{shipping_id}/items
Find companies based on search criteria
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| receiver_address.region | integer | Da | ID raion a destinatarului din nomenclatorul de raioane |
| receiver_address.city | integer | Da | ID oras a destinatarului din nomenclatorul de orase |
| receiver_address.street | string | Da | Strada destinatarului |
| receiver_address.block | string | Da | Numarul casei destinatarului |
| receiver_address.zip_code | string | Nu | Codul postal a destinatarului |
| receiver_address.house | string | Nu | Numarul blocului de locuit a destinatarului |
| receiver_address.office | string | Nu | Numarul oficiului destinatarului |
| receiver_address.entrance | string | Nu | Scara destinatarului |
| receiver_address.floor | string | Nu | Etajul destinatarului |
| receiver_address.entrance_code | string | Nu | Codul de intrare a destinatarului |
| receiver_address.geolocation | string | Nu | Pozitia geografica a destinatarului |
| receiver_name | string | Nu | Nume destinatar |
| receiver_phone_number | integer | Nu | Telefon de contact destinatar (lungimea minima 7 cifre) |
| receiver_email | string | Nu | Email de contact destinatar |
| awb_number | string | Nu | Numarul awb in dependenta de diapazon |
| cash_on_delivery_amount | number | Nu | Suma ramburs |
| declared_amount | number | Nu | Valoare totala declarata |
| additional_service | string | Nu | Serviciu aditional |
| weight | number | Nu/Da | Greutatea trimiterii, este obligatorie în cazul în care este prezentă declarația. |
| length | number | Nu | Lungimea trimiterii |
| width | number | Nu | Latimea trimiterii |
| height | number | Nu | Inaltimea trimiterii |
| quantity | number | Nu | Cantitatea trimiterii |
| declaration.items[].description | string | Da | Descrierea obiectului din declaratie |
| declaration.items[].weight | string | Nu | Greutatea obiectului din declaratie |
| declaration.items[].quantity | integer | Nu | Cantitatea obiectului din declaratie |
| declaration.items[].declared_amount | number | Nu | Valoarea declarata obiectului din declaratie |
| declaration.items[].tariff_number | number | Nu | Numarul tarifului obiectului din declaratie |
| declaration.items[].country | integer | Nu | Tara de origine al obiectului din declaratie |
| declaration.postal_fees | number | Nu | Taxa postala a declaratiei |
| declaration.declared_amount | number | Nu | Valoarea declarata a declaratiei |
| declaration.declared_amount_words | number | Nu | Valoarea declarata in litere a declaratiei |
| declaration.cash_on_delivery_amount | number | Nu | Suma ramburs a declaratiei |
| declaration.description | string | Nu | Dexcrierea declaratiei |
Calculeaza tariful trimiterii
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.post('https://trimiteri-api.posta.md/ecommerce/shipping/check-tariff', json={
"shipping_type": "104",
"delivery_method": "05",
"delivery_region": "02",
"ask_courier": True,
"priority": None,
"sender_address": {
"country": 2097,
"city": 14595,
"region": 2231,
"street": "Mircea cel Batran 33/5"
},
"sender_name": "Mihai",
"sender_email": "ion@gmail.com",
"items": [
{
"receiver_address": {
"country": 2097,
"city": 14595,
"region": 2231,
"street": "Mircea cel Batran 33/5"
},
"weight": 12,
"quantity": 23,
"declared_amount": 10
},
{
"receiver_address": {
"country": 2097,
"city": 14595,
"region": 2231,
"street": "Mircea cel Batran 33/5"
},
"weight": 12,
"quantity": 23,
"declared_amount": 10
}
]
}, headers=headers)
print(r.json())
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/shipping/check-tariff');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
"shipping_type" => "104",
"delivery_method" => "05",
"delivery_region" => "02",
"ask_courier" => true,
"priority" => null,
"sender_address => [
"country" => 2097,
"city" => 14595,
"region" => 2231,
"street" => "Mircea cel Batran 33/5"
],
"sender_name" => "Mihai",
"sender_email" => "ion@gmail.com",
"items" => [
[
"receiver_address" => [
"country" => 2097,
"city" => 14595,
"region => 2231,
"street" => "Mircea cel Batran 33/5"
],
"weight" => 12,
"quantity" => 23,
"declared_amount" => 10
],
[
"receiver_address" => [
"country" => 2097,
"city" => 14595,
"region" => 2231,
"street" => "Mircea cel Batran 33/5"
],
"weight" => 12,
"quantity" => 23,
"declared_amount" => 10
]
]
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Exemplu obiect JSON expediat
{
"shipping_type": "104",
"delivery_method": "05",
"delivery_region": "02",
"ask_courier": true,
"priority": null,
"sender_address": {
"country": 2097,
"city": 14595,
"region": 2231,
"street": "Mircea cel Batran 33/5"
},
"sender_name": "Mihai",
"sender_email": "ion@gmail.com",
"items": [
{
"receiver_address": {
"country": 2097,
"city": 14595,
"region": 2231,
"street": "Mircea cel Batran 33/5"
},
"weight": 12,
"quantity": 23,
"declared_amount": 10
},
{
"receiver_address": {
"country": 2097,
"city": 14595,
"region": 2231,
"street": "Mircea cel Batran 33/5"
},
"weight": 12,
"quantity": 23,
"declared_amount": 10
}
]
}
Exemplu de raspuns cu success
{
"fast_courier_tariff": 3,
"base_cost": 230,
"cost": 233,
"items": [
{
"base_tariff": 115,
"additional_service_tariff": 0,
"tariff": 115
},
{
"base_tariff": 115,
"additional_service_tariff": 0,
"tariff": 115
}
]
}
POST https://trimiteri-api.posta.md/ecommerce/shipping/check-tariff
Find companies based on search criteria
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| sender_address.save_address | boolean | Nu | Salveaza adresa in contul utilizatorului |
| sender_address.region | integer | Da | ID raion a expediatorului din nomenclatorul de raioane |
| sender_address.city | integer | Da | ID oras a expediatorului din nomenclatorul de orase |
| sender_address.street | string | Da | Strada expediatorului |
| sender_address.block | string | Da | Numarul blocului de locuit a expediatorului |
| sender_address.house | string | Nu | Numarul casei expediatorului |
| sender_address.zip_code | string | Nu | Codul postal a expediatorului |
| sender_address.office | string | Nu | Numarul oficiului expediatorului |
| sender_address.entrance | string | Nu | Scara expediatorului |
| sender_address.floor | string | Nu | Etajul expediatorului |
| sender_address.entrance_code | string | Nu | Codul de intrare a expediatorului |
| sender_address.geolocation | string | Nu | Pozitia geografica a expediatorului |
| sender_name | string | Da | Nume expediator |
| sender_phone_number | integer | Da | Telefon de contact expediator (lungimea minima 7 cifre) |
| sender_email | string | Da | Email de contact expediator |
| payment_type | string | Nu | Modalitate de plata: credit_card, cash, transfer |
| cash_on_delivery_amount | number | Nu | Suma ramburs |
| declared_amount | number | Nu | Valoare totala declarata |
| shipping_type | string | Da | Cod-ul tipului trimiterilor, din numenclator |
| delivery_method | string | Da | Cod-ul metodei de livrare a trimiterilor, din numenclator |
| delivery_region | string | Da | Cod-ul regiunii de livrare a trimiterilor, din numenclator |
| priority | string | Nu | Cod-ul regiunii de livrare a trimiterilor, din numenclator |
| ask_courier | boolean | Nu | In cazul in care v-a primi valoarea true va fi solicitat curier pentru ridicarea acestei liste de colete |
| items[].receiver_address.region | integer | Da | ID raion a destinatarului din nomenclatorul de raioane |
| items[].receiver_address.city | integer | Da | ID oras a destinatarului din nomenclatorul de orase |
| items[].receiver_address.street | string | Da | Strada destinatarului |
| items[].receiver_address.block | string | Da | Numarul casei destinatarului |
| items[].receiver_address.zip_code | string | Nu | Codul postal a destinatarului |
| items[].receiver_address.house | string | Nu | Numarul blocului de locuit a destinatarului |
| items[].receiver_address.office | string | Nu | Numarul oficiului destinatarului |
| items[].receiver_address.entrance | string | Nu | Scara destinatarului |
| items[].receiver_address.floor | string | Nu | Etajul destinatarului |
| items[].receiver_address.entrance_code | string | Nu | Codul de intrare a destinatarului |
| items[].receiver_address.geolocation | string | Nu | Pozitia geografica a destinatarului |
| items[].receiver_name | string | Nu | Nume destinatar |
| items[].receiver_phone_number | integer | Nu | Telefon de contact destinatar (lungimea minima 7 cifre) |
| items[].receiver_email | string | Nu | Email de contact destinatar |
| items[].cash_on_delivery_amount | number | Nu | Suma ramburs |
| items[].declared_amount | number | Nu | Valoare totala declarată |
| items[].weight | number | Nu | Greutatea trimiterii |
| items[].length | number | Nu | Lungimea trimiterii |
| items[].width | number | Nu | Latimea trimiterii |
| items[].height | number | Nu | Inaltimea trimiterii |
| items[].quantity | number | Nu | Cantitatea trimiterii |
Export declarație
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://trimiteri-api.posta.md/ecommerce/shipping/114/items/167/declaration', headers=headers)
# Salvare fisier
with open('awb.pdf', 'wb') as f:
f.write(r.content)
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/shipping/114/items/167/declaration');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, 0);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
$fp = fopen('awb.pdf', 'w');
fwrite($fp, $response);
fclose($fp);
Export declarație
POST https://trimiteri-api.posta.md/ecommerce/shipping/{shipping_id}/items/{id}/declaration
Export AWB
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://trimiteri-api.posta.md/ecommerce/shipping/114/items/167/awb', headers=headers)
# Salvare fisier
with open('awb.pdf', 'wb') as f:
f.write(r.content)
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/shipping/114/items/167/awb');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, 0);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
$fp = fopen('awb.pdf', 'w');
fwrite($fp, $response);
fclose($fp);
Export AWB
POST https://trimiteri-api.posta.md/ecommerce/shipping/{shipping_id}/items/{id}/awb
Printare adresa
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://trimiteri-api.posta.md/ecommerce/shipping/114/items/167/export-letter', headers=headers)
# Salvare fisier
with open('awb.pdf', 'wb') as f:
f.write(r.content)
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/shipping/114/items/167/export-letter');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, 0);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
$fp = fopen('awb.pdf', 'w');
fwrite($fp, $response);
fclose($fp);
Printare adresa
GET https://trimiteri-api.posta.md/ecommerce/shipping/{shipping_id}/items/{shipping_item_id}/export-letter
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| size | string | Nu | Exporta in marimea corespunzatoare valorii indicate (small, medium, large) |
Printare lista
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://trimiteri-api.posta.md/ecommerce/shipping/114/items/export', headers=headers)
# Salvare fisier
with open('awb.pdf', 'wb') as f:
f.write(r.content)
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/shipping/114/items/export');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, 0);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
$fp = fopen('awb.pdf', 'w');
fwrite($fp, $response);
fclose($fp);
Printare lista
POST https://trimiteri-api.posta.md/ecommerce/shipping/{shipping_id}/items/export
Stergere trimitere in lista de trimiteri
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.delete('https://trimiteri-api.posta.md/ecommerce/shipping/114/items/167', headers=headers)
print(r.json())
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/shipping/114/items/167');
curl_setopt($curl, CURLOPT_DELETE, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Sterge trimiterea din lista de comenzi
POST https://trimiteri-api.posta.md/ecommerce/shipping/{shipping_id}/items/{id}
Listă trimiteri din comanda
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://trimiteri-api.posta.md/ecommerce/shipping/114/items', params={
"page": 1,
"per_page": 50,
"ordering": "-created_at",
}, headers=headers)
print(r.json())
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/shipping/114/items?' . http_build_query([
"page" => 1,
"per_page" => 50,
"ordering" => "-created_at",
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Exemplu de raspuns cu success
{
"count": 4,
"total_pages": 1,
"per_page": 10,
"current_page": 1,
"results": [
{
"id": 331,
...
},
{
"id": 332,
...
}
]
}
GET https://trimiteri-api.posta.md/ecommerce/shipping/{shipping_id}/items
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| ordering | string | Nu | Ordonare |
| page | integer | Nu | Numarul paginii |
| per_page | integer | Nu | Numarul de rezultate returnate pe pagina |
Listă comenzi
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://trimiteri-api.posta.md/ecommerce/shipping', params={
"page": 1,
"per_page": 50,
"ordering": "-created_at",
}, headers=headers)
print(r.json())
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/shipping?' . http_build_query([
"page" => 1,
"per_page" => 50,
"ordering" => "-created_at",
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Exemplu de raspuns cu success
{
"count": 4,
"total_pages": 1,
"per_page": 10,
"current_page": 1,
"results": [
{
"id": 331,
...
},
{
"id": 332,
...
}
]
}
GET https://trimiteri-api.posta.md/ecommerce/shipping
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| ordering | string | Nu | Ordonare |
| status | string | Nu | Statutul curent al listei de trimiteri |
| shipping_type | string | Nu | Tipul trimiterilor din lista |
| page | integer | Nu | Numarul paginii |
| per_page | integer | Nu | Numarul de rezultate returnate pe pagina |
Detalii comanda
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://trimiteri-api.posta.md/ecommerce/shipping/104', headers=headers)
print(r.json())
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/shipping/104');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Obtine detalii comanda dupa id-ul comenzii
GET https://trimiteri-api.posta.md/ecommerce/shipping/{shipping_id}
Completează comanda
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.post('https://trimiteri-api.posta.md/ecommerce/shipping/104/complete', headers=headers)
print(r.json())
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/shipping/104/complete');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Completare comanda dupa id-ul comenzii
După apelarea acestui endpoint comanda își va schimba statutul increat și se va începe procesul de livrare
GET https://trimiteri-api.posta.md/ecommerce/shipping/{shipping_id}/complete
Anulare comanda
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://trimiteri-api.posta.md/ecommerce/shipping/104/cancel', headers=headers)
print(r.json())
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/shipping/104/cancel');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Anulare comanda dupa id-ul comenzii
GET https://trimiteri-api.posta.md/ecommerce/shipping/{shipping_id}/cancel
Țări
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://trimiteri-api.posta.md/ecommerce/nomenclatures/countries', headers=headers)
print(r.json())
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/nomenclatures/countries');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, 0);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Listă de țări disponimile
GET https://trimiteri-api.posta.md/ecommerce/nomenclatures/countries
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| search | string | Nu | Cautare dupa text |
| shipping_type | string | Nu | Codul tipului trimiterii |
| delivery_method | string | Nu | Codul metoda de livrare a trimiterii |
| delivery_region | string | Nu | Codul regiunea de livrare a trimiterii |
Raioane
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://trimiteri-api.posta.md/ecommerce/nomenclatures/regions', headers=headers)
print(r.json())
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/nomenclatures/regions');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, 0);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Lista de raioane disponibile
GET https://trimiteri-api.posta.md/ecommerce/nomenclatures/regions
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| country | string | Nu | Filtrare dupa ID country din nomenclatoare |
| search | string | Nu | Cautare dupa text |
Exemplu de raspuns cu success
{
"results": [
{
"id": 2035,
"modified_at": "2023-03-20T00:00:01.052731Z",
"created_at": "2022-05-16T14:15:58.847334Z",
"name": "mun. Bălţi",
"code": "2035",
"country": 2097
},
{
"id": 2034,
"modified_at": "2023-03-20T00:00:01.054905Z",
"created_at": "2022-05-16T14:15:58.875668Z",
"name": "mun. Chişinău",
"code": "2034",
"country": 2097
}
]
}
Orase
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://trimiteri-api.posta.md/ecommerce/nomenclatures/cities', headers=headers)
print(r.json())
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/nomenclatures/cities');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, 0);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Lista de localitati disponibile
GET https://trimiteri-api.posta.md/ecommerce/nomenclatures/cities
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| region | string | Nu | Filtrare dupa ID raion din nomenclatoare |
| search | string | Nu | Cautare dupa text |
Exemplu de raspuns cu success
{
"results": [
{
"id": 4671,
"modified_at": "2023-02-21T00:00:02.360649Z",
"created_at": "2022-05-16T14:16:02.104571Z",
"name": "Abaclia",
"code": "4671",
"region": 2003
},
{
"id": 5626,
"modified_at": "2023-02-21T00:00:03.659181Z",
"created_at": "2022-05-16T14:16:04.895949Z",
"name": "Acui",
"code": "5626",
"region": 2006
}
]
}
Străzi
Code samples
import requests
r = requests.get('https://main-api.posta.md/nomenclatures/streets')
print(r.json())
$curl = curl_init('https://main-api.posta.md/nomenclatures/streets');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, 0);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Lista de străzi din Republica Moldova
GET https://main-api.posta.md/nomenclatures/streets
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| city | string | Nu | Filtrare dupa ID orașului din nomenclatoare |
| city_name | string | Nu | Filtrare dupa numele orașului din nomenclatoare |
| ordering | string | Nu | ordonare după: -name, |
| search | string | Nu | Cautare dupa text |
| page | integer | Nu | Numarul paginii |
| per_page | integer | Nu | Numarul de rezultate returnate pe pagina |
Exemplu de raspuns cu success
{
"count": 27274,
"total_pages": 2728,
"per_page": 2,
"current_page": 1,
"results": [
{
"id": 586251,
"modified_at": "2023-07-18T19:26:01.530356Z",
"created_at": "2022-03-28T09:49:08.392923Z",
"name": "02 Iunie 1941",
"code": "586251",
"city": 14886
},
{
"id": 273946,
"modified_at": "2023-07-18T20:12:20.031473Z",
"created_at": "2022-03-28T09:55:29.302779Z",
"name": "10 A. Mateevici",
"code": "273946",
"city": 15463
}
]
}
Blocuri
Code samples
import requests
r = requests.get('https://main-api.posta.md/nomenclatures/blocks')
print(r.json())
$curl = curl_init('https://main-api.posta.md/nomenclatures/blocks');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, 0);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Lista de blocuri din Republica Moldova
GET https://main-api.posta.md/nomenclatures/blocks
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| city | string | Nu | Filtrare dupa ID orașului din nomenclatoare |
| street | string | Nu | Filtrare dupa ID străyii din nomenclatoare |
| city_name | string | Nu | Filtrare dupa numele orașului din nomenclatoare |
| ordering | string | Nu | ordonare după: -name, |
| search | string | Nu | Cautare dupa text |
| page | integer | Nu | Numarul paginii |
| per_page | integer | Nu | Numarul de rezultate returnate pe pagina |
Exemplu de raspuns cu success
{
"count": 680572,
"total_pages": 68058,
"per_page": 2,
"current_page": 1,
"results": [
{
"id": 1195708,
"modified_at": "2023-07-20T17:29:39.734169Z",
"created_at": "2023-03-01T07:31:26.412218Z",
"name": "1",
"description": "r-nul Fălești, com. Egorovca, sat. Ciuluc, str. Svobodî 1",
"code": "MD-5916",
"street": 1195596
},
{
"id": 1244353,
"modified_at": "2023-07-18T22:19:35.731024Z",
"created_at": "2023-03-01T06:06:19.508268Z",
"name": "1",
"description": "r-nul Soroca, com. Vasilcău, sat. Vasilcău, str. Sfatul Еўării 1",
"code": "MD-3046",
"street": 1242948
}
]
}
Oficii postale
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://trimiteri-api.posta.md/ecommerce/nomenclatures/postal-offices',
headers=headers)
print(r.json())
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/nomenclatures/postal-offices');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Listeaza oficii postale, post terminale, centre de colectare si depozite
GET https://trimiteri-api.posta.md/ecommerce/nomenclatures/postal-offices
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| office_type | string | Nu | Filtrare dupa tip: post_office, post_agency, post_center, fast_courier_center, post_terminal, transit_center, deposit |
| search | string | Nu | Cautare dupa text |
| zip_code | string | Nu | Cautare dupa cod postal |
Tip trimiteri
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://trimiteri-api.posta.md/ecommerce/nomenclatures/shipping-types',
headers=headers)
print(r.json())
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/nomenclatures/shipping-types');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Tipurile de trimiteri disponibile
GET https://trimiteri-api.posta.md/ecommerce/nomenclatures/shipping-types
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| search | string | Nu | Cautare dupa text |
Metode de livrare
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://trimiteri-api.posta.md/ecommerce/nomenclatures/delivery-methods', params={
"shipping_type": "101"
},
headers=headers)
print(r.json())
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/nomenclatures/delivery-methods?' . http_build_query([
"shipping_type" => "101"
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Metodele disponibile de livrare a trimiterilor
GET https://trimiteri-api.posta.md/ecommerce/nomenclatures/delivery-methods
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| shipping_type | string | Da | Codul tipului trimiterii |
| search | string | Nu | Cautare dupa text |
Regiunea de livrare
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://trimiteri-api.posta.md/ecommerce/nomenclatures/delivery-regions', params={
"shipping_type": "101",
"delivery_method": "01"
},
headers=headers)
print(r.json())
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/nomenclatures/delivery-regions?' . http_build_query([
"shipping_type" => "101",
"delivery_method" => "01"
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Regiunile disponibile de livrare a trimiterilor
GET https://trimiteri-api.posta.md/ecommerce/nomenclatures/delivery-regions
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| shipping_type | string | Da | Codul tipului trimiterii |
| delivery_method | string | Da | Codul metodei de livrare a trimiterii |
| search | string | Nu | Cautare dupa text |
Prioritatea expedierii
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://trimiteri-api.posta.md/ecommerce/nomenclatures/delivery-priorities', params={
"shipping_type": "101",
"delivery_method": "01",
"delivery_region": "01"
},
headers=headers)
print(r.json())
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/nomenclatures/delivery-priorities?' . http_build_query([
"shipping_type" => "101",
"delivery_method" => "01",
"delivery_region" => "01"
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Prioritatile disponibile de livrare a trimiterilor
GET https://trimiteri-api.posta.md/ecommerce/nomenclatures/delivery-priorities
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| shipping_type | string | Da | Codul tipului trimiterii |
| delivery_method | string | Da | Codul metodei de livrare a trimiterii |
| delivery_region | string | Da | Codul regiunii de livrare a trimiterii |
| search | string | Nu | Cautare dupa text |
Servicii aditionale
Code samples
import requests
headers = {
'Authorization': 'Token 00000000000000000000000000000000'
}
r = requests.get('https://trimiteri-api.posta.md/ecommerce/nomenclatures/additional-services', params={
"shipping_type": "101",
"delivery_method": "01",
"delivery_region": "01",
"priority": "00",
"country": 2097
},
headers=headers)
print(r.json())
$curl = curl_init('https://trimiteri-api.posta.md/ecommerce/nomenclatures/additional-services?' . http_build_query([
"shipping_type" => "101",
"delivery_method" => "01",
"delivery_region" => "01",
"priority" => "00",
"country" => 2097
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Token 00000000000000000000000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);
var_dump(json_decode($response));
Seviciile aditionale disponibile
GET https://trimiteri-api.posta.md/ecommerce/nomenclatures/additional-services
Parameters
| Nume parametru | Tip | Obligator | Descriere |
|---|---|---|---|
| shipping_type | string | Da | Codul tipului trimiterii |
| delivery_method | string | Da | Codul metodei de livrare a trimiterii |
| delivery_region | string | Da | Codul regiunii de livrare a trimiterii |
| priority | string | Da | Codul priotitatii de livrare a trimiterii |
| country | string | Da | ID-ul tarii de livrare a trimiterii |
| search | string | Nu | Cautare dupa text |
Statuturile trimiterii
Statuturile posibile ale trimiterii
| Code | Description |
|---|---|
| draft | Trimiterea a fost creată, dar nu și finalizată |
| created | Trimiterea a fost finalizată și a început procesul de livrare |
| canceled | Trimiterea a fost anulată |
| confirmed | Trimiterea a fost confirmata de catre posta |
| error | A aparut o eroare |
| pickup | Trimiterea a fost ridicată |
| delivered | Trimiterea a fost livrată |
| on_custom_validation | Trimiterea se află spre validare la vamă |
| free_of_customs | Trimiterea este liberă de vamă |
| invalidated_by_customs | Trimiterea nu a fost validată de vamă |