REST API for shipments in Mexico
Una sola integración de Nexus para cotizar, generar guías y rastrear envíos con más de 30 paqueterías de México. Sin contratos por carrier, sin mensualidad y con saldo prepago compartido.

Nexus API
LOGISTICS
The Nexus API unifies the quotation, generation of guides, tracking, cancellation and collectionof over 30 Mexican carriers in a single integration. Instead of signing agreements and connecting with each carrier separately, you integrate a single API and Nexus orchestrate DHL, FedEx, Estafeta, Paquetexpress, UPS, J&T Express and many more for you, with real-time rates, PDF label and shared prepaid balance between your API, your online stores and the web platform.
API Endpoints
Returns real-time rates for over 30 carriers for a route, weight and dimensions. Public, no session required.
Create the guide, debit the balance and return tracking and PDF label. In the same call, you ensure the merchandise, declare customs data and group guides. Requires API Key and Secret.
Check the status and timeline of any guide by tracking number. Public, without keys.
Request, approve or cancel a guide. Refund the balance if the cancellation at the carrier is successful. Requires API Key and Secret.
Generate multiple guides in a single call, validating sufficient balance. Ideal for ERPs and operators. Requires API Key and Secret.
Schedule the collection at home of one or more shipments with date and time window. Requires API Key and Secret.
With a single call you consult balance, lists and detail of guides, webhook deliveries and the catalog of events. The action field chooses the operation. Requires API Key and Secret.
Base endpoint: https://app.app.bhgcnexuslogistics.com/functionsThe public documentation for developers (reference of endpoints, examples by language, webhooks and compatibility) is at API Docs.
Shipping types
Each shipment declares its type in the package_typefield. The quote engine treats each type separately — never mixes a package rate with a pallet or truck rate — and within the type the price is calculated by Weightwith dimensions from 1 to 300 cm. The most common aliases are normalized automatically, so box it is paquete y truck it is camion.
| package_type | Type | Maximum weight | Usage |
|---|---|---|---|
| over | Envelope | 70 kg | Documents and envelopes with guidealias: envelope · document |
| package | Package | 70 kg | Standard box or packagealias: box · caja |
| pallet | Pallet (LTL) | 1,000 kg | Consolidated cargo on palletalias: ltl |
| pallet | Pallet | 1,000 kg | Wooden stowage as its own typealias: zorra |
| truck | Full truck (FTL) | 1,000 kg | Dedicated shipment with complete unitalias: truck · ftl · trailer |
A package over 70 kg responds 400: heavy cargo is quoted by declaring tarima, pallet o camionwhich can weigh up to 1,000 kg. Live evidence of each type, with its requests, is in the API REST report.
Benefits of Nexus API
Connect once and access DHL, FedEx, Estafeta, Paquetexpress, UPS, J&T Express, Redpack, 99 Minutos, Ivoy, iMile and more, without individual contracts with each carrier.
Receive rate, delivery time, postal zone and billable weight in milliseconds. Compare and choose the best carrier by route, not by brand.
One wallet for your API, WooCommerce store, Shopify, TiendaNube and web platform. Load once and operate across all channels.
Each guide includes basic shipment protection service and PDF A6 label. With the declared value, you activate additional protection and Cudo coverage in the same call.
Send HS code, country of manufacture, reason for export, incoterm and declared parties with their exchange rate: the international guide is issued with Commercial Invoice and Carta Porte.
The platform updates your guide status automatically. If you prefer pull, check tracking whenever you want without webhooks.
The same API covers domestic and international shipments. Automatic destination detection and customs documentation included.
Quote example
The quote is public and does not require authentication. You send origin, destination, weight and dimensions; you receive each carrier’s rates with fee, delivery time and zone.
curl -X POST https://app.app.bhgcnexuslogistics.com/functions/publicQuoteShipments \
-H "Content-Type: application/json" \
-d '{
"origin_cp": "06600",
"dest_cp": "45050",
"package_type": "paquete",
"weight_kg": 2.5,
"length_cm": 30,
"width_cm": 20,
"height_cm": 15
}'
# Respuesta
{
"rates": [
{ "carrier": "NEXUS", "service": "Nexus Express", "total_cost": 189.20, "transit_days": 1 },
{ "carrier": "DHL", "service": "Express Nacional", "total_cost": 169.00, "transit_days": 1 },
{ "carrier": "Estafeta", "service": "Nacional", "total_cost": 138.50, "transit_days": 2 }
]
}Use cases
Integrate quoting and guide generation into your inventory and warehouse management system, with bulk upload and automatic tracking.
Connect your e-commerce (WooCommerce, Shopify, TiendaNube) to the same API to display rates at checkout and generate guides when selling.
Manage your customers' shipments with shared balance, per-customer rates, and consolidated reports in a single API.
Quote and generate guides from your app with the REST API, without integration fees or monthly charges.
Why it's better to integrate each carrier
| Feature | Nexus API | Direct integration |
|---|---|---|
| More than 30 carriers in one API | One API per carrier | |
| No individual contract with each carrier | Separate agreement | |
| Public quoting without token | Mandatory authentication | |
| Shared prepaid wallet across channels | Payment by guide with card | |
| Bulk guide upload in one call | Batch limit | |
| Webhooks managed by the platform | Manual configuration | |
| No monthly fee or rent | Monthly fee starting at $999 | |
| Human support via WhatsApp | Tickets and forums |
Webhooks and tracking
The platform manages carriers' webhooks internally and updates your guide status without configuration. If you prefer to check status on demand, use the endpoint /publicTrackShipment en cualquier momento. Para notificaciones en tu propio sistema registra la URL del webhook en tu llave: recibirás shipment.created, shipment.status_changed, shipment.cancelled y webhook.test, firmados con HMAC-SHA256 en el header X-BHGC-Webhook-Signature.