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

De SIU
Saltar a: navegación, buscar
(Página creada con «<span style="float: right; margin: 0 0 15px 15px;">{{TOClimit|5}}</span> <span style="float: right; margin: 0 0 15px 15px;">Archivo:ISOSIU-SQ.png|derecha|60px||derecha|li...»)
 
 
(No se muestran 7 ediciones intermedias del mismo usuario)
Línea 5: Línea 5:
  
 
= 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 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 [[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 ==
 +
 +
{  <br />
 +
"servicio": "3",  <br />
 +
"id_tipo_servicio": 5,  <br />
 +
"numero_inscripcion": 5474,  <br />
 +
"fecha_inscripcion": "2023-08-11",  <br />
 +
"medio_pago": 14,  <br />
 +
"importe_total": 15000,  <br />
 +
"cliente": {  <br />
 +
"id_global": null,  <br />
 +
"id_externo": 6,  <br />
 +
"tipo_documento": 0,  <br />
 +
"numero_documento": "14141416",  <br />
 +
"apellido": "Beteguin",  <br />
 +
"nombres": "Ariel"  <br />
 +
},  <br />
 +
"instancia": {  <br />
 +
"codigo": "2023_anual",  <br />
 +
"anio": "2023",  <br />
 +
"vigencia_desde": "2023-07-01",  <br />
 +
"acepta_suscripciones": true,  <br />
 +
"importe_total": 15000,  <br />
 +
"frecuencia_facturacion": 2  <br />
 +
},  <br />
 +
"a_cobrar": [  <br />
 +
{  <br />
 +
"cantidad": 2,  <br />
 +
"importe": 7500  <br />
 +
}  <br />
 +
]  <br />
 +
}  <br />

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
}
]
}