1. Documents Manager
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
        POST
      • Get export request by id
        GET
      • Delete export request by id
        DELETE
      • Generate signed URLs for export files by id
        GET
      • Export structured document data processed in the Pipeline
        GET
    • 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
    • Account Payable
      • This operation will list the Account payable events
      • This operation will count all the Account payable
      • This operation will search the Account payable by id
      • This operation will search all the Account payable
      • This operations is designed to search an account payable by metadata information
  • Tax Reform
    • Data Integration
      • Create a new request
      • Update request status
      • Batch update request statuses
      • Generate signed URL
      • Generate upload path
      • Batch generate upload paths
    • CClasTrib Data
      • Get cclasstrib data
  • Schemas
    • Schemas
      • nationalRegisterGeneric
      • ProcessUpload
      • Date
      • QueryOperatorFormat
      • FileUploadBase64DTO
      • QueryOperators
      • QueryOperatorStep
      • costCenterGeneric
      • DocumentTributeDTO
      • CreateTokenDTO
      • Status
      • TableMetadata
      • HeaderResponse
      • CteCargoQuantityDetail
      • CteTomadorDto
    • Currency
    • DataDto
    • UserContextModel
    • ForgotPasswordDTO
    • NationalRegisterGeneric
    • BaseResponse
    • AuditBigQueryRequest
    • CompanyDTO
    • DocumentFileDTO
    • AccountsPayableDto
    • Period
    • TransitionalTokenResponseDTO
    • AddresGeneric
    • DocumentType
    • CreateResponse
    • AuditBigQueryResponse
    • InstallmentDetailsModel
    • DocumentFileErpDTO
    • SyncRequest
    • HeaderModel
    • BusinessPartner
    • LoginDTO
    • ProviderGeneric
    • Error
    • CreateResponseData
    • DeleteResponse
    • DataBaseDest
    • AuditBigQueryResponseData
    • CurrencyDTO
    • DocumentAddressDTO
    • SyncResponse
    • LinkModel
    • PurchaseItem
    • CustomTokenResponseDTO
    • NfeModalityDto
    • HTTPValidationError
    • DeleteResponseData
    • AccountsPayableHeaderDto
    • AuditStorageRequest
    • ValueDTO
    • DocumentPartyDTO
    • SyncResponseData
    • CostCenter
    • PaymentMethod
    • RefreshTokenResponseDTO
    • NfeDocumentHeaderDto
    • SignedUrlRequest
    • HolderDto
    • AuditStorageResponse
    • AccountPayableMetadataDTO
    • DocumentServiceDTO
    • ItemParentModel
    • PurchaseOrderDto
    • ClientTreeFilter
    • RefreshTokenDTO
    • NfeTaxDto
    • CostCenterGeneric
    • Type
    • GetResponse
    • AuditStorageResponseData
    • ReceiptModel
    • DocumentCpomDTO
    • Tribute
    • Contact
    • BaseFiltersModel
    • AuthorizationTokenResponseDTO
    • UpdateStatusRequest
    • CreateRequestSuccessResponse
    • ProcessStatus
    • GetResponseData
    • AccountsPayableResponseDto
    • CanceledAccountPayableUser
    • ItemModel
    • Address
    • ExportRequestModel
    • UserInfoDTO
    • NfeItemDto
    • ValidationError
    • SignedUrlResponse
    • GenericErrorResponse
    • AccountsPayableModelResponse
    • CanceledAccountPayable
    • DocumentTransportDTO
    • BatchDeleteRequest
    • ServiceLocation
    • BankAccount
    • CreateRequestDTO
    • NfeDto
    • GenericUnauthorizedResponse
    • ListResponse
    • PaymentPurpose
    • DocumentPaymentDTO
    • BatchDeleteResponse
    • TaxModel
    • Branch
    • Array
    • TokenSuccessResponseDTO
    • NfeResponseDto
    • UpdateResponse
    • ListResponseData
    • IsLocked
    • DocumentTotalResumeDTO
    • DocumentCteCityDTO
    • BatchUpdateResponse
    • DocumentModel
    • AdditionalInfos
    • ProcessRequestDTO
    • TokenErrorResponseDTO
    • NfeModelResponse
    • UpdateResponseData
    • PublicCreateTokenDTO
    • PaginationData
    • AccountPayableTaxDataModel
    • DecryptFilesRequest
    • DocumentCteProtocolDTO
    • BatchUpdateStatusRequest
    • GenericModel
    • SupplierDto
    • ExportRequestFileModel
    • GenericHeaderModel
    • ChangeAuthPasswordDTO
    • NfseDocumentHeaderDto
    • GenericSuccessResponse
    • AccountPayable
    • DecryptFilesResponse
    • DocumentCteQuantityInformationDTO
    • BatchUploadPathRequest
    • EntityRequestModel
    • TaxDto
    • Blob
    • RedefinePasswordDTO
    • NfseTax
    • RequestItem
    • BarcodeDetailDTO
    • DecryptFilesResponseData
    • DocumentCteCargoDetailsDTO
    • BatchUploadPathResponse
    • Object
    • TaxCodeDto
    • ZipProcessorDTO
    • CreateMfaResponseDTO
    • ItemNfseDto
    • GetAllRequestItemSuccessResponse
    • BankAccountDTO
    • DecryptedFileInfo
    • DocumentCteServiceComplementationDTO
    • ConductorCallback
    • PendingDto
    • TaxCodeIrfDto
    • ClientTreeOption
    • CreateMfaDTO
    • NfseDto
    • PixDetailDTO
    • RequestActionUserDTO
    • EntityStatusModel
    • CostCenterDto
    • Additional
    • ActiveMfaDto
    • NfseResponseDto
    • SignedUrlResponseData
    • TedDetailDTO
    • FileActionHistoryDTO
    • UpdateStatusDto
    • PaymentConditionDto
    • ExportFiltersModel
    • SendMfaVerificationDTO
    • NfseModelResponse
    • AbstractPaymentDetailDTO
    • EntityTimelineModel
    • ItemDto
    • CreateExportFiltersDTO
    • VerifyTokenResponseDTO
    • ConsumptionBillDocumentHeaderDto
    • Table
    • TaxWithBarcodeDetailDTO
    • GetDataResponseDto
    • FinancialNatureDto
    • UpdateExportFiltersDTO
    • AddMfaTypeDTO
    • ItemGeneric
    • DARFDetailDTO
    • PatchPriorityDto
    • InvoiceItem
    • SourceData
    • SetDefaultTypeDTO
    • ConsumptionBillDto
    • DARJDetailDTO
    • PendingResponseDto
    • OutboundInvoiceDto
    • QrCodeDTO
    • ConsumptionBillResponseDto
    • DPVATDetailDTO
    • IntegrationDTO
    • DeliveryAuthorizationItem
    • OidcInterceptorDTO
    • ConsumptionBillModelResponse
    • GAREDetailDTO
    • DocumentResponseDTO
    • String
    • DeliveryAuthorizationDto
    • UserIdDTO
    • CteCityDto
    • IPVADetailDTO
    • PaginatedDocumentsResponseDTO
    • DeliveryDto
    • BlindReviewItem
    • MfaMyOptionsResponseDTO
    • CteTributesDto
    • LicensingDetailDTO
    • LegacyDeliveryDTO
    • BlindReviewDto
    • CreateTrustedDeviceDTO
    • CteShippingDto
    • SimpleDARFDetailDTO
    • EventHubDTO
    • GoodsThirdPartyDto
    • AuthorizationGenerationDTO
    • PayrollDetailDTO
    • ServerToServerTokenResponseDTO
    • CteCargoDetailsDto
    • InstallmentDTO
    • MfaDTO
    • DeliverySuccessResponseDto
    • PaymentPurposeDTO
    • TokenExchangeDTO
    • TenantResponseDTO
    • DeliveryBadRequestResponseDto
    • CteDocumentHeaderDto
    • AccountPayableTaxDataDTO
    • UserTenantResponseDTO
    • DeliveryUnauthorizedResponseDto
    • IdentificationModel
    • CteDto
    • AccountPayableDTO
    • OutputTenantDTO
    • ItemCategorizationModel
    • CteResponseDto
    • UserDetailDTO
    • CreateTokenResponseDTO
    • CteModelResponse
    • AccountPayableUpdateDTO
    • CreateTokenRequestDTO
    • AccountPayableUpdateStatusMetadataModel
    • ImpersonateUserDTO
    • AccountPayableUpdateStatusDTO
    • AccountPayableUpdateIsOpenDTO
    • MassUnlockDTO
    • CnaeCode
    • AccountPayableUpdateDefaultHolderBankDTO
    • LegalNature
    • AccountPayableReceiptDTO
    • SupplierData
    • AccountPayableRescheduleDTO
    • SupplierContent
    • RequestPaymentDTO
    • SupplierResponseDto
    • IntegrationEventMetadata
    • SupplierModelResponse
    • UploadPathRequest
    • IntegrationEvent
    • UploadPathResponse
    • IntegrationEventDTO
    • UploadPathResponseData
    • AccountPayableDeleteDTO
    • FileDto
    • AccountPayableEvent
    • DateModel
    • AttachsDto
    • Number
    • LegacyGetAttachsDto
    • GetDataDto
    • UniqueFiltersModel
    • PaginatedAccountPayable
    • SearchDTO
    • UpdateStatusResponseDto
    • ManifestationStatusModel
    • AccountPayableRedefineDetailDTO
    • ManifestationModel
    • AccountPayableRedefineMetadataDTO
    • AccountPayableUpdateIntegrationStatusDTO
    • AccountPayableAuthentication
    • AuthenticationDTO
    • AccountPayableExportDTO
    • PatchTranslatedDataDto
    • AccountPayableExportMetadata
    • AccountsPayableExportLog
    • AccountPayableExportUpdateDTO
    • ReprocessDto
    • Entity
  1. Documents Manager

