API Prisma Altas: Tramitación de Altas y Bajas de trabajadores
Consulta las especificaciones de la API de Prisma Altas e integra la tramitación de altas y bajas en la Tesorería de la Seguridad Social en tu propia plataforma. También puedes utilizar servicios ya integrados como Prisma Form, que permite realizar las tramitaciones de Altas y Bajas de Trabajadores desde tu página web.
Login
Para iniciar sesión en la API, debes enviar una petición con el nombre de usuario y contraseña proporcionados.Si la información es correcta, los datos de respuesta incluirán un token jwt que debes usar en el resto de peticiones.
Debes enviar una petición tipo POST a: /auth/local
Si usas Postman o similar, debes fijar el Body como RAW con el tipo JSON (application/json).
{
"identifier": "usuario@email.com",
"password": "miclave"
}
La respuesta incluye el token jwt que debe usarse en posteriores consultas.
{
"jwt": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MSwiaWF0IjoxNTc2OtzDEsU",
"user": {
"id": 1,
"username": "usuario",
...
}
}
Enviar una Tramitación
Petición para enviar una tramitación de Alta o Baja a Prisma.
POST https://api.createapps.es/miendpoint
[{
"tipoTramitacion":"Alta", ## Dos valores posibles: Alta o Baja.
"claveBaja": "93", ## Tipo baja en Seguridad Social
"idEmpresa":"bxxxxxxx", ## CIF Emmpresa
"provinciaNaf":"10", ## Código provincial del NAF. 2 dígitos.
"naf":"0493049304", ## Número de Afiliación sin el código provincial.
"tipoIdentificacionPersFisicas":1 o 6, ## Tipo de Identificador del Trabajador. 1 = DNI; 6 = NIE.
"identificacionPersFisicas":"05132135B", ## DNI o NIE. Si es NIE debe comenzar con un cero. Ej: 0Y029302E
"regimen":"0111", ## código de régimen
"modalidadCotizacion":null, ## Campo Opcional. Numérico. Código de Modalidad de Cotización.
"ccc1":"10", ## Código provincial del Código de Cuenta de Cotización. 2 dígitos.
"ccc2":"029403949", ## Código de Cuenta sin código provincial.
"diaAlta":"25", ## Dia de alta. 2 dígitos.
"mesAlta":"07", ## Mes de Alta. 2 dígitos.
"yearAlta":2020, ## Año de alta. 4 dígitos.
"idTramitacion":"1", ## Identificador de Tramitación. Campo opcional de texto.
"grupoCotizacion":"08", ## Código de grupo de cotización. 2 Dígitos.
"tipoContrato":401, ## Código de Tipo de Contrato.
"iCotizMensual":"No", ## Dos valores posibles. Si o No.
"convenioColectivo":"5454544545455", ## Código de convenio colectivo.
"colectivoTrabajador": "968",
"coeficienteParcialidad":null, ## Campo opcional. Numérico.
"emailEmpresa":"empresa@email.com", ## Email cliente
"emailAsesoria":"asesoria@email.com", ## Email despacho
}]
Respuesta
[{
"id":1,
"tipoTramitacion":"Alta",
"claveBaja": "93",
"idEmpresa":"bxxxxxxxx",
"provinciaNaf":"10",
"naf":"0493049304",
"tipoIdentificacionPersFisicas":1 o 6,
"identificacionPersFisicas":"05132135B",
"regimen":"0111",
"modalidadCotizacion":null,
"ccc1":"10",
"ccc2":"029403949",
"diaAlta":"25",
"mesAlta":"07",
"yearAlta":2020,
"idTramitacion":"1",
"grupoCotizacion":"08",
"tipoContrato":401,
"iCotizMensual":"No",
"convenioColectivo":"5454544545455",
"coeficienteParcialidad":null,
"emailEmpresa":"empresa@email.com",
"emailAsesoria":"asesoria@email.com",
"resultadoTramitacion":"EnProceso",
"codigoCliente":"0294049",
"colectivoTrabajador": "968",
"created_at":"2020-07-20T09:30:40.883Z",
"updated_at":"2020-07-21T11:28:06.444Z"
}]
Consultar Estado de una tramitación
Devuelve una tramitación por su Identificador.
GET https://api.createapps.es/miendpoint/1
Consultar Todas las Tramitaciones
Devuelve todas las tramitaciones.
GET https://api.createapps.es/miendpoint
Contar Tramitaciones
Devuelve el número de tramitaciones que coinciden con los parámetros
GET https://api.createapps.es/miendpoint/count
Filtros
Puedes pasar los filtros en la raiz de la petición o bien con el parámetro _where.
eq: Igual
ne: No igual
lt: Menor que
gt: Mayor que
lte: Menor o igual que
gte: Mayor o igual que
contains: Contiene
Ejemplo:
Tramitaciones que contienen un email específico:
GET /miendpoint?emailEmpresa_eq=email@email.com
Resultado de la tramitación
El campo resultadoTramitacion te informará del estado de la tramitación en cada petición. Ten en cuenta que cada tramitación necesita unos segundos en completarse, por lo que tendrás que consultar el estado pasado un tiempo.
Si el resultado de una tramitación no es completado correctamente, debes volver a enviar la petición por completo.
Valores disponibles del campo resultadoTramitación:
PETICION REALIZADA CORRECTAMENTE: La petición se ha tramitado
correctamente en la Tesorería de la Seguridad Social.
MOVIMIENTO PREVIO ERRONEO - AFILIADO EN ALTA PREVIA: El Afiliado ya se
encuentra en situación de alta.
NÚMERO DE AFILIADO INCORRECTO: El Número de Afiliación no se
corresponde con ningún afiliado.
CUENTA DE COTIZACION ERRONEA: La Cuenta de Cotización del cliente
no es correcta.
AFILIADO EN SITUACION DE ALTA EN CUENTA DE COTIZACION DADA: El Afiliado ya se encuentra
en alta.
API Prisma Altas
Integra la posibilidad de realizar tramitaciones de alta y baja de trabajadores en la Tesorería de la Seguridad Social en tu propia plataforma fácilmente.