Manual de OhMyDeCA

Asistente público con las cuatro exenciones del art. 2 como opciones. Responde cuatro preguntas y obtén el resultado documentado (exento sí/no y motivo). No requiere cuenta.

El asistente de ámbito del wizard avisa cuando estás emitiendo para un supuesto excluido (internacional o privado complementario). Es un aviso, no un bloqueo: la decisión es tuya y queda registrada.

Si el transporte se documenta en carta de porte u otro documento acreditativo que contenga todos los datos del art. 6, ese documento sirve como documento de control. El DeCA tampoco exime de las obligaciones del ADR ni de la documentación de residuos.

El panel no tiene login propio: se entra con la sesión de OhMyDat y el conmutador de empresa. Al primer acceso el módulo auto-provisiona la empresa, las series, los canales de entrega, los tipos de mercancía y la política de retención.

Razón social, NIF, domicilio, serie por defecto (prefijo y año), método de modificación (A o B), plantilla de PDF, retención (mínimo legal 1 año; por defecto 6), firma y canales de entrega.

Nombre o razón social, NIF validado, domicilio completo y contacto. Un mismo tercero puede tener varios papeles (cargador, transportista, destinatario) sin duplicar la ficha.

Matrícula, tipo (tractor, remolque, semirremolque, rígido, furgoneta, especial), ITV y marca de autorización especial si la necesita. Un conjunto articulado son dos matrículas: tractora y remolque.

Nombre, NIF, teléfono y PIN de 4 a 6 dígitos. El teléfono es el identificador de acceso a la PWA y el PIN se guarda cifrado. Entrega el PIN en mano: es la llave de la app de campo.

Una ruta reutilizable guarda cargador, transportista, origen, destinos, naturaleza de mercancía, vehículo y conductor habituales. Reutilizar es el atajo principal: el 80 % de las emisiones salen de una plantilla.

Los documentos con serie TEST- no consumen cuota, no tienen valor legal y no se entregan al conductor de verdad. Sirven para ver el PDF, escanear el QR y comprobar la descarga directa antes de emitir el primero real.

El buscador del wizard permite dar de alta un tercero sin salir del flujo, pero cada alta improvisada acaba en duplicados. Dedica media hora al directorio y ahorrarás correcciones.

Si el vehículo es un conjunto articulado, crea la tractora y el remolque por separado. El art. 6.g exige las dos matrículas: emitir con una sola deja el documento incompleto.

Cuando un vehículo tiene marcado que requiere autorización especial, el validador la exige y el PDF la imprime automáticamente. Sin esa marca, la emisión sale sin el dato y no lo notas hasta la inspección.

El teléfono identifica al conductor; el PIN abre la PWA. Si sospechas que el dispositivo se ha perdido, revoca la sesión desde la ficha: la sesión dura 12 horas y es revocable.

Elige la plantilla de ruta más usada, confirma la fecha (hoy por defecto) y ajusta conductor y vehículo si procede. Pulsa Emitir y tendrás PDF, QR y enlace listos con la entrega al conductor en curso.

El asistente de ámbito pregunta lo mínimo; después vienen las partes, el itinerario, la mercancía y el vehículo. Al elegir cargador verás sus destinos habituales, y al elegir conductor su vehículo asignado.

Un borrador no tiene número, ni PDF, ni consume cuota. La respuesta trae siempre la lista completa de campos que faltan (missingFields), no de uno en uno, para que puedas completarlos todos de golpe.

Al emitir se reserva número, se compone el PDF con el QR, se crea el enlace y se registra la fecha y hora de emisión. La ficha muestra datos, versiones, timeline, entregas, descargas, adjuntos y cumplimiento.

Puedes seleccionar varios borradores, completar conductor y vehículo en bloque y emitir en lote, o duplicar un DeCA anterior con la fecha de hoy. Útil para preparar la mañana de una flota.

El conductor escribe su teléfono y su PIN de 4 a 6 dígitos. La sesión dura 12 horas, es revocable por dispositivo desde el panel y se renueva con el PIN. No necesita cuenta de OhMyDat.

Tarjetas grandes con la plantilla de ruta, el origen y el destino, la mercancía habitual y el vehículo asignado. Toca la ruta, revisa fecha, peso y bultos (los únicos campos que suele tocar) y pulsa Emitir.

