solinte.net/api.cc1/

Ahora podés incorporar la plataforma cuentas.club a tu proyecto.

Ideas

Podés desarrollar una app desde la cual los clientes de tu cliente consultan el saldo de sus cuentas y realizan o informan pagos. Un portal de cuentas completo integrado a tu proyecto.

Si tu proyecto es un sistema contable podés ofrecer la integración a un Portal de cuentas corrientes online sin necesidad de desarrollarlo vos mismo.

Empecemos

Es necesario tener creado un usuario Solinte para registrar y conseguir una clave para tu app.

Para conseguir una clave para tu app contactanos desde Soporte.

Hemos desarrollado una api clara y segura. Desde el primer momento nuestro objetivo es facilitar las integraciones y hacer que tu trabajo sea lo más sencillo posible.

Tenemos ganas de ver qué vas a construír con Cuentas Club de Solinte. Sabemos que la mejor forma de que una plataforma crezca es abrirla a gente con ideas innovadoras, equipos y emprendedores que buscan una oportunidad de mejorar su propio proyecto.

Los endpoints que ponemos a tu disposición serán complementados con nuevos a partir de tus comentarios y pedidos.

Lo fundamental

Cuentas Club de Solinte api.cc1 es REST / Json + OAuth 2.0.

Para saber más sobre el protocolo de autorización: https://solinte.net/OAuth2/

API.CC1 Scopes

Scopes:

El usuario puede aceptar o no cada uno de los rangos de acceso que le solicitás, tu app debería evaluar si el scope necesario fue otorgado por el usuario para evitar mensajes de error por intentar acceder a un endpoint sin el scope correspondiente concedido por el usuario. De cualquier manera la respuesta de nuestra api indica el tipo de error, así que también deberá reaccionar a los distintos estados. En todo esto te ayudaremos.

API.CC1 Endpoints

Recordá que en todas las llamadas a la Api tenés que enviar acces_token.
La estructura de todas las respuestas coincide con la estructura de las llamadas.

/usuario

Colección de endpoints con las opciones habilitadas para la gestión del usuario.

  • GET /usuario/email

    [solinte] => 
        (
            [usuario] => 
                (
                    [email] => emailusuario@dominio.com
                    [verificado] => 1
                )
	)

/usuario/perfil

  • GET /usuario/perfil

Detalle del perfil del usuario.

"solinte":{
	"scope":true,
	"usuario":{	
		"perfil":{
			"alias_publico":"Mi Nombre de Usuario",
			"ocupacion":"estudiante",
			"vive_en":"Ciudad Provincia Pais",
			"sitio_web":""
		}
	}
}

/usuario/roles

  • GET /usuario/roles

Detalle de los Roles incorporados por el usuario

"solinte":{
	"scope":true,
	"usuario":{
		"roles":[{
			"rid":"396367011992",
			"denominacion":"Cuenta de Mi Hija Rosella en Demo10 (1059)",
			"verificadores":"RR",
			"codigo":"asCdy7YpST",
			"tipo_codigo":"26",
			"tipo_descripcion":"ver cuenta corriente",
			"sucursal":{
				"denominacion":"DEMO Sucursal 10",
				"cuis":"DEMO10",
				"portal":"https:\/\/solinte.net\/portal\/DEMO10",
				"portal_habilitado":"1",
				"img_encabezado":"https:\/\/solinte.net\/portales\/media\/encabezados\/1408585415.png"}
			},{
			"rid":"124025214809",
			"denominacion":"Solinte para DEMO Empresa Sincronizada por demo10@solinte.net en 2016\/05\/19 11:2",
			"verificadores":"LO",
			"codigo":"vFO8CiAFrm",
			"tipo_codigo":"26",
			"tipo_descripcion":"ver cuenta corriente",
			"sucursal":{
				"denominacion":"Servicios y Tienda Web Solinte",
				"cuis":"SLNTSS02",
				"portal":"https:\/\/solinte.net\/portal\/SLNTSS02",
				"portal_habilitado":"1",
				"img_encabezado":"https:\/\/solinte.net\/portales\/media\/encabezados\/1466087228.png"}
			}
		]
	}
}

  • GET /usuario/roles/saldo/{rid}/{fecha}

