Preguntas frecuentes
A continuación encontrarás respuestas a las dudas más comunes sobre el uso del servicio OData en Delfín Software, ideal para desarrolladores, analistas y usuarios que integran o consultan datos desde el sistema.
🔤 Generalidades
¿Qué es OData?
OData (Open Data Protocol) es un estándar que permite acceder y consultar datos a través de URLs usando operaciones como filtros, ordenamientos, selección de columnas, paginación, entre otros. Delfín Software expone sus entidades mediante este protocolo para facilitar la integración con herramientas externas como Excel, Power BI, aplicaciones web y móviles.
¿Necesito autenticación para acceder al servicio?
No. El servicio OData no requiere autenticación.
¿Qué entidades están disponibles?
Las entidades disponibles dependen de la configuración del sistema y los permisos del usuario. Algunas de las más comunes incluyen:
ProductoClienteCompraVentaNotaCreditoEncabezadoInventarioMensualTransaccionReservaHabitacion
Puedes consultar la metadata del servicio para ver todas las entidades disponibles y sus propiedades.
¿Dónde puedo ver ejemplos completos?
Puedes revisar los Ejemplos que incluye consultas para productos, clientes, ventas, inventario y más.
¿Puedo conectar el servicio OData a Excel o Power BI?
Sí. Excel y Power BI permiten conectarse directamente a servicios OData para importar y analizar datos. Consulta el Uso con Excel para ver los pasos detallados.
🔍 Consulta de información
¿Qué pasa si consulto un registro que no existe?
El servicio devolverá un mensaje como:
Recurso no encontrado para el segmento 'Entidad'
Consulta las Consultas por ID para más información.
¿Cómo filtro los datos?
Usa el parámetro $filter en la URL para aplicar condiciones. Ejemplos:
GET /v1/OrganizacionOData.svc/Producto?$format=json&$filter=Nombre eq 'LECHE'
GET /v1/OrganizacionOData.svc/Cliente?$format=json&$filter=Edad gt 30
Consulta Filtrar información para más ejemplos.
¿Cómo selecciono solo algunas columnas?
Usa el parámetro $select para indicar qué columnas deseas incluir en la respuesta:
GET /v1/OrganizacionOData.svc/Producto?$format=json&$select=CodigoProducto,Nombre
Consulta Seleccionar columnas para más detalles.
¿Puedo consultar datos por rangos de fechas?
Sí. Puedes usar filtros con operadores como gt, lt, ge, le y funciones como year(), month():
GET /v1/OrganizacionOData.svc/VentaEnero?$format=json&$filter=FechaVenta gt datetime'2024-01-01T00:00:00' and FechaVenta lt datetime'2024-01-31T23:59:59'
¿Cómo ordeno los resultados?
Usa el parámetro $orderby para ordenar los datos por una columna:
GET /v1/OrganizacionOData.svc/Producto?$format=json&$orderby=Nombre asc
¿Cómo limito la cantidad de registros?
Usa el parámetro $top para limitar el número de registros devueltos:
GET /v1/OrganizacionOData.svc/Producto?$format=json&$top=10