Skip to content

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

Nexus API

LOGISTICS

app.app.bhgcnexuslogistics.com https://app.app.bhgcnexuslogistics.com/functions Domain Brand
DHL Express FedEx UPS Estafeta Paquetexpress Redpack Quetzal Nuvee Carssa T1 Business Guatex 99 Minutos Drive Express Afimex Sendex Ivoy iMile Fletes México Tres Guerras AMPM Coordinadora FedEx Freight Almex Big Logistics Castores Delivery Send PuntoPost Uber J&T Express Yaslan Nexus Logistics DHL Express FedEx UPS Estafeta Paquetexpress Redpack Quetzal Nuvee Carssa T1 Business Guatex 99 Minutos Drive Express Afimex Sendex Ivoy iMile Fletes México Tres Guerras AMPM Coordinadora FedEx Freight Almex Big Logistics Castores Delivery Send PuntoPost Uber J&T Express Yaslan Nexus 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

POST/publicQuoteShipments
Quote shipment

Returns real-time rates for over 30 carriers for a route, weight and dimensions. Public, no session required.

POST/createShipmentLabel
Generate prepaid guide

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.

POST/publicTrackShipment
Track shipment

Check the status and timeline of any guide by tracking number. Public, without keys.

POST/cancelShipment
Cancel guide

Request, approve or cancel a guide. Refund the balance if the cancellation at the carrier is successful. Requires API Key and Secret.

POST/bulkCreateShipments
Bulk guide upload

Generate multiple guides in a single call, validating sufficient balance. Ideal for ERPs and operators. Requires API Key and Secret.

POST/schedulePickup
Schedule pickup

Schedule the collection at home of one or more shipments with date and time window. Requires API Key and Secret.

POST/apiIntegration
Balance, guides and webhooks

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_typeTypeMaximum weightUsage
overEnvelope70 kgDocuments and envelopes with guidealias: envelope · document
packagePackage70 kgStandard box or packagealias: box · caja
palletPallet (LTL)1,000 kgConsolidated cargo on palletalias: ltl
palletPallet1,000 kgWooden stowage as its own typealias: zorra
truckFull truck (FTL)1,000 kgDedicated 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

One integration, all carriers

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.

Real-time quote

Receive rate, delivery time, postal zone and billable weight in milliseconds. Compare and choose the best carrier by route, not by brand.

Shared prepaid balance

One wallet for your API, WooCommerce store, Shopify, TiendaNube and web platform. Load once and operate across all channels.

Labels and protection included

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.

Customs resolved by API

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.

Webhooks and tracking without configuration

The platform updates your guide status automatically. If you prefer pull, check tracking whenever you want without webhooks.

Domestic and international

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

ERPs and WMS

Integrate quoting and guide generation into your inventory and warehouse management system, with bulk upload and automatic tracking.

Online stores

Connect your e-commerce (WooCommerce, Shopify, TiendaNube) to the same API to display rates at checkout and generate guides when selling.

3PL operators

Manage your customers' shipments with shared balance, per-customer rates, and consolidated reports in a single API.

Messaging apps

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

FeatureNexus APIDirect integration
More than 30 carriers in one APIOne API per carrier
No individual contract with each carrierSeparate agreement
Public quoting without tokenMandatory authentication
Shared prepaid wallet across channelsPayment by guide with card
Bulk guide upload in one callBatch limit
Webhooks managed by the platformManual configuration
No monthly fee or rentMonthly fee starting at $999
Human support via WhatsAppTickets 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.

Related integrations

Frequently asked questions

Es una API REST que unifica la cotización, generación de guías, rastreo, cancelación y recolección de más de 30 paqueterías de México en una sola integración. En lugar de conectar con cada carrier por separado, integras una sola API y Nexus orquesta todos los carriers y agregadores por ti.