> For the complete documentation index, see [llms.txt](https://devcenter.unico.io/unico-sign/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://devcenter.unico.io/unico-sign/guia-das-apis/gerenciando-documentos/obter-detalhes.md).

# Obter detalhes

## Sobre este guia[​](https://developers.unico.io/docs/sign/api-guides/managing-documents/get-details#sobre-este-guia) <a href="#sobre-este-guia" id="sobre-este-guia"></a>

Através deste guia, demonstraremos como obter todos os detalhes de um documento através de nossa API REST. Ao seguir os passos deste guia, em poucos minutos você será capaz de obter todos os detalhes de um documento de forma estruturada em uma resposta JSON.

## O que você vai precisar[​](https://developers.unico.io/docs/sign/api-guides/managing-documents/get-details#o-que-voc%C3%AA-vai-precisar) <a href="#o-que-voce-vai-precisar" id="o-que-voce-vai-precisar"></a>

Antes de iniciar sua integração:

1. Certifique-se que você possui credenciais válidas para utilizar o **Unico Sign**. Se você ainda não possui suas credenciais, siga nosso [<mark style="color:blue;">guia de Primeiros Passos</mark>](https://devcenter.unico.io/unico-sign/primeiros-passos) para configurar sua conta de teste e obter suas chaves de API. Para esta API é necessário que a conta de serviço possua a seguinte permissão: (`viewdocument`).
2. Entenda os conceitos básicos sobre nosso produto. É extremamente importante que você entenda estes conceitos para fazer uma boa utilização das APIs do **Unico Sign**. Você pode encontrar nossos conceitos básicos [<mark style="color:blue;">neste guia</mark>](https://devcenter.unico.io/unico-sign/conceitos-basicos).

## Funcionamento básico[​](https://developers.unico.io/docs/sign/api-guides/managing-documents/get-details#funcionamento-b%C3%A1sico) <a href="#funcionamento-basico" id="funcionamento-basico"></a>

Como explicamos em nosso [<mark style="color:blue;">guia de conceitos básicos</mark>](https://devcenter.unico.io/unico-sign/conceitos-basicos), **Documentos** (`document`) são a representação virtual de um documento que deve ser assinado (por um ou mais assinanates) e pode ser gerado a patir de um arquivo PDF ou de um modelo (`Template`).

Todos os eventos que ocorrem no ciclo vida de um documento ficam registrados e podem ser recuperados através desta funcionalidade. Este endpoint disponibilza os detalhes de cada documento, assim como todos seus eventos.

Atualmente, os seguintes eventos são armazenados e retornados:

* Envio do documento para assinatura;
* Abertura do link do envelope por um assinante;
* Visualização do documento por um assinante;
* Assinatura ou recusa do documento por um assinante;

Entenda, a seguir, como chamar nossa API Rest para obter detalhes de seus documentos:

{% stepper %}
{% step %}

### Obtenha um token OAuth válido <a href="#obtenha-um-token-oauth-valido" id="obtenha-um-token-oauth-valido"></a>

Para efetuar requisições à nossa API REST você necessitará de um token de acesso OAuth válido. Caso não esteja familiarizado com o modelo de autenticação OAuth, entenda como gerar um token válido [<mark style="color:blue;">neste artigo</mark>](https://devcenter.unico.io/unico-sign/guia-das-apis/autenticacao).  Após sua geração, o token de acesso deverá ser enviado no `header` de sua requisição,  junto ao parâmetro `Authorization`.

{% hint style="info" %}
**Ambientes**

Ao iniciar sua integração você receberá credenciais a nosso ambiente de homologação. Sómente após o processo de testes e certificação você receberá credenciais de produção.

Você deverá apontar suas requisições às URLs corretas em cada estágio de sua integração. Abaixo listamos as URLs de homologação e produção:

* Ambiente de homologação: `https://signhom.acesso.io`;
* Ambiente de produção: `https://sign.acesso.io`.
  {% endhint %}

{% endstep %}

{% step %}

### Faça uma requisição GET para o endpoint `/documents/` <a href="#faca-uma-requisicao-get-para-o-endpoint-documents" id="faca-uma-requisicao-get-para-o-endpoint-documents"></a>

Após gerar um token de acesso válido, faça uma requisição para o endpoint de obtenção de detalhes de documentos da nossa API REST (`GET/service/documents`), especificando qual documento deseja como um parâmetro no path da requisição.

Abaixo um exemplo da requisição:

{% hint style="info" %}
Não se esqueça de substituir o parâmetro `DOCUMENT_UUID` na requisição abaixo. Este parâmetro deve conter o UUID do documento ao qual você deseje gerar as evidências.

Exemplo de formato de um UUID: 00000000-0000-0000-0000-000000000000
{% endhint %}

{% code overflow="wrap" %}

```json
curl -X 'GET' \
  'https://signhom.acesso.io/api/v1/service/documents/{{DOCUMENT_UUID}}' \
  -H 'accept: application/pdf' \
  -H 'Authorization: Bearer {{ACCESS_TOKEN}}'

```

{% endcode %}

Se tudo der certo em sua requisição, você receberá como respota um JSON contendo uma lista com os campos do template:

{% code overflow="wrap" %}

```json
{
  "Url": "https://",
  "UrlVoucher": "https://",
  "DocumentType": "Nome",
  "CreatedDate": "09/04/2022 20:09",
  "EmitterUserName": "Name",
  "EmitterUserEmail": "email@gmail.com",
  "CompanySocialName": "Unico",
  "UUID": "4a95e405-2534-4cf6-aa56-01ddc535bbf4",
  "HasFile": false,
  "Subscribers": [
    {
      "SubscriberName": "Flavia dos Santos",
      "SubscriberCPF": "10000000019",
      "SubscriberEmail": "email@gmail.com",
      "SubscriberPhone": "5513987654321",
      "ID_SubscriberStatus": 108,
      "SubscriberOrder": 1,
      "SubscriberIp": "177.155.112.242",
      "SubscriberGeolocation": {
        "Latitude": "-23.591878",
        "Longitude": "-46.7383888"
      },
      "SubscriberEvents": [
        {
          "EventName": "NotifiedEmail",
          "EventDescription": "O envelope foi enviado via E-mail",
          "EventDates": [
            "2022-09-03T20:20:01.6046578+00:00"
          ]
        },
        {
          "EventName": "EnvelopeOpened",
          "EventDescription": "O link do envelope foi aberto",
          "EventDates": [
            "2022-09-04T15:20:01.6046598+00:00",
            "2022-09-04T16:20:01.6046602+00:00"
          ]
        },
        {
          "EventName": "DocumentViewed",
          "EventDescription": "O documento foi visualizado",
          "EventDates": [
            "2022-09-04T17:20:01.6046608+00:00",
            "2022-09-04T18:20:01.6046614+00:00",
            "2022-09-04T19:20:01.6046616+00:00"
          ]
        },
        {
          "EventName": "DocumentAccepted",
          "EventDescription": "O documento foi aceito",
          "EventDates": [
            "2022-09-04T20:10:01.6046619+00:00"
          ]
        },
        {
          "EventName": "DocumentRefused",
          "EventDescription": "Recusou-se a assinar",
          "EventData": "Os meus dados pessoais estão inválidos.",
          "EventDates": [
            "2024-10-04T13:33:16.210813+00:00"
          ]
        },
        {
          "EventName": "DocumentFinalized",
          "EventDescription": "O processo de assinatura do signatário foi finalizado",
          "EventDates": [
            "2022-09-04T20:15:01.6046622+00:00"
          ]
        }
      ]
    }
  ],
  "IsTemplate": false,
  "DocumentSubcategoryUUID": "af70e1a4-1f8e-432c-b4c1-40b29dfd1aea",
  "DocumentSubcategoryName": "Abertura de conta bancária",
  "DocumentCategoryUUID": "e3529e7f-63cd-4574-a03e-d248f078d8fd",
  "DocumentCategoryName": "Admissão"
}
```

{% endcode %}

\
Cada elemento do objeto `SubscriberEvents` representa um evento ocorrido no documento, sendo que:

* O parâmetro `EventName` representa o nome do evento;
* O parâmetro `EventDescription` representa a descrição do evento;
* O parâmetro `EventDates` contem uma lista de datas nas quais o evento ocorreu.
  {% endstep %}

{% step %}
A propriedade `Subscribers[].SubscriberGeolocation` somente será retornada caso o usuário tenha compartilhado a localização durante o aceite do documento no processo de assinatura.

{% endstep %}
{% endstepper %}

## Próximos passos[​](https://developers.unico.io/docs/sign/fundamentals#pr%C3%B3ximos-passos) <a href="#proximos-passos" id="proximos-passos"></a>

* Conheça as funcionalidades disponíveis para o [<mark style="color:blue;">Gerenciamento de documentos</mark>](https://devcenter.unico.io/unico-sign/guia-das-apis/gerenciando-documentos).
* Conheça as funcionalidades disponíveis para o [<mark style="color:blue;">Gerenciamento de envelopes</mark>](https://devcenter.unico.io/unico-sign/guia-das-apis/gerenciando-envelopes).
* Tendo problemas em nossa integração? Acesse nossa seção de [<mark style="color:blue;">FAQ e problemas comuns</mark>](https://devcenter.unico.io/unico-sign/recursos-adicionais/faq).

***

**Dúvidas?**[**​**](https://developers.unico.io/docs/IDunico/Integracao/primeirosPassos#d%C3%BAvidas)

Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da [<mark style="color:blue;">Central de Ajuda</mark>](https://empresas.unico.io/hc/pt-br/p/atendimentoparaempresas).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://devcenter.unico.io/unico-sign/guia-das-apis/gerenciando-documentos/obter-detalhes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.