Create document export request

HOM
https://hom.roit.ai
HOM
https://hom.roit.ai
POST
/assembler-documents-manager/api/v1/export/requests

Request

Header Params

Body Params application/jsonRequired

Example
Request example
{
    "master": "anyMasterId",
    "preference": "original",
    "filters": {
        "type": {
            "in": [
                ".xml",
                ".pdf"
            ]
        },
        "createAt": {
            "gte": "2025-01-10T03:00:00.000Z"
        },
        "issueDate": {
            "lte": "2025-01-10T03:00:00.000Z"
        },
        "entryDate": {
            "gte": "2025-01-10T03:00:00.000Z"
        },
        "clientTree": [
            {
                "group": {
                    "eq": "1234567890"
                },
                "company": {
                    "eq": "1234567890"
                },
                "identifier": {
                    "eq": "1234567890"
                }
            }
        ],
        "classification": {
            "in": [
                "/fiscal/nfe",
                "/fiscal/cte"
            ]
        },
        "step": {
            "in": [
                "COMPLEMENTATION"
            ]
        },
        "origin": {
            "nin": [
                "SITE",
                "FORMS"
            ]
        },
        "isConsolidated": {
            "eq": false
        },
        "finalized": {
            "eq": false
        },
        "originCity": {
            "in": [
                "12345",
                "67890"
            ]
        },
        "destinyCity": {
            "in": [
                "12345",
                "67890"
            ]
        },
        "number": {
            "gte": "100"
        },
        "totalValue": {
            "gte": 100,
            "lte": 10000
        },
        "internalId": {
            "in": [
                "docId1",
                "docId2",
                "docId3"
            ]
        },
        "serviceMadeCity": {
            "in": [
                "12345",
                "67890"
            ]
        },
        "supplierDocumentNumber": {
            "in": [
                "1234567890"
            ]
        },
        "hasIssRetention": {
            "eq": true
        },
        "accessKey": {
            "eq": "accessKey123"
        },
        "purchaseOrder": {
            "in": [
                "purchaseOrder123",
                "purchaseOrder456"
            ]
        },
        "moviment": {
            "in": [
                "movementType12345",
                "movementType67890"
            ]
        },
        "classTypeEvent": {
            "eq": "eventType123"
        },
        "message": {
            "eq": "message123"
        }
    }
}

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/assembler-documents-manager/api/v1/export/requests' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "master": "anyMasterId",
    "preference": "original",
    "filters": {
        "type": {
            "in": [
                ".xml",
                ".pdf"
            ]
        },
        "createAt": {
            "gte": "2025-01-10T03:00:00.000Z"
        },
        "issueDate": {
            "lte": "2025-01-10T03:00:00.000Z"
        },
        "entryDate": {
            "gte": "2025-01-10T03:00:00.000Z"
        },
        "clientTree": [
            {
                "group": {
                    "eq": "1234567890"
                },
                "company": {
                    "eq": "1234567890"
                },
                "identifier": {
                    "eq": "1234567890"
                }
            }
        ],
        "classification": {
            "in": [
                "/fiscal/nfe",
                "/fiscal/cte"
            ]
        },
        "step": {
            "in": [
                "COMPLEMENTATION"
            ]
        },
        "origin": {
            "nin": [
                "SITE",
                "FORMS"
            ]
        },
        "isConsolidated": {
            "eq": false
        },
        "finalized": {
            "eq": false
        },
        "originCity": {
            "in": [
                "12345",
                "67890"
            ]
        },
        "destinyCity": {
            "in": [
                "12345",
                "67890"
            ]
        },
        "number": {
            "gte": "100"
        },
        "totalValue": {
            "gte": 100,
            "lte": 10000
        },
        "internalId": {
            "in": [
                "docId1",
                "docId2",
                "docId3"
            ]
        },
        "serviceMadeCity": {
            "in": [
                "12345",
                "67890"
            ]
        },
        "supplierDocumentNumber": {
            "in": [
                "1234567890"
            ]
        },
        "hasIssRetention": {
            "eq": true
        },
        "accessKey": {
            "eq": "accessKey123"
        },
        "purchaseOrder": {
            "in": [
                "purchaseOrder123",
                "purchaseOrder456"
            ]
        },
        "moviment": {
            "in": [
                "movementType12345",
                "movementType67890"
            ]
        },
        "classTypeEvent": {
            "eq": "eventType123"
        },
        "message": {
            "eq": "message123"
        }
    }
}'

