Solinte ® Marca Registrada+ developers

/api.v1/

¡Bienvenido desarrollador!

Tu desarrollo puede incorporar la plataforma de trabajo contable de tu cliente.

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

Empecemos

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

Solinte api.v1 es REST / Json + OAuth 2.0.

Oauth 2.0

Para saber más sobre el protocolo de autorización:

https://solinte.net/OAuth2/

API.V1 Ejemplo

Como ejemplo de una alpicación concreta te proponemos ver la App Solinte oficial para Android.
Disponible en Google Play
Un desarrollo sencillo que aportaría mucho valor a tu trabajo.
Idea: desarrollá una app desde la cual los clientes de tu cliente consultan el saldo de sus cuentas y le informan pagos. Un portal de cuentas completo integrado a tu proyecto.

API.V1 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.V1 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. La respuesta de /api.v1/usuario/perfil está en el objeto solinte.usuario.perfil.

/usuario

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

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

/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

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

/usuario/mensajes

/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.

Estamos trabajando

Te mostramos siempre lo que estamos haciendo para vos. Pronto setearemos un canal en Github para subir clases y fragmentos de código que podrías usar.

Antes de hacer cualquier cambio vamos a notificar con tiempo, nuestra intención es que la .v1 sea mantenida por muchos años más, mejorarla y extenderla.

Gracias por trabajar con nosotros.