# API: parteAvanceObra

**URL:** <https://bc.finneg.com/t/api-parteavanceobra/5572>\
**Category:** API\
**Tags:** constructoras, instructivo\
**Created:** [29 Julio, 2025 19:56 UTC](https://bc.finneg.com/t/api-parteavanceobra/5572 "2025-07-29T19:56:48Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Gregorio\_Martin](https://bc.finneg.com/user_avatar/bc.finneg.com/gregorio_martin/32/20068_2.png) [@Gregorio\_Martin](https://bc.finneg.com/u/Gregorio_Martin)\
**Post date:** [29 Julio, 2025 19:56 UTC](https://bc.finneg.com/t/api-parteavanceobra/5572/1 "2025-07-29T19:56:48Z")

</div>

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](https://bc.finneg.com/t/como-generar-el-token-para-las-apis/2827)

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**

```auto
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**

```auto
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**

```auto
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**

```auto
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)**

```auto
{
  "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**

```auto
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**

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

```

* * *

### 🔹 DELETE

**URL**

```auto
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**

```auto
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.