--- title: "Exato - Batch Insert" method: POST path: "/exato/batch/insert" tags: ["Exato - Processamento em Lote"] --- # Exato - Batch Insert `POST /exato/batch/insert` ## Request - Base URL: `https://api.directdigital.com.br` - URL: `https://api.directdigital.com.br/exato/batch/insert` - Auth: API key in header `token` - TypeScript: (a function with typed inputs; its response is checked against the schema) Exato - Batch Insert ## Query parameters - `test_mode` boolean - `lightweight` boolean ## Request body `application/x-www-form-urlencoded` - object - `file_name` string: Batch input file name (required if using file upload) - `file_base64` string: Batch input file in base64 (required if using file upload) - `documents` string: List of documents (CPF/CNPJ) separated by comma or line break. Alternative to file upload. Max 500 documents. - `reuse_period_days` integer: Window in days for reusing previous reports of the same type/document from the client tree. Null or <= 0 disables reuse. Max 90. - `reuse_risk_indicators` string: Risk indicators accepted for reuse, comma-separated, like '3,4'. Requires reuse_period_days > 0. - `datasource_external_id` string, required: Datasource external id - `name` string: Batch name for display/reference. When empty, the file name or a generated name is used - `description` string: Batch description - `reference_id` string: External ID for correlation with client's system - `params` string: JSON with default parameters for all batch items (e.g. {"versao": 2}) ## Response `200` Success - ExatoBatchInsertResponse: ExatoBatchInsertResponse - `ApiResultType` 'Success' | 'SuccessWithRemarks' | 'InvalidInput' | 'DataUnavailable' | 'NotFound' | 'InvalidParameters' | 'UnsupportedCombination' | 'RemoteUnavailable' | 'Timeout' | 'RetryLimitReached' | 'RemoteError' | 'InProgress' | 'InsufficientCredits' | 'ConcurrentLimitReached' | 'TransactionUnavailable' | 'AccessDenied' | 'TransactionCancelled' | 'Created' | 'Updated' | 'Deleted' | 'InternalError' | 'ValidationFailed' | 'Conflict' | 'ResourceLocked' | 'PendingApproval' | 'Approved' | 'Rejected' | 'Cancelled' | 'Paused' | 'Resumed': New unified result type for queries and administrative operations. Replaces TransactionResultType with better semantics. - `BalanceInBrl` number, double: Current balance in BRL. - `BalanceInCredits` integer: Current balance in credits. - `DataSourceCategory` string: Data source category - `Date` string, date-time: Transaction date. - `ElapsedTimeInMilliseconds` integer: Execution time (in milliseconds). - `ExecutedDataSourceName` string: Display name of the query type that actually ran. - `ExecutedDataSourceTypeId` integer: Id of the query type that actually ran (the one recorded on the transaction), which may differ from the requested type when the route is generic per state or when a master delegates to a sub-query. - `HasOriginalFiles` boolean: Indicates that the transaction carries original files from the source (the issued certificate, for example) for download at OriginalFilesUrl. False does not mean the URL does not exist: it is always built. - `HasPdf` boolean: Indicates that there is a PDF proof document for the result. - `Message` string: Message. - `OriginalFilesUrl` string: URL to download the transaction's original files (when available). - `OutdatedResult` boolean: Indicates that the result is dated. - `PdfUrl` string: URL to download the transaction's PDF proof document (when available). - `ResultSubtype` string: Specific result subtype to provide additional context (e.g.: 'duplicate_name', 'invalid_cpf'). - `ResultTypeCode` integer: Numeric result code (compatible with TransactionResultTypeCode but extensible). - `TotalCost` number, double: Internal use only. - `TotalCostInCredits` integer: Total transaction cost in credits. - `TransactionResultType` 'Success' | 'SuccessWithRemarks' | 'InvalidInputData' | 'UnavailableData' | 'EntityNotFound' | 'InvalidParameters' | 'ParametersNotSupported' | 'RemoteSystemUnavailable' | 'Timeout' | 'AttemptsLimitReached' | 'RemoteSystemError' | 'AsyncExecutionInProgress' | 'AwaitingExecution' | 'BirthDateRequired' | 'InsufficientBalance' | 'SimultaneousTransactionsLimitReached' | 'TransactionUnavailable' | 'AccessDenied' | 'TransactionCancelled' | 'InternalError':
TransactionResultType CodeTransactionResultTypeFinalBillableError
1SuccessTrueTrueFalse
2Partial success or success with remarksTrueTrueFalse
3Invalid input or documentTrueFalseTrue
4Data not availableTrue (for the day)FalseFalse
5Entity or document nonexistent/not foundTrueTrueFalse
6Invalid input parametersTrueFalseTrue
7Unsupported parameter combinationTrueFalseTrue
8Data source or remote system unavailableFalseFalseTrue
9Time limit exceededFalseFalseTrue
10Attempts limit reachedFalseFalseTrue
11Error in the data source or remote systemFalseFalseTrue
12Transaction in progressFalseFalseFalse
101Insufficient credit balance, please contact usFalseFalseTrue
102Simultaneous transactions limit reached, please contact usFalseFalseTrue
103Transaction not available, please contact usFalseFalseTrue
104Invalid credentials or access denied, please contact usFalseFalseTrue
105Transaction cancelled, please contact usFalseFalseTrue
255*Unexpected internal error, please contact usTrue (for the day)FalseTrue
* Query under maintenance, try again later or contact Exato to report the problem
- `TransactionResultTypeCode` integer: Transaction result type code. - `UniqueIdentifier` string: Unique transaction identifier. Store it for control and debugging. - `Result` ExatoBatchInsertResult: ExatoBatchInsertResult - `BatchUid` string - `TotalValidDocuments` integer - `TotalReused` integer - `InvalidDocuments` string[] - `BatchStatusId` integer - `BatchStatusDescription` string - `Name` string - `Description` string - `ReferenceId` string - `ReusePeriodDays` integer - `ReuseRiskIndicators` integer[] ## Changes > 16 revisions in range; 1 not diffed. - **2026-11-05** `3b7fd216787b`: 1 info - endpoint added [Operation history](https://skmtc.dev/directdigital/apis/directdigital/changes/exato/batch/insert/post.md) --- [API](https://skmtc.dev/directdigital/apis/directdigital.md) - [All operations](https://skmtc.dev/directdigital/apis/directdigital/llms.txt) - [OpenAPI document](https://skmtc.dev/directdigital/apis/directdigital/revisions/3b7fd216787b?raw)