> This page is for Docs.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# File, ZDP & Prefetch errors

> This reference details file, ZDP, and prefetch errors, covering error codes, their messages, and suggested remedies.

This reference details file, ZDP, and prefetch errors, covering error codes, their messages, and suggested remedies.

Error code range: 70002281–70002299

| Code     | Error Code                                                | Error Message                                                                                                    | Possible Remedy                                                                   |
| -------- | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| 70002281 | FILE_ALREADY_EXISTS                                       | The file “\[File Name]” already exists.                                                                          | Use a different file name or delete the existing file first.                      |
| 70002282 | ZDP_METADATA_DUPLICATED_TABLE_NAME                        | The table name “\[Table Name]” is already in use in database “\[Database Name]”. Please choose a different name. | Choose a unique table name.                                                       |
| 70002283 | ZDP_METADATA_NOT_EXISTING                                 | The data platform metadata “\[Metadata Name]” was not found.                                                     | Verify the metadata ID.                                                           |
| 70002284 | ZDP_METADATA_CANNOT_UPDATE_WHEN\_​CONCURRENT_MODIFICATION | This metadata is being updated by another session. Please try again shortly.                                     | Wait and retry.                                                                   |
| 70002285 | ZDP_SYNC_DEFINITION_NOT_EXISTING                          | The sync definition “\[Sync Definition Name]” was not found.                                                     | Verify the sync definition ID.                                                    |
| 70002286 | PREFETCH_DEFINITION_NOT_EXISTING                          | The prefetch definition “\[Prefetch Definition Name]” was not found.                                             | Verify the prefetch definition ID. Create one if needed via the admin tools.      |
| 70002287 | ZDP_SYNC_DEFINITION_TABLE_REVISION_NOT_EXISTING           | Revision “\[Revision Number]” of table “\[Table Name]” was not found.                                            | Verify the revision number and table name.                                        |
| 70002288 | ZDP_SYNC_DEFINITION_INVALID_PARTITION_BY                  | All tables must use the same partition-by column.                                                                | Update table definitions so they share the same partition-by column.              |
| 70002289 | ZDP_SYNC_DEFINITION_INVALID_PARTITION_COUNT               | All tables must have the same partition count.                                                                   | Align partition counts across all tables.                                         |
| 70002290 | ZDP_SYNC_DEFINITION_PARTITION_BY_NOT_EXISTING             | The partition column “\[Column Name]” does not exist in table “\[Table Name]”.                                   | Add the column to the table schema or choose an existing column for partitioning. |
| 70002291 | PREFETCH_DEFINITION_FILTER_NOT_EXISTING                   | The filter field “\[Field Name]” does not exist in table “\[Table Name]”.                                        | Update the filter to reference a valid column.                                    |
| 70002292 | PREFETCH_DEFINITION_VALUE_FIELD_NOT_EXISTING              | The value field “\[Field Name]” does not exist in table “\[Table Name]”.                                         | Update the value field to reference a valid column.                               |
| 70002293 | ZDP_SYNC_DEFINITION_DUPLICATED_NAME                       | The sync definition name “\[Sync Definition Name]” is already in use. Please choose a different name.            | Choose a unique name.                                                             |
| 70002294 | FILE_PATH_TOO_LONG                                        | The file path “\[File Path]” is too long. Please shorten it.                                                     | Shorten directory names or reduce path depth.                                     |
| 70002295 | ZDP_METADATA_DUPLICATED_PRIMARY_KEYS                      | Only one primary key field is allowed. Please remove duplicates.                                                 | Designate a single field as the primary key.                                      |
| 70002296 | ZDP_METADATA_EVENT_ID_FIELDS_MISSING                      | The schema must include at least one event ID field.                                                             | Add an event ID field to the schema.                                              |
| 70002297 | ZDP_METADATA_PRIMARY_KEY_FIELDS_MISSING                   | The schema must include exactly one primary key field.                                                           | Designate one field as the primary key.                                           |
| 70002298 | PREFETCH_MORE_THAN_ONE_FOUND                              | Multiple prefetch definitions were found. Please specify which one to use.                                       | Provide the specific prefetch definition ID.                                      |
| 70002299 | PREFETCH_NOT_FOUND                                        | No prefetch definition was found.                                                                                | Create a prefetch definition for this meter via the admin tools.                  |