Description: Complete integration for managing Bartolini (BRT) shipments, allowing the creation, confirmation, and tracking of packages directly within the order management system.
What is it for? (Practical examples)
This tool is essential to optimize the workflow related to logistics and shipping.
- Quick Generation: Use it to immediately generate a new BRT shipment as soon as an order is received, without having to access external portals.
- Centralized Tracking: Keep track of the delivery status of all orders shipped with BRT directly from the sales list or order details.
- Size Management: Pre-configure the packaging dimensions of each product, allowing the system to automatically calculate the total volume and weight of the shipment.
Main Features
Shipment Management (Order Details)
By accessing the BRT sidebar panel within a sales order, you can perform the following operations:
- Create Shipment: Generate a new BRT shipment. The system automatically uses sender data (your company) and recipient data (the customer) and calculates weight and volume based on the products included in the order.
- Explicit Confirmation: If required by settings, you must confirm the shipment after creation. This operation sends a signal to BRT that the package is ready to be processed by the branch.
- Cancel Shipment: Allows cancellation of a created BRT shipment, provided it has not already been picked up by the courier.
- Status Display: Shows the unique parcel identifier (Parcel ID) and current shipment status, with a direct link for tracking on the BRT website.
Product Dimensions
Within each individual product's configuration tab, there is a dedicated section for BRT Dimensions where you can specify:
- Length (cm)
- Width (cm)
- Height (cm)
These data are fundamental for automatically calculating the total shipment volume at package creation time.
How to configure
Integration with BRT requires entering credentials and specific codes provided by the courier. Configuration takes place during plugin activation or via the "Settings/External Connections" section.
| Configuration Field | User Description | Example |
|---|---|---|
| BRT User ID | Your user code for accessing BRT APIs. | 0323007 |
| BRT Password | The password associated with your User ID. | (Hidden) |
| BRT Sender Customer Code | The customer code assigned by BRT for the sender (your company). | 0323007 |
| BRT Departure Depot | The code of the BRT branch from which your shipments depart. | 032 |
| BRT Default Service Code | The default shipping service code (e.g., C for Express, P for Priority). | C |
| BRT Pricing Condition Code | The pricing condition code agreed upon with BRT. | 300 |
| Confirmation Mode | Internal setting defining whether shipments are confirmed automatically or require manual "Confirm BRT Shipment" action. | Explicit |
Automatic integrations
Order Status Update
The module integrates with order management in two main ways:
1. Status Column in Sales List: Adds a column in the main sales list showing the current BRT shipment status (e.g., Not sent, Awaiting confirmation, Dispatched, Delivered).
2. Automatic Status Synchronization: The system runs a scheduled automatic operation (every 5 minutes) to query BRT servers. If parcel status changes (e.g., from "Dispatched" to "Delivered"), it automatically updates the saved BRT status in the order and, if mapped, can also update internal sales order status.
Size and Data Calculation
When creating a shipment, the system automatically retrieves and compiles these data:
- Sender Data: Address, contacts, and customer codes taken from company settings.
- Recipient Data: Address and contacts taken from order shipping information.
- Weight and Volume: Calculated by summing weight and dimensions (Length, Width, Height) of all products present in the order.
Key Differences
This module is specifically designed for direct interaction with Bartolini's (BRT) APIs. If you use other couriers, you will need to refer to their dedicated integration modules. Using this tool is recommended if BRT is your main logistics partner and you want to maximize automation of labels and tracking.
