Consultar tarifas o calcular el precio de certificados
GET/pricing
Requiere autenticación (cualquier usuario). Las tarifas dependen del tipo del usuario autenticado (type_id): 1 → INCLUDED, 2 → SOFTWARE_HOUSE, 3 → SERVER_RANGE_n, 4 → PARTNER_RANGE_n. Precios en COP con IVA incluido. Dos modos: (1) sin quantity y vigencia (o con solo uno de ellos, que se ignora) retorna en dataRecords.data el arreglo de rangos activos del tipo de usuario, ordenados; (2) con ambos parámetros retorna en dataRecords.data un objeto con el precio calculado. En el modo (2), para los tipos 3 y 4 el rango se elige por effective_quantity = certificados vigentes de la empresa + quantity. Se cuentan las solicitudes de la empresa creadas el año actual o el anterior, en estado PROCESSED o PROCESSING, y que sigan vigentes según su vigencia: con life = 1, sin fecha de vencimiento o con vencimiento posterior al momento de la consulta; con life = 2, sin fecha de vencimiento o con vencimiento posterior a un año desde el momento de la consulta (un certificado de 2 años que ya está en su segundo año no se cuenta). Para los demás tipos effective_quantity = quantity. El volumen suma las solicitudes de los dos tipos de emisión. Siempre se factura por quantity. Tipo de emisión (issuance_flow): cada tipo de usuario tiene una lista de precios por tipo de emisión (BIOMETRIC, la de los rangos anteriores, y DOCUMENTARY, rangos DOC_<TIPO>_RANGE_n). Sin issuance_flow se usa el de la empresa (viafirma → BIOMETRIC; mail y dual → DOCUMENTARY); con él, debe estar permitido para la empresa. Siempre se responde con la lista del tipo de emisión solicitado (o el de la empresa si no se envía): los rangos llegan con ese mismo issuance_flow. Un tipo de usuario sin tarifas para el tipo de emisión pedido recibe un arreglo vacío en el modo (1) y 422 PRICING_TIER_NOT_FOUND en el modo (2).
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
- 500
Modo (1): message = Tarifas obtenidas exitosamente y dataRecords.data es un arreglo de rangos. Modo (2): message = Precio calculado exitosamente y dataRecords.data es un objeto de cotización.
No autenticado: token Bearer ausente, inválido, expirado o revocado.
La empresa del usuario está inactiva (solo modo 2).
El usuario no tiene empresa asociada (solo modo 2). En el modo (1) un usuario sin empresa recibe la lista BIOMETRIC si no envía issuance_flow, o la del tipo pedido si lo envía (solo se valida que sea BIOMETRIC o DOCUMENTARY).
Tres casos: (a) modo (2) con parámetros inválidos (quantity no entero o menor que 1, vigencia distinta de 1 o 2): errors y message = Error de validación de datos.; (b) issuance_flow no reconocido o no permitido para la empresa: error_code = INVALID_ISSUANCE_FLOW o ISSUANCE_FLOW_NOT_ALLOWED y errors.issuance_flow; (c) modo (2) sin rango configurado para la cantidad efectiva en la lista del tipo de emisión: error_code = PRICING_TIER_NOT_FOUND y message, p. ej. No se encontró un rango de precios configurado para la cantidad 5.
Límite general de 60 peticiones por minuto excedido.
Error interno.