Diferencia entre revisiones de «SIU-Sanaviron-Quilmes/version2.4.0/suscripciones-migraciones»

De SIU
Saltar a: navegación, buscar
(Recurso Api-rest: suscripciones-migraciones)
 
(No se muestran 6 ediciones intermedias del mismo usuario)
Línea 6: Línea 6:
 
= Recurso Api-rest: suscripciones-migraciones =
 
= Recurso Api-rest: suscripciones-migraciones =
  
Este recurso que se encuentra en la api-rest del módulo SQ-Académico permitirar dar de alta inscripciones asociadas a propuestas.
+
Este recurso que se encuentra en la api-rest del módulo SQ-Académico permitirá dar de alta inscripciones asociadas a propuestas.
  
== Paso a paso ==
+
== Requisitos ==
Crear en Guaraní una propuesta de tipo posgrado, grado o pregrado. Posteriormente dar de alta el plan de estudios y desde la operación Sincronizar novedades con SQ informar la propuesta. Esto creará en SQ-Académico un Servicio.
+
* Tener creada en Guaraní una propuesta de tipo posgrado, grado o pregrado.  
  
Desde el recurso api rest  verbo POST / suscripciones-migraciones ingresar el siguiente modelo  
+
* Dar de alta un plan de estudios
 +
 
 +
* Desde la operación '''Sincronizar novedades con SQ''' informar la propuesta. Esto creará en SQ-Académico un servicio.
 +
 
 +
* Desde el recurso api rest  verbo POST / suscripciones-migraciones ingresar el siguiente modelo
 +
 
 +
 
 +
== Consideraciones ==
 +
 
 +
* Si la instancia se crea antes de ingresar la primera suscripción se deberá tomar el código con que se creo y en Datos básico deben estar completos Vigencia hasta e Importe de referencia.
 +
* Si no se accede a la instancia antes de informar la primera suscripción, se creará la instancia con los datos proporcionados en el json.
 +
* El periodo de inicio de Generación de Cuota con el que se creará el servicio instancias y las ventas a generar será el periodo '''actual'''
 +
* Es posible externer la cantidad de cuota para las inscripciones de una instancia a través del recurso [[SIU-Sanaviron-Quilmes/version2.4.0/suscripciones-novedades-extender-cuotas| '''suscripciones-novedades''']].
 +
 
 +
== Descripción de campos ==
 +
 
 +
{| class="wikitable"
 +
|-
 +
!style="width:300px"| '''Campos''' !!style="width:800px"| '''Descripción'''
 +
|-
 +
|  "servicio": "3", ||  Corresponde al id_externo del servicio. Tomarlo de la tabla servicios. Es un dato informado por Guaraní con la propuesta.
 +
|-
 +
| "id_tipo_servicio": 5, ||  Corresponde al tipo de propuesta. Valores posibles: 4 - Posgrados, 5 - Grado/Pregrado
 +
|-
 +
| "numero_inscripcion": 5474, ||  Corresponde al número de inscripción del alumno que genera Guaraní.
 +
|-
 +
| "medio_pago": 14, ||  Corresponde al id_medio_pago que se deberá tomar de la tabla medios_pagos.
 +
Valores posibles 5 - Mercadopago, 12 - Pago en ventanilla, 13 - Trasferencia bancaria, 14 - PagoTIC
 +
|-
 +
|  "importe_total": 15000, ||  Dato obligatorio, similar al importe de la instancia.
 +
|-
 +
|  "id_externo": 6, ||  Corresponde al '''id''' persona tomado de la tabla negocio.mdp_personas de Guaraní
 +
|-
 +
|  "codigo": "2023_anual", ||  Corresponde al código con que se creará la instancia en SQ-Académico
 +
|-
 +
|    "anio": "2023", ||  Corresponde al año en que se creará la instancia
 +
|-
 +
|    "vigencia_desde": "2023-07-01", ||  Corresponde a la fecha de creación de la instancia
 +
|-
 +
|    "acepta_suscripciones": true, ||  Permite migrar inscripciones sobre la instancia
 +
|-
 +
|    "importe_total": 15000, ||  Corresponde al importe total de referencia de la instancia (Datos básicos)
 +
|-
 +
|    "frecuencia_facturacion": 2 ||  Corresponde a la frecuencia con que se generarán las cuotas. Valores posibles: 2 - Mensual, 6 - Siempre.
 +
Cuando se define una cantidad de cuotas limitada utilizar 2 mensual.
 +
Cuando las cuotas se generarán mes a mes indefinidamente utilizar 6 - siempre.
 +
|-
 +
|    "cantidad": 2,  <br /> "importe": 7500 ||    Cantidad de cuotas a generar, cada una por el importe ingresado. Si se configura la frecuencia 6 solo será necesario ingresar 1 como cantidad.
 +
|-
 +
|}
  
 
== Modelo json ==
 
== Modelo json ==
Línea 45: Línea 94:
 
]  <br />
 
]  <br />
 
}  <br />
 
}  <br />
 
== Consideraciones ==
 
 
* Si la instancia se crea antes de ingresar la primera suscripción se deberá tomar el código con que se creo y en Datos básico deben estar completos Vigencia hasta e Importe de referencia.
 
* Si no se accede a la instancia antes de informar la primera suscripción, se creará la instancia con los datos proporcionados en el json.
 
