Partner Reports

Partner Reports — visão geral

Consulta integrada de eventos publicados, tipos de ingresso, combos, produtos e pedidos. Os dados são servidos a partir do data warehouse da Ingresse com cache de curta duração.

Fluxo

Obter token → reutilizar por ~5 min
GET /v1/reports/organizations/{organizationId}/events → o id de cada evento é o eventId dos demais endpoints
Consultar /tickets, /bundles, /products e /orders do evento

Valores monetários

Todos os campos de valor — price, item_unit_value, item_discount_value, item_total_value — são inteiros em centavos. R$ 150,00 = 15000.

Endpoints

Endpoint	Descrição	Página
GET /events	Eventos da organização, sessões, local e link de venda	Eventos
GET /tickets · /bundles · /products	Catálogo por lote, preço e estoque	Catálogo
GET /orders · /orders/{orderId}	Pedidos, linhas de compra, comprador e portadores	Pedidos

Erros

Status	Quando ocorre
400Bad Request	Parâmetros inválidos — misturar page/page_size com limit/cursor, limit não numérico ou ≤ 0, data em formato inválido, ou offset de fuso nos filtros de /orders.
401unauthorized	Token ausente, expirado, malformado ou com assinatura inválida.
403ACL_FORBIDDEN	Sem a permissão events.reports na organização ou no evento.
404Not Found	orderId inexistente ou de outro evento — indistinguíveis, de propósito.
500Internal Server Error	Falha ao consultar o data warehouse. Reenvie com backoff.
502ACL_CHECK_FAILED	Serviço de permissões ou backend de relatórios indisponível.
504Gateway Timeout	Timeout interno da consulta (30 s) — corpo vazio.

Erros de autenticação retornam { "code": "...", "message": "..." }. Erros do backend são repassados como { "error": "..." } com mensagem genérica de propósito — para investigar, envie ao suporte o trace_id ou x-amzn-RequestId retornado.

Limites e boas práticas

Tema	Regra
Token	Renove quando restarem menos de 60 s. Mantenha o anterior em cache como fallback.
Retry	Apenas em 5xx e timeout, com backoff exponencial e no máximo 3 tentativas. Erros 4xx são definitivos.
Timeout do cliente	35 segundos — o serviço tem timeout interno de 30 s.
Cache	Respostas são cacheadas no servidor por ~1 minuto. Requisições em intervalos menores retornam os mesmos dados.
Paginação	Em /events e /orders, itere até acumular total. Para sincronização incremental, /orders, /tickets e /bundles aceitam janelas de data (updated_after etc.) e paginação por cursor (limit/cursor) — veja as páginas de Pedidos e Catálogo.
Limite de requisições	Não publicado — consulte o account manager.