Documentos

Envía los datos completos del transporte. La respuesta se entrega después de generar y almacenar el PDF cifrado.

Una referencia no nula es única por organización y entorno. Repetir la referencia con los mismos datos normalizados y metadata devuelve el resultado original dentro de 24 horas (200), sin emitir otro PDF. Una creación nueva devuelve 201. Datos distintos o una referencia de otra credencial producen 409 sin divulgar documentos. Sin referencia no se garantiza deduplicación.

Una referencia cuyo resultado ha vencido devuelve 409 DOCUMENT_WINDOW_EXPIRED. Si el documento está eliminado, no se devuelve su contenido ni se reutiliza su referencia; el reintento devuelve 404. Para rectificar utiliza los endpoints PUT.

Puedes solicitar un token sk_demo_ sin una cuenta ni un alta de organización. Dura 24 horas desde su emisión y solo funciona desde la IP pública que lo solicitó. Cambiar de red o de IP requiere solicitar otro token. La demo añade demo: true, expires_at, qr_url (alias de url) y pdf_url (alias de pdf_download_url). document_locale es el idioma elegido al solicitar el token (es por defecto). Los datos y PDF temporales quedan separados del archivo real y no se cifran como los documentos reales.

Identifica el documento anterior mediante su UUID y envía todos los datos corregidos, sin parches. Solo puede rectificarse la última versión de la misma credencial. Se permite rectificar un documento de más de 24 horas sin devolver su contenido anterior. Un documento eliminado devuelve 404 y no puede rectificarse.

Se genera un documento rectificativo con UUID, PDF y QR nuevos; el original y su QR se conservan. Entrega el nuevo PDF al conductor. El campo reference del cuerpo corresponde a la nueva versión, no al documento de la URL.

Repetir el mismo PUT con los mismos datos normalizados y metadata devuelve la rectificación ya emitida durante las 24 horas siguientes a su creación, sin generar otra versión. Esta comprobación se realiza antes de rechazar un documento ya rectificado y funciona también si el reintento identifica al mismo documento por referencia. Un cambio de datos sobre un documento ya rectificado devuelve 409. Un reintento cuyo resultado ha vencido devuelve 409 DOCUMENT_WINDOW_EXPIRED. Si la rectificación devuelta está eliminada, el reintento devuelve 404. Para otra rectificación, utiliza el UUID o la referencia de la última versión.

Borrado lógico para corregir errores detectados al generar un documento, exclusivamente antes de entregarlo al transportista o al conductor y antes de utilizarlo en un transporte. La integración debe confirmar ambas condiciones; no basta con estar dentro del plazo. Si el documento ya se ha entregado o utilizado, debe rectificarse mediante PUT.

Se permite únicamente mientras la hora del servidor sea anterior a created_at + 2 horas; a las 2 horas exactas ya no se permite. Ni una consulta ni un reintento reinician el plazo. Cada versión utiliza su propia fecha de creación. Solo puede eliminarse la última versión de la credencial autenticada.

Se conservan el PDF, los datos y la trazabilidad, pero el documento deja de aparecer en el listado. Las consultas por UUID o referencia, la descarga autenticada, el QR y los reintentos que devolverían su contenido responden 404. La consulta de estado responde únicamente con status: deleted durante la ventana de consulta de 24 horas. La referencia sigue reservada. No hay endpoint de reactivación; el borrado no destruye el archivo para permitir una recuperación futura.

Repetir el DELETE dentro de las mismas 2 horas devuelve 204 sin cambiar la fecha de eliminación. Pasado ese plazo devuelve 409.

El primer acceso correcto al enlace QR bloquea también el borrado con 409 DOCUMENT_ALREADY_ACCESSED. Ese acceso no prueba por sí solo la realización del transporte.

Devuelve resúmenes, sin PDF, secreto QR ni metadata. El servidor aplica siempre la ventana de 24 horas y el aislamiento de la credencial. Orden descendente por fecha de creación y UUID como desempate, paginación por página y filtros inclusivos de fecha de transporte. La ventana se evalúa en cada petición; no constituye una instantánea estable entre páginas. No permite consultar el histórico.

Los documentos eliminados no aparecen en el listado.

Recupera el resultado original dentro de 24 horas, solo para la credencial que emitió el documento. Incluye todos los campos aceptados y normalizados y la metadata sin modificación semántica.

Un UUID o una referencia inexistente, de otra credencial o fuera de la ventana devuelve la misma respuesta 404, sin confirmar existencia ni propietario. Cada referencia identifica su propia versión y no redirige a una rectificación posterior.

Un documento eliminado devuelve 404. Para saber si está eliminado, utiliza la consulta de estado.

Devuelve únicamente el estado de un documento de la credencial autenticada, durante las 24 horas siguientes a su creación. Para un documento eliminado responde 200 con {"status":"deleted"}; no devuelve datos del transporte, PDF, enlace QR ni metadata. Un documento activo responde con {"status":"active"}.

Un UUID inexistente, de otra credencial o fuera de las 24 horas devuelve el mismo 404. La eliminación no amplía esa ventana.

Devuelve exactamente los bytes del PDF almacenado, sin regenerarlo. Exige credencial propietaria y una antigüedad inferior a 24 horas. Esta limitación no altera la conservación legal ni la vigencia del QR.

Un documento eliminado devuelve 404 sin entregar el PDF.