El valor de 'rid' lo tomamos de los valores devueltos por usuario/roles. El valor de 'fecha' debe ser de formato YYYY-MM-DD o la palabra 'hoy'. En caso de ser una fecha no válida, un formato incorrecto o una fecha superior a la actual, tomará el valor de fecha actual.

"solinte":{
	"scope":true,
	"usuario":{
		"roles":{
			"saldo":{
				"rid":"396367011992",
				"denominacion":"Cuenta de Mi Hija Rosella en Demo10 (1059)",
				"verificadores":"RR",
				"codigo":"asCdy7YpST",
				"tipo_codigo":"26",
				"tipo_descripcion":"ver cuenta corriente",
				"fecha":"2016-07-12",
				"saldo":1330,
				"d_h":"d",
				"sucursal":{
					"denominacion":"DEMO Sucursal 10",
					"cuis":"DEMO10",
					"portal":"https:\/\/solinte.net\/portal\/DEMO10",
					"portal_habilitado":"1",
					"img_encabezado":"https:\/\/solinte.net\/portales\/media\/encabezados\/1408585415.png"
				}
			}
		}
	}
}

  • POST /usuario/roles/incorpora

    Recibe y verifica los datos para incorporar un Rol desde la Api.
    Parámetros que necesita:

    • acces_token : "f45d30691b92ec3a2c3b76b06d126c406e85692e"
    • descripcion : "DESCRIPCIÓN DEL ROL"
    • cuis : "CUIS_SUCURSAL"
    • rol_codigo : "09F234309DKWEOIPR"
    • rol_verificador : "XX"

  • POST /usuario/roles/oculta

    Oculta un Rol del listado de Roles del Usuario.
    Parámetros que necesita:

    • acces_token : "f45d30691b92ec3a2c3b76b06d126c406e85692e"
    • rid : "396367011992"

  • POST /usuario/roles/renombra

    Reemplaza la denominación actual de un rol por la nueva, luego de validar que no esté vacía.
    Parámetros que necesita:

    • acces_token : "f45d30691b92ec3a2c3b76b06d126c406e85692e"
    • rid : "396367011992"
    • descripcion : "NUEVA DESCRIPCIÓN"

  • POST /usuario/roles/comparte

    El sistema genera un link de acceso para que quien lo reciba y acceda pueda incorporar el mismo rol que el usuario.
    Parámetros que necesita:

    • acces_token : "f45d30691b92ec3a2c3b76b06d126c406e85692e"
    • rid : "396367011992"
    • metodo : ["email"|"link"]
    • emails : "emaildestinatario@dominio.com otrodestinatario@dominio.com"

/usuario/contactos

  • GET /usuario/contactos

Devuelve un listado con los usuarios Solinte que están en la lista de contactos del usuario dueño del recurso.

"solinte": {
	"scope": true,
	"usuario": {
		"contactos": {
			"cantidad": 3,
			"nus1": {
				"ensucus": null,
				"alias_publico": demon10,
				"vive_en": "  ",
				"web": null,
				"archivo_foto": null,
				"apodo": "Demo 10",
				"cid": "10201"
			},
			"nus2": {
				"ensucus": "",
				"alias_publico": null,
				"vive_en": "  ",
				"web": null,
				"archivo_foto": null,
				"apodo": "Mi amigo Jorge",
				"cid": "10298"
			},
			"nus3": {
				"ensucus": "",
				"alias_publico": Mabel,
				"vive_en": "  ",
				"web": null,
				"archivo_foto": null,
				"apodo": "null",
				"cid": "10398"
			}
		}
	}	
}

  • POST /usuario/contactos

/usuario/mensajes

  • GET /usuario/mensajes/nuevos

  • GET /usuario/mensajes

  • POST /usuario/mensajes

/usuario/permisos

  • GET /usuario/permisos

/organizacion

En cada endpoint de la colección ORGANIZACION el usuario debe tener la clase y el nivel de permiso necesarios otorgados por los responsables de la organización para ejecutar la acción correspondiente al endpoint.

  • GET /organizacion/{CUIS}/comunicaciones

  • GET /organizacion/{CUIS}/permisos

Estamos pensando en vos y en tus clientes

Te mostramos siempre lo que estamos haciendo. Escuchamos sugerencias y propuestas.

Gracias por trabajar con nosotros.