Cargoffer Wiki

Appearance

Como publicar una carga y gestionar todo el ciclo ​

Lo que vas a conseguir ​

Al final de esta guia, habras creado una subasta de transporte, recibido ofertas de transportistas, aceptado la mejor oferta y firmado el contrato digital. Todo sin papel, sin llamadas, sin perder tiempo.

El orden de las operaciones ​

Publicar una carga no es solo "subir un anuncio". Es un proceso con varios pasos que tienen un orden logico:

Crear subasta → Publicar → Recibir ofertas → Aceptar → Contractar → Firmar

Cada paso depende del anterior. Vamos a ver por que se hace asi y que esperar en cada uno.

Paso 1: Crear la subasta ​

Documentacion: docs.cargoffer.com/#tag/auction

Primero creas la subasta con los datos basicos. La subasta nace en estado "borrador" para que puedas revisarla antes de publicarla.

bash
curl -X POST "https://api.pro.cargoffer.com/api/auction/" \
  -H "Authorization: Bearer *** \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "Madrid",
    "destination": "Barcelona",
    "weight": 15000,
    "vehicleType": "camion",
    "loadingDate": "2026-06-20"
  }'

Parametros:

  • origin y destination: Ciudades o coordenadas. Los transportistas buscaran por estos campos.
  • weight: En kilogramos. Determina que tipo de vehiculo puede transportarlo.
  • vehicleType: "camion", "furgoneta", "trailer". Cada tipo tiene capacidades distintas.
  • loadingDate: Fecha de carga. Los transportistas planifican sus rutas con dias de antelacion.

La API devuelve un serviceCode (ej: "SRV-2026-001"). Lo necesitaras para los siguientes pasos.

Por que en este orden: Necesitas crear la subasta primero para tener un serviceCode antes de poder publicarla, anadirle imagenes, o hacer cualquier otra operacion.

Paso 2: Publicar la subasta ​

Documentacion: docs.cargoffer.com/#tag/auction

Una vez creada, la publicas para que los transportistas puedan verla y ofertar.

bash
curl -X PUT "https://api.pro.cargoffer.com/api/auction/publish/{serviceCode}" \
  -H "Authorization: Bearer <token...
**Que cambia:** Antes de publicar, solo tu ves la subasta. Despues de publicar, aparece en los resultados de busqueda de todos los transportistas.

---

## Paso 3: Recibir y revisar ofertas

**Documentacion:** [docs.cargoffer.com/#tag/Bid-Auctions](https://docs.cargoffer.com/#tag/Bid-Auctions)

Los transportistas interesados empezaran a ofertar. Puedes ver todas las ofertas recibidas:

```bash
curl -X GET "https://api.pro.cargoffer.com/api/company/bid-auctions/" \
  -H "Authorization: Bearer *** Ver el detalle de una oferta especifica:

```bash
curl -X GET "https://api.pro.cargoffer.com/api/company/bid-auctions/minimal/{serviceCode}" \
  -H "Authorization: Bearer *** La respuesta incluye: quien oferta, importe, fecha, y datos del transportista.

---

## Paso 4: Aceptar la mejor oferta

**Documentacion:** [docs.cargoffer.com/#tag/Auction---Actions](https://docs.cargoffer.com/#tag/Auction---Actions)

Cuando encuentres una oferta que te convenga, la aceptas:

```bash
curl -X POST "https://api.pro.cargoffer.com/api/company/auction/acceptCurrent" \
  -H "Authorization: Bearer *** -H "Content-Type: application/json" \
  -d '{"service_code": "SRV-2026-001"}'

Que pasa despues: El transportista recibe una notificacion y puede ver que su oferta ha sido aceptada. A partir de aqui, ambas partes deben formalizar el contrato.

Paso 5: Generar y firmar el contrato ​

Documentacion: docs.cargoffer.com/#tag/Auction---Contract

Primero generas el contrato:

bash
curl -X POST "https://api.pro.cargoffer.com/api/company/auction/contract" \
  -H "Authorization: Bearer *** -H "Content-Type: application/json" \
  -d '{"service_code": "SRV-2026-001"}'

Luego lo firmas digitalmente:

bash
curl -X POST "https://api.pro.cargoffer.com/api/company/auction/sign" \
  -H "Authorization: Bearer *** -H "Content-Type: application/json" \
  -d '{"service_code": "SRV-2026-001"}'

Por que son dos pasos: Primero se genera el documento legal con los terminos acordados. Luego se firma. Esto permite a ambas partes revisar el contrato antes de comprometerse.

Paso 6: Ver el contrato firmado ​

Documentacion: docs.cargoffer.com/#tag/Contracts

Puedes consultar el contrato en cualquier momento:

bash
curl -X GET "https://api.pro.cargoffer.com/api/company/contracts/{serviceCode}" \
  -H "Authorization: Bearer <token...
## Siguiente paso

Una vez firmado el contrato, la carga entra en fase de entrega. Sigue con la guia de [seguimiento de entregas](/carga/seguimiento) para gestionar el transporte desde que sale hasta que llega.

Documentación de Cargoffer

© 2026 Cargoffer