Saltar al contenido principal
Version: 1.0.0

Address Module API

API para gestión de direcciones de compañía

API para gestión de claves API de la compañía

API for managing transport auctions

API for company user authentication, registration and account management

Proporciona endpoints para buscar y gestionar subastas de carga.

Módulo de facturación de Cargoffer para empresas de transporte.

Sistema integral de gestión financiera que permite controlar toda la información relacionada con:

  • Facturación de servicios de transporte
  • Costes operativos por ruta y vehículo
  • Comisiones de la plataforma Cargoffer
  • Liquidaciones con transportistas colaboradores
  • Generación automática de documentos CMR

Características principales:

  • Dashboard financiero en tiempo real
  • Histórico completo con análisis de rentabilidad
  • Integración con sistemas contables externos
  • Informes personalizables por periodo
  • Alertas de límites de crédito y pagos pendientes

Casos de uso empresariales:

  • Control de márgenes por cliente y ruta
  • Análisis de costes vs transporte propio
  • Reporting financiero para dirección
  • Conciliación automática de gastos
  • Optimización de rentabilidad operativa

API for HS Code classification system (sections, chapters, headings, subheadings)

API for managing CMR (Consignment Note) documents

Sistema de Soporte Cargoffer - Atención especializada en transporte

Proporciona endpoints para gestionar comunicación directa con el equipo de soporte:

Categorías de soporte disponibles:

  • Problemas técnicos de la plataforma
  • Incidencias en entregas y transportistas
  • Consultas sobre facturación y pagos
  • Solicitudes de nuevas funcionalidades
  • Asistencia en procesos de integración

Tipos de usuarios atendidos:

  • Empresas cargadoras registradas (con autenticación JWT)
  • Transportistas de la red Cargoffer
  • Usuarios no registrados (consultas generales)
  • Partners tecnológicos y integradores

Funcionalidades del sistema:

  • Tickets categorizados por prioridad
  • Seguimiento de estado en tiempo real
  • Histórico de consultas anteriores
  • Escalado automático según criticidad
  • Integración con CRM empresarial

This API provides endpoints for managing transportation contracts between companies and carriers. Includes functionality for:

  • Retrieving contract lists - Generating PDF contracts - Sending contracts via email All endpoints require authentication via JWT token.

Proporciona endpoints para: - Obtener información de países (público y admin) - Obtener regex para validación de códigos de país - Crear, actualizar y eliminar países (solo admin) Nota: - Los endpoints que modifican datos requieren autenticación como administrador

API for company dashboard statistics

API para gestionar datos y firmas del perfil de la empresa

API para la gestión de entregas de transporte

API para gestión de documentos de empresas. Permite subir, listar, actualizar y eliminar documentos asociados a una compañía, con control de versiones y estados.

API for managing company invoices and payments

API for managing transport issues and support tickets

API para cálculos mínimos de rutas (costos, CO2, información de ruta)

API for managing company carriers and their drivers

API para la gestión integral de notificaciones dentro de la plataforma CargOffer.

Proporciona endpoints para:

  • Consultar notificaciones del dashboard
  • Marcar notificaciones como leídas
  • Eliminar notificaciones

Audiencia:

  • Aplicaciones cliente de CargOffer
  • Integraciones empresariales

Seguridad:

  • Autenticación mediante JWT
  • Acceso restringido a usuarios autorizados

API para gestión de pagos y métodos de pago de compañía

Este módulo permite gestionar el ciclo completo de entregas mediante tokens QR:

  • Consulta de información de entregas
  • Confirmación de entregas
  • Reporte de incidencias

Funcionalidades clave:

  • Autenticación mediante JWT (Bearer token)
  • Tokens QR únicos por entrega
  • Integración con el sistema de tracking
  • Notificaciones en tiempo real

Requisitos:

  • Acceso autorizado con token JWT válido
  • Permisos adecuados para operaciones QR
  • Tokens generados por el sistema

Consideraciones:

  • Los tokens QR tienen validez limitada
  • Las confirmaciones son irreversibles
  • Las incidencias generan notificaciones automáticas

Ejemplo de flujo completo:

  1. Escanear QR → GET /{token}
  2. Verificar datos de entrega
  3. Confirmar entrega → PUT /confirm
  4. (Opcional) Reportar incidencia → POST /issue

API para gestión de configuraciones de la plataforma

Proporciona endpoints para buscar estaciones por:

  • Mejor valoración
  • Precio más económico
  • Proximidad geográfica
  • Provincia
  • Ruta específica

API for managing company users

API for managing company vehicle fleet

API para gestión integral de transportistas asociados a la empresa

Sistema de Gestión de Transportistas Colaboradores

Proporciona endpoints para administrar transportistas que trabajan con la compañía:

Funcionalidades principales:

  • Registro individual y masivo (CSV) de transportistas
  • Gestión completa del perfil de conductores
  • Asignación de vehículos por defecto
  • Control de acceso y permisos
  • Filtrado por DNI/NIE/CIF
  • Obtención de información de contacto

Casos de uso empresariales:

  • Onboarding de nuevos transportistas
  • Actualización de datos de conductores
  • Importación masiva desde sistemas externos
  • Consulta rápida por identificación fiscal
  • Gestión de flota colaborativa

Características avanzadas:

  • Envío automático de credenciales por email
  • Validación de datos fiscales (taxid)
  • Verificación de correos electrónicos
  • Plantillas CSV para importación
  • Notas de ayuda multiidioma

Seguridad:

  • Autenticación JWT obligatoria
  • Verificación de pertenencia a compañía
  • Control de permisos multitenant
  • Límites según plan de suscripción

Authentication​

JWT Bearer authentication

Security Scheme Type:

http

HTTP Authorization Scheme:

bearer

Bearer format:

JWT

License