OdooWiki OCA HUB

Delivery CBL

delivery_cbl folder_open OCA/delivery-carrier open_in_new
Delivery License: AGPL-3

This module adds CBL to the available carriers.

The following operations are supported:

  • Register shippings
  • Generate shipping labels when shippings are registered. The PDF is generated using the labelary API (http://api.labelary.com/).
  • Validate shippings (both manually and automatically)
  • Cancel shippings
  • Generate the CBL Manifest

auto_awesome What this module does

AI-generated from the code · Odoo 17.0

Adds CBL Logística as a delivery carrier in Odoo: register shipments, generate labels, confirm or cancel them, and print a CBL manifest.

This module lets you configure CBL Logística as a shipping carrier and manage its shipments directly from Odoo.

On the carrier form you get a new CBL tab where you enter the user, password, client code and client token, choose the freight type (collect or prepaid), decide whether cash on delivery applies, whether shipments need confirmation, and whether labels are produced as ZPL or PDF.

When you validate a delivery with a CBL carrier, Odoo sends the shipment to CBL, stores the tracking reference, and attaches the shipping labels to the delivery. If the carrier is set to require confirmation, the delivery stays unconfirmed until you confirm it.

On the delivery order you see a confirmed flag and a Confirm button. You can also select several deliveries in the list and use the Confirm CBL pickings action, which opens a wizard listing the eligible deliveries before confirming them. A daily scheduled job automatically confirms pending CBL shipments for carriers that need confirmation.

Cancelling a CBL shipment is supported and posts a message on the delivery. Finally, a CBL Manifest report can be generated from the manifest wizard for a carrier and date range, listing tracking numbers, deliveries, dates, contacts, packages and weights, with totals.

Depends on

delivery_package_numberbase_delivery_carrier_label
Models and fields (4)
  • stock.picking · extends an existing modelcbl_confirmed
  • manifest.wizard · extends an existing model
  • delivery.carrier · extends an existing modelcbl_user (User), cbl_password (Password), delivery_type, cbl_client_code (Client Code), cbl_client_token (Client Token), cbl_freight_type (Freight Type), cbl_label_format (Label Format), cbl_cash_on_delivery (Cash On Delivery), cbl_needs_confirmation (Needs Confirmation)
  • wizard.confirm.cbl.pickings · new modelpicking_ids

Text generated by AI (DeepSeek) from reading the Odoo 17.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 1 confirmed, 8 with no information of 9 versions.

Sources · Odoo 17.0

Confirmed on 2026-11-03 in branch 17.0 of OCA/delivery-carrier.

terminal Installation and usage

OCA documentation · Odoo 17.0

Configuration

Source · Odoo 17.0

To configure this module, you need to:

  • Add a Shipping Method with Provider CBL and introduce the User, Password, Client Code and Client Token.
  • Choose the "Collect" "Freight Type" if the delivery needs to be paid by the receiver, or the "Prepaid" type if it needs to be paid by the shipper.
  • Activate the "Cash On Delivery" option if shippings are paid by cash, assuming that the picking has a related sales order.
  • Activate the "Needs Confirmation" option if shippings need to be confirmed after the tracking number is created in order to be oficially included in the CBL pending shippings database. It is crucial to have the same configuration both in Odoo and in your CBL account. Contact CBL for more information on how they can configure this feature.

NOTE Contact CBL to get testing credentials.

Usage

Source · Odoo 17.0

To carry out the shipment, the shipping method previously created must be set on the delivery order:

  • Once the outgoing delivery is “Validated (Done)", the shipping information is automatically transmitted to CBL. If everything is correct, a tracking number and the corresponding labels are generated.
  • Shipments can be cancelled by clicking the "Cancel" button located next to the picking's tracking number. Keep in mind that using a carrier with the "Needs Confirmation" option unchecked, while having the opposite configuration set in CBL, may cause issues when attempting to cancel a shipment. In such cases, contact CBL so they can adjust the confirmation policy accordingly.
  • If a shipment could not be generated or has been cancelled, a new one can be created by clicking the "Send to Shipper" button at the top of the stock picking.
  • Shipments that require confirmation after the tracking number has been assigned can be confirmed as follows:
  • Individually: By clicking the "Confirm" button in the "Tracking Number" field, located under the "Additional Info" tab within the "Shipping Information" section.
  • [Improved] Bulk method: In the list view of outgoing deliveries, select all deliveries for the carrier whose status is “Validated (Done)", click the "Actions" gear icon → "Confirm CBL pickings". A wizard will appear listing the deliveries to be confirmed. Verify that all required pickings are included, then click the "Confirm Shipments" button.
  • Additionally, there is a scheduled action ("CBL: Confirm Shipments") that automatically validates pending CBL shipments once per day by default.
  • To generate the manifest, you need to Inventory > Operation > Manifest, select a CBL carrier and set the date range to select the picking.

No verified information in OCA: Installation.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.