Códigos de error de Integraciones
Todos los códigos de error de la API pública que emite Integraciones, con su estado HTTP, su type y una página por código.
Códigos de error que emite Integraciones. Cada code enlaza a su propia página con la causa y la acción a tomar.
| Code | Type | HTTP | Descripción |
|---|---|---|---|
charge_rule_invalid | invalid_request_error | 422 | La regla no es coherente: la condición, el resultado, el motivo de no facturación, el concepto o el IVA no encajan entre sí o no son válidos. El campo conflictivo se indica en param. |
charge_rule_limit_reached | invalid_request_error | 422 | La cuenta de Stripe ya tiene el número máximo de reglas de tratamiento de cobros. |
charge_rule_not_found | not_found_error | 404 | La regla de tratamiento de cobros no existe en la cuenta de Stripe indicada o no pertenece a tu empresa. |
connect_return_domain_already_exists | conflict_error | 409 | El host que intentas dar de alta ya es uno de los dominios de retorno de tu cuenta. Se compara normalizado (minúsculas, sin puerto ni ruta), así que App.Ejemplo.com y app.ejemplo.com son el mismo dominio. |
connect_return_domain_limit_reached | invalid_request_error | 422 | Tu cuenta ya tiene el número máximo de dominios de retorno que admite, y no se ha guardado el nuevo. El tope es por cuenta y cuenta todos los dominios dados de alta. |
connect_return_domain_not_found | not_found_error | 404 | El dominio de retorno que indicas en la ruta no existe en tu cuenta, o pertenece a otra: las dos respuestas son idénticas a propósito para no revelar los dominios de otras cuentas. |
connect_return_url_not_allowed | invalid_request_error | 422 | El host de la return_url no figura entre los dominios de retorno de la cuenta de la clave con la que inicias la conexión de Stripe. Solo se aceptan direcciones https cuyo host (exacto, sin comodines) esté dado de alta en esa cuenta, para que nadie pueda llevar a la persona a un sitio que no controlas. |
invalid_connection_method | invalid_request_error | 422 | El método de conexión indicado no existe para este proveedor. |
platform_account_subscriptions_owned_by_billing | invalid_request_error | 422 | La cuenta de Stripe conectada es la de la propia plataforma: las cuotas de suscripción de Factuarea las factura Facturación directamente, así que esa cuenta no admite la autofacturación de suscripciones (subscription_autoinvoicing_enabled). |
shopify_api_version_expired | api_error | 500 | La versión de la API de administración con la que hablamos con la tienda ya no está soportada. Shopify no devuelve un error cuando eso pasa: sirve la versión estable más antigua con código 200, así que la avería aparece como campos que dejan de estar en la respuesta. |
shopify_credentials_rejected | invalid_request_error | 422 | La tienda ha contestado y ha rechazado el token de acceso, o no había ninguno que usar. En Shopify el token nace de la autorización de la app y el comerciante puede revocarla desde su panel en cualquier momento, así que un token que funcionaba ayer puede no valer hoy sin que nadie haya tocado la configuración. |
shopify_store_unreachable | api_error | 502 | La tienda no ha contestado: se agotó el tiempo de espera, falló el transporte, Shopify devolvió un error propio o se agotó el presupuesto de coste de consulta de la API de administración. Lo que falla está aguas arriba y no en la credencial. |
store_already_connected | invalid_request_error | 422 | Esa tienda ya está conectada a tu empresa con el mismo proveedor. El par proveedor + tienda remota es único por empresa, así que conectarla dos veces dejaría dos tiendas ingiriendo los mismos pedidos y facturándolos por duplicado. |
store_external_id_mismatch | invalid_request_error | 422 | El identificador remoto que envías no corresponde a ninguna tienda que tu empresa haya autorizado para esa integración. En los proveedores que firman sus avisos con el secreto de la aplicación —Shopify—, ese identificador decide a qué empresa se factura cada venta, así que sólo se admite el de una tienda que haya pasado por la autorización. |
store_not_found | not_found_error | 404 | El identificador no corresponde a ninguna tienda conectada de la empresa autenticada. Una tienda de otra empresa responde exactamente igual, de modo que la respuesta nunca revela si existe en otro sitio. |
store_url_not_allowed | invalid_request_error | 422 | La dirección base de la tienda no es un destino de salida autorizado para tu empresa. Releer pedidos desde la tienda abriría una conexión hacia un host que nadie ha aprobado. |
stripe_account_linked_elsewhere | conflict_error | 409 | Esa cuenta de Stripe ya está vinculada y activa en otra empresa de Factuarea. Una cuenta de Stripe activa solo puede pertenecer a una empresa. |
stripe_oauth_exchange_failed | invalid_request_error | 422 | Stripe no ha confirmado la autorización de la cuenta: el código de autorización ha caducado, ya se usó o fue denegado. |
woocommerce_credentials_rejected | invalid_request_error | 422 | La tienda ha contestado y ha rechazado la credencial, o la credencial no podía usarse: falta la clave, falta el secreto o la dirección base no es https. La autenticación viaja en la cabecera sobre HTTPS, así que una tienda publicada en texto claro entregaría las dos piezas en el primer salto y por eso se rechaza antes de salir. |
woocommerce_rest_route_missing | invalid_request_error | 422 | La tienda ha contestado, pero su API REST no está publicada: WordPress ha devuelto que la ruta no existe. Lo habitual es que los enlaces permanentes estén en modo simple, de modo que /wp-json/ no se sirve. La credencial puede ser perfectamente correcta. |
woocommerce_store_unreachable | api_error | 502 | La tienda no ha contestado: se agotó el tiempo de espera, falló el transporte o su alojamiento devolvió un error propio. Lo que falla está aguas arriba, en la instalación del comerciante, y no en la plataforma ni en la credencial. |
Relacionado
Códigos de error por categoría
Localiza un error por la categoría que lo emite.
Tabla de referencia completa
Todos los códigos, estados HTTP, tipos y descripciones en una referencia.
Modelo de errores
Interpreta la respuesta de error y gestiona los errores por código.