Esta entrada posee información técnica sobre la API especificada y está dirigido a clientes que busquen integrar el Maestro de Máquinas con otro sistema.
Pasos a seguir:
Antes de cada solicitud se debe obtener el token de autorización, en función de las credenciales de un usuario API creado en el maestro Usuarios.
Se utiliza para generar un token de autenticación que permite poder consumir una API de Finnegans.
2. Métodos de recuperación y envío de datos a un servidor:
GET
URL:
https://api.finneg.com/api/Maquina/{codigo}?ACCESS_TOKEN={$access_token}
Parámetros:
- ACCESS_TOKEN: Requerido. Ejemplo: “a0e172d4-e070-4346-96fa-c02a97230384”.
- {codigo} Es el Código del registro en el maestro Máquinas.
Códigos de respuesta:
- 200 Ok: Se devuelve la información de la Máquina.
- 404 Solicitud incorrecta: { “error”: "Not Found: ", “status”: 404 }.
- 500 Error interno de servidor: { “error”: “Internal Server Error: null”,“status”: 500}.
JSON maquina
{
"EsquemaContableID": null,
"Aseguradora": "",
"ExigeParteDiario": false,
"Consumo": 0.000000,
"NroChasis": "",
"NroSerie": "",
"NroAcoplado": "",
"NroMotor": "",
"Costo": 0.0000,
"MaquinaAlquilada": false,
"ProductoID": null,
"Nombre": "2 ACOPLADO TOLVA AUTODESCARGABLE MOD. ATV8 MARCA GROSPAL - VIALCAM",
"Codigo": "CO110",
"BienDeUsoID": "BUAC09109",
"TipoContratoAlquiler": "",
"TipoContador": 3,
"Potencia": 0.0000,
"MinimoHorasPorParte": 0.000000,
"Patente": "",
"RutinaItems": [],
"NroPoliza": "",
"Longitud": "0",
"Capacidad": 0.000000,
"MarcaID": null,
"ModeloID": null,
"Caudal": null,
"CostoPorParo": 0.0000,
"SumaAsegurada": 0.0000,
"Descripcion": "",
"Marca": "",
"TipoCosteo": 1,
"Certificado": "",
"MarcaMotor": "",
"Activo": true,
"AplicaCostoPorParo": false,
"MonedaID": "PES",
"PiezasItems": [],
"FechaVencimientoSeguro": "2017-02-24",
"Prima": 0.0000,
"Propietario": "",
"IdentificacionExternaCW": null
}
POST
URL: https://api.finneg.com/api/Maquina?ACCESS_TOKEN={$access_token}
Parámetros:
- ACCESS_TOKEN: Requerido. Ejemplo: “a0e172d4-e070-4346-96fa-c02a97230384”.
Códigos de respuesta:
- 200 Ok: Se devuelve el id de la máquina, un mensaje informando que se creó correctamente y el código de estado de la respuesta. Ejemplo: {
“id”: “358e63c1cf9a0a36161aec8c49a341e3d031e34d”,
“message”: “created”,
“status”: 200
} - 404 Solicitud incorrecta: { “error”: "Not Found: ", “status”: 404 }.
- 500 Error interno de servidor: { “error”: “Internal Server Error: null”,“status”: 500}.
PUT
URL:
https://api.finneg.com/api/Maquina/{codigo}?ACCESS_TOKEN={$access_token}
Parámetros:
- ACCESS_TOKEN: Requerido. Ejemplo: “a0e172d4-e070-4346-96fa-c02a97230384”.
- {codigo} Es el Código del registro en el maestro Máquinas.
Códigos de respuesta:
- 200 Ok: Se devuelve un mensaje informando que se actualizó correctamente y el código de estado de respuesta. Ejemplo: {
“message”: “updated”,
“status”: 200
} - 404 Solicitud incorrecta: { “error”: "Not Found: ", “status”: 404 }.
- 500 Error interno de servidor: { “error”: “Internal Server Error: null”,“status”: 500}.
DELETE
URL: https://api.finneg.com/api/Maquina/{codigo}?ACCESS_TOKEN={$access_token}
Parámetros:
- ACCESS_TOKEN: Requerido. Ejemplo: “a0e172d4-e070-4346-96fa-c02a97230384”.
- {codigo} Es el Código del registro en el maestro Máquinas.
Códigos de respuesta:
- 200 Ok: Se devuelve un mensaje informando que se eliminó correctamente y código de estado de respuesta. Ejemplo: {
“message”: “deleted”,
“status”: 200
} - 404 Solicitud incorrecta: { “error”: "Not Found: ", “status”: 404 }.
- 500 Error interno de servidor: { “error”: “Internal Server Error: null”,“status”: 500}.
Antes de empezar
Antes de utilizar esta API, se deben considerar algunas cuestiones que se detallan a continuación.
Definición de API
Dentro de la API en el Diccionario de APIs debe estar la información configurada de acuerdo a lo que se detalla:
- En la solapa Definición debe indicarse todos los campos que tiene el JSON indicado más arriba.
- En el campo Tipo debe estar el valor Entidad.
- En el campo Entidad debe indicarse Máquina.