Gestão de Imóveis
- Upload
- Buscar documento
- Modelo
Para efetuar o upload de um documento do tipo Gestão de Imóveis, basta enviar uma requisição POST conforme demonstrado abaixo. O seu código interno é o 67.
POST URL Ambiente/documents/upload
Header
| Identificador | Valor |
|---|---|
| Content-type | multipart/form-data |
| IDEXA-API-KEY | [api_key] |
Payload
| Parâmetro | Descrição | Obrigatório | Tipo | Exemplos |
|---|---|---|---|---|
| files | Documento(s) a ser(em) processado(s) | Sim | File | "arquivo.pdf" |
| type | Tipo do documento enviado | Sim | Integer | 67 |
| pages | Páginas a serem analisadas (Quando extensão for pdf) | Não | String | "1,2,5-10" |
| externalId | Id externo para controle do documento (não pode repetir) | Não | String | "0001" |
Exemplo
('files',('arquivo.pdf',open('/path/to/file/arquivo.pdf','rb'),'application/pdf'))
{
"type": 67,
"pages": "1,2,5-10",
"externalId": "0001"
}
Retorno
Status code 200
Ao enviar um documento, o retorno 200 dado pela api, irá enviar um objeto data nulo pois a inferência do documento ainda será feita. Para obter o resultado da Inteligência Artificial, é necessário utilizar a requisição vista na próxima sessão.
| Parâmetro | Descrição | Tipo | Exemplos |
|---|---|---|---|
| id | Código interno do documento | UUID | "95893394-337c-429c-..." |
| externalId | Id externo para controle do documento (não pode repetir) | String | "0001" |
| type | Tipo do documento enviado | Integer | 67 |
| status | Situação do documento (0-Received, 1-Finished, 2-Error, 3-In Progress) | Integer | 0 |
| statusDesc | Situação do documento (RECEIVED, FINISHED, IN_PROGRESS, ERROR) | String | "FINISHED" |
| createdAt | Horário de criação do registro | Datetime | "01/01/2023 00:00:00.0000" |
| updatedAt | Horário de atualização do registro | Datetime | "01/01/2023 00:00:00.0000" |
Exemplo
{
"id": "bc1bc4ea-8964-4bb7-97cc-2d77d39908d8",
"externalId": "0001",
"type": 67,
"status": 0,
"statusDesc": "RECEIVED",
"createdAt": "2022-10-14 14:38:50.045316",
"updatedAt": "2022-10-14 14:38:50.045316"
}
Para buscar o resultado do documento processado, disponibilizamos o método GET, mostrado a seguir. Pasta passar no parâmetro id, o UUID recebido no momento do upload.
GET URL Ambiente/documents/[id]
Header
| Identificador | Valor |
|---|---|
| Content-type | application/json |
| IDEXA-API-KEY | [api_key] |
Retorno
Status code 200
Um http code 200 é retornado quando o documento é inserido corretamente.
| Parâmetro | Descrição | Tipo | Exemplos |
|---|---|---|---|
| id | Código interno do documento | UUID | "95893394-337c-429c-..." |
| externalId | Id externo para controle do documento (não pode repetir) | String | "0001" |
| type | Tipo do documento enviado | Integer | 67 |
| data | Objeto retornado pela IA | Modelo referente ao tipo do documento | json_object |
| processTime | Tempo de processamento | Float | 10.02232 |
| status | Situação do documento (0-Received, 1-Finished, 2-Error) | Integer | 3 |
| statusDesc | Situação do documento (RECEIVED, FINISHED, ERROR) | String | "FINISHED" |
| createdAt | Horário de criação do registro | Datetime | "01/01/2023 00:00:00.0000" |
| updatedAt | Horário de atualização do registro | Datetime | "01/01/2023 00:00:00.0000" |
Exemplo
{
"id": "bc1bc4ea-8964-4bb7-97cc-2d77d39908d8",
"externalId": "0001",
"type": 67,
"data": {
// Verificar em Modelo o resultado esperado desse documento
},
"processTime": null,
"status": 1,
"statusDesc": "FINISHED",
"createdAt": "2022-10-14 14:38:50.045316",
"updatedAt": "2022-10-14 14:38:50.045316"
}
| Parâmetro | Descrição | Tipo | Exemplos |
|---|---|---|---|
| documentType | Tipo do Documento | String | INSTRUMENTO PARTICULAR DE TRANSAÇÃO, INDENIZAÇÃO E QUITAÇÃO |
| grantors | Outorgantes (a parte que concede algo) | Array | |
| property | Dados do Imóvel | Date | |
| undertakingArea | Área do Empreendimento (opcional) | String | 15.000 m² |
| bankingDetails | Dados Bancários para Pagamento (opcional) | Date | |
| compensationValue | Valor da Indenização | String | R$ 25.450,75 |
| compensationDate | Data da Indenização (YYYY-MM-DD) | String | 2025-08-15 |
| signature | Presença de Assinatura | Boolean | true |
| signatures | Lista de Assinantes | Array |