El QR ocupa la pantalla entera con el número de documento, la matrícula y la fecha visibles sin scroll. Funciona sin cobertura, siempre que la sesión siga viva y el documento se haya descargado antes.

Salir sella el inicio del servicio y Llegué el fin. Esos dos sellos alimentan la ventana de 7 días del enlace, los tiempos del informe y el control de entrega previa al inicio.

Si hay avería o cambio de remolque, el conductor modifica con motivo obligatorio y campos permitidos (vehículo, remolque, peso, bultos y observaciones). La oficina recibe el aviso al momento.

Elige canal: email, WhatsApp, SMS, notificación push, entrega manual o impresión. La copia, electrónica o impresa, debe contener siempre el código QR; el conductor puede llevar además el QR como fichero suelto.

La entrega pasa por pendiente, enviada, entregada, fallida o confirmada por el conductor. Un envío sin acuse no acredita nada: el panel avisa a la oficina cuando falta confirmación cerca del inicio previsto.

Puedes exigir entrega acreditada antes de sellar el inicio del servicio (bloqueo) o solo avisar y dejar constancia. En una flota pequeña el aviso suele ser suficiente; en tráfico con inspecciones frecuentes, el bloqueo.

Si el conductor no lleva dispositivo, imprime la copia desde el panel o envíala por email o WhatsApp. La copia impresa incluye la leyenda de que las anotaciones manuscritas no se tienen en cuenta.

PDF nativo, A4, con cabecera de empresa, partes, envíos, mercancía, vehículo y autorización, fecha, observaciones, número, versión, hash, pie legal y el QR embebido. Metadatos de creación y modificación incluidos, como exige la norma.

El importe interno y los metadatos del módulo no se imprimen jamás: el PDF usa una lista blanca de campos. El DeCA no lleva importes porque no es un contrato de transporte; un importe ahí solo confundiría el documento.

El QR abre una ruta que responde con el PDF (Content-Type application/pdf) sin pedir credenciales ni mostrar botones. Es válido cualquier dispositivo: el móvil del agente, una tablet o el navegador de la oficina.

Además del QR incrustado, el módulo genera el QR suelto en PNG y en SVG. Sirve para imprimirlo en una etiqueta, pegarlo en la documentación del vehículo o incrustarlo en un documento propio.

El enlace vive hasta siete días naturales después del fin del servicio. Mientras el servicio siga abierto, nunca caduca: la fecha se recalcula al alza. Si no se declaró fin, se calcula desde la fecha de transporte.

Superada la ventana, la ruta responde 410 Gone con un texto mínimo informativo: sin botones, sin formularios y sin marca más allá de lo imprescindible. El PDF no se destruye: sigue conservado el tiempo que marque la retención.

La empresa fija el método por defecto. Si no lo cambias, el sistema usa método B para cambios sustanciales: así el documento que lleva el conductor siempre coincide con lo que ve la inspección.

Motivos: cambio de vehículo, cambio de conductor, corrección de peso, de mercancía, de destino, de partes, autorización especial u otro con texto. Tipificar el motivo permite explotarlo en analítica y demuestra diligencia.

Toda modificación dispara el reenvío por los canales activos. Si no hay acuse antes del inicio del servicio, el panel genera una alerta para que la oficina lo persiga.

El timeline muestra todas las versiones con su autor, motivo y PDF descargable, y un diff campo a campo entre versiones. Es la prueba de qué cambió, cuándo y quién lo cambió.

La anulación exige motivo y deja el estado en anulado. El PDF se conserva porque la norma no permite destruirlo, y el enlace deja de servir el documento vigente salvo para la propia empresa. El número no se reutiliza ni se libera.

La opción se desbloquea solo si las partes coinciden. Si intentas agrupar envíos con cargador o transportista distintos, el validador lo bloquea con un error tipificado de agrupación.

El DeCA tiene un origen de cabecera y varios destinos. De cada envío se identifican el lugar de origen y destino y la naturaleza y el peso, como pide el apartado c) y d) del art. 6. Si otros datos difieren, se indican por envío.

El PDF de un documento agrupado pagina los envíos y lleva impreso el aviso de que la secuencia no supone orden de ejecución. Ese aviso evita discusiones en la descarga y es literal de la norma.

