1. Descuentos
  • Uso de API
    • 1. Introducción
    • 2. Ambientes Disponibles
    • 3. Seguridad
    • 4. Respuestas
    • 5. Tipos de Parámetros
    • 6. Errores
    • 7. Por dónde comenzar
    • 8. Webhooks
    • 9.-Adjuntos
  • Apis
    • 8.1. Documentos
      • Nuevo Documento
      • Listar DTEs
      • Listar DTEs V.2
      • Obtener Documento
      • Listar Documentos Adjuntos
      • Adjuntar archivo o documentos a un DTE
      • Dejar un comentario en la bitacora de un documento
      • Listar los registros de bitácora de un DTE
      • Asociar contacto a un DTE
      • Enviar DTE por correo electrónico
      • Generar una acción comercial sobre un DTE
      • Actualizar información de pago de un documento
      • Obtener información de pago de un documento
      • Cargar Borrador DTE
      • Nuevo Documento Portafolio Contrato
      • Carga Masiva Documentos Contrato
      • Listar tipos de Documentos de Escritorio Digital
      • Enviar a flujo expedientes
      • Listar opciones v2
      • Listar flujos para aprobaciones
    • 8.1.2 No Tributario
      • Nuevo Documento No Tributario
      • Listar DNTs
      • Actualizar Documento No Tributario
      • Obtener información de un documento
      • Actualiza Estado de Documento No Tributario
      • Buscar DTE referenciados a un DNT
    • 8.1.3 Documentos Personalizados
      • Convertir documento personalizado a expedientes para Escritorio Digital
      • Obtener listado de documentos personalizados
      • Crear un documento
    • 8.2. Folios
      • Cargar un CAF
      • Anular un CAF
      • Listar CAFs cargados
      • Listar CAFs
      • Solicitar un rango de folios para sucursal
      • Listar rangos de folios entregados a sucursales
      • Listar distribución de folios consumidos y por usar
      • Obtener Folios de un CAF
    • 8.3. Empresas
      • Articulos
        • Categorias
          • Listar categorias
          • Crear Categoria
          • Actualizar
          • Eliminar
        • Descuentos
          • Listar Descuentos
            GET
          • Crear Descuento
            POST
        • Listar artículo de venta
          GET
        • Buscar artículos
          GET
        • Crear artículo de venta
          POST
        • Eliminar artículo de venta
          DELETE
        • Actualizar artículo de venta
          PUT
      • Listar mis empresas
        GET
      • Crear una empresa
        POST
      • Buscar Sucursales de una empresa
        GET
      • Crear sucursal
        POST
      • Actualizar Sucursal
        PUT
      • Eliminar Sucursal
        DELETE
      • Obtener sucursal
        GET
      • Crear Choferes de una empresa
        POST
      • Buscar choferes de una empresa
        GET
      • Obtener Chofer
        GET
      • Actualizar Choferes de una empresa
        PUT
      • Modificar Choferes de una empresa
        PATCH
      • Eliminar chofer
        DELETE
      • Crear transportistas de una empresa
        POST
      • Buscar transportistas de una empresa
        GET
      • Obtener un transportista
        GET
      • Actualizar un transportista
        PUT
      • Modificar un transportista
        PATCH
      • Marcar eliminado un transportista
        DELETE
      • Crear vehiculos de una empresa
        POST
      • Buscar vehiculos de una empresa
        GET
      • Obtener vehiculo
        GET
      • Actualizar vehiculo
        PUT
      • Modificar vehiculo
        PATCH
      • Eliminar Vehiculo
        DELETE
      • Cargar Certificado Digital para la Empresa
        PUT
      • Obtener el certificado digital cargado en el sistema
        GET
      • Listar correos de la empresa enviados o recibidos por medio de Febos
        GET
      • Modificar grupo de unidad organizativa
        PUT
      • Actualizar usuarios de grupo de unidad organizativa
        POST
      • Eliminar grupos de unidad organizativa
        DELETE
      • Crear Lista Personalizada
        POST
      • Listar Lista Personalizada
        GET
      • Eliminar lista personalizada
        DELETE
      • Modificar lista personalizada
        PUT
      • Modificar lista personalizada
        POST
      • Listar elementos de lista personalizada
        GET
      • Invitar Proveedor
        POST
      • Buscar Proveedores
        GET
      • Listar árbol de usuarios dentro de grupos
        GET
      • Listar Unidades y oficinas de Escritorio Digital
        GET
      • Consultar información de una empresa
        GET
      • Lista Suplencias de Empresa
        GET
    • 8.4. Seguridad
      • Listar roles
      • Listar permisos de rol
      • Ingreso programático
      • Crear Token permanente
      • Listar Token
    • 8.5. Utilidades
      • Pre firmar URL para upload
      • Subir archivo para proceso
      • Realizar acción masiva
      • Encolar tarea en background
      • Consulta estado de tarea en background
      • Historial de Eventos
      • Crear ticket de soporte
    • 8.6. SII
      • Generar AEC.
    • 8.7. Firma Electrónica
      • Firmar un documento
      • Recuperar Firmas Disponibles
    • 8.8. Usuarios
      • Listar Usuarios
      • Listar Roles de Usuario
      • Obtener Usuario
      • Latido de usuario
      • Listar Grupos Usuario
    • 8.9. Impuestos
      • Listar Impuestos
    • 8.10. Aprobaciones
      • Previsualización documentos de aprobación
      • Listar Ejecuciones en Aprobaciones
      • Enviar archivo a flujo de firma
      • Obtener estado de ejecucion
    • 10. Configuraciones
      • Obtener objeto con configuraciones
  • Schemas
    • Schemas
      • Aprobaciones
        • AprobacionCrearResponse
        • Aprobacion-Paso
      • Articulos
        • Categoria
      • Estructura básica de un adjunto
    • BaseResponse
    • BaseListResponse
  1. Descuentos

