Descripción General
Los endpoints de Códigos de Barras permiten gestionar los códigos de barras asociados a los artículos del restaurante. Esta funcionalidad es esencial para la identificación rápida de productos mediante lectores de códigos de barras, facilitando el proceso de venta y control de inventario.
🎯 Características de los Códigos de Barras
- Identificación única: Cada código de barras es único en el sistema
- Asociación con artículos: Vinculación directa con productos específicos
- Múltiples formatos: Soporte para diferentes tipos de códigos de barras
- Validación automática: Verificación de integridad del código
- Búsqueda rápida: Identificación instantánea de productos
Endpoints Disponibles
GET
/Master/Articulos/GetArticulosBarra
Obtiene todos los códigos de barras registrados en el sistema. Este endpoint devuelve una lista completa de todos los códigos de barras asociados a productos.
Parámetros de consulta:
- initialCatalog (string, requerido): Nombre de la base de datos
- userID (string, opcional): ID de usuario de la base de datos
- password (string, opcional): Contraseña de la base de datos
200 OK
Lista de códigos de barras devuelta exitosamente
[
{
"codigoBarra": "1234567890123",
"articulo": "ART001",
"descripcion": "Código de barras para hamburguesa clásica",
"tipo": "EAN13"
},
{
"codigoBarra": "9876543210987",
"articulo": "ART002",
"descripcion": "Código de barras para pizza margarita",
"tipo": "EAN13"
}
]
500 Internal Server Error
Error interno del servidor
GET
/Master/Articulos/GetArticuloBarra/{codigoBarra}
Obtiene un código de barras específico por su valor. Este endpoint permite recuperar la información de un código de barras en particular.
Parámetros de ruta:
- codigoBarra (string, requerido): Valor del código de barras
Parámetros de consulta:
- initialCatalog (string, requerido): Nombre de la base de datos
- userID (string, opcional): ID de usuario de la base de datos
- password (string, opcional): Contraseña de la base de datos
200 OK
Código de barras encontrado y devuelto
{
"codigoBarra": "1234567890123",
"articulo": "ART001",
"descripcion": "Código de barras para hamburguesa clásica",
"tipo": "EAN13",
"fechaCreacion": "2024-01-15T10:30:00Z"
}
404 Not Found
Código de barras no encontrado
500 Internal Server Error
Error interno del servidor
POST
/Master/Articulos/AddArticuloBarra
Crea un nuevo código de barras en el sistema. Este endpoint permite asociar un código de barras a un producto existente.
Body (JSON):
{
"codigoBarra": "1234567890124",
"articulo": "ART001",
"descripcion": "Nuevo código de barras para hamburguesa clásica",
"tipo": "EAN13"
}
Parámetros de consulta:
- initialCatalog (string, requerido): Nombre de la base de datos
- userID (string, opcional): ID de usuario de la base de datos
- password (string, opcional): Contraseña de la base de datos
201 Created
Código de barras creado exitosamente
{
"codigoBarra": "1234567890124",
"articulo": "ART001",
"descripcion": "Nuevo código de barras para hamburguesa clásica",
"tipo": "EAN13",
"fechaCreacion": "2024-01-15T11:00:00Z"
}
500 Internal Server Error
Error interno del servidor
PUT
/Master/Articulos/UpdateArticuloBarra/{codigoBarra}
Actualiza un código de barras existente en el sistema. Este endpoint permite modificar la información de un código de barras.
Parámetros de ruta:
- codigoBarra (string, requerido): Valor del código de barras a actualizar
Body (JSON):
{
"codigoBarra": "1234567890123",
"articulo": "ART001",
"descripcion": "Código de barras actualizado para hamburguesa clásica",
"tipo": "EAN13"
}
Parámetros de consulta:
- initialCatalog (string, requerido): Nombre de la base de datos
- userID (string, opcional): ID de usuario de la base de datos
- password (string, opcional): Contraseña de la base de datos
200 OK
Código de barras actualizado exitosamente
404 Not Found
Código de barras no encontrado
500 Internal Server Error
Error interno del servidor
DELETE
/Master/Articulos/DeleteArticuloBarra/{codigoBarra}
Elimina un código de barras del sistema. Este endpoint permite remover un código de barras asociado a un producto.
Parámetros de ruta:
- codigoBarra (string, requerido): Valor del código de barras a eliminar
Parámetros de consulta:
- initialCatalog (string, requerido): Nombre de la base de datos
- userID (string, opcional): ID de usuario de la base de datos
- password (string, opcional): Contraseña de la base de datos
200 OK
Código de barras eliminado exitosamente
{
"message": "Articulo barra deleted successfully",
"barra": {
"codigoBarra": "1234567890123",
"articulo": "ART001",
"descripcion": "Código de barras para hamburguesa clásica",
"tipo": "EAN13"
}
}
404 Not Found
Código de barras no encontrado
500 Internal Server Error
Error interno del servidor
Servicio Utilizado
IArticulosBarraService - Servicio para la gestión de códigos de barras
- GetAll(): Obtiene todos los códigos de barras
- GetById(): Obtiene un código de barras específico
- Add(): Crea un nuevo código de barras
- Update(): Actualiza un código de barras existente
- Delete(): Elimina un código de barras