Acuso de estado en linea 2
Seguridad permitida 2
Estados del proceso 2
Request 3
Definición de campos 3
Ejemplo de request 4
Response 6
Acuso de estado en linea
2
Habilitando este servicio podrán recibir los estados de las ordenes de flete asociadas a su empresa junto con
otra información de utilidad. Para que esto pueda ser llevado acabo se debe cumplir con lo siguiente:
Deben disponer un endpoint que cumpla con lo requerido por el proceso
Las ordenes de flete deben estar asociadas al RUT de su empresa
Al momento de realizar la configuración, se debe establecer que tipo de documentos tendrán sus OF;
esto debido a que el proceso de acuso requiere que la OF un documento declarada junto con su
respectivo número. En caso de que no los tenga, no se informara el cambio de estado
Seguridad permitida en la API
En caso de que su endpoint requiera tener seguridad, nuestro proceso permite que sea de la siguiente manera:
1. Una autentificación básica de usuario y contraseña
2. La implementación de un token como header con el nombre x-api-key o un token Bearer, en ambos
casos fijo
3. Ningún método de autentificación
Estados del proceso
MACRO Descripción
RECIBIDO EN STARKEN OF está en manos de Starken
EN TRANSITO A DESTINO OF está siendo llevada a su destino
La OF fue recibido por la sucursal de Starken
RECIBIDO EN AGENCIA DESTINO
encargada de gestionar la entrega al cliente final
EN REPARTO A DOMICILIO OF se encuentra camino al domicilio del cliente
ENTREGADO OF recibida por el destino
NO ENTREGADO Entrega de OF no pudo ser concretada
CERRADO CON EXCEPCION OF se encuentra con Reclamo formal
En el caso de la no entrega, informamos los siguientes motivos
Motivos de devolución
3-DIRECCION INCORRECTA
4-NO SE UBICO DESTINATARIO
5-SIN DINERO
3
6-ENTREGA FUTURA
7-RECHAZADO POR CLIENTE
8-SIN MORADORES
9-RECHAZADO POR DANO
10-TRASPASO A CTA. CTE.
12-CLIENTE SOLICITA CAMBIO DE FEC
13-RECHAZADO (PRODUCTO NO CORRESP
14-RECHAZADO (PRODUCTO FALTANTE)
16-PRODUCTO NO CUPO EN DOMICILIO
301-MOVIL NO ENTREGA
303-ENTREGA FUERA DE HORARIO
304-CLIENTE DESISTE DEL RETIRO
305-DL TIENDA
306-RETIRO NO CUMPLE C/FORMULARIO
308-EMPRESA CERRADA
309-RECHAZO POR DETERIORO
Request
Definición de campos
Request
Atributo Tipo Dato Descripción
tipo_documento Int o String Tipo Documento Cliente
folio Int o String Nro. Documento Cliente
fecha_hora_evento String Fecha y Hora del Evento
Código del Estado para Cliente
codigoEstado String (homologado)
descripcionEstado String Descripción del Estado
latitud Long Latitud (coordenada de entrega)
longitud Long Longitud (coordenada de entrega)
Patente del Vehículo que Entrega la
patente String O/F
rut Int Rut de quien recibe la O/F
Digito Verificador del Rut que recibe la
dv String O/F
Motivo de No Entrega (solo para
tipoDevolucion String excepción en el Reparto)
numeroOrdenFlete Long Nro. de la O/F
Ejemplo de request
{
"codigo":7327955,
4
"folio":202310276483,
"tipoDocumento":4,
"estadoMacro":5,
"nombreEstadoHomologado":"EN REPARTO A DOMICILIO",
"reIntentoWebhook":0,
"numeroOrdenFlete":991221176,
"estadoMicro":9,
"tripulacion":[
{
"tripcodigo":45036,
"usuausuariomodi":"TDGR",
"comucodigo":2804,
"etracodigo":34,
"licecodigo":1,
"tcarcodigo":1,
"tripapellidom":"yentzen",
"tripapellidop":"inversiones",
"tripcelular":null,
"tripcodigobarra":1,
"tripdepartamento":"1",
"tripdireccion":"1",
"tripdv":"7",
"tripestado":1,
"tripfeccontrato":"2020-07-07",
"tripfechacrea":1594135052000,
"tripfechaingreso":null,
"tripfechamodi":1594135052000,
"triplicencias":null,
"triplicevenci":"2050-05-20",
"tripnombres":"transportes",
"tripnumeracion":"1",
"triprut":76978676,
"tripversion":1,
"usuausuariocrea":"TDGR"
}
],
"ubicacionActual":"1053",
"rutEmpresa":77235177,
"codCiudadDestino":502,
"fechaHoraEvento":"20-10-2023 [Link]",
"codigoEstadoHomologado":"EN REPARTO A DOMICILIO",
"descripcionEstado":"EN REPARTO A DOMICILIO",
"latitud":"0",
"longitud":"0",
"rutRecibe":0,
"dvRecibe":null,
"nombreRecibe":null,
"tipoDevolucion":null,
"codigoInternoEstado":5,
"codigoAgenciaDestino":1053,
"intePersonalizada":0,
"inteBeetrack":0,
5
"inteWebhook":1,
"reIntentoPersonalizada":0,
"reIntentoBeetrack":0,
"saludAcusoPersonalizada":0,
"saludAcusoBeetrack":0,
"saludAcusoWebhook":0,
"ctacteNumero":"612024",
"ciudadDestino":"PERALILLO",
"estadoEnReparto":0,
"encargosTotales":1,
"maquina":{
"tmaqcodigo":3,
"agencodigo":1053,
"maqucodigo":20013,
"usuausuariomodi":"TDGR",
"maqudescripcion":null,
"emprcodigoservi":1,
"maqumatricula":"LZJD77",
"maqunumero":4102,
"maqumarca":null,
"maquano":0,
"maqumodelo":null,
"etracodigo":34,
"maqufechacrea":1603811508000,
"maqufechamodi":1603811508000,
"maquversion":1,
"maqutara":0,
"maqukgs":0.0,
"maqum3":0.0,
"maquismuela":1,
"maqutipomuela":null,
"maquestado":1,
"maquestadomotivo":null,
"maqucolor":null,
"maqucelular":null,
"maquisentrega":1,
"maquisretiro":1,
"maqutdocgarantia":"BOLETA",
"maqundocgarantia":1,
"maqumontodgarantia":1,
"maquistraspasado":0,
"maquisvolumen":1,
"maqufechaing":null,
"maqufechartec":null,
"maqulargo":1.0,
"maquancho":0.0,
"maqualto":0.0,
"maqutipoflota":11,
"usuausuariocrea":"TDGR"
},
"urlImagen":""
}
6
Response
Al momento de hacer envio del request, su endpoint debe tener respuesta exitosa y fallida (Según sea el caso);
este ultimo nos permitirá hacer reintento de envio.
