API OData de Acqua ERP

Servicio OData v4 de solo-lectura y escritura sobre los maestros del ERP. Es autodescriptivo: con la URL y una credencial, cualquier cliente OData genérico — Excel, Power BI, Postman, una librería — puede listar las entidades disponibles, ver sus campos y navegar a los maestros relacionados.

nota

Cómo usar esta guía. Los ejemplos usan https://TU-HOST/synergy-server/jwt-odata-key/ como service root: reemplazá TU-HOST por el servidor que te pasaron. Todos los bloques de código tienen botón de copiar.

Contenido

• Arranque rápido — tres llamadas y ya estás leyendo datos.
• 1. Autenticación — API key o JWT, y lista blanca de IP.
• 2. Descubrir el modelo — documento de servicio y $metadata.
• 3. Leer datos — colecciones, entidades, claves.
• 4. Query options — $select, $orderby, $search.
• 5. $filter en detalle
• 6. Maestros relacionados — $expand y navegación.
• 7. Paginación
• 8. Tipos de datos
• 9. Escribir
• 10. Errores
• 11. Recetas por herramienta — curl, Postman, Excel, Power BI, Python, C#.
• 12. Prestaciones no implementadas
• 13. Límites y comportamiento operativo
• 14. Qué pedirle al administrador del ERP