PUBLIC SERVICES [PROD]
  1. External System 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
      • Export structured document data processed in the Pipeline
    • External System Integration
      • Get pending entities to be integrated
        POST
      • Register delivery integration
        POST
      • Update integration status
        POST
      • Get all documents attached to a request
        POST
      • Reprocess a specific request
        POST
    • 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. External System Integration

Get pending entities to be integrated

HOM
https://hom.roit.ai
HOM
https://hom.roit.ai
POST
/ibs-core-entrypoint/api/v1/entrypoint/requests/pending
The document payloads in the response can be customized according to the requester's needs. Please contact our team for analysis and planning of the required adjustments.

Request

Header Params

Body Params application/json

Examples
Get pending NFE documents
{
    "entity": "DOCUMENT",
    "integrationId": "9876c5d4-ba32-1098-7654-321f98765432",
    "type": "NFE"
}

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
curl --location --request POST 'https://hom.roit.ai/ibs-core-entrypoint/api/v1/entrypoint/requests/pending' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "entity": "DOCUMENT",
    "integrationId": "9876c5d4-ba32-1098-7654-321f98765432",
    "type": "NFE"
}'

Responses

🟢201Created
application/json
Document responses
Body

Examples
{
    "timestamp": 1709913600000,
    "message": "Success",
    "status": "OK",
    "data": [
        {
            "header": {
                "nationalRegister": "93293146000153"
            },
            "documents": [
                {
                    "requestId": "1234567890",
                    "reference": "1234567890",
                    "file": "NFe.xml",
                    "nationalRegister": "93293146000153",
                    "type": "NFE",
                    "header": {
                        "accessKey": "1234567890543129867564538762198736451238413",
                        "documentTotalValue": "1000.00",
                        "series": "1",
                        "number": "123456",
                        "postingDate": "2024-03-08T00:00:00.000Z",
                        "issueDate": "2024-03-08T00:00:00.000Z",
                        "dueDate": "2024-04-08T00:00:00.000Z",
                        "shipping": {
                            "modality": "3",
                            "value": "100"
                        },
                        "authorizationCode": "1234567890543129867564538762198736451238413"
                    },
                    "items": [
                        {
                            "purchaseNumber": "7504120",
                            "purchaseItem": "01",
                            "code": "XYZ123",
                            "costCenter": {
                                "code": "01.02"
                            },
                            "quantity": "10",
                            "unityValue": "100.00",
                            "totalValue": "1000.00",
                            "unitMeasurement": "UN",
                            "ncm": "98765432",
                            "ean": "9876543210123",
                            "cfop": "1234",
                            "taxes": [
                                {
                                    "name": "ICMS",
                                    "base": 12234.68,
                                    "aliquot": 0.1,
                                    "value": 25
                                }
                            ]
                        }
                    ],
                    "provider": {
                        "nationalRegister": "93293146000153",
                        "name": "Empresa Exemplo",
                        "personType": "CNPJ",
                        "cityUniqueCode": "3452314",
                        "address": {
                            "street": "Rua das Flores",
                            "number": "123",
                            "zipCode": "71745800",
                            "city": "São Paulo",
                            "cityUniqueCode": "3452314",
                            "complement": "Apto 123",
                            "state": "SP",
                            "district": "Bairro das Flores"
                        }
                    }
                }
            ]
        }
    ]
}
🟠400Bad Request
🟠403Forbidden
Modified at 2025-11-12 11:50:40
Previous
Export structured document data processed in the Pipeline
Next
Register delivery integration
Built with