📄 PhotonDoq Widget

OCR embeddable para o teu site — 3 linhas de código

Quick Start

Cola este código no teu HTML:

<div id="photondoq-widget"></div>
<script
  src="https://app.photondoq.com/embed.js"
  data-key="YOUR_API_KEY"
></script>

Opções

AtributoTipoDescrição
data-keystringobrigatórioAPI key do parceiro
data-colorstringopcionalCor de destaque (hex). Default: #a855f7
data-brandstringopcionalNome da marca. Default: PhotonDoq
data-logoURLopcionalURL do logo (altura recomendada: 24px)
data-localept/en/esopcionalIdioma. Default: pt
data-templatestringopcionalTipo de documento esperado (fatura, ies, contrato...)
data-callbackURLopcionalURL para receber POST com resultado
data-widthCSSopcionalLargura. Default: 100%
data-heightCSSopcionalAltura. Default: 400px
data-targetstringopcionalID do elemento container. Default: photondoq-widget

Eventos

O widget comunica via postMessage e custom events:

// Ouvir resultado da extracção
PhotonDoq.onResult(function(data, fileName) {
  console.log('Dados extraídos:', data);
  console.log('Ficheiro:', fileName);
  // data.tipo_documento, data.campos, data.linhas_detalhe, etc.
});

// Ouvir erros
PhotonDoq.onError(function(error) {
  console.error('Erro OCR:', error);
});

// Ou via addEventListener
window.addEventListener('photondoq:result', function(e) {
  console.log(e.detail.data);
});

Exemplo com Callback

<div id="photondoq-widget"></div>
<script
  src="https://app.photondoq.com/embed.js"
  data-key="pdq_abc123..."
  data-color="#2563eb"
  data-brand="PhotonGrant"
  data-locale="pt"
  data-template="ies"
  data-callback="https://meusite.com/api/ocr-result"
></script>

Resposta

O widget envia este JSON:

{
  "tipo_documento": "fatura",
  "confianca": 0.95,
  "campos": {
    "emitente_nome": "EDP Comercial SA",
    "emitente_nif": "505015437",
    "valor_total": "123.45",
    "data_documento": "15/03/2026",
    ...
  },
  "linhas_detalhe": [...],
  "alertas": [...]
}

Preços

TipoCusto/páginaModelo IA
Recibos simples€0.03Haiku (rápido)
Faturas, extractos€0.15Sonnet (standard)
IES, contratos, escrituras€0.75Opus (preciso)
QR Express (ATCUD)€0.10

Documentação completa: API Reference →