Conexión de Topsort com sistemas de gestión de pedidos
Os sistemas de gestión de pedidos (OMS), como Vantage, Boostr, ADvendio e Placements.io, ajudan a os varejistas a gerenciar a planificação de campanhas, as reservas e o inventario. Você pode integrar estos sistemas com as API de Topsort para automatizar a creação e gestión de campanhas.
Esta guia mostra como integrar OMS com Topsort utilizando as API existentes para flujos de trabajo de campanhas automatizadas.
Flujos de trabajo
A integração do OMS implica tres flujos de trabajo principales para diferentes roles e momentos:
| Flujo de trabajo | Quién | Cuándo | Objetivo |
|---|---|---|---|
| Guía de implementação | Equipo de DevOps/Integração | Configuração única | Establecer sincronização automatizada de OMS ↔ Topsort |
| Creação de campanhas | Gestores de campanhas/Equipos de ventas | Por campanha | Criar campanhas automáticamente a partir de dados de OMS |
| Sincronização de desempenho | Equipos de marketing | En curso | Incorporar o desempenho das campanhas a os paneles de OMS |
Como Funciona a integração de OMS
- Planificação de campanhas: Os equipos de ventas planifican as campanhas en seu interfaz OMS.
- Creação automatizada: OMS envía dados de campanha a Topsort através de llamadas a API.
- Actualizaciones em tempo real: As notificaciones de webhook mantêm os sistemas sincronizados.
- Relatórios unificados: Os dados de desempenho se envían de vuelta a os paneles de control de OMS.
Ejemplo de implementação
Creação de campanhas a partir de dados de OMS
Rol: Gestores de campanhas/Equipos de ventas | Frecuencia: Por campanha
Integração de webhook para actualizaciones em tempo real
Referencia API
API Topsort actuales para a integração
| API | Caso de uso de integração | Estado | Documentação |
|---|---|---|---|
| Campanha api | Crea campanhas com estrategia de puja, presupuesto e segmentação | ✅ Disponible | Gestión completa do ciclo de vida da campanha |
| Recursos api | URL de referencia de recursos en campanhas | ✅ Disponible | Gestión e colecciones de recursos |
| Relatórios api | Obter dados de desempenho para OMS/paneles de control | ✅ Disponible | Relatórios de campanha, proveedor e marketplace |
| Leilãos api | Configurar parámetros do seubasta e pujas | ✅ Disponible | Configuração do seubastas |
Autenticação
Operaciones de campanha masivas
Recuperação de dados de desempenho para paneles de control de OMS
Rol: Equipos de Marketing | Frecuencia: Continua/Programada
Melhores Práticas
Sincronização de datos
- Asignação de campos: Asigne os campos de campanha de OMS a os parámetros Topsort e API.
- Validação de datos: Validar os dados da campanha antes de enviaros a as API de Topsort
- Operaciones masivas: Utilice o procesamiento por lotes para a gestión de campanhas a escaa empresarial.
Manejo de errores
- Lógica de reintento: Implementar un retroceso exponenciao para as llamadas fallidas a API
- Registro completo: Seguimiento de todas as interacciones e falos de API
- Monitoreo de salud: Configurar alertas para problemas de integração
Seguridade
- Gestión de claves API: Almacene as claves API de forma segura e róteas periódicamente.
- Limitação de velocidade: Respete os límites de velocidade de API para evitar a limitação de ancho de banda.
- Sanitização de entrada: Validar todos os datos antes de enviaros a as API.
Guía de implementação
1
API Configuração de acceso
Obtenga as claves Topsort e API e configure a autenticação:
- Solicite a clave avanzada API a seu representante de Topsort
- Almacena as claves API de forma segura en suas variables de entorno
- Configurar os encabezados de autenticação para todas as llamadas a API
2
Configuração de webhook
Configura os endpoints de webhook para actualizaciones de campanha em tempo real:
- Crea un punto de conexión webhook en sua sistema OMS
- Registra o webhook URL com Topsort para eventos de campanha
- Implementar controladores para eventos de creação/actualização/eliminação de campanhas
3
Asignação de campos de datos
Asignar os campos da campanha de OMS a os parámetros Topsort e API:
- Asignação de campos de documentos entre sistemas
- Implementar a lógica de transformação de datos
- Verificar que os campos obligatorios estejan presentes
4
Implementação do manejo de errores
Implemente una lógica integrao de manejo de errores e reintentos:
- Implementar retroceso exponenciao para llamadas fallidas a API
- Agregar registro completo para depuração
- Configurar alertas para falos de integração
5
Pruebas e validação
Prueba a integração com dados de prueba antes da producção:
- Criar campanhas de prueba através de o flujo de trabajo de OMS
- Verificar que as campanhas aparezcan correctamente en Topsort
- Prueba de entrega e manejo de webhooks
6
Monitoreo e mantenimiento
Establecer un sistema de monitoreo continuo para a integração:
- Seguimiento das tasas de éxito/fracaso das llamadas a API
- Supervisar o desempenho da creação de campanhas
- Configurar paneles de control para o estado da integração
Recursos relacionados
- Guía de integração de DAM - Conectividade de gestión de activos digitales
- Documentação da campanha api
- Documentação de informes api
¿Listo para integrar seu OMS com Topsort? Póngase en contacto com seu representante de cuenta para comenzar com o acceso a API e o soporte de implementação.
Last updated: