Errores y códigos de estado

Validación interna

Los errores de validación interna se producen cuando los datos enviados en una solicitud no se ajustan al formato o esquema esperado definido por la API. Por ejemplo, si un campo espera un tipo de valor específico, como una enumeración concreta (p. ej., “1” para Herr, “2” para Frau, “3” para Divers) o una estructura requerida, cualquier discrepancia activará un error de validación.

Validación externa

En caso de que la validación externa a través de ERiC/ELSTER falle, el mensaje de error puede recuperarse a través del endpoint Download ERiC/ELSTER transmission XML. Ten en cuenta que el XML puede contener varios errores.

Importante: El XML es la respuesta sin procesar enviada por ERiC/ELSTER. La API SIGN DE x Submission de fiskaly no interpreta la respuesta.

Estado 2xx

Los códigos de estado en el rango 200–299 indican éxito.

Estado 4xx

Los códigos de estado en el rango 400–499 indican errores causados por la aplicación solicitante (p. ej., se ha enviado un cuerpo de solicitud con formato incorrecto). Reintentar dichas solicitudes con el mismo cuerpo de solicitud no tiene sentido y dará como resultado el mismo código de estado. Algunos errores 4xx pueden gestionarse mediante programación. La respuesta de error está en formato JSON y tiene la siguiente estructura:

{
  "status_code": 400,
  "error": "Bad Request",
  "code": "E_SOME_ERROR",
  "message": "Something bad happened"
}

La respuesta contendrá un código de error u otra información que revele el motivo del error. Modifique la solicitud en consecuencia antes de volver a intentarlo. A continuación encontrará los errores más frecuentes y cómo solucionarlos.

• 401 Unauthorized
  • E_UNAUTHORIZED_ACCESS
    • Autenticar la API
• 403 Forbidden
  • E_ACCESS_FORBIDDEN
• 404 El recurso no existe
  • E_ESTABLISHMENT_NOT_FOUND
  • E_TAXPAYER_NOT_FOUND
  • E_TAXPAYER_ADDRESS_NOT_FOUND
  • E_TAXPAYER_PERSON_NOT_FOUND
  • E_SUBMISSION_NOT_FOUND
  • E_CLIENT_NOT_FOUND
  • E_CLIENT_ADDITIONAL_DATA_NOT_FOUND
• 409 Conflict
• 423 Locked
  • E_LOCKED_RESOURCE

Estado 5xx

Los códigos de estado en el rango 500–599 indican errores en el lado del servidor. Estos errores pueden considerarse temporales.