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

Crear Descuento

Desarrollando
POST
/v2/empresas/{id}/articulos/descuentos
InformaciónDetalle
Permiso requeridoDESC01
ID operaciónio.empresas.articulos.descuentos.crear
Permite crear descuentos de la empresa

Solicitud

Parámetros de ruta

Parámetros de consulta

Parámetros de Header

Parámetros del Body application/json

Ejemplos

Respuestas

🟢200Correcto
application/json
OK
Body

Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location --request POST '/v2/empresas//articulos/descuentos?pagina=1&itemsPorPagina=15&filtros&aplicacion=FEB' \
--header 'token;' \
--header 'token: xx' \
--header 'empresa: 98765432-1' \
--header 'empresa: 1111111-1' \
--header 'Content-Type: application/json' \
--data-raw '{
    "codigo": "DESC100EVA",
    "tipoDescuento": "permanente",
    "valor": 100,
    "tipoValor": "porcentaje",
    "aplicabilidad": "global",
    "indicadorFacturacion": "afecto",
    "categorias": [],
    "productos": [],
    "fechaInicio": "2025-11-13T00:00:00",
    "fechaFin": "2026-02-28T23:59:59",
    "montoMinimo": 1000,
    "montoMaximoDescuento": 100000000,
    "usosMaximos": 300,
    "tiempoBloqueo": 0
  }'
Respuesta Ejemplo de Respuesta
{
  "descuento": {
    "aplicabilidad": "global",
    "categorias": [],
    "codigo": "DESC100EVA",
    "empresaId": "e2c7e3fe-d65a-467d-a642-afcf83cc5dd2",
    "estado": "activo",
    "fechaFin": "2026-02-28T23:59:59",
    "fechaInicio": "2025-11-13T00:00:00",
    "id": "0435ff53-91ea-49f0-842b-40bdc1a5d532",
    "indicadorFacturacion": "afecto",
    "montoMaximoDescuento": 100000000,
    "montoMinimo": 1000,
    "productos": [],
    "tiempoBloqueo": 0,
    "tipoDescuento": "permanente",
    "tipoValor": "porcentaje",
    "usosActuales": 0,
    "usosMaximos": 300,
    "valor": 100
  },
  "codigo": 10,
  "mensaje": "Acción realizada satisfactoriamente",
  "hora": "2025-12-01 13:20:09",
  "seguimientoId": "4c87ddab-6b42-4613-9958-66218178d3dd"
}
Modificado en 2025-12-10 20:20:58
Anterior
Listar Descuentos
Siguiente
Listar artículo de venta
Built with