PUBLIC SERVICES [PROD]
  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
      • Generate signed URL
    • CClasTrib Data
      • Get cclasstrib data
    • Data Sync
      • Sync data
  • Schemas
    • Schemas
      • Currency
      • UserContextModel
      • ForgotPasswordDTO
      • nationalRegisterGeneric
      • ProcessUpload
      • NationalRegisterGeneric
      • CompanyDTO
      • DocumentFileDTO
      • Date
      • Period
      • TransitionalTokenResponseDTO
      • AddresGeneric
      • InstallmentDetailsModel
      • DocumentFileErpDTO
      • HeaderModel
      • QueryOperatorFormat
      • LoginDTO
      • ProviderGeneric
      • FileUploadBase64DTO
      • CurrencyDTO
      • DocumentAddressDTO
      • LinkModel
      • QueryOperators
      • CustomTokenResponseDTO
      • NfeModalityDto
      • AccountsPayableHeaderDto
      • ValueDTO
      • DocumentPartyDTO
      • CostCenter
      • QueryOperatorStep
      • RefreshTokenResponseDTO
      • NfeDocumentHeaderDto
      • HolderDto
      • AccountPayableMetadataDTO
      • DocumentServiceDTO
      • ItemParentModel
      • ClientTreeFilter
      • RefreshTokenDTO
      • NfeTaxDto
      • CostCenterGeneric
      • ReceiptModel
      • DocumentCpomDTO
      • Tribute
      • BaseFiltersModel
      • AuthorizationTokenResponseDTO
      • costCenterGeneric
      • CreateRequestSuccessResponse
      • AccountsPayableResponseDto
      • CanceledAccountPayableUser
      • DocumentTributeDTO
      • ItemModel
      • ExportRequestModel
      • UserInfoDTO
      • NfeItemDto
      • GenericErrorResponse
      • AccountsPayableModelResponse
      • CanceledAccountPayable
      • DocumentTransportDTO
      • ServiceLocation
      • CreateRequestDTO
      • CreateTokenDTO
      • NfeDto
      • GenericUnauthorizedResponse
      • Status
      • PaymentPurpose
      • DocumentPaymentDTO
      • TaxModel
      • Array
      • TokenSuccessResponseDTO
      • NfeResponseDto
      • IsLocked
      • DocumentTotalResumeDTO
      • DocumentCteCityDTO
      • DocumentModel
      • ProcessRequestDTO
      • TokenErrorResponseDTO
      • NfeModelResponse
      • PublicCreateTokenDTO
      • AccountPayableTaxDataModel
      • DocumentCteProtocolDTO
      • GenericModel
      • ExportRequestFileModel
      • GenericHeaderModel
      • ChangeAuthPasswordDTO
      • NfseDocumentHeaderDto
      • GenericSuccessResponse
      • AccountPayable
      • DocumentCteQuantityInformationDTO
      • EntityRequestModel
      • Blob
      • RedefinePasswordDTO
      • NfseTax
      • BarcodeDetailDTO
      • DocumentCteCargoDetailsDTO
      • Object
      • ZipProcessorDTO
      • CreateMfaResponseDTO
      • ItemNfseDto
      • GetAllRequestItemSuccessResponse
      • BankAccountDTO
      • DocumentCteServiceComplementationDTO
      • PendingDto
      • ClientTreeOption
      • CreateMfaDTO
      • NfseDto
      • PixDetailDTO
      • EntityStatusModel
      • Additional
      • ActiveMfaDto
      • NfseResponseDto
      • TedDetailDTO
      • UpdateStatusDto
      • ExportFiltersModel
      • SendMfaVerificationDTO
      • NfseModelResponse
      • AbstractPaymentDetailDTO
      • EntityTimelineModel
      • CreateExportFiltersDTO
      • VerifyTokenResponseDTO
      • ConsumptionBillDocumentHeaderDto
      • TaxWithBarcodeDetailDTO
      • GetDataResponseDto
      • UpdateExportFiltersDTO
      • AddMfaTypeDTO
      • ItemGeneric
      • TableMetadata
      • DARFDetailDTO
      • PatchPriorityDto
      • SourceData
      • SetDefaultTypeDTO
      • ConsumptionBillDto
      • DARJDetailDTO
      • PendingResponseDto
      • QrCodeDTO
      • ConsumptionBillResponseDto
      • DPVATDetailDTO
      • IntegrationDTO
      • OidcInterceptorDTO
      • ConsumptionBillModelResponse
      • GAREDetailDTO
      • DocumentResponseDTO
      • String
      • HeaderResponse
      • UserIdDTO
      • CteCityDto
      • IPVADetailDTO
      • PaginatedDocumentsResponseDTO
      • MfaMyOptionsResponseDTO
      • CteTributesDto
      • LicensingDetailDTO
      • CreateTrustedDeviceDTO
      • CteShippingDto
      • SimpleDARFDetailDTO
      • AuthorizationGenerationDTO
      • CteCargoQuantityDetail
      • PayrollDetailDTO
      • ServerToServerTokenResponseDTO
      • CteCargoDetailsDto
      • InstallmentDTO
      • MfaDTO
      • CteTomadorDto
      • PaymentPurposeDTO
      • TenantResponseDTO
      • CteDocumentHeaderDto
      • AccountPayableTaxDataDTO
      • UserTenantResponseDTO
      • 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
      • IntegrationEvent
      • IntegrationEventDTO
      • 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
    • DataDto
    • BaseResponse
    • AuditBigQueryRequest
    • AccountsPayableDto
    • DocumentType
    • CreateResponse
    • AuditBigQueryResponse
    • SyncRequest
    • BusinessPartner
    • Error
    • CreateResponseData
    • DeleteResponse
    • DataBaseDest
    • AuditBigQueryResponseData
    • SyncResponse
    • PurchaseItem
    • HTTPValidationError
    • DeleteResponseData
    • AuditStorageRequest
    • SyncResponseData
    • PaymentMethod
    • SignedUrlRequest
    • AuditStorageResponse
    • PurchaseOrderDto
    • Type
    • GetResponse
    • AuditStorageResponseData
    • Contact
    • UpdateStatusRequest
    • ProcessStatus
    • GetResponseData
    • Address
    • ValidationError
    • SignedUrlResponse
    • BankAccount
    • ListResponse
    • Branch
    • UpdateResponse
    • ListResponseData
    • AdditionalInfos
    • UpdateResponseData
    • PaginationData
    • DecryptFilesRequest
    • SupplierDto
    • DecryptFilesResponse
    • TaxDto
    • RequestItem
    • DecryptFilesResponseData
    • TaxCodeDto
    • DecryptedFileInfo
    • TaxCodeIrfDto
    • CostCenterDto
    • SignedUrlResponseData
    • PaymentConditionDto
    • ItemDto
    • Table
    • FinancialNatureDto
    • InvoiceItem
    • OutboundInvoiceDto
    • DeliveryAuthorizationItem
    • DeliveryAuthorizationDto
    • DeliveryDto
    • BlindReviewItem
    • LegacyDeliveryDTO
    • BlindReviewDto
    • EventHubDTO
    • GoodsThirdPartyDto
    • DeliverySuccessResponseDto
    • DeliveryBadRequestResponseDto
    • DeliveryUnauthorizedResponseDto
  1. Documents Manager

