# Descarregar PDF de Pagamentos

### Obter Caminho para Ficheiro

{% hint style="warning" %}
Para um documento ser descarregado, o mesmo deve estar com um estado (status)  de finalizado (status = 1) .
{% endhint %}

De modo a descarregar o PDF de um documento, deverá realizar um pedido à seguinte rota:

{% code title="GET" overflow="wrap" %}

```html
https://app.toconline.pt/api/url_for_print/<id do documento de compra>?filter[type]=PurchasesDocument&filter[copies]=1
```

{% endcode %}

{% hint style="info" %}
Para obter o id do Documento de Compra pretendido (document\_id) poderá consultar:&#x20;

[#obter-todos-os-documentos-de-compra-finalizados](https://api-docs.toconline.pt/apis/documentos-de-compra#obter-todos-os-documentos-de-compra-finalizados "mention")
{% endhint %}

Tal como nos restantes pedidos especificados anteriormente,  o \<access\_token> corresponde ao token de acesso válido devolvido pelo serviço de OAuth

### Descarregar Ficheiro

Utilizando a resposta recebida, deverá concatenar os atributos: scheme + "://" +  host + path, e irá obter o link através do qual a transferência é imediata. Neste caso, seria:&#x20;

{% code title="GET" %}

```html
https://app.toconline.pt/public-file/path_to_file
```

{% endcode %}
