Saltar al contenido principal

Facturas de Venta (/salesinvoices)

Permite la consulta, detalle y gestión de facturas emitidas a clientes registradas en BaseGes ERP.


1. Consulta y Filtros (GET /salesinvoices)​

Permite recuperar la lista paginada de facturas de venta con los siguientes filtros:

  • Paginación: page y pageSize.
  • Filtros de Negocio:
    • customerCode: Filtrar por código del cliente.
    • projectCode: Filtrar por código de obra.
    • status: Filtrar por estado de la factura (Draft, Issued, Paid, PartiallyPaid, Cancelled).
    • fromDate y toDate: Rango de fechas de emisión.
  • Búsqueda global (search): Búsqueda parcial sobre:
    • Número de factura de venta (Number / tVentas2).
    • Observaciones de la factura (Observations.Description / tVentas17).
    • Nombre del cliente en el maestro de contactos (tClientes2).

2. Bases Imponibles y Desglose Fiscal (TaxBases)​

Cada factura de venta incluye el desglose de importes agrupados por tipo impositivo:

  • Requisito: Es obligatorio indicar como mínimo una base imponible, admitiéndose hasta un máximo de 4 bases imponibles distintas.
  • Esta información es la que utiliza el ERP para los modelos de IVA, el Libro Registro de Facturas Emitidas y los asientos contables automáticos.

Selección de Tipo de Impuesto (TaxCode)​

El campo TaxCode es opcional:

  • Si se informa explícitamente, el sistema aplica de inmediato el código de tipo de impuesto repercutido indicado.
  • Si no se informa, el sistema busca automáticamente en la configuración de BaseGes un tipo de impuesto que coincida con:
    1. El porcentaje de IVA (TaxRate).
    2. El porcentaje de recargo de equivalencia (EquivalenceSurcharge), en caso de aplicar.
  • En instalaciones con varios tipos impositivos que compartan porcentajes idénticos (por ejemplo, regímenes especiales agrarios o canarios), es muy recomendable enviar TaxCode de forma explícita.