Los servicios de integración disponibles a través del School Service Bus, permiten a aplicaciones de terceros interactuar con las herramientas administrativas de BDC. Actualmente los siguientes sistemas intercambian datos de las entidades Colegio, Colegio-Nivel, Artículos y Contratos con BDC:
- CRM - Microsoft Dynamics
- ERP - EMS, SAP y Navision
- Sistemas Legacy - PRSAC
...
Una vez que se cuenta con los catálogos necesarios, es posible proceder a la creación de un colegio y/o institución , el cual se lleva o la modificación de una entidad existente; estos procesos se llevan a cabo por medio del servicio School; éste , el cual cuenta con un llamado POST y un llamado PUT.
...
| Proceso | Servicio | Tipo de llamado | Campos de búsqueda | Campos de datos únicos |
|---|---|---|---|---|
| Creación de colegio | School | POST | colegio_id; colegio_clave | colegio_id (automático asignado por sistema), colegio_clave, crm_id, erp_id (sap_id). |
| Descripción de campos: | ||||
| Campo | Tipo | Longitud | Valor por defecto | Observaciones |
| colegio_id | int | 11 | 0 | colegio_id Ej. 8125 |
| pais_id | int | 11 | id del país de la empresa que crea el colegio | Sólo los niveles escolares se crean en la empresa correspondiente |
| colegio_clave | varchar | 50 | Definido por negocio | En la integración con CRM este valor es el mismo que el colegio_id |
| crm_id | varchar | 100 | El id registrado en CRM | El mismo |
| erp_id | varchar | 20 | Valor correspondiente a la entidad en el ERP | Sólo es obligatorio en el caso de que exista alguna interfaz hacia el ERP |
...
| Proceso | Servicio | Tipo de llamado | Campos de búsqueda | Campos de datos únicos |
|---|---|---|---|---|
| Actualización/edición de un colegio | School | PUT | colegio_id; colegio_clave | colegio_id (automático asignado por sistema), colegio_clave, crm_id, erp_id (sap_id). |
| Descripción de campos | ||||
| Campo | Tipo | Longitud | Valor por defecto | Observaciones |
| colegio_clave | varchar | 50 | Definido por negocio | En el caso de interfaz desde CRM, si no se informa, se toma el id del colegio |
| colegio | varchar | 255 | Definido por negocio | |
| colegio_orden | int | 11 | 0 | Cuando se necesita una ordenación especial en informes o vistas |
| alias | varchar | 255 | Definido por negocio | Si se requiere un nombre diferente al oficial, se usa este campo |
| demo | int | 11 | 0 | Se activa cuando el colegio es únicamente para demostración o pruebas |
| baja | int | 11 | 0 | Cuando un colegio ya no es parte del programa, se da de baja, acompañado de una razón de baja |
| erp_id | varchar | 20 | NULL | Código asociado al colegio en el ERP (cuando proceda) |
| crm_id | varchar | 100 | NULL | Código asociado al colegio en el CRM (cuando corresponda) |
| embajador | ||||
Una vez que creado el colegio y se obtiene el su ID del colegio , es necesario realizar la creación de los niveles , ya que sin niveles escolares que contendrá el colegio. Sin niveles, el colegio no estará visible para ninguna plataforma administrativa. La entidad Colegio Nivel Ciclo es considerada única en Cada país tiene su propia estructura de niveles escolares, y éstos son válidos para todas las empresas que se creen en cada país.
La entidad Colegio Nivel Ciclo es considerada única en BBDD por los siguientes campos: colegio_nivel_ciclo_id, clave, crm_id y erp_id (sap_id) tanto en la creación cómo como en la modificación, estos datos son considerados para una búsqueda de duplicidad. El servicio collegeLevelCycle cuenta con un llamado POST Y y un llamado PUT.
- colegio_nivel_ciclo_id: En un llamado tipo POST el , este dato deberá ir en 0, cómo . Como respuesta tendremos su ID correspondiente en BDC, el cual deberá sustituir al 0 en un llamado PUT.
- clave: Identificador único el cual deberá tener una longitud de 50 caracteres como máximo, este será definido por el negocio.
- crm_id: Aunque no es un campo obligatorio se sugiere que para integraciones con CRM se mande la información ya que es un identificador único del nivel en su sistema .
- erp_id: Este campo no es obligatorio sin embargo si se cuenta con la información del id del sistema que se integra ya sea ERP, SAP es posible utilizar este tag para almacenamiento y tener el id único del nivel de su base de datos.
| Proceso | Servicio | Tipo de llamado | Campos de búsqueda | Campos de datos únicos |
|---|---|---|---|---|
| Creación de Nivel de Colegio | collegeLevelCycle | POST | colegio_nivel_ciclo_id, clave | colegio_nivel_ciclo_id, clave, crm_id, erp_id |
| Descripción de campos | ||||
| Campo | Tipo | Longitud | Valor por defecto | Observaciones |
| colegio_nivel_ciclo_id | int | 11 | 0 | En el llamado POST, siempre debe ir en cero. |
| colegio_id | int | 11 | ID del colegio | Campo requerido en el llamado POST, se debe indicar el id del colegio al que se le crea el nivel escolar |
| erp_id | varchar | 35 | Definido por negocio | Clave o código identificador del colegio en el ERP |
| crm_id | varchar | 100 | Valor del CRM | Es el indicador único del nivel del colegio en el CRM |
| empresa_id | int | 11 | ID de la empresa | Identificador de la empresa en la que se crea el nivel |
| nivel_id | int | 11 | ID del nivel | Los niveles se crean por país y aplican a todos los colegios |
| ciclo_escolar_id | int | 11 | ID del ciclo escolar | Identificador único del ciclo escolar; los ciclos escolares pueden variar en las empresas de cada país |
| clave | varchar | 50 | Definido por negocio | Clave otorgada por negocio al nivel del colegio |
| clave_oficial | varchar | 100 | Definida por negocio | Es la clave otorgada por los ministerios de educación a cada nivel escolar de los colegios. |
Campos editables en un llamado PUT:
...