# Cargoffer API

> Documentacion de la API de Cargoffer para transporte y logistica.

## API Reference

- OpenAPI Spec (YAML): https://docs.cargoffer.com/openapi/cargoffer-api.yaml
- OpenAPI Spec (JSON): https://docs.cargoffer.com/openapi/cargoffer-api.json
- Documentation: https://docs.cargoffer.com/
- Sitemap: https://docs.cargoffer.com/sitemap.xml

## Core Resources

The API is organized into 4 modules:

1. **Transport API** (/api/*) - 25 endpoints
   - Create, manage, and bid on transport auctions
   - Manage deliveries, contracts, and carriers
   
2. **Company API** (/company/*) - 182 endpoints
   - Company registration and management
   - User administration, API keys, payment methods
   - eCMR documents, legal documents, notifications
   
3. **Truckers API** (/truckers/*) - 51 endpoints
   - Trucker registration and profile
   - Vehicle fleet management, driver management
   - GPS tracking, routes, and deliveries
   
4. **Vehicle Types API** (/vehicle-types/*) - 1 endpoint
   - List available vehicle types

## Authentication

The API uses Bearer token authentication.

## Tutoriales y Guias

La wiki de Cargoffer contiene tutoriales paso a paso y guias de integracion para todos los modulos:

### Casos de Uso Guiados
- Transportista encuentra retorno: https://docs.cargoffer.com/wiki/casos-de-uso/transportista-retorno
- Empresa publica carga: https://docs.cargoffer.com/wiki/casos-de-uso/empresa-publica-carga
- Viaje internacional: https://docs.cargoffer.com/wiki/casos-de-uso/viaje-internacional
- Gestion de flota: https://docs.cargoffer.com/wiki/casos-de-uso/gestion-flota-completa

### Integraciones con ERPs
- Sage 50 / ContaPlus: https://docs.cargoffer.com/wiki/integraciones/sage/
- Odoo ERP: https://docs.cargoffer.com/wiki/integraciones/odoo/
- SAP Business One: https://docs.cargoffer.com/wiki/integraciones/sap/
- Microsoft Dynamics 365: https://docs.cargoffer.com/wiki/integraciones/dynamics/
- Contasol / A3: https://docs.cargoffer.com/wiki/integraciones/contasol/

### Tutoriales por modulo
- eCMR: https://docs.cargoffer.com/wiki/ecmr/crear
- Transportistas: https://docs.cargoffer.com/wiki/transportistas/retorno
- TMS: https://docs.cargoffer.com/wiki/tms/conductores
- API guias: https://docs.cargoffer.com/wiki/api/auth

### Indice completo
https://docs.cargoffer.com/wiki/tutoriales