Gestión de Bienes y Servicios (Items)

Pruebas
Producción

Dominio: https://test-api-factura.edw-dev.com

La API de gestión de items permite realizar operaciones CRUD completas sobre los bienes y servicios del sistema. Incluye funcionalidades para consultar, crear, actualizar, eliminar items, así como gestionar inventario y kardex.

Endpoints Disponibles

La API de items está organizada en las siguientes secciones:

Consultar Items - Obtener listados y buscar items específicos
Crear Items - Registrar nuevos bienes y servicios
Actualizar Items - Modificar información de items existentes
Eliminar Items - Eliminar items del sistema
Gestión de Inventario - Agregar y gestionar stock
Kardex - Consultar y exportar movimientos de inventario

Tipos de Items

Tipo	Descripción	Maneja Inventario
`PRODUCT`	Producto físico con inventario	Sí
`SERVICE`	Servicio sin inventario	No

Características por Tipo

PRODUCT: Requiere control de inventario, permite movimientos de kardex, tiene cantidad disponible
SERVICE: No maneja inventario, se factura directamente sin control de stock

Tipos de Movimientos de Kardex

Tipo	Descripción	Afecta Stock
`INCOME`	Ingreso de inventario	Aumenta
`OUTCOME`	Salida de inventario	Disminuye
`ADJUSTMENT`	Ajuste de inventario	Según valor

Detalles de Movimientos

INCOME: Se registra al agregar inventario manualmente o por compras
OUTCOME: Se registra automáticamente en ventas o salidas manuales
ADJUSTMENT: Permite correcciones de inventario por diferencias físicas

Códigos de Respuesta

Código	Descripción	Cuándo Ocurre
`200`	Consulta exitosa	Operaciones de lectura correctas
`201`	Item creado exitosamente	Creación de nuevo item
`400`	Error en los datos enviados	Datos malformados o incompletos
`401`	Token de autorización inválido	Autenticación fallida
`404`	Item no encontrado	Código de item inexistente
`422`	Error de validación	Código duplicado o datos inválidos
`500`	Error interno del servidor	Fallo del sistema

Notas Importantes

Códigos de Items

El campo code debe ser único en todo el sistema
Se recomienda usar códigos alfanuméricos descriptivos
Los códigos no se pueden modificar una vez creados

Gestión de Inventario

Solo los items de tipo PRODUCT manejan inventario
El campo allow_accounting debe ser 1 para habilitar control de inventario
Los movimientos de inventario se registran automáticamente en las ventas
El kardex solo está disponible para items con allow_accounting = 1

Impuestos

Los impuestos deben corresponder a códigos válidos del sistema LOVs
Se pueden asignar múltiples impuestos a un item
Los porcentajes de impuestos se obtienen automáticamente del sistema

Precios y Precisión

Los precios se manejan con 2 decimales de precisión
El campo rate representa el precio unitario base
Los impuestos se calculan sobre el precio base

Exportaciones

Las exportaciones de kardex se generan en tiempo real
Formatos disponibles: Excel (.xlsx) y PDF
Se pueden aplicar filtros de fecha y tipo de movimiento

Filtros Avanzados

La API de items soporta el sistema de filtros avanzados. Para más información sobre cómo implementar filtros, consulta la documentación de filtros.

Campos Filtrables

Campo	Tipo	Descripción
`code`	string	Código del item
`description`	string	Descripción del item
`rate`	number	Precio unitario
`unit`	string	Unidad de medida
`type`	string	Tipo de item (PRODUCT/SERVICE)
`allow_accounting`	boolean	Permite contabilidad
`count_available`	integer	Cantidad disponible
`created_at`	datetime	Fecha de creación
`updated_at`	datetime	Fecha de actualización

Ejemplo de Filtro

{
  "filters": [
    {
      "field": "type",
      "condition": "equals",
      "value": "PRODUCT"
    },
    {
      "field": "rate",
      "condition": "greater_than",
      "value": 10
    }
  ],
  "logic": "and"
}

Autenticación

Todos los endpoints requieren autenticación mediante Bearer Token:

Authorization: Bearer {token}
Accept: application/json

Para obtener un token de acceso, consulta la documentación de autenticación.