Integraciones y acceso por API

Objetivo #

Determinar si Trackberry puede conectarse con el sistema que tiene en mente y qué punto de integración conviene usar.

¿Hay una API pública? #

Sí, de solo lectura. Cualquier miembro puede crear un token de API en Configuración de la organización → Tokens de API y leer envíos, seguimiento, días libres, alertas, verificaciones, documentos y listas de empaque en formato JSON. Consulte La API de Trackberry para los tokens, las versiones y todos los endpoints.

Todavía no puede crear ni modificar nada, y no hay webhooks salientes. Si un endpoint de escritura o un webhook cambiaría su forma de trabajar con Trackberry, cuéntenos qué construiría con él en support@trackberry.com. Un caso de uso concreto pesa mucho.

Lo que puede automatizar hoy #

Gran parte de los datos de Trackberry ya es legible por máquina. Estos son los puntos de integración que existen y tienen soporte.

El correo de entrada es un verdadero punto de integración #

La dirección de su organización, your-slug@in.trackberry.com, acepta correos de cualquier sistema capaz de enviarlos. Todo lo que pueda enviar una lista de empaque por correo puede alimentar a Trackberry: el ERP de un proveedor, el sistema de notificaciones de un agente de carga, una tarea programada en sus propios sistemas.

Los documentos se extraen y se asocian al envío correcto, y el cuerpo del correo se analiza en busca de cambios de estado. No hay credenciales que gestionar de su lado. Consulte Recibir documentos por correo electrónico.

El feed de calendario es una URL en vivo #

El enlace de suscripción ICS descrito en la guía del calendario es una URL estable, con token, que devuelve las llegadas de envíos actuales cada vez que se consulta. Está pensado para aplicaciones de calendario, pero cualquier herramienta que lea ICS puede consultarlo periódicamente.

Dos cosas que debe saber antes de construir sobre él:

• El token da acceso de lectura a los datos de llegadas de su organización. Trátelo como un secreto; Revocar enlace lo invalida de inmediato.
• Devuelve llegadas, no registros completos de envíos. No sustituye a una API.

La integración con ERP se configura con usted, no la configura usted #

Trackberry envía los datos a los sistemas ERP mediante una conexión que nuestro equipo construye y mantiene: a través de la propia API de su ERP, un depósito de archivos o automatización de la interfaz para el software que no tiene ninguna de las dos. Nuestro equipo la configura, así que no es algo que usted configure por su cuenta, y tiene un costo de puesta en marcha y una cuota mensual.

Consulte Exportación de datos e integración con ERP para los métodos, el contenido de la exportación y los precios actuales.

Limitaciones conocidas #

Conocer estos límites de antemano evita descubrirlos a mitad de un desarrollo:

• La API es de solo lectura. Lee lo que usted ve en la aplicación, pero no enlaza a los archivos de los documentos; descárguelos en la aplicación.
• No hay webhooks salientes. Trackberry no puede hacer un POST a su endpoint cuando cambia un envío. Las notificaciones llegan a personas, no a sistemas. Consulte Notificaciones.
• No hay API de escritura. Los envíos se crean por correo, por carga manual o como contenedor borrador, no mediante una solicitud a la API.
• El feed de calendario es de solo lectura y se limita a las llegadas.
• Los formatos de exportación dependen de cada ERP. Hoy está disponible TradaBase XLSX; otras plantillas se crean a pedido.

Obtener ayuda #

Escriba a support@trackberry.com contándonos qué intenta conectar y qué sistema hay del otro lado. Le diremos si un punto de integración existente lo cubre, o qué haría falta para construir uno.