Responses

🟢200OK
application/json
Success response
Body

Example
{
    "timestamp": 1234567890,
    "status": "success",
    "data": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "user": {
            "id": "string",
            "name": "string",
            "email": "string"
        },
        "master": "anyMasterId",
        "period": {
            "from": "2024-03-01",
            "to": "2024-03-31"
        },
        "quantity": 0,
        "size": 0,
        "status": "pending",
        "preference": "original",
        "filters": {
            "type": {
                "in": [
                    ".xml",
                    ".pdf"
                ]
            },
            "createAt": {
                "gte": "2025-01-10T03:00:00.000Z"
            },
            "issueDate": {
                "gte": "2025-01-10T03:00:00.000Z"
            },
            "entryDate": {
                "gte": "2025-01-10T03:00:00.000Z"
            },
            "clientTree": [
                {
                    "group": {
                        "in": [
                            "1234567890"
                        ]
                    },
                    "company": {
                        "in": [
                            "1234567890"
                        ]
                    },
                    "identifier": {
                        "in": [
                            "1234567890"
                        ]
                    }
                }
            ],
            "classification": {
                "in": [
                    "/fiscal/nfe",
                    "/fiscal/cte"
                ]
            },
            "step": {
                "in": [
                    "COMPLEMENTATION"
                ]
            },
            "origin": {
                "nin": [
                    "SITE",
                    "FORMS"
                ]
            },
            "isConsolidated": {
                "eq": false
            },
            "finalized": {
                "eq": false
            },
            "originCity": {
                "in": [
                    "12345",
                    "67890"
                ]
            },
            "destinyCity": {
                "in": [
                    "12345",
                    "67890"
                ]
            },
            "number": {
                "gte": "100"
            },
            "totalValue": {
                "gte": 100,
                "lte": 10000
            },
            "internalId": {
                "in": [
                    "docId1",
                    "docId2",
                    "docId3"
                ]
            },
            "serviceMadeCity": {
                "in": [
                    "12345",
                    "67890"
                ]
            },
            "supplierDocumentNumber": {
                "in": [
                    "1234567890"
                ]
            },
            "hasIssRetention": {
                "eq": true
            },
            "accessKey": {
                "eq": "accessKey123"
            },
            "purchaseOrder": {
                "in": [
                    "purchaseOrder123",
                    "purchaseOrder456"
                ]
            },
            "moviment": {
                "in": [
                    "INPUT",
                    "OUTPUT"
                ]
            },
            "classTypeEvent": {
                "eq": "eventType123"
            },
            "message": {
                "eq": "message123"
            }
        },
        "totalOfParts": 0,
        "totalOfPartsProcessed": 0
    },
    "message": "Request received successfully"
}
🟠400Bad Request
🟠401Unauthorized
Modified at 2026-03-02 21:18:07
Previous
Generate a token to access ROIT APIs
Next
Get export request by id
Built with