Códigos de erro — RocketPVA
All domain errors return HTTP 400 with a standardized error envelope. The code field identifies the specific error.
All domain errors return HTTP 400 with a standardized error envelope. The code field identifies the specific error.
{
"success": false,
"data": null,
"errors": [
{
"code": "BOOKKEEPING_NOT_FOUND",
"message": "Bookkeeping not found for the given filter."
}
]
}
| Code | Description |
|---|
CERTIFICATE_NOT_VALID | Certificate is expired or invalid |
CERTIFICATE_EXCLUSION_ERROR | Certificate cannot be deleted (in use) |
DUPLICATE_CERTIFICATE_ERROR | Certificate already exists for this customer |
BYTE_CONVERSION_ERROR | Failed to read certificate file bytes |
ERROR_EXTRACTING_CERTIFICATE_DATA | Failed to parse certificate data |
EXPIRATION_NOT_FOUND | Could not determine certificate expiration date |
COMPANY_AND_TAX_ID_NOT_FOUND | Could not find company and tax ID in certificate |
TAX_ID_NOT_FOUND | Could not extract tax ID from certificate |
COMPANY_ISSUER_NOT_FOUND | Could not find certificate issuer information |
| Code | Description |
|---|
BOOKKEEPING_NOT_FOUND | Bookkeeping not found for the given ID or filter |
BOOKKEEPING_INVALID_STATUS | Operation not allowed for the current bookkeeping status |
BOOKKEEPING_INVALID_SPED_TYPE | Invalid SPED type specified |
INVALID_FILE_STATUS | Invalid file status for the requested operation |
BOOKKEEPING_EXPIRED_VALIDATION_FILE | Validation file has expired and needs to be re-uploaded |
BOOKKEEPING_TRANSMISSION_NOT_FOUND | Transmission record not found for the bookkeeping |
BOOKKEEPING_CANNOT_DELETE_DUE_TO_TRANSMISSION | Cannot delete bookkeeping that has been transmitted |
BOOKKEEPING_ORIGINAL_WITH_TRANSMISSIONS | Original bookkeeping has transmission records |
BOOKKEEPING_NOT_FOUND_FOR_FILTER | No bookkeeping matches the provided filter criteria |
| Code | Description |
|---|
BOOKKEEPING_FILE_HISTORY_NOT_FOUND | File history record not found |
BOOKKEEPING_RESULTS_FILE_NOT_FOUND | Validation results file not found in storage |
BOOKKEEPING_GENERATE_EDITED_FILE_NOT_FOUND | Edited file not found for generation |
BOOKKEEPING_COPIA_SEGURANCA_FILE_NOT_FOUND | Backup file not found |
| Code | Description |
|---|
BULK_BOOKKEEPING_DATE_RANGE_EXCEEDS_LIMIT | Bulk operation date range exceeds the allowed limit |
BOOKKEEPING_ALREADY_IN_BULK_PROCESS | Bookkeeping is already part of a bulk process |
USER_ALREADY_HAS_BULK_OPERATION_IN_PROGRESS | User already has a bulk operation running |
BULK_OPERATION_NOT_FOUND | Bulk operation not found |
BULK_OPERATION_FILE_NOT_FOUND | Bulk operation file not found |
| Code | Description |
|---|
SIGNATURE_WITH_CERTIFICATE_ERROR | Error signing with the assigned certificate |
SIGNATURE_NOT_FOUND | Signatory not found |
SIGNATURE_EXPIRED | Signatory's certificate has expired |
UNQUALIFIED_SIGNATORY | Signatory does not have a valid qualification |
INVALID_CERTIFICATE_TYPE_FOR_ECD_SIGNATORY | Certificate type is incompatible with ECD signatory requirements |
| Code | Description |
|---|
CUSTOMER_NOT_ACTIVE | Customer account is not active |
PRODUCT_NOT_ACTIVE | Product subscription is not active |
TRIAL_EXPIRED | Customer trial period has expired |
| HTTP Status | Error Category |
|---|
| 400 | Domain/business rule violations (codes listed above) |
| 401 | Missing or invalid authentication token |
| 403 | Insufficient permissions (missing required role) |
| 404 | Resource not found |
| 500 | Unexpected server error |
