Envoltorio de errores
{
"error": {
"code": "asset_not_found",
"message": "No asset with id 42 for this shop",
"status": 404,
"request_id": "req_..."
}
}Incluye el request id al ponerte en contacto con el soporte.
Códigos de error habituales
| HTTP | Código | Significado |
|---|---|---|
| 400 | invalid_request | JSON mal formado o campo ausente. |
| 400 | idempotency_key_required | Solicitud de escritura sin Idempotency-Key. |
| 401 | unauthorized | Token ausente, no válido, desconocido o revocado. |
| 402 | plan_required | El acceso a la API no se ha activado para la tienda. |
| 404 | asset_not_found, mapping_not_found, order_not_found, category_not_found, job_not_found | El recurso no existe o pertenece a otra tienda. |
| 409 | idempotency_conflict | La misma clave se reutilizó con una solicitud distinta. |
| 409 | stamping_in_progress | El reenvío está bloqueado mientras el marcado del PDF está pendiente. |
| 409 | delivery_not_yet_released | El producto tiene configurado un retraso de entrega de descargas y los archivos del comprador aún no se han desbloqueado. error.details.release_at es el instante ISO 8601 en que se desbloquean; el comerciante puede liberar el pedido antes con el endpoint grant-downloads. |
| 422 | storage_quota_exceeded | La subida o importación superaría la cuota de almacenamiento. |
| 422 | key_limit_reached | La tienda ya tiene el máximo de 25 claves de API activas; revoca una primero. |
| 422 | withdrawal_consent_required | La tienda tiene activado el consentimiento del derecho de desistimiento de la UE y el pedido aún no tiene registro de consentimiento; las URLs de descarga se emiten una vez que el cliente da su consentimiento. |
| 429 | rate_limited | Se alcanzó el límite de claves de API o de reenvíos del pedido. |
| 500 | internal_error | Error inesperado del servidor. |
Documentación de la API
¿Te ha resultado útil?
Última actualización 2026-06-05