* El periodo de inicio de Generación de Cuota que se con el que se creará el servicio instancias y las ventas a generar será el periodo actual
 
 
== Descripción de campos ==
 
 
 
 
{| class="wikitable"
 
|-
 
!style="width:300px"| '''Campos''' !!style="width:800px"| '''Descripción'''
 
|-
 
|  "servicio": "3", ||  id_externo del servicio. Tomarlo de la tabla servicios. Es un dato informado por Guaraní.
 
|-
 
| "id_tipo_servicio": 5, ||  Corresponde al tipo de propuesta. Valores posibles: 4 - Posgrados, 5 - Grado/Pregrado
 
|-
 
| "numero_inscripcion": 5474, ||  Número de inscripción del alumno que se debe tomar de Guaraní.
 
|-
 
| "medio_pago": 14, ||  id_medio_pago que se deberá tomar de la tabla medios_pagos.
 
Valores posibles 5 - Mercadopago, 12 - Pago en ventanilla, 13 - Trasferencia bancaria, 14 - PagoTIC
 
|-
 
|  "importe_total": 15000, ||  Dato obligatorio, similar al importe de la instancia.
 
|-
 
|    "id_externo": 6, ||  id persona tomado de la tabla negocio.mdp_personas de Guaraní
 
|-
 
|    "codigo": "2023_anual", ||  Código con que se creará la instancia
 
|-
 
|    "anio": "2023", ||  Año en que se creará la instancia
 
|-
 
|    "vigencia_desde": "2023-07-01", ||  Fecha de creación de la instancia
 
|-
 
|    "acepta_suscripciones": true, ||  Permite migrar inscripciones sobre la instancia
 
|-
 
|    "importe_total": 15000, ||  Importe total de referencia de la instancia
 
|-
 
|    "frecuencia_facturacion": 2 ||  Frecuencia con que se generarán las cuotas.
 
Valores posibles: 2 - Mensual, 6 - Siempre.
 
Cuando se define una cantidad de cuotas limitada utilizar 2.
 
Cuando las cuotas se generarán mes a mes indefinidamente utilizar 6.
 
|-
 
|    "cantidad": 2,  <br /> "importe": 7500 ||    Cantidad de cuotas a generar, cada una por el importe ingresado. Si se configura la frecuencia 6 solo será necesario ingresar 1 como cantidad.
 
|-
 
|}
 

Revisión actual del 12:53 23 ago 2023

ISOSIU-SQ.png

< Volver

Recurso Api-rest: suscripciones-migraciones

Este recurso que se encuentra en la api-rest del módulo SQ-Académico permitirá dar de alta inscripciones asociadas a propuestas.

Requisitos

  • Tener creada en Guaraní una propuesta de tipo posgrado, grado o pregrado.
  • Dar de alta un plan de estudios
  • Desde la operación Sincronizar novedades con SQ informar la propuesta. Esto creará en SQ-Académico un servicio.
  • Desde el recurso api rest verbo POST / suscripciones-migraciones ingresar el siguiente modelo


Consideraciones

  • Si la instancia se crea antes de ingresar la primera suscripción se deberá tomar el código con que se creo y en Datos básico deben estar completos Vigencia hasta e Importe de referencia.
  • Si no se accede a la instancia antes de informar la primera suscripción, se creará la instancia con los datos proporcionados en el json.
  • El periodo de inicio de Generación de Cuota con el que se creará el servicio instancias y las ventas a generar será el periodo actual
  • Es posible externer la cantidad de cuota para las inscripciones de una instancia a través del recurso suscripciones-novedades.

Descripción de campos

Campos Descripción
"servicio": "3", Corresponde al id_externo del servicio. Tomarlo de la tabla servicios. Es un dato informado por Guaraní con la propuesta.
"id_tipo_servicio": 5, Corresponde al tipo de propuesta. Valores posibles: 4 - Posgrados, 5 - Grado/Pregrado
"numero_inscripcion": 5474, Corresponde al número de inscripción del alumno que genera Guaraní.
"medio_pago": 14, Corresponde al id_medio_pago que se deberá tomar de la tabla medios_pagos.

Valores posibles 5 - Mercadopago, 12 - Pago en ventanilla, 13 - Trasferencia bancaria, 14 - PagoTIC

"importe_total": 15000, Dato obligatorio, similar al importe de la instancia.
"id_externo": 6, Corresponde al id persona tomado de la tabla negocio.mdp_personas de Guaraní
"codigo": "2023_anual", Corresponde al código con que se creará la instancia en SQ-Académico
"anio": "2023", Corresponde al año en que se creará la instancia
"vigencia_desde": "2023-07-01", Corresponde a la fecha de creación de la instancia
"acepta_suscripciones": true, Permite migrar inscripciones sobre la instancia
"importe_total": 15000, Corresponde al importe total de referencia de la instancia (Datos básicos)
"frecuencia_facturacion": 2 Corresponde a la frecuencia con que se generarán las cuotas. Valores posibles: 2 - Mensual, 6 - Siempre.

Cuando se define una cantidad de cuotas limitada utilizar 2 mensual. Cuando las cuotas se generarán mes a mes indefinidamente utilizar 6 - siempre.

"cantidad": 2,
"importe": 7500
Cantidad de cuotas a generar, cada una por el importe ingresado. Si se configura la frecuencia 6 solo será necesario ingresar 1 como cantidad.

Modelo json

{
"servicio": "3",
"id_tipo_servicio": 5,
"numero_inscripcion": 5474,
"fecha_inscripcion": "2023-08-11",
"medio_pago": 14,
"importe_total": 15000,
"cliente": {
"id_global": null,
"id_externo": 6,
"tipo_documento": 0,
"numero_documento": "14141416",
"apellido": "Beteguin",
"nombres": "Ariel"
},
"instancia": {
"codigo": "2023_anual",
"anio": "2023",
"vigencia_desde": "2023-07-01",
"acepta_suscripciones": true,
"importe_total": 15000,
"frecuencia_facturacion": 2
},
"a_cobrar": [
{
"cantidad": 2,
"importe": 7500
}
]
}