Através da integração com nossa API, é possível realizar o download automático dos relatórios de serviço que são gerados. Essa é uma opção muito útil se você deseja compartilhar os relatórios com os clientes sem precisar exportar manualmente e salvá-los em alguma nuvem compartilhada (ex.: Google Drive, Dropbox ou FTP) ou disponibilizar no seu próprio site.
Para isso, temos 2 opções que funcionam tanto para exportação PDF quanto Excel:
Opção 1: Solicitar para enviar o arquivo por e-mail
Opção 2: Solicitar para download
Esses 2 tipos de solicitações da API são assíncronos. No caso 1, é só realizar a chamada que assim que a exportação for concluída o e-mail será enviado automaticamente. Já o caso 2, é necessário primeiro solicitar e depois fazer uma consulta a cada 10/20 segundos para verificar se a exportação foi concluída para realizar o download.
Em nossa documentação da API temos um exemplo de como fazer isso na seção 09 Export_Request - 01 - List.
Veja abaixo como realizar a integração das 2 formas:
Exemplo opção 1 - Envio por e-mail
Request para solicitar exportação:
POST /export_requests
{
"export_request":
{
"account_id": 12345,
"send_method": "email",
"to_email": "teste@produttivo.com.br",
"export_profile_id": 12345,
"filter": {
"form_fill_ids": [12345]
}
}
}
Exemplo opção 2 - Download do arquivo
Request para solicitar exportação:
POST /export_requests
{
"export_request":
{
"account_id": 12345,
"send_method": "download",
"export_profile_id": 12345,
"filter": {
"form_fill_ids": [12345]
}
}
}
Request para verificar se exportação está pronta e pegar a url de download:
GET /export_requests/:id
Se estiver concluído, o atributo "status" será retornado com o valor "available". Basta fazer o download do arquivo através da url /export_requests/:id/download enviando os parâmetros de acesso do usuário. Isso é necessário por segurança para que o arquivo não possa ser visualizado por outras pessoas.
A url de download pode contar um redirecionamento para outra url (status code 302 Found). Dependendo da ferramenta ou biblioteca utilizada, é necessário realizar uma tratativa para utilizar a url retornada pelo 302 para realizar o download.