Listar Descuentos

Desarrollando
GET
/v2/empresas/{id}/articulos/descuentos/_search
InformaciónDetalle
Permiso requeridoART04
ID operaciónio.empresas.articulos.categorias.listar
Permite buscar categorias de artículos de la empresa

Solicitud

Parámetros de ruta

Parámetros de consulta

Parámetros de Header

Respuestas

🟢200Correcto
application/json
OK
Body

Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location --request GET '/v2/empresas//articulos/descuentos/_search?pagina=1&itemsPorPagina=15&filtros&aplicacion=FEB' \
--header 'token;' \
--header 'token: xx' \
--header 'empresa: 98765432-1' \
--header 'empresa: 1111111-1'
Respuesta Ejemplo de Respuesta
{
    "totalElementos": 1,
    "totalPaginas": 1,
    "paginaActual": 1,
    "elementosPorPagina": 20,
    "documentos": [
        {
            "estado": "activo",
            "id": "3f6de38d-4fd0-41d4-9b10-8f2929d1dbc0",
            "usosActuales": 0,
            "valor": 25,
            "aplicabilidad": "global",
            "montoMaximoDescuento": 60000,
            "usosMaximos": 300,
            "productos": [
                "f94559f926d2024da12a61525979fea21092",
                "eb5de857237da241792b94c2a31554ede8f5",
                "f42e873b25202247fd2b6762f3a553fb82d7"
            ],
            "indicadorFacturacion": "todos",
            "fechaInicio": "2025-11-13T00:00:00",
            "tiempoBloqueo": 0,
            "fechaFin": "2026-02-28T23:59:59",
            "tipoValor": "porcentaje",
            "tipoDescuento": "multiple",
            "codigo": "DESCCOMBINADO25",
            "montoMinimo": 10000,
            "categorias": [
                "cat-101",
                "cat-105"
            ],
            "empresaId": "5ed2865f-2438-4b84-9ae6-286168c832d7"
        }
    ],
    "codigo": 10,
    "mensaje": "Acción realizada satisfactoriamente",
    "hora": "2025-12-10 17:17:28",
    "seguimientoId": "b5770b66-654a-47f1-a65a-467894be3c35",
    "duracion": 584
}
Modificado en 2025-12-10 20:18:17
Anterior
Eliminar
Siguiente
Crear Descuento
Built with