Errores más comunes
Errores controlados (de configuración)
En caso de que no se haya agregado la propiedad server.transportFiscalDocument.certificate , al dataAccess.properties, el smart debería mostrar el siguiente error: Carta porte API error: No se cuenta con el número de certificado para la carta porte.
En caso de que no se haya agregado la propiedad server.transportFiscalDocument.api.url , al dataAccess.properties, el smart debería mostrar el siguiente error: Carta porte API error: No se ha indicado la URL de la API.
En caso de que no se haya agregado la propiedad server.transportFiscalDocument.api.user o server.transportFiscalDocument.api.password al dataAccess.properties o no sean válidos, el smart debería mostrar el siguiente error: Carta porte API error: Carta porte API error: 401 Unauthorized.
En caso de que no se llenen los campos indicados en la Configuración del Centro de Distribución, al iniciar sesión el smart, deberá mostrar el siguiente error: Carta porte API error: El centro de distribución no cuenta con la configuración necesaria para la carta porte.
En caso de que no se llenen los campos correspondientes a las claves de localidad, colonia y municipio, el smart deberá arrojar un mensaje de error: Carta porte API error: Validar que el centro de distribución cuente con las claves de localidad, colonia y municipio. Este mensaje aplica tanto para el centro de distribución como para el empleado.
En caso de que no se llenaran los campos de la carta porte en la Configuración del camión, el smart mostrará el siguiente error: Carta porte API error: El camión no cuenta con la configuración necesaria para la carta porte.
En caso de que no se llenaran los campos de unidad móvil en la Configuración del camión, el smart mostrará el siguiente error: Carta porte API error: Validar que el camión cuente con placas y modelo registrado.
Cabe mencionar que si el operador quiere iniciar sesión en una zona donde no tiene recepción y tiene habilitada el check de carta porte no podrá hacerlo debido a que no y forma de que el smart se comunique con el server y realice el proceso; por lo que es necesario una comunicación constante.
En caso de que tenga la sesión activa (con carta porte vigente) y entre a una zona sin recepción no tendrá problema para operar.
Errores no controlados (de operación)
Este tipo de errores no se tiene un control total, ya que muchos dependen de datos cargados por el usuario, errores al construir el xml, y del SAT. En estos casos es necesario coordinarse con el PAC para detectar a detalle el error y en su caso el dato que no está permitiendo timbrar el documento y corregirlo.
Un caso muy común donde el documento no se timbra, ocasionando que el smart por 10 minutos intente obtener el QR sin éxito (No se pudo realizar la descarga de Carta Porte) es cuando el autotanque (UDR) no cuenta con una capacidad o no es mayor a cero
Otro error por el cual no se timbra un documento ocasionando lo mismo que lo anterior es cuando las direcciones (claves sat) no son válidas, es decir, que no coincidan la localidad - colonia - municipio, o que no se hayan cargado correctamente desde el csv (esto sucede cuando al abrir el archivo desde excel se pierden los ceros de la izquierda de la clave; por ejemplo 047 a 47), para esto siempre hay que ingresar una comilla simple antes del número: '047, y si se vuelve a abrir volverla a poner.
Hay un caso muy común en los que no se puede obtener el QR que no tiene que ver con un error, si no que el teléfono tiene como límite 10 min para obtener el archivo, pero tarda el PAC más de 10 min en timbrar y generar el QR. En caso que haya ocurrido un error inesperado o que no se haya podido obtener el QR, hay que eliminar la caché del teléfono e iniciar nuevamente.
NOTA: Siempre existe la opción de deshabilitar el check de Requiere Carta Porte en el empleado si esta comienza a ser un bloqueante en la operación, así omitiendo la petición de la misma, recordando que el equipo debe estar comunicando para poder refrescar el cambio realizado.