Relatórios e provas

Os resultados são separados de propósito em versões imutáveis, PDF oficiais e provas originais protegidas. Siga estes passos sem depender do momento do webhook.

Passo 1 — Descobrir o que está pronto

GET /v1/rentals/{rental_id}/report é o índice atual. Pode apresentar departure pronto enquanto comparison ainda não existe.

Validação humana	Fase	Tipo oficial
Entrega concluída	departure	departure
Devolução concluída	return	comparison

Não existe um tipo oficial return: a devolução produz a comparação com a entrega. Os webhooks aceleram a reconciliação, mas não são a fonte de verdade; releia o índice após cada sinal.

Passo 2 — Arquivar JSON imutável

1. Liste as versões com GET /v1/rentals/{rental_id}/reports.
2. Leia a versão pretendida em GET /v1/reports/{report_id}.
3. Guarde ID público, versão e hash de conteúdo com o Rental.

Uma correção suportada cria uma nova versão com novo ID e hash; o ID anterior continua a referir a versão anterior. Não substitua o histórico usando apenas o Rental ID.

Passo 3 — Descarregar o PDF oficial

GET /v1/reports/{report_id}/pdf devolve os bytes em 200. 202 significa que a geração ou reparação continua; respeite Retry-After e consulte GET /v1/jobs/{job_id} ou repita a rota PDF. A API transmite o ficheiro e não fornece URL permanente de armazenamento.

Passo 4 — Listar provas originais

Chame GET /v1/inspections/{inspection_id}/evidence separadamente para entrega e devolução. Cada elemento contém phase, kind, view, zone, associação a dano e content_path. GET /v1/evidence/{evidence_id}/content transmite a imagem original.

O contrato nunca expõe URLs de armazenamento, contornos, máscaras, coordenadas ou imagens anotadas. is_fresh_for_record é proveniência operacional da integração autenticada e não aparece em JSON partilhado, PDF ou webhooks.

Passo 5 — Descarregar em lote

Âmbito	Endpoint	Conteúdo
Uma inspeção	GET /v1/inspections/{inspection_id}/evidence/archive	Originais da entrega ou devolução
Rental completo	GET /v1/rentals/{rental_id}/evidence/archive	Últimas provas de ambas as fases em pastas distintas

Cada ZIP inclui manifest.json com fase, vista, zona, tipo e gravidade do dano, peças afetadas, integridade e caminho relativo. As imagens são originais sem anotação; nunca inclui contornos, máscaras, camadas ou URLs privadas. O limite efetivo consta em limits.max_evidence_archive_bytes de /v1/capabilities.

Passo 6 — Manter anexos separados

Os anexos Rental são documentos privados do seu software, não provas oficiais. Carregue-os através de /v1/rentals/{rental_id}/attachments. No fluxo TrakarIA aparecem automaticamente em Documentos adicionais através de uma ligação autorizada temporária, sem carregamento duplicado. Permanecem contexto só de leitura e não entram nos arquivos nem no relatório.

O tratamento de imagens permanece simples

A integração não classifica fotografias nem atribui vistas. O TrakarIA deteta a vista, agrupa imagens gerais e close-ups e aceita automaticamente deteções utilizáveis; o operador pode sempre corrigi-las.

Numa correção manual, a interface percorre todas as imagens da vista e guarda uma decisão coerente para o conjunto. Um processamento que termine mais tarde não pode tornar silenciosamente incompleta uma vista validada. Uma verdadeira adição, remoção ou reatribuição pode pedir revisão focada e leva diretamente à vista afetada. Este processo interno não complica o contrato público.