Saltar al contenido principal

Gestión de Artículos y Unidades de Obra Genéricas

En ocasiones, un documento de venta debe incluir referencias de materiales o trabajos que todavía no existen en el catálogo de BaseGes.

La API permite registrar estos elementos directamente en el documento, utilizando la información proporcionada en la petición.

Si en una línea de tipo Product se especifica un code que no existe en el catálogo de artículos de BaseGes, el sistema la creará igualmente utilizando los datos enviados en la petición:

  • code: Código o identificador del artículo.
  • description: Descripción del producto.
  • price: Precio de venta unitario.
  • cost: Coste unitario.
  • quantity: Cantidad.
  • taxCode: Código del impuesto.

Tratamiento del impuesto (taxCode):

  • Si se informa taxCode, se aplica el código de impuesto indicado.
  • Si no se informa, se utiliza automáticamente el tipo de IVA de ventas por defecto configurado en BaseGes.

Ejemplo de Producto Genérico​

{
  "type": "Product",
  "code": "MAT-ESPECIAL-001",
  "description": "Material fuera de catálogo",
  "quantity": 10,
  "price": 25.50,
  "cost": 18.00,
  "taxCode": "00000021"
}

2. Unidades de Obra Genéricas​

Si una línea de tipo Workunit contiene un código que no existe en el catálogo de unidades de obra de BaseGes, el sistema la creará igualmente utilizando los datos proporcionados en la petición:

  • code: Código o identificador de la unidad de obra.
  • description: Descripción de la unidad de obra.
  • quantity: Cantidad.
  • lines: Productos que formarán parte de la unidad de obra. Estos productos se tratarán como productos genéricos, por lo que deberán incluir todos sus datos en la petición.

Ejemplo de Unidad de Obra Genérica​

{
  "type": "Workunit",
  "code": "UO-ESPECIAL-001",
  "description": "Instalación de sistema de iluminación especial",
  "quantity": 5,
  "lines": [
    {
      "type": "Product",
      "code": "LED-001",
      "description": "Panel LED 60x60",
      "quantity": 2,
      "price": 45.00,
      "cost": 30.00
    },
    {
      "type": "Product",
      "code": "INST-001",
      "description": "Material auxiliar de instalación",
      "quantity": 1,
      "price": 12.00,
      "cost": 8.00
    }
  ]
}