Plataforma de desarrolladores

# Construye sobre Transportial

Una API REST completa, App Store SDK, framework de webhooks y modelo de datos nativo OTM5\. Todo lo que necesitas para construir software logístico sobre una plataforma ya en producción.

[Leer la documentación](https://docs.transportial.com)[Obtener acceso gratuito a la API](https://portal.otms.transportial.com/auth/register)

OpenAPI 3.0Estándar de API

RESTInterfaz HTTP

OTM5Estándar abierto

WebhooksSistema de eventos

Transportial REST API

\# Autentícate con tu clave API

Authorization: Bearer <api-key>

GET /api/v1/transport-orders \# list & filter orders

POST /api/v1/trips/optimise \# VRP trip optimisation

GET /api/v1/vehicles/tracking \# live GPS positions

POST /api/v1/webhooks/register \# subscribe to events

GET /api/v1/invoices \# billing & financials

\# App Store SDK

import { TransportialSDK } from '@transportial/sdk'

Referencia completa de API, guías y documentación del SDK en[docs.transportial.com](https://docs.transportial.com)

[Abrir documentación](https://docs.transportial.com)

Inicio rápido

## En funcionamiento en minutos

Sin incorporación compleja. Obtén tu clave API, lee la documentación y realiza tu primera llamada a la API.

01

### Crea una cuenta gratuita

Regístrate en portal.otms.transportial.com — sin tarjeta de crédito. Tu clave API se genera al instante.

02

### Lee la documentación

Explora la especificación OpenAPI 3.0, guías y ejemplos de código en docs.transportial.com.

03

### Realiza tu primera llamada a la API

Usa tu clave API para listar órdenes de transporte, crear viajes o transmitir posiciones de vehículos.

04

### Construye y publica

Desarrolla tu integración o app del App Store y envíala al marketplace de Transportial.

Tu primera llamada a la API:

curl \-H "Authorization: Bearer YOUR\_API\_KEY" \\

https://api.transportial.com/v1/transport-orders

Referencia de API

## Qué puedes construir con la API

Cada recurso principal de Transportial está expuesto vía REST. CRUD completo, filtrado, paginación y eventos de webhooks.

Órdenes de transporte

### Crea y gestiona órdenes de transporte

Gestión completa del ciclo de vida: crear, actualizar, asignar y rastrear.

[Ver documentación](https://docs.transportial.com/api/transport-orders)

Gestión de viajes

### Optimiza y ejecuta viajes

Activa la optimización VRP, asigna conductores y sigue la ejecución en tiempo real.

[Ver documentación](https://docs.transportial.com/api/trips)

Seguimiento y telemetría

### GPS en vivo y telemetría IoT

Transmite posiciones de vehículos en vivo, estado del conductor y telemetría de sensores.

[Ver documentación](https://docs.transportial.com/api/tracking)

Webhooks

### Suscríbete a eventos en tiempo real

Registra webhooks para más de 60 tipos de eventos. Payloads firmados con HMAC.

[Ver documentación](https://docs.transportial.com/api/webhooks)

Motor de precios

### Consulta y configura reglas de precios

Crea tarifas, aplica suplementos de combustible y activa la facturación automática.

[Ver documentación](https://docs.transportial.com/api/pricing)

Documentos

### Genera documentos de transporte

Genera automáticamente CMR, albaranes y documentos aduaneros a partir de datos de órdenes.

[Ver documentación](https://docs.transportial.com/api/documents)

Usuarios y permisos

### Gestiona usuarios y control de acceso

Más de 200 permisos nombrados, control de acceso basado en roles, SSO SAML 2.0 y auth JWT.

[Ver documentación](https://docs.transportial.com/api/users)

App Store

### Construye y publica apps del marketplace

Usa el SDK del App Store para incrustar paneles personalizados en cualquier vista.

[Ver documentación](https://docs.transportial.com/app-store)

App Store SDK

## Amplía la plataforma con tus propias apps

El App Store de Transportial permite incrustar paneles React personalizados directamente en el TMS — vistas de viajes, dashboards, detalles de envíos.

* Registra paneles en cualquier slot de vista (viaje, orden, dashboard)
* Accede al contexto de la plataforma en vivo mediante el hook del SDK
* Llama a la API REST desde tu panel de app
* Envía al marketplace o instala de forma privada
* Gestión de versiones y actualizaciones automáticas
* Entorno sandbox para desarrollo y pruebas

[Documentación del SDK](https://docs.transportial.com/app-store)[Convertirse en App Partner](/es/contact)

app-store-sdk.ts

import { TransportialSDK } from '@transportial/sdk'

const app = new TransportialSDK({

appId: 'your-app-id',

version: '1.0.0',

})

// Register a panel in the trip view

app.registerPanel({

slot: 'trip.sidebar',

component: MyPanel,

})

Framework de integración

## Conecta cualquier sistema externo

El pipeline de integración integrado gestiona colas, lógica de reintento, seguimiento de estado y manejo de errores.

### API REST

Especificación OpenAPI 3.0 completa. Autenticación por clave API con límites por clave y registros detallados de solicitudes.

### Servidor FTP y EDI

Servidor FTP integrado con análisis de archivos EDI para sistemas heredados. Compatible con EDIFACT, X12 y formatos de archivo plano personalizados.

### Webhooks y eventos

Suscríbete a más de 60 eventos de la plataforma con payloads de webhook verificados con HMAC. Reintento configurable con retroceso exponencial.

### SAML 2.0 SSO

Federación de identidad empresarial con cualquier IdP SAML 2.0 — Azure AD, Okta, Google Workspace y más.

### Estándar OTM5

Modelo de datos nativo OTM5 para interoperabilidad con el ecosistema europeo de transporte de mercancías.

### Conectores personalizados

Desarrolla conectores de integración personalizados con el SDK del framework y despliégalos en cualquier tenant de Transportial.

Código abierto

## Construido en abierto

Creemos que la mejor infraestructura se comparte. Transportial publica bibliotecas de código abierto que impulsan nuestra propia plataforma — disponibles gratuitamente para cualquier desarrollador.

### GSJson

KotlinJavaScript

Getter/setter JSON rápido para JVM y JavaScript

Una potente biblioteca de rutas JSON inspirada en GJSON. Consulta y muta JSON con rutas de notación de puntos, comodines, filtros de array, modificadores y referencias inversas — en Kotlin/Java y JavaScript/TypeScript.

\# Consulta JSON anidado con una sintaxis de ruta limpia

GSJson.get(json, 'name.first') // → "Tom"

GSJson.get(json, 'friends.\[age > "40"\].\[#.first\]') // → \["Dale","Roger","Jane"\]

GSJson.get(json, 'children|@reverse|@join') // → "Jack,Alex,Sara"

npm install`gsjson`

[Ver en GitHub](https://github.com/Transportial/GSJson)

[github.com/Transportial](https://github.com/Transportial)

## Recursos para desarrolladores

Todo lo que necesitas desde la idea hasta la producción.

[Referencia de APIEspecificación OpenAPI 3.0 completa con Swagger UI interactivo.Explorar referencia de API](https://docs.transportial.com/api)[Especificación OpenAPIDescarga la especificación OpenAPI JSON/YAML sin procesar para generación de código o clientes SDK.Descargar especificación](https://docs.transportial.com/openapi)[App Store SDKPaquete NPM, tipos TypeScript y hooks React para apps del marketplace de Transportial.Ver documentación del SDK](https://docs.transportial.com/sdk)[Guía de webhooksEsquemas de payload, catálogo de eventos, verificación de firma HMAC y sandbox de pruebas.Leer guía de webhooks](https://docs.transportial.com/webhooks)[Guía del App StoreGuía paso a paso para construir, enviar y mantener una app del marketplace.Leer guía del App Store](https://docs.transportial.com/app-store)[Soporte para desarrolladoresEnvía un email a nuestro equipo de relaciones con desarrolladores para preguntas técnicas o consultas de asociación.Enviar email al equipo](mailto:developers@transportial.com)

## ¿Listo para construir?

Obtén tu clave API gratis, lee la documentación y realiza tu primera llamada en minutos.

[Leer la documentación](https://docs.transportial.com)[Obtener acceso gratuito a la API](https://portal.otms.transportial.com/auth/register)

---
Canonical page: https://transportial.com/es/developers