SelSup Developers

Plataforma SelSup · Guías

Extensiones e integraciones personalizadas

Elegir entre un servicio de backend externo, una interfaz de usuario de React integrada y un mercado o módulo de entrega del lado del servidor.

5 seccionesGuía para desarrolladores
→

La mayoría de las integraciones deben comenzar como un backend externo utilizando el público API. Una interfaz de usuario integrada es apropiada cuando los usuarios deben operar la función directamente dentro de SelSup.

Desarrolladores de aplicaciones y socios tecnológicos

01

Seleccione el tipo de integración

  1. 1

    Servicio de backend externo

    Lo mejor para ERP, tienda web, WMS, BI y sincronización similar. El token se queda en su servidor y los datos se mueven a través de API y webhooks.

  2. 2

    Extensión de reacción

    Utilice para una interfaz de usuario que debe ejecutarse dentro de SelSup y reutilizar los patrones de interacción del producto.

  3. 3

    Modulo de backend SelSup

    Requerido para una integración profunda del mercado o de entrega que participe en procesos compartidos de fondo SelSup.

i
Comience con una hoja vertical delgada

Implementar un flujo de trabajo completo y su observabilidad primero. Agregar importaciones en granel, UI y más tipos de eventos después de que la reconciliación sea estable.

02

Arquitectura de aplicaciones externas

Mantenga el token en un administrador de secretos y llame a SelSup solo desde su backend. Su aplicación de navegador debe hablar con su API y nunca recibir el token SelSup.

Separar el adaptador SelSup, la cola de trabajo y el modelo de dominio. Cambios de contrato API se mantienen aislados del resto de la aplicación.

Utilice una bandeja de entrada para eventos entrantes y una bandeya de salida para cambios salientes. Ambas revistas deben admitir la repetición y la auditoría.

Flujo de datos · Text
SelSup webhook → inbox → domain worker → ERP/WMS
ERP/WMS change → outbox → SelSup API → reconciliation

Puntos finales API relacionados

GET/api/product/findEjemplo de lectura del diccionarioGET/api/order/findEjemplo de sincronización incremental

03

Extensión de React incorporada

El componente se ejecuta dentro de la interfaz SelSup. Un dominio externo debe permitir las solicitudes de selsup.ru y manejar correctamente las restricciones del navegador.

Nunca coloque un token API permanente en el paquete. Ruta el trabajo privilegiado a través de su backend y el contexto de usuario de corta duración definido por la arquitectura de extensión.

Combine los patrones de interacción del producto y cubra los estados accesibles de vacío, carga y error.

!
El CORS no es autorización

Un origen permitido controla el acceso del navegador pero no autentica a un usuario.

Componente de demostración · URL
https://github.com/SelSup/component

04

Modulo de integración del lado del servidor

Una integración de mercado normalmente cubre tokens, tarjetas, precios, acciones, pedidos y actualizaciones de estado de fondo.

Este módulo cambia el backend principal de SelSup y sigue su proceso de revisión, prueba, localización y liberación.

Convierta fallos externos de API en valores estables de ApplicationError y tokens externos revocados o inválidos en AccessException de acuerdo con las reglas del proyecto backend.

i
Compatibilidad de los datos compartidos

No agregue campos específicos del mercado a las entidades compartidas. Mantenga contratos en bruto en las ODD de integración y cartografía los límites.

05

Liberación y funcionamiento

  1. 1

    Crear una cuenta de prueba

    Separar los tokens de prueba, los almacenes, los productos y los pedidos de los datos de producción del cliente.

  2. 2

    Añadir observabilidad

    Rastrear retraso en la cola, errores por código, recuentos de retemplajes y discrepancias de reconciliación.

  3. 3

    Plan de migración por contrato

    Apoyar campos antiguos durante una transición y desplegar a los consumidores antes de desactivar el formato antiguo.

  4. 4

    Desconexión de documentos

    Los usuarios deben saber cómo revocar un token, eliminar un webhook y detener la sincronización sin perder datos.