Errores


Cuando una solicitud falla, success es false y una lista errors indica qué salió mal. El estado HTTP nunca es 200. Revise success en cada respuesta antes de considerar un registro como guardado.

Respuesta fallida
			
{
  "success": false,
  "errors": [
    "Unable to find record"
  ]
}


		

Códigos de estado HTTP

  • 400 La solicitud fue rechazada. La mayoría de las fallas usan este estado: un campo faltante o no válido, un registro que no existe o una regla que los datos incumplen. Corrija la solicitud antes de enviarla de nuevo.
  • 401 Falta el token o no se puede leer. Consulte Autenticación.
  • 403 El token es válido, pero no tiene permiso para hacer esto, o el acceso a la API no está activado para el sitio.
  • 413 El cuerpo de la solicitud es mayor de 1 MB.
  • 422 Un endpoint Add/Update rechazó datos que nunca podrán aceptarse tal como se enviaron, por lo que enviarlos de nuevo fallará de la misma manera.
  • 429 Envió demasiadas solicitudes. Consulte Límites de solicitudes.
  • 503 En un endpoint Add/Update, otra solicitud estaba actualizando el mismo registro en ese momento. Espere unos segundos y envíe la misma solicitud de nuevo.
  • 500 Algo salió mal de nuestro lado. Inténtelo de nuevo y comuníquese con soporte si sigue ocurriendo.

Códigos de error

La mayoría de las entradas en errors son mensajes simples. Algunas son objetos con un code que puede usar para identificarlas en lugar del texto, y data que describe el registro involucrado.

Error con un código
			
{
  "success": false,
  "errors": [
    {
      "code": "record_not_found",
      "data": {
        "modelName": "Customer",
        "externalId": "CUST-1001"
      }
    }
  ]
}


		
  • record_not_found Un registro al que hizo referencia no existe en este sitio. Revise el id que envió o cree primero el registro.
  • record_locked Otra solicitud está actualizando el mismo registro. El estado es 503 en los endpoints Add/Update y 400 en los demás. En cualquier caso, es seguro enviar la misma solicitud de nuevo después de una breve espera.

Registros que se deben enviar primero

Cuando una solicitud hace referencia a un registro que debe existir primero, como el padre de un cliente, la respuesta puede incluir una lista missingRecords. Cada entrada indica el tipo de registro y el id que usó para él. Cree esos registros y luego envíe de nuevo la solicitud original.

Respuesta con registros faltantes
			
{
  "success": false,
  "errors": [
    {
      "code": "record_not_found",
      "data": {
        "modelName": "Customer",
        "externalId": "PARENT-1001"
      }
    }
  ],
  "missingRecords": [
    {
      "model": "Customer",
      "externalId": "PARENT-1001"
    }
  ]
}


		

Errores comunes

Los mensajes de abajo se citan textualmente, para que pueda buscar en esta página el texto que recibió.

  • Feature integrations.hyfin_api_access is not available for Site {site_id} El acceso a la API no está activado para este sitio. Comuníquese con soporte para activarlo. El mensaje termina con el id del sitio.
  • Unable to find record No existe ningún registro con ese id en este sitio, o el registro fue eliminado.
  • Missing required field Un campo obligatorio está vacío o falta. El mensaje indica el nombre del campo.
  • Invalid totals.subtotal Invalid totals.total Los totales que envió no coinciden con las líneas de la orden de compra. El mensaje muestra el monto esperado y el monto recibido.
  • Invoice has been paid and cannot be deactivated La orden de compra tiene un pago realizado a través de la app, por lo que no se puede eliminar. Consulte Eliminación de registros.
  • Invoice is deleted, will not resend. Una orden de compra eliminada no se puede volver a enviar.
  • You have hit the throttle limit for this payment, please try again in a minute El mismo pago se solicitó de nuevo en menos de un minuto.
  • Request body too large El cuerpo de la solicitud supera 1 MB. Envíe menos registros en cada solicitud.