Verde significa que todos los requisitos están cubiertos; ámbar, avisos como entrega sin confirmar o inicio sin fecha; rojo, incumplimiento real. Solo se pueden forzar avisos, nunca datos del art. 6, y siempre con motivo.

El informe de exposición al riesgo lista servicios sin DeCA emitido, documentos emitidos después del inicio, entregas no acreditadas y documentos sin fin de servicio, con su precepto al lado. Recuerda que cada expedición puede ser una infracción independiente.

El mínimo legal es un año y el sistema rechaza cualquier valor inferior. Por defecto viene en seis años, alineado con las obligaciones mercantiles y fiscales. Conservar más es una decisión de negocio, no una obligación.

El legal hold impide que un documento se purgue aunque venza su retención. Úsalo con expedientes abiertos, sanciones, litigios o requerimientos: exige motivo y queda auditado.

La purga programada se simula antes de ejecutarse y deja registro de lo purgado. Nunca purga un documento con legal hold ni con retención vigente, y conserva eventos y hash aunque borre el binario.

Por rango de fechas o por documento: PDFs, indice.csv, hashes.sha256 y LEEME.txt con el procedimiento de verificación y el texto de la norma aplicable. Es tu antídoto contra el lock-in y lo que pide una gestoría.

El ZIP de evidencias reúne el timeline, el registro de descargas, las entregas y el reparto de responsabilidad por campo. Es lo que se adjunta cuando llega una multa, una denuncia o un requerimiento.

La clave se muestra una sola vez y se guarda como hash. El prefijo dice el entorno: dca_live_ para producción y dca_test_ para pruebas. Se pueden revocar al instante y limitar por scopes.

Con clave dca_test_ el módulo emite con serie TEST-, no consume cuota y no entrega de verdad a ningún conductor: los envíos van a un buzón de pruebas. El sandbox es completo, no un simulador parcial.

Toda escritura acepta la cabecera Idempotency-Key con 24 horas de ventana. Reintentar con la misma clave y el mismo cuerpo devuelve la respuesta original con Idempotent-Replayed; la misma clave con otro cuerpo da 409.

Los listados usan limit y starting_after con has_more y next_cursor. Los errores llegan con un sobre único y un código tipificado: ramifica siempre por code, nunca por el texto del mensaje.

Los eventos (emitido, versionado, entregado, completado, anulado, descargado, por caducar, alerta de cumplimiento) se firman con HMAC-SHA256 y una marca de tiempo. Hay ocho reintentos con backoff y dos secretos activos para rotar.

La especificación es pública y se puede importar en Postman, Insomnia o un generador de clientes. Se publican ejemplos en curl, JavaScript y PHP, que son los tres lenguajes que piden los integradores de ERP españoles.

Al seleccionar ADR, DI de residuos, SANDACH o carta de porte aparece el bloque «Datos del formato» con solo los campos de ese formato. Cada campo lleva debajo su base legal (apartado 5.4.1.1 del ADR, anexo I del RD 553/2020, anexo VIII del Reglamento (UE) 142/2011…).

En el DI de residuos: número de DI, NIMA de operador, productor y destino, operación de tratamiento (R/D), código LER, cantidad en kg, peligrosidad (HP) y fecha de inicio. En SANDACH: categoría, material, establecimiento, cantidad y, para la categoría 3, la mención de que no se destina al consumo humano. En ADR: número ONU, designación oficial, clase, grupo de embalaje, cantidad y la declaración del expedidor.

El validador evalúa las reglas R23: lo que la norma del sector exige bloquea la emisión y lo que solo es coherencia (el grupo de embalaje del ADR, que la tabla A asigna solo a algunas materias) queda como aviso. Guardar el borrador nunca se bloquea: la decisión de emitir es tuya y responsable.

La ruta devuelve el JSON del borrador eFTI y lo guarda como artefacto en el almacenamiento de la empresa (export/efti/<año>/<id>-v<N>.json). Con ?descargar=1 se descarga como fichero.

El JSON incluye meta.conforme = false y meta.faltantes con los elementos del eFTI data set que el DeCA todavía no cubre (información de contacto de las partes, códigos de agencia de los identificadores, formato de fecha/hora y el enlace UIL del nodo eFTI). Es un borrador de integración, no una declaración de conformidad.