API e integración con el ERP

Sí. La API REST JSON de DGAssistant se diseñó para integrarse con sistemas de gestión y plataformas logísticas. Hay clientes que la han integrado con SAP, SAGE X3 y otros sistemas. La integración la realiza su equipo informático o su socio de ERP, con el acompañamiento constante del equipo de DGAssistant durante el análisis, la implantación y la puesta en marcha.

Sí, la API es un módulo con licencia propia que se añade a las licencias estándar. Se incorpora a su suscripción cuando decide integrarse.

La API se mide por licencia: cada una cubre 1.500 expediciones y 7.500 llamadas a los servicios al año, y permite mantener en la base de datos hasta 5.000 objetos distintos de las expediciones, como productos y participantes (destinatarios, proveedores, conductores y demás). Si prevé más volumen, basta con añadir licencias adicionales. El precio unitario del módulo de API aparece junto al resto del catálogo en nuestra tienda y puede incluirse en cualquier presupuesto a medida.

El modo por lotes recibe la especificación completa de la expedición en una sola llamada, ideal cuando el ERP ya conoce las mercancías, los intervinientes y las cantidades. El modo interactivo permite construir la expedición paso a paso, validando cada mercancía según se añade; se parece más a como funciona la aplicación web y resulta útil cuando necesita flujos guiados por el usuario sobre la API.

Las dos formas son válidas. La recomendada son los datos predefinidos: cree sus mercancías y sus intervinientes una vez en la aplicación web -o impórtelos- y refiéralos por su código desde las llamadas a la API. La definición sobre la marcha permite enviarlo todo en cada llamada, lo que va bien cuando el ERP es el dueño de esos datos y no quiere cargarlos previamente.

Hay dos opciones. Puede recibir los documentos en la respuesta de la API como PDF codificados en base64 -documento de transporte, declaración del expedidor, lista de comprobaciones, marcado de bultos, etc.- o hacer que la plataforma los envíe automáticamente por correo a una dirección configurada.

Sí. Funcionan bien dos patrones: que su ERP descargue el PDF de la API y lo envíe a su propia cola de impresión, o que DGAssistant envíe los documentos por correo a un buzón dedicado y una pequeña utilidad de impresión automática los imprima en la impresora que corresponda. Muchos clientes usan el segundo porque no exige código adicional en el ERP.

La especificación OpenAPI completa, con ejemplos interactivos, está publicada en la documentación de la API de mercancías peligrosas. Facilitamos además un proyecto de SoapUI con llamadas de prueba realistas para que sus desarrolladores puedan explorarla en minutos.

Toda llamada a la API debe incluir un requestGuid único que identifica la petición en nuestros registros y permite a nuestro equipo de soporte localizar la transacción exacta cuando usted reporta una incidencia. Se acepta cualquier valor alfanumérico único; recomendamos generar un UUID estándar en el cliente.

Unas credenciales que el servicio no acepta: que falte la cabecera de autorización HTTP Basic o sea incorrecta o, cuando la llamada se autentica con OAuth2, un testigo de acceso que nunca se solicitó, que pertenece a otro entorno o que ya ha caducado. Existe una dirección de soporte específica que puede invocar para confirmar que la API responde y que sus credenciales son válidas. Si se queda atascado, envíenos la petición y la respuesta HTTP completas -con su requestGuid- y una descripción del comportamiento esperado: es lo que antes desbloquea el problema.