# Construye sobre la API con la que funciona Roadmark. > Construye sobre la misma API pública que usan las pantallas, la app para choferes y los agentes de Roadmark: cada carga, cotización y factura, webhooks y MCP. URL: https://roadmark.ai/es/desarrolladores Language: es 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. ## Cada registro que usa el producto está en la API. Un solo modelo de recursos, el mismo del que leen nuestras pantallas. Nada en la app tiene una forma que tu código no pueda ver también. - **loads** Un envío desde la recolección hasta la entrega, con sus paradas y su estatus. - **stops** Una parada de recolección, de entrega o intermedia, y su ventana de cita. - **quotes** Una solicitud con precio, en borrador o enviada, con las razones detrás de la cifra. - **orders** La reserva de un cliente antes de convertirse en carga. - **customers** A quién le facturas, sus contratos y sus contactos. - **carriers** A quién contratas, sus seguros, rutas e historial de tarifas. - **drivers** Horas de servicio, documentos y pago, para tu propia flota. - **units** Camiones y remolques, su mantenimiento y su carga actual. - **invoices** Lo que le facturas a un cliente, y cuándo se pagó. - **settlements** Lo que se le debe a un chofer o transportista, y cuándo se pagó. - **documents** POD, confirmaciones de tarifa y cualquier otra cosa adjunta a una carga. - **events** Cada cambio en cada registro, y quién o qué lo hizo. ## 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.drafted** Un agente o una persona crea una cotización para una RFQ o una solicitud de la bandeja de entrada. - **quote.sent** Una cotización sale hacia un cliente. - **load.status_changed** Una carga pasa entre reservada, despachada, en tránsito y entregada. - **load.stop.arrived** Una llamada de seguimiento, un escaneo o un evento del ELD marca la llegada a una parada. - **tender.accepted** Un transportista acepta una oferta de carga en el portal para transportistas o por EDI. - **invoice.issued** Se crea una factura a partir de una carga entregada. - **settlement.paid** Se paga la liquidación de un chofer o transportista. - **document.uploaded** Un POD, una confirmación de tarifa u otro documento llega a una carga. ## El mismo servidor MCP que usan Claude, ChatGPT y Gemini. Es un conjunto pequeño de herramientas, en palabras sencillas, no una copia de toda la API. Cada llamada se ejecuta como la persona que inició sesión: ve sus empresas y clientes, y nada más. - **search_loads** Busca cargas por cliente, ruta, estatus o fecha, como lo preguntaría un despachador. - **get_load** Lee una carga completa: paradas, estatus, tarifa y documentos. - **draft_quote** Pone precio a una ruta a partir de los contratos y el historial de tarifas, y deja el resultado como borrador. - **update_eta** Registra una nueva ETA a partir de una llamada de seguimiento o un retraso, preparada para aprobación como cualquier otra actualización. - **list_invoices** Busca las facturas abiertas, pagadas o vencidas de un cliente. - **find_customer** Consulta el contrato, los contactos y las cargas recientes de un cliente. ## 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. ## Un sandbox con un grupo real ya cargado. Las claves de prueba apuntan a Ashgrove Transportation Group, un espacio de pruebas con empresas, cargas, clientes y transportistas ya cargados. Nada de lo que hagas ahí llega a una empresa real. ## 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. ## Páginas relacionadas - [Integraciones](https://roadmark.ai/es/integraciones): ELD, EDI, bolsas de cargas y contabilidad - [Conecta tu asistente de IA](https://roadmark.ai/es/asistentes-ia): Usa Roadmark desde Claude, ChatGPT o Gemini - [Servidor MCP de TMS: Roadmark en cualquier asistente de IA](https://roadmark.ai/es/integraciones/modelcontextprotocol): Roadmark tiene un servidor MCP: un pequeño conjunto de herramientas de carga para cualquier cliente MCP, y cada llamada actúa como la persona que inició sesión. - [Seguridad](https://roadmark.ai/es/seguridad): Aislamiento por empresa, accesos y tus datos - [Integración EDI X12: los 204, 990, 214 y 210 explicados](https://roadmark.ai/es/integraciones/edi): Qué son los EDI 204, 990, 214 y 210, en qué sentido va cada uno y cuándo se envía, cómo se configura un socio comercial y cómo el rastreo se vuelve 214. Las empresas, personas y cifras de los ejemplos del producto son ficticias. Ilustran flujos de trabajo; no son testimonios de clientes ni resultados medidos.