Servicio con incidencia

wbhk

serviceIncidence

Logístiko envía este evento cuando el conductor registra una incidencia.

Dirección: Logístiko → ERP

El campo status tiene el valor 5. El motivo se comunica mediante
codeIncidence y labelIncidence, junto con las observaciones y coordenadas disponibles.

Payload

Cuerpo JSON enviado por Logístiko al endpoint configurado por el cliente.

El conductor ha registrado una incidencia en el servicio.

timestamp

int64

required

Fecha y hora expresada en epoch milisegundos.

routeId

string

Identificador interno de la ruta.

routeRef

string

Referencia visible o externa de la ruta.

driverId

string

Identificador interno del conductor.

driverCode

string

Código del conductor.

licensePlate

string

Matrícula o código del vehículo asociado.

uniqueId

string

Identificador único de la expedición o servicio en Logístiko.

serviceId

string

Identificador interno del servicio específico.

serviceRef

string

required

Número de albarán o referencia principal del servicio.

serviceIdOrder

string

Referencia externa o identificador del pedido en el ERP.

status

const

enum

required

Código fijo del evento: 5.

Allowed:

trackingLink

uri

Enlace público de seguimiento, cuando está disponible.

olKey

string

Clave externa o de integración asociada al servicio.

serviceLabel

string

Etiqueta o clasificación del servicio.

servicePos

integer

Posición actual o completada del servicio dentro de la ruta.

barcodeReadStartRoute

int64

Fecha y hora expresada en epoch milisegundos.

barcodeReadCompleteService

int64

Fecha y hora expresada en epoch milisegundos.

latitudeService

double

Coordenada geográfica en grados decimales.

longitudeService

double

Coordenada geográfica en grados decimales.

type

integer

enum

Tipo de actividad: 1 recogida, 2 entrega.

Allowed:

dateEstimated

int64

Fecha y hora expresada en epoch milisegundos.

dateArrive

int64

Fecha y hora expresada en epoch milisegundos.

dateDeparture

int64

required

Fecha y hora expresada en epoch milisegundos.

notesArrive

string

Comentarios registrados en la llegada.

notesDeparture

string

Comentarios registrados al finalizar el servicio.

notesIncidence

string

Comentarios de la incidencia.

latitudeArrive

double

Coordenada geográfica en grados decimales.

longitudeArrive

double

Coordenada geográfica en grados decimales.

latitudeDeparture

double

Coordenada geográfica en grados decimales.

longitudeDeparture

double

Coordenada geográfica en grados decimales.

status1

integer

Código de resultado final configurado para el servicio.

status1Label

string

Etiqueta del resultado final.

status2

integer

Código del motivo final configurado.

status2Label

string

Etiqueta del motivo final.

codeIncidence

string

Código externo o interno del motivo de incidencia.

labelIncidence

string

Descripción del motivo de incidencia.

podSign

string

^data:[^;]+;base64,

Firma como data URI Base64.

podSignName

string

Nombre de la persona firmante.

podSignID

string

Documento de identidad de la persona firmante.

podPhoto

string

^data:[^;]+;base64,

Primera fotografía como data URI Base64.

podPhotoList

array of strings

Listado de fotografías como data URI Base64 cuando está habilitado el envío múltiple.

podPhotoList

parcelList

array of objects

Artículos o bultos asociados al servicio.

parcelList

form

array of objects

Respuestas del formulario de servicio, cuando está habilitado. El envío puede demorarse hasta que las respuestas estén disponibles.

form

transaction

object

Datos de una transacción de pago realizada durante el servicio.

previousInvoiceList

array of objects

Documentos o importes anteriores relacionados con el cliente.

previousInvoiceList

Headers

Authorization

string

Valor de autenticación configurado para el endpoint receptor. Se envía literalmente, por ejemplo Bearer <token> o cualquier valor acordado. Si no se configura autenticación, la cabecera puede omitirse.

Responses

200

Evento recibido y procesado correctamente. Logístiko considera válida cualquier respuesta HTTP 2xx.

204

Evento recibido correctamente sin contenido de respuesta. Logístiko considera válida cualquier respuesta HTTP 2xx.

default

Respuesta no satisfactoria del sistema receptor. Los códigos 3xx, 4xx y 5xx, así como los errores de conexión o timeout, pueden provocar reintentos según la configuración.