API de transporte
Construye sobre la API con la que funciona Roadmark.
Nuestras propias pantallas, la app para choferes y cada agente llaman a la misma API pública. No hay una privada. Todo lo que Roadmark puede hacer con una carga, una cotización o una factura, tu código también puede hacerlo, con los mismos permisos.
GET /v1/loads/48213
Roadmark-Company: ashgrove-freight
200 OK
{
"id": "48213",
"object": "load",
"status": "delivered",
"customer": { "id": "prairie-foods", "name": "Prairie Foods" },
"equipment": { "type": "dry_van", "length_ft": 53, "trailer": "TRL 5317" },
"stops": [
{ "type": "pickup", "location": "Mississauga, ON", "appointment_at": "2026-09-29T06:00:00-04:00" },
{ "type": "delivery", "location": "Joliet, IL", "appointment_at": "2026-09-29T14:45:00-05:00" }
],
"rate": { "amount": "4215.00", "currency": "USD" },
"invoice": { "id": "INV-10442", "total": "4315.00" },
"version": 8,
"updated_at": "2026-09-29T18:21:07-05:00"
}
POST https://hooks.ashgrove.example/roadmark
Roadmark-Signature: t=1790722840,v1=5b3f2a…
{
"id": "evt_01J9M3QZ",
"object": "event",
"type": "load.status_changed",
"created_at": "2026-09-29T18:00:40-05:00",
"company": "ashgrove-freight",
"data": {
"id": "48213",
"object": "load",
"status": "delivered",
"previous_status": "in_transit",
"version": 7
}
}
// Claude, ChatGPT or Gemini: connector settings
{
"mcpServers": {
"roadmark": {
"url": "https://mcp.roadmark.ai/v1",
"auth": "oauth"
}
}
}
Cada persona inicia sesión una vez; luego el asistente actúa en su nombre.
Cada registro que usa el producto está en la API.
loadsUn envío desde la recolección hasta la entrega, con sus paradas y su estatus.stopsUna parada de recolección, de entrega o intermedia, y su ventana de cita.quotesUna solicitud con precio, en borrador o enviada, con las razones detrás de la cifra.ordersLa reserva de un cliente antes de convertirse en carga.customersA quién le facturas, sus contratos y sus contactos.carriersA quién contratas, sus seguros, rutas e historial de tarifas.driversHoras de servicio, documentos y pago, para tu propia flota.unitsCamiones y remolques, su mantenimiento y su carga actual.invoicesLo que le facturas a un cliente, y cuándo se pagó.settlementsLo que se le debe a un chofer o transportista, y cuándo se pagó.documentsPOD, confirmaciones de tarifa y cualquier otra cosa adjunta a una carga.eventsCada cambio en cada registro, y quién o qué lo hizo.
Eventos y webhooks
Los webhooks avisan a tus sistemas en cuanto cambia una carga.
Suscribe un endpoint a los eventos que te interesan. Cada uno lleva el id del registro y su versión, así que un reintento tardío nunca sobrescribe algo más reciente, y siempre puedes obtener el registro completo con los permisos de tu propia clave.
quote.draftedUn agente o una persona crea una cotización para una RFQ o una solicitud de la bandeja de entrada.quote.sentUna cotización sale hacia un cliente.load.status_changedUna carga pasa entre reservada, despachada, en tránsito y entregada.load.stop.arrivedUna llamada de seguimiento, un escaneo o un evento del ELD marca la llegada a una parada.tender.acceptedUn transportista acepta una oferta de carga en el portal para transportistas o por EDI.invoice.issuedSe crea una factura a partir de una carga entregada.settlement.paidSe paga la liquidación de un chofer o transportista.document.uploadedUn POD, una confirmación de tarifa u otro documento llega a una carga.
El mismo servidor MCP que usan Claude, ChatGPT y Gemini.
search_loadsBusca cargas por cliente, ruta, estatus o fecha, como lo preguntaría un despachador.get_loadLee una carga completa: paradas, estatus, tarifa y documentos.draft_quotePone precio a una ruta a partir de los contratos y el historial de tarifas, y deja el resultado como borrador.update_etaRegistra una nueva ETA a partir de una llamada de seguimiento o un retraso, preparada para aprobación como cualquier otra actualización.list_invoicesBusca las facturas abiertas, pagadas o vencidas de un cliente.find_customerConsulta el contrato, los contactos y las cargas recientes de un cliente.
Construye tu propio agente
Los agentes que construyes preparan el trabajo, y una persona lo aprueba en el mismo registro.
Lo que construyas sobre la API escribe en los mismos borradores que usan nuestros propios agentes. Nada de lo que prepara llega a un cliente, transportista o chofer hasta que alguien lo aprueba en Roadmark, y cada acción se atribuye a tu integración por su nombre.
- 09:14integration:ashgrove-sms preparó una llamada de seguimiento a partir del mensaje de R. Diaz: cruzó en Port Huron a las 09:05
- 09:16K. Wong la aprobó; Prairie Foods la ve en la página de rastreo
Un sandbox con un grupo real ya cargado.
Usa la API REST y JSON con clientes tipados para Node.js, Python y Ruby.
Preguntas
Lo que preguntan los desarrolladores.
¿Tiene Roadmark una API pública?
Sí, y es la misma API que llaman las pantallas, la app para choferes y los agentes de Roadmark; no hay una privada. Todo lo que Roadmark puede hacer con una carga, una cotización o una factura, tu código también puede hacerlo, con los mismos permisos.
¿Qué datos cubre la API?
Cada registro que usa el producto: cargas, paradas, cotizaciones, pedidos, clientes, transportistas, choferes, unidades, facturas, liquidaciones, documentos y eventos. Es el mismo modelo de recursos del que leen las pantallas.
¿Roadmark admite webhooks?
Sí. Suscribe un endpoint a eventos como quote.sent, load.status_changed, tender.accepted o invoice.issued. Cada evento lleva el id y la versión del registro, así que un reintento tardío nunca sobrescribe algo más reciente.
¿Hay un servidor MCP?
Sí, el mismo que usan Claude, ChatGPT y Gemini. Es un conjunto pequeño de herramientas en palabras sencillas, como search_loads, draft_quote y list_invoices, y cada llamada se ejecuta como la persona que inició sesión, que solo ve sus empresas y clientes.
¿Hay un sandbox para pruebas?
Sí, y el acceso es gratis. Las claves de prueba apuntan a Ashgrove Transportation Group, un espacio de pruebas con empresas, cargas, clientes y transportistas ya cargados, y nada de lo que hagas ahí llega a una empresa real.
¿Hay SDK?
Sí. Hay clientes tipados para Node.js, Python y Ruby. También puedes usar la API REST y JSON directamente.
Obtén un sandbox.
Te configuramos claves de prueba sobre el espacio de pruebas Ashgrove para que empieces a construir el mismo día.
- Claves de prueba, sin ninguna empresa real de por medio
- La API completa, los webhooks y el servidor MCP
- Un desarrollador, no un vendedor, en la llamada