Export structured document data processed in the Pipeline

HOM
https://hom.roit.ai
HOM
https://hom.roit.ai
GET
/assembler-documents-manager/api/v1/export/data
Returns structured data about fiscal documents processed in the Pipeline.
This endpoint does not return the original file (PDF/XML), only metadata
and extracted fields (file metadata, provider, beneficiary, values, tributes, etc.).
Depending on documentType, it returns NFSe, NFe, CTe or any other document type,
always including common fields and, when available, type-specific fields.

Request

Query Params

Header Params

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 GET 'https://hom.roit.ai/assembler-documents-manager/api/v1/export/data' \
--header 'Authorization;'

Responses

🟢200OK
application/json
Paginated response of documents data. The response structure varies based on document type (NFSe, NFe, CTe or others). Each document type returns only its specific fields plus common fields.
Body

Examples
Example response for a NFSe document. Contains NFSe-specific fields like authorizationCode, serviceDescription, and tribute values (PIS, COFINS, CSLL, etc.).
{
    "data": [
        {
            "documentType": "NFSe",
            "file": {
                "internalId": "33efa415-bea2-4da8-8296-e16407f0c2ff",
                "origin": "INBOUND_NFSE_SAOPAULOSERVICE",
                "name": "578b69e9402a56cf328777e82519d165/2025/09/16/22/07/54/1758060472051-0f237dbc7df9afd7340afb.xml",
                "displayName": "string",
                "step": "string",
                "stepOrder": 3,
                "message": "string",
                "uploadDate": "2025-09-16T22:07:59.394Z",
                "processStatus": "DONE",
                "visible": true,
                "duplicated": false,
                "deletedDocument": false,
                "isConsolidated": true,
                "finalized": false,
                "dueDate": "2025-10-16T12:00:00.000Z"
            },
            "fileErp": {
                "fiscalIntegrationMessage": "SUCCESS",
                "fiscalIntegrationValue": "string",
                "accountingIntegrationMessage": "SUCCESS",
                "accountingIntegrationValue": "string"
            },
            "accessKey": null,
            "number": "46811",
            "series": null,
            "issueDate": "2025-09-16T13:58:23.000Z",
            "cancelled": true,
            "value": 771.56,
            "liquidValue": 724.1,
            "dueDate": "2025-10-16T12:00:00.000Z",
            "provider": {
                "nationalRegister": "12345678000190",
                "name": "string",
                "optantSimples": false,
                "optantMei": false,
                "address": {
                    "city": "SAO PAULO",
                    "state": "SP"
                }
            },
            "beneficiary": {
                "nationalRegister": "98765432000111",
                "name": "string",
                "tradeName": "string",
                "legallyActive": true,
                "address": {
                    "city": "BARUERI",
                    "state": "SP"
                }
            },
            "authorizationCode": "string",
            "purchaseOrder": [
                "481524"
            ],
            "service": {
                "sameAddress": true,
                "description": "string",
                "discrimination": "string",
                "code": "1704",
                "serviceMadeCity": "3550308"
            },
            "serviceSheet": [],
            "claimant": null,
            "transferValue": 0,
            "paymentProviderStatus": "PAID",
            "cpom": {
                "description": null,
                "aliquot": null
            },
            "tributes": [
                {
                    "name": "cofins",
                    "aliquot": 3,
                    "value": 23.15
                },
                {
                    "name": "csll",
                    "aliquot": 1,
                    "value": 7.72
                },
                {
                    "name": "inss",
                    "aliquot": 0,
                    "value": 0
                },
                {
                    "name": "irrf",
                    "aliquot": 1.5,
                    "value": 11.57
                },
                {
                    "name": "iss",
                    "aliquot": 0,
                    "value": 0
                },
                {
                    "name": "pis",
                    "aliquot": 0.65,
                    "value": 5.02
                }
            ],
            "decrementValue": 0,
            "incrementValue": 0,
            "fineValue": 0
        }
    ],
    "total": 1,
    "page": 1,
    "limit": 1000,
    "totalPages": 1
}
🟠400Bad Request
Modified at 2025-12-08 19:42:27
Previous
Generate signed URLs for export files by id
Next
Get pending entities to be integrated
Built with