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 | Code | Meaning |
|---|---|---|
| 400 | invalid_request | Malformed JSON or missing field. |
| 400 | idempotency_key_required | Write request missing Idempotency-Key. |
| 401 | unauthorized | Missing, invalid, unknown, or revoked token. |
| 402 | plan_required | API access has not been activated for the shop. |
| 404 | asset_not_found, mapping_not_found, order_not_found, category_not_found, job_not_found | The resource is missing or belongs to another shop. |
| 409 | idempotency_conflict | The same key was reused with a different request. |
| 409 | stamping_in_progress | Resend is blocked while PDF stamping is pending. |
| 409 | delivery_not_yet_released | The product has a download delivery delay configured and the buyer's files have not unlocked yet. error.details.release_at is the ISO 8601 instant they unlock; the merchant can release the order early with the grant-downloads endpoint. |
| 422 | storage_quota_exceeded | The upload or import would exceed storage quota. |
| 422 | key_limit_reached | The shop already holds the maximum of 25 active API keys; revoke one first. |
| 422 | withdrawal_consent_required | The shop has EU withdrawal-right consent enabled and the order has no consent record yet; download URLs are issued once the customer consents. |
| 429 | rate_limited | The API key or order resend limit was reached. |
| 500 | internal_error | Unexpected server error. |
Documentación de la API
¿Te ha resultado útil?
Última actualización 2026-06-05