API: parteAvanceObra

Gregorio_Martin
Tue, 29 Jul 2025 19:56:48 +0000
API

Esta API permite consultar, crear, actualizar y eliminar Partes de Avance de Obra junto con sus ítems y ajustes contables relacionados.

1. Obtención de token

Antes de consumir cualquier endpoint, es necesario contar con un ACCESS_TOKEN válido.
Este token se obtiene mediante las credenciales de un usuario API autorizado en el sistema Finnegans.

2. Métodos disponibles

GET

URL

https://go.finneg.com/api/1/teamplace/generic/bridge/custom/parteAvanceObra?access_token={$access_token}&identificacionExterna={codigo}

ACCESS_TOKEN: Token de autenticación obtenido desde el ERP.

{codigo}: Código del parte de avance a consultar (por ejemplo: PARTEAVANCE-391).

Códigos de respuesta

200 OK       → Devuelve el objeto completo del parte de avance.
404 Not Found → { "error": "Not Found", "status": 404 }
500 Error     → { "error": "Internal Server Error", "status": 500 }

POST

URL

https://go.finneg.com/api/1/teamplace/generic/bridge/custom/parteAvanceObra?access_token={$access_token}

ACCESS_TOKEN: Token de autenticación.

Códigos de respuesta

200 OK       → { "documento": "PARTEAVANCE - 403", "id": "uuid", "message": "created", "status": 200 }
400 Error    → { "error": "Bad Request", "status": 400 }
500 Error    → { "error": "Internal Server Error", "status": 500 }

Ejemplo de cuerpo (JSON)

{
  "TransaccionSubtipoID": "PARTEAVANCE",
  "Descripcion": "",
  "EmpresaID": "36595-50",
  "TalonarioID": "EJ-GEN",
  "FechaComprobante": "2025-06-25",
  "EstadoID": "ACTIVA",
  "ParteAvanceObraItems": [
    {
      "Descripcion": "",
      "PlanificacionObraItemID": "3 Acero especial en barras, ADN 420 Colocado",
      "Cantidad": 1.110000,
      "ParteAvanceObraItemID": 2273,
      "TransaccionID": 153811
    }
  ]
}

PUT

URL

https://go.finneg.com/api/1/teamplace/generic/bridge/custom/parteAvanceObra?access_token={$access_token}&identificacionExterna={codigo}

{codigo}: Código del parte de avance a modificar.

ACCESS_TOKEN: Token de autenticación.

Códigos de respuesta

200 OK       → { "message": "updated", "status": 200 }
404 Not Found → { "error": "Not Found", "status": 404 }
500 Error     → { "error": "Internal Server Error", "status": 500 }

DELETE

URL

https://go.finneg.com/api/1/teamplace/generic/bridge/custom/parteAvanceObra?access_token={$access_token}&identificacionExterna={codigo}

{codigo}: Código del parte de avance a eliminar.

ACCESS_TOKEN: Token de autenticación.

Códigos de respuesta

200 OK       → { "message": "Deleted", "status": 200 }
404 Not Found → { "error": "Not Found", "status": 404 }
500 Error     → { "error": "Internal Server Error", "status": 500 }

3. Atributos principales (main)

Campo | Tipo | Ejemplo | Descripción
| | |
TransaccionSubtipoID | string | “PARTEAVANCE” | Tipo de transacción
EmpresaID | string | “36595-50” | Código de empresa
FechaComprobante | string | “2025-06-25” | Fecha del parte
TalonarioID | string | “EJ-GEN” | Código de talonario
EstadoID | string | “ACTIVA” | Estado del parte
ParteAvanceObraItems | array | […] | Lista de ítems de avance

4. Atributos de ParteAvanceObraItems

Campo | Tipo | Ejemplo | Descripción
| | |
ParteAvanceObraItemID | string | “2273” | ID del ítem
PlanificacionObraItemID | string | “3 Acero especial en barras, ADN 420” | Descripción del ítem
Cantidad | decimal | 1.110000 | Cantidad reportada
TransaccionID | string | “153811” | ID de transacción

5. Soporte

Para dudas, errores o inconvenientes con esta API, contactar a soporte técnico por los canales oficiales de Finnegans.