PUBLIC SERVICES [PROD]
  1. Data Integration
PUBLIC SERVICES [PROD]
  • Introduction
  • Document Management
  • External Integration
  • Authentication
    • Generate a token to access ROIT APIs
      POST
  • Invoice-to-Pay
    • Documents Manager
      • Create document export request
      • Get export request by id
      • Delete export request by id
      • Generate signed URLs for export files by id
    • External System Integration
      • Get pending entities to be integrated
      • Register delivery integration
      • Update integration status
      • Get all documents attached to a request
      • Reprocess a specific request
    • Upload Document
      • Upload document as base64
  • Tax Reform
    • Data Integration
      • Create a new request
        GET
      • Update request status
        POST
      • Generate signed URL
        POST
      • Audit storage
        POST
      • Audit bigquery
        POST
  1. Data Integration

Generate signed URL

HOM
https://hom.roit.ai
HOM
https://hom.roit.ai
POST
/roit-data-integration/v1/data/generate-signed-url
Generates a signed URL for secure file upload to cloud storage

Request

Header Params

Body Params application/json

Example
{
    "nationalRegister": "string",
    "processUniqueId": "string",
    "type": "ECF",
    "fileName": "string",
    "force": false
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://hom.roit.ai/roit-data-integration/v1/data/generate-signed-url' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "nationalRegister": "string",
    "processUniqueId": "string",
    "type": "ECF",
    "fileName": "string",
    "force": false
}'

Responses

🟢200OK
application/json
Signed URL generated successfully
Body

Example
{
    "status": "success",
    "message": "Signed URL generated successfully",
    "data": {
        "signedUrl": "https://storage.example.com/upload?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=...",
        "expiresAt": "2024-01-15T13:00:00Z",
        "fileName": "documento_nfe.xml",
        "processUniqueId": "bb0c892a-9695-414d-966b-c3cd66959067"
    }
}
🟠400Bad Request
🔴500Server Error
Modified at 2025-08-04 17:31:00
Previous
Update request status
Next
Audit storage
Built with