Envelope de erro
{
"error": {
"code": "asset_not_found",
"message": "No asset with id 42 for this shop",
"status": 404,
"request_id": "req_..."
}
}Inclua o request id ao entrar em contato com o suporte.
Códigos de erro comuns
| HTTP | Código | Significado |
|---|---|---|
| 400 | invalid_request | JSON malformado ou campo ausente. |
| 400 | idempotency_key_required | Requisição de escrita sem Idempotency-Key. |
| 401 | unauthorized | Token ausente, inválido, desconhecido ou revogado. |
| 402 | plan_required | O acesso à API não foi ativado para a loja. |
| 404 | asset_not_found, mapping_not_found, order_not_found, category_not_found, job_not_found | O recurso não existe ou pertence a outra loja. |
| 409 | idempotency_conflict | A mesma chave foi reutilizada com uma requisição diferente. |
| 409 | stamping_in_progress | O reenvio fica bloqueado enquanto o carimbo do PDF está pendente. |
| 409 | delivery_not_yet_released | O produto tem um atraso de entrega de downloads configurado e os arquivos do comprador ainda não foram liberados. error.details.release_at é o instante ISO 8601 da liberação; o lojista pode liberar o pedido antecipadamente com o endpoint grant-downloads. |
| 422 | storage_quota_exceeded | O upload ou a importação excederia a cota de armazenamento. |
| 422 | key_limit_reached | A loja já possui o máximo de 25 chaves de API ativas; revogue uma primeiro. |
| 422 | withdrawal_consent_required | A loja tem o consentimento do direito de arrependimento da UE ativado e o pedido ainda não possui registro de consentimento; as URLs de download são emitidas assim que o cliente consente. |
| 429 | rate_limited | O limite de chaves de API ou de reenvios do pedido foi atingido. |
| 500 | internal_error | Erro inesperado do servidor. |
Documentação da API
Isto foi útil?
Última atualização 2026-06-05