---
agentTools:
  projectIndex: https://docs.grafeno.digital/llms.txt
---

# Gerar URL assinada para upload de documentos do devedor

Registra a URL para savar os documentos do tomador de crédito.

> 🚧 ⚠️ Atenção ao envio de documentos
>
> O cadastro e o upload de documentos do tomador de crédito são feitos um documento por vez e a URL assinada tem o **prazo de expiração de 60 segundos**. Não é possível enviar mais de um documento na mesma requisição. Além disso, o cliente é responsável por atender a todos os documentos necessários e obrigatórios conforme o tipo de tomador (PF, PJ e representante legal). Consulte a lista completa de documentos exigidos para cada tipo em NOME\_DO\_LINK.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "API de Crédito - Grafeno Ativos",
    "version": "3.0.0"
  },
  "servers": [
    {
      "url": "https://apis.stg.grafeno.be/"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://example.com/oauth2/token",
            "scopes": {}
          }
        }
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/laas/v2/debtors/url-document": {
      "post": {
        "summary": "Gerar URL assinada para upload de documentos do devedor",
        "description": "Registra a URL para savar os documentos do tomador de crédito.",
        "operationId": "generate-signed-url-credit-api",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "debtor_identification",
                  "file_type",
                  "file_format"
                ],
                "properties": {
                  "debtor_identification": {
                    "type": "string",
                    "description": "CPF ou CNPJ do tomador de crédito."
                  },
                  "file_type": {
                    "type": "string",
                    "description": "Tipo de documento que será submetido ao cadastro do tomador de crédito.",
                    "enum": [
                      "debtor_identification_file",
                      "debtor_proof_of_income_file",
                      "debtor_address_proof_file",
                      "debtor_social_or_statute_contract",
                      "debtor_monthly_turnover_on_last_12_months_file",
                      "representative_address_proof_file",
                      "representative_identification_file"
                    ]
                  },
                  "file_format": {
                    "type": "string",
                    "description": "Formatos de arquivos válidos para os documentos.",
                    "enum": [
                      "pdf",
                      "jpeg",
                      "jpg"
                    ]
                  },
                  "representative_identification": {
                    "type": "string",
                    "description": "CPF do representante legal da empresa tomadora do crédito. <b>Se informado, o parâmetro debtor_identification com o CNPJ do tomador de crédito também deverá ser informado.</b>"
                  }
                }
              },
              "examples": {
                "Request Example": {
                  "value": {
                    "debtor_identification": "12345679891",
                    "representative_identification": "11122233300",
                    "file_type": "debtor_address_proof_file",
                    "file_format": "pdf"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "201",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"upload_url\": \"https://grafeno-dev-minutaria-back-permanent-storage.s3.us-east-1.amazonaws.com/debtors/27948716416/debtor_address_proof_file_1783623595563.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=ASIAYHN735NKVRTGOMO4%2F20260709%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260709T185956Z&X-Amz-Expires=60&X-Amz-Security-Token=IQoJb3JpZ2luX2VjENv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMSJHMEUCIE6WZRHc9U%2BBwO3qq6B%2BsTKXyUt1vW0u8k%2Fi7Sn4SDukAiEAu6T%2BYFcysR3SbUlhs7txS7g8f6JTtIREx0f9OhcStmEqlwUIpP%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARAFGgw1NjU3Mjc0NTYwODUiDOQCWyMDz%2FmzKloQByrrBDJ2cZp0mUUUaIdT0GE6Xf%2B0HYBAb3bC2gdz1hqFXrjxgEjTHZxb9cGFY7TETxo23ueFGI9kn1GWweT2K5v1JarypcgZdFuJt7wHXlUrTDprGGPrxAz9kO4jqfyhEKrSyubd3EXSEvJB2b3ZuNgJ30a9MIfQoFqKaqDCIlZZXA87cdMcJOxvBq9n2iCB9fQv%2FpdNbsU82nQbkbgPSbI10LnrL7k%2BkbGz%2BSMZYNqjsECvW5j0t2imKGErPW9QFofJ9uH3Pe3raFfwCNlbx1v%2BOOB7hPjojqRkMs%2F5tH152mgXzkgkj4RlmybkSvghnX%2BgjFt5mMeUp8z2SJ3pu%2BOwC3m%2Fa%2FTZXUX3vseuo282h6VNaSDA%2FWZkq5VhmPebUrF6bZRLgBDiTPU%2FSRWcajLL5cy3w%2B%2F1EQORlCBlh9ZhjHehk6jObMSdk7xTZLSjvSXDU5GZ0o36ZCwOt2mjUEpwQT%2BN5tJLHOpw5kx76LHESo1mk26RdFUeJ3cZZA7WDPJkRtFQE1cq5ORoXiywEyEqJBDMhRLOM7CcW9GfTxjuit%2BE58idzBCIvTM7WYTTWu6RH5ZeHQJ%2BWB8q3mG0XaSKCwYsdvor%2BWuQrvK5Jri3FfEdz7344Gohr1P5e%2FwKdjSZzCo7ZfX5LdAtw5YZupr9CsPJPED4JhNQHPzpzFLa3Ed3Q6kNcyVqYJocny%2Fsh1XzKTcsAUnMq4x8m1Wpk1ezg8MJ69IpEL56FxPzzmyohsh5WOqo29HPT8HELVucUpGogiMRdJZ03qAT8Wv9%2BuDBcXeWJbgfTNvK61dWlCk03fRDPtQY0CtwD%2FlBB2IwrN%2B%2F0gY6mAEKkQmajo8EjG0zIwDtq2MmVhxv6UNbh5WJkQiljZXfgo3%2FIW8cmkTPVj0wc%2FAa4rS8eq9b6dV7iSOEWjem%2FadLEJaC%2FvMAQK7bybjxqxWvKoPZKAWPmDJ0VUY6jItHVv8T%2FTRbOAO0NE4et5g%2Fqf9wlr%2F32NIdfGY%2F3KIFXDpSr%2FEvCW3eYuvP%2BEp%2F2ckBAewaSaGdk3c01Q%3D%3D&X-Amz-Signature=ac726f1d0998d6664f2e4b04edcba5e5be11135f32e7ecbeda3fa069d9dd6c31&X-Amz-SignedHeaders=host&x-amz-checksum-crc32=AAAAAA%3D%3D&x-amz-sdk-checksum-algorithm=CRC32&x-id=PutObject\",\n  \"file_key\": \"debtors/27948716416/debtor_address_proof_file_1783623595563.pdf\",\n  \"expires_in_seconds\": 60\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "upload_url": {
                      "type": "string",
                      "example": "https://grafeno-dev-minutaria-back-permanent-storage.s3.us-east-1.amazonaws.com/debtors/27948716416/debtor_address_proof_file_1783623595563.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=ASIAYHN735NKVRTGOMO4%2F20260709%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260709T185956Z&X-Amz-Expires=60&X-Amz-Security-Token=IQoJb3JpZ2luX2VjENv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMSJHMEUCIE6WZRHc9U%2BBwO3qq6B%2BsTKXyUt1vW0u8k%2Fi7Sn4SDukAiEAu6T%2BYFcysR3SbUlhs7txS7g8f6JTtIREx0f9OhcStmEqlwUIpP%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARAFGgw1NjU3Mjc0NTYwODUiDOQCWyMDz%2FmzKloQByrrBDJ2cZp0mUUUaIdT0GE6Xf%2B0HYBAb3bC2gdz1hqFXrjxgEjTHZxb9cGFY7TETxo23ueFGI9kn1GWweT2K5v1JarypcgZdFuJt7wHXlUrTDprGGPrxAz9kO4jqfyhEKrSyubd3EXSEvJB2b3ZuNgJ30a9MIfQoFqKaqDCIlZZXA87cdMcJOxvBq9n2iCB9fQv%2FpdNbsU82nQbkbgPSbI10LnrL7k%2BkbGz%2BSMZYNqjsECvW5j0t2imKGErPW9QFofJ9uH3Pe3raFfwCNlbx1v%2BOOB7hPjojqRkMs%2F5tH152mgXzkgkj4RlmybkSvghnX%2BgjFt5mMeUp8z2SJ3pu%2BOwC3m%2Fa%2FTZXUX3vseuo282h6VNaSDA%2FWZkq5VhmPebUrF6bZRLgBDiTPU%2FSRWcajLL5cy3w%2B%2F1EQORlCBlh9ZhjHehk6jObMSdk7xTZLSjvSXDU5GZ0o36ZCwOt2mjUEpwQT%2BN5tJLHOpw5kx76LHESo1mk26RdFUeJ3cZZA7WDPJkRtFQE1cq5ORoXiywEyEqJBDMhRLOM7CcW9GfTxjuit%2BE58idzBCIvTM7WYTTWu6RH5ZeHQJ%2BWB8q3mG0XaSKCwYsdvor%2BWuQrvK5Jri3FfEdz7344Gohr1P5e%2FwKdjSZzCo7ZfX5LdAtw5YZupr9CsPJPED4JhNQHPzpzFLa3Ed3Q6kNcyVqYJocny%2Fsh1XzKTcsAUnMq4x8m1Wpk1ezg8MJ69IpEL56FxPzzmyohsh5WOqo29HPT8HELVucUpGogiMRdJZ03qAT8Wv9%2BuDBcXeWJbgfTNvK61dWlCk03fRDPtQY0CtwD%2FlBB2IwrN%2B%2F0gY6mAEKkQmajo8EjG0zIwDtq2MmVhxv6UNbh5WJkQiljZXfgo3%2FIW8cmkTPVj0wc%2FAa4rS8eq9b6dV7iSOEWjem%2FadLEJaC%2FvMAQK7bybjxqxWvKoPZKAWPmDJ0VUY6jItHVv8T%2FTRbOAO0NE4et5g%2Fqf9wlr%2F32NIdfGY%2F3KIFXDpSr%2FEvCW3eYuvP%2BEp%2F2ckBAewaSaGdk3c01Q%3D%3D&X-Amz-Signature=ac726f1d0998d6664f2e4b04edcba5e5be11135f32e7ecbeda3fa069d9dd6c31&X-Amz-SignedHeaders=host&x-amz-checksum-crc32=AAAAAA%3D%3D&x-amz-sdk-checksum-algorithm=CRC32&x-id=PutObject"
                    },
                    "file_key": {
                      "type": "string",
                      "example": "debtors/27948716416/debtor_address_proof_file_1783623595563.pdf"
                    },
                    "expires_in_seconds": {
                      "type": "integer",
                      "example": 60,
                      "default": 0
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true,
  "_id": "6a4eb63c911754a264d3d6e4:6a4fb214485180fa9a85cd34"
}
```