# ¿Cómo bajar un adjunto por API?

**URL:** <https://bc.finneg.com/t/como-bajar-un-adjunto-por-api/2975>\
**Category:** API\
**Tags:** transacciones, api, cómo-se-hace\
**Created:** [21 Diciembre, 2023 20:38 UTC](https://bc.finneg.com/t/como-bajar-un-adjunto-por-api/2975 "2023-12-21T20:38:52Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![jgonzalez](https://bc.finneg.com/user_avatar/bc.finneg.com/jgonzalez/32/30967_2.png) [@jgonzalez](https://bc.finneg.com/u/jgonzalez)\
**Post date:** [21 Diciembre, 2023 20:38 UTC](https://bc.finneg.com/t/como-bajar-un-adjunto-por-api/2975/1 "2023-12-21T20:38:53Z")

</div>

**⏲ 5 min**

**DESCARGAR LOS ADJUNTOS DE UNA TRANSACCIÓN POR API** :

* * *

**Esta funcionalidad tiene como objetivo dar la posibilidad de descargar los adjuntos de una transacción/maestro del sistema, por API, por medio del método GET.**

* * *

# ¿Para qué sirve?

Para ejecutar la acción de descargar los adjuntos de una transacción/maestro por API, por medio del método GET.

# Antes de empezar

Obtener el access\_token, para poder consumir una api de teamplace.

URL: [https://api.teamplace.finneg.com/api/oauth/token?grant\_type=client\_credentials&client\_id={$clientid}&client\_secret={$secretkey}](https://api.teamplace.finneg.com/api/oauth/token?grant_type=client_credentials&client_id=%7B$clientid%7D&client_secret=%7B$secretkey%7D)

# Modo de uso

1. Buscamos la identificación externa de la transacción/maestro que queremos buscar la lista de adjuntos.

_Select identificacionexterna from bstransaccion where transacciones =xxxx_

1. Buscamos el nombre del adjunto que queremos descargar, por medio del método GET y la URL

URL: [https://api.teamplace.finneg.com/api/custom/files/list/{Entidad}/{Código}?ACCESS\_TOKEN={$access\_token}](https://api.teamplace.finneg.com/api/pedidoVenta/%7Bcodigo%7D?ACCESS_TOKEN=%7B$access_token%7D).

 ![](https://bc.finneg.com/uploads/default/original/2X/f/f68ac3a585eba904e0e14fc1a0ac1fb68c0d0fda.png)

1. Utilizamos la siguiente API, para descargar un adjunto de una transacción o maestro., por medio del método GET.

[https://api.teamplace.finneg.com/api/custom/files/](https://api.teamplace.finneg.com/api/pedidoVenta/%7Bcodigo%7D?ACCESS_TOKEN=%7B$access_token%7D)retrieve[/{Entidad}/{Código}?ACCESS\_TOKEN={$access\_token}](https://api.teamplace.finneg.com/api/pedidoVenta/%7Bcodigo%7D?ACCESS_TOKEN=%7B$access_token%7D)&fileHash={Nombre archivo}

Descarga el archivo del nombre físico pasado como parámetro.

Este se compone de {Entidad}-{Codigo}-{NombreDelArchivo}-{Extención}

o {Transacción}-{IDTransacción}-{NombreDelArchivo}-{Extención}

Por ejemplo

BSProducto-CamLege.L.BL-border collie.jpg

BSTransaccion-17242-YoHablando.jpg

 ![](https://bc.finneg.com/uploads/default/original/2X/b/b8f65897d300b98fa5b8eaa2e9e1bc4a82ff29b3.png)

1. Como respuesta obtenemos, el contenido del archivo adjunto de una transacción o maestro.