---
title: 40. BoxNow
description: "BoxNow este un serviciu de curierat pentru livrare la oficii poștale automate (APM) și dulapuri. În integrarea TrimiteIn BoxNow conectează sistemul la BoxNow Partner API prin OAuth2 și permite: creați și urmăriți expedierile; generarea etichetelor (PDF/ZPL); punct de livrareri de taxare/puncte de pr"
url: "https://trimitein.ro/docs/boxnow/"
updated: "2026-07-02"
category: Curieri
---

# 40. BoxNow

BoxNow este un serviciu de curierat pentru livrare la oficii poștale automate (APM) și dulapuri. În integrarea TrimiteIn`BoxNow`conectează sistemul la BoxNow Partner API prin OAuth2 și permite:

- creați și urmăriți expedierile;
- generarea etichetelor (PDF/ZPL);
- punct de livrareri de taxare/puncte de primire (puncte de service);
- calcularea prețului pe intervale de greutate;
- actualizare automată a punctelor (cron: în fiecare zi la 21:00).

## Cerințe preliminare

1. Contract BoxNow și acces la portalul partenerului.
2. Acreditări OAuth2 de la BoxNow:
   - Client ID
   - Client Secret
     Acestea sunt diferite de numele de utilizator/parola portalului web.

## Pasul 1: Creați integrarea BoxNow

Accesați Couriers → Configurare și selectați BoxNow. Setările sunt în două grupuri: Autentificare și Opțiuni generale.

## Pasul 2: Autentificare

| Domeniu | Descriere |
| --- | --- |
| Client ID | ID de client OAuth2 de la BoxNow |
| Client Secret | Secretul clientului OAuth2 de la BoxNow |

Fără acreditări valide, solicitările API vor returna erori de autentificare (coduri X403 etc.).

> Pentru testare puteți folosi serverul de scenă; pentru expedieri reale — producție.

## Pasul 3: Opțiuni generale

### API URL

| Valoare | Utilizare |
| --- | --- |
| Producție (implicit) | `https://api-production.boxnow.bg`- pentru expedieri reale |
| Stage | `https://api-stage.boxnow.bg`- pentru teste |

Dacă câmpul este gol, sistemul utilizează producția.

### Locație de origine implicită

Selectabil dintr-un meniu derulant (încărcat din API-ul BoxNow:`apps/boxnow/origins`).

- Acesta este depozitul/locația expeditorului din care provin transporturile.
- Implicit poate fi „Orice APM” (`any-apm`), dacă nu selectați o anumită locație.
- Pentru o funcționare stabilă, se recomandă alegerea unui anumit depozit contractat cu BoxNow.

### Restricționați returnările

- Dezactivat (implicit) — Sunt permise derulări.
- Activat - Retururile sunt interzise pentru expedierile din această integrare.

### Dimensiunea implicită a compartimentului

Se folosește atunci când lipsesc dimensiunile locului (locului) din expediție:

| Cod | Dimensiune | Dimensiuni maxime |
| --- | --- | --- |
| 1 | Small | până la 300×300×300 mm |
| 2 | Mediu (implicit) | până la 450×450×450 mm |
| 3 | Large | până la 600×600×600 mm |

### Intervalele de prețuri

Matrice JSON cu prețuri în funcție de greutate în grame:

> ```
> [ {"from": 0, "to": 3000, "price": 3}, {"from": 3001, "to": 6000, "price": 6}, {"from": 6001, "to": 10000, "price": 8}, {"from": 10001, "to": 20000, "price": 10} ]
> ```

- `from`- greutate minimă (incl.)
- `to`— greutate maximă (incl.); dacă lipsește — fără limită superioară
- `price`— prețul pentru gamă (ar putea fi`0`pentru transport gratuit)

Dacă nu configurați intervale, sunt utilizate valorile implicite încorporate (3 / 6 / 8 / 10 pentru greutățile corespunzătoare de până la 20 kg).

## Pasul 5: Tarife și puncte de ridicare

### Tarifar

Integrarea percepe un tarif:

- Nume: Rata implicită Boxnow
- Tip: autoservire/punct service (`TYPE_SELF_SERVICE_POINT`)
- ID extern:`88`

### Puncte de preluare (APM/Culatare)

- Punctele sunt sincronizate de API-ul BoxNow.
- Automat: în fiecare zi la ora 21:00 (cron`update-service-points`).
- Dacă este necesar, începeți încărcarea manuală de la administrația serviciului de curierat (dacă este disponibilă în instalația dvs.).

Când plasează o comandă, clientul trebuie să aleagă un punct de service BoxNow - fără acesta, expedierea nu poate fi exportată.

## Pasul 6: Cerințe la crearea unei expedieri

Când exportați în BoxNow, cererea trebuie să aibă:

| Domeniu | Obligatoriu |
| --- | --- |
| Numele destinatarului | Da |
| Numărul de telefon al destinatarului | Da |
| E-mailul destinatarului | Recomandat |
| Punct de service (locația BoxNow) | Da |
| Cel puțin un loc cu articole | Da |
| Numărul de urmărire lipsește | Da (transport nou) |

### Restricții

- Greutate maximă: 20.000 g (20 kg)
- Volumul maxim: 600×600×600 mm (216.000.000 mm³)
- Dacă este depășit, calculatorul/exportul returnează un mesaj de eroare.

### Ramburs la livrare si plata

- Comandă plătită → Mod preplătit (fără NP).
- Comandă neplătită → Mod COD (ramburs la livrare).

Suma de încasare include valoarea comenzii și, dacă este necesar, costul livrării (conform setărilor expeditorului/serviciului).

## Pasul 7: Etichete și urmărire

După exportul cu succes:

1. BoxNow returnează un ID de expediere și un număr de urmărire.
2. Din OrderAdmin, puteți imprima o etichetă (PDF sau ZPL) folosind serviciul de etichetă al integrării.
3. Stările sunt actualizate în funcție de API și de sarcinile de urmărire configurate.

La reîncercare, dacă expedierea a fost deja creată în BoxNow, dar nu există nicio urmărire în TrimiteIn, sistemul poate restaura datele din fișierul salvat. `exportResult` nicio solicitare API nouă.

## Pasul 8: Testarea înainte de producție

1. Setați adresa URL API = Etapă.
2. Introduceți ID-ul clientului de testare/Secretul din BoxNow.
3. Creați un transport de testare cu o greutate mică și un punct de testare valid.
4. Verificați: calcul → export → etichetă → urmărire.
5. Schimbați la acreditările de producție și producție înainte de comenzile reale.

## Probleme comune

| O problemă | Un posibil motiv | Soluţie |
| --- | --- | --- |
| Eroare de autentificare | ID/Secret client greșit | Verificați acreditările în portalul BoxNow |
| „Shipment service point is missing“ | Niciun punct BoxNow selectat | Selectați punctul de service la comanda |
| „No available rates found“ | Lipsește conexiunea/tariful | Verificați tarifele de conectare și încărcare |
| „Order is too heavy“ | Peste 20 kg | Împărțiți transportul sau alegeți alt serviciu |
| O listă goală de locații de origine | Acreditări nevalide sau integrare lipsă | Salvați autentificarea și reîncărcați formularul |
| Preț greșit în calcul | JSON nevalid în intervalele de preț | Remediați formatul JSON |