Saltar al contenido principal

Estructura de Documentos de Venta

En BaseGes ERP, los documentos de venta permiten organizar sus líneas mediante partidas que pueden contener artículos, unidades de obra y otros elementos.

La propiedad lines permite incluir líneas dentro de una partida, manteniendo una estructura organizada para representar los distintos conceptos del documento.

1. Tipos de Elementos​

TipoSinónimos / VariantesDescripción
Category (4)Partida, Capitulo, HojaContenedor de líneas del documento. Corresponde a una categoría o pestaña del documento en BaseGes.
Workunit (1)UnidadObra, UOUnidad de obra compuesta por líneas técnicas de descomposición.
Product (0)Articulo, ProductoArtículo de catálogo o genérico con precio, coste y cantidad.
Text (3)TextoLínea descriptiva libre. Puede incluir información económica.

2. Deducción Automática de Tipos (Campo Opcional)​

El campo type de las líneas del documento puede omitirse. En ese caso, el sistema deducirá automáticamente el tipo de línea correspondiente.

Las reglas de deducción son las siguientes:

  1. Líneas sueltas en la raíz: Si se envía una lista de artículos o textos directamente en el campo lines del documento, se agrupan automáticamente dentro de una partida por defecto.
  2. Línea en la raíz con líneas hijas (lines): Se deduce como una partida.
  3. Línea con líneas hijas dentro de una partida: Se deduce como una unidad de obra cuando su estructura y propiedades corresponden a una unidad de obra.
  4. Línea sin líneas hijas con código, precio, coste o cantidad: Se deduce como Product.
  5. Línea sin líneas hijas que contiene únicamente una descripción: Se deduce como Text.
  6. Línea hija dentro de una unidad de obra: Se interpreta como un elemento de su descomposición.

3. Ejemplo de Payload​

A continuación, se muestra un ejemplo de documento de venta con una partida que contiene artículos y textos descriptivos.

{
  "documentType": 0,
  "series": "01",
  "number": "0000000123",
  "date": "2026-11-02",
  "customerCode": "CLI-00120",
  "projectCode": "OBRA-2026",
  "paymentMethod": "00000001",
  "warehouse": "00000001",
  "updatesStock": true,
  "isBillable": true,
  "notes": "Materiales para instalación eléctrica",
  "lines": [
    {
      "type": "Category",
      "description": "Instalaciones eléctricas",
      "lines": [
        {
          "type": "Product",
          "code": "CBL-001-AZ",
          "description": "Cable Manguera 3G 2.5mm",
          "quantity": 150,
          "price": 1.55,
          "cost": 0.95
        },
        {
          "type": "Product",
          "code": "PIA-16A-1P",
          "description": "Interruptor magnetotérmico 1P+N 16A",
          "quantity": 8,
          "price": 12.40,
          "cost": 7.20
        },
        {
          "type": "Text",
          "description": "Material suministrado conforme a las especificaciones del proyecto."
        }
      ]
    }
  ]
}

4. Unidades de Obra y Descomposición​

Las unidades de obra pueden incluir sus propias líneas de descomposición mediante la propiedad lines.

Cuando no se envían estas líneas, la API recupera automáticamente las líneas por defecto configuradas en la ficha de la unidad de obra en BaseGes.

Para incluir unidades de obra que no existen en el catálogo, consulta el apartado Artículos y Unidades de Obra Genéricas.

5. Actualización y Reconciliación de Líneas​

Al modificar un documento existente mediante PUT /salesdocuments/{series}/{number}, puedes incluir la propiedad id en cada elemento del array lines para actualizar líneas in-situ, conservar identificadores y aplicar ajustes diferenciales de inventario: