API REST de mercancías peligrosas

Qué hace la API

Expediciones. La API REST JSON de DGAssistant crea la expedición de mercancías peligrosas desde su propio sistema de gestión o de logística y devuelve la declaración del expedidor, la lista de comprobaciones y el marcado de bultos, ya verificados conforme a la reglamentación que corresponde. Su sistema conserva los datos comerciales; DGAssistant aporta el conocimiento reglamentario y los documentos.

Consolidación. La API cubre además el agrupamiento de expediciones de varios expedidores por sus dos ejes. El eje contractual es la expedición maestra —una reserva, una consolidación marítima o aérea, un grupaje por carretera— con sus intervinientes, sus referencias, las expediciones que se le enganchan, sus transiciones de estado y su histórico. El eje físico son los equipos de transporte (contenedor, vehículo, remolque o unidad de carga aérea) y los movimientos de transporte (travesía, vuelo o viaje) con sus escalas, junto con los buques, los vehículos y las ubicaciones de la cuenta. Más de la mitad del servicio está dedicada a esta parte.

Abrir la especificación de la API de mercancías peligrosas

Dos formas de trabajar: por lotes e interactiva

Por lotes. Una sola llamada lleva la especificación completa de la expedición con todas sus mercancías. Es la forma pensada para los sistemas de gestión y de logística que envían expediciones ya montadas.

Interactiva. Primero se abre la expedición y las mercancías se van añadiendo una a una. Cada respuesta trae los mensajes de validación de lo que se acaba de añadir, de modo que su propia aplicación puede mostrarlos al usuario mientras prepara el envío.

Datos predefinidos o datos al vuelo

Datos predefinidos. Los productos y los intervinientes —expedidores, transportistas, destinatarios, cargadores y conductores— se crean de antemano y la API utiliza sus códigos. Es la forma más sencilla de trabajar y la que recomendamos, porque la clasificación reglamentaria se resuelve una vez y se reutiliza en cada expedición.

Datos al vuelo. Los productos y los intervinientes se definen en la misma llamada que crea la expedición. Conviene a los sistemas que no mantienen catálogo propio o que expiden mercancías ocasionales.

Los documentos que devuelve

De cada expedición: la declaración del expedidor de la reglamentación que aplique, la lista de comprobaciones y el marcado de bultos. Se recuperan en PDF, XLSX o DOCX, o se envían directamente por correo electrónico desde el propio servicio.

De la consolidación: los documentos de la unidad de transporte, los del movimiento —entre ellos el manifiesto de mercancías peligrosas y la notificación al capitán— y los de la expedición maestra.

Qué comprueba la API

En la expedición. La segregación entre las mercancías que viajan juntas, los límites de cantidad de la instrucción de embalaje aplicable y de los regímenes de cantidad limitada y exceptuada, la admisibilidad de la mercancía en el modo de transporte, la legalidad del embalaje y la completitud de la declaración. Cuando algo no cumple, la respuesta dice qué regla no se cumple y con qué valores, de modo que el mensaje pueda mostrarse en su propia aplicación.

En la consolidación. La segregación dentro de la unidad de transporte, la segregación entre las unidades cargadas en un mismo movimiento, el cálculo del umbral 1.1.3.6 del ADR del movimiento con su desglose, y las restricciones del viaje devueltas como dato, como el código de restricción en túneles o la presencia de mercancías peligrosas de alto riesgo.

Reglamentaciones y tipos de transporte que cubre

ADR por carretera, IMDG por vía marítima, IATA por vía aérea y 49 CFR. Las tres reglamentaciones principales se gestionan juntas y no como módulos separados, de modo que una expedición que cambia de modo de transporte no hay que volver a prepararla.

Se admiten el embalaje en común, los sobreembalajes, las cisternas, el transporte a granel, los embalajes vacíos sin limpiar, los residuos y las materias radiactivas de la clase 7, cada uno con los datos que exige. Los textos de los documentos se emiten en diecinueve idiomas.

Disponibilidad

El servicio está publicado en tres regiones —Europa, América y Asia-Pacífico—, cada una con su propia dirección, para que la integración trabaje contra la región en la que está la cuenta. La infraestructura es redundante y está vigilada las veinticuatro horas.

Cómo empezar

Solicite una prueba gratuita de dos semanas y, con ella, las credenciales del servicio. La autenticación es OAuth 2.0 con el flujo de credenciales de cliente: su sistema obtiene un testigo de acceso y lo envía en cada petición.

La especificación completa está publicada en formato OpenAPI y puede leerse, explorarse y usarse para generar un cliente en su propio lenguaje antes de escribir una sola línea de integración.