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...»)
 
(Recurso Api-rest: suscripciones-migraciones)
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 permitirar dar de alta inscripciones asociadas a propuestas.
 +
 +
== Paso a paso ==
 +
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.
 +
 +
Desde el recurso api rest  verbo POST / suscripciones-migraciones ingresar el siguiente modelo
 +
 +
== 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 />
 +
 +
== 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 del 15:13 16 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 permitirar dar de alta inscripciones asociadas a propuestas.

Paso a paso

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.

Desde el recurso api rest verbo POST / suscripciones-migraciones ingresar el siguiente modelo

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

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

Campos 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,
"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.