API: parteAvanceObra

API
,
1

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

:small_blue_diamond: 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 }

:small_blue_diamond: 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
    }
  ]
}

:small_blue_diamond: 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 }

:small_blue_diamond: 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.