Payload de Resposta

Após o processamento do documento, o Scanify envia o resultado para o callbackUrl informado na requisição.

Envelope do payload

O envelope é sempre o mesmo para todos os tipos de documento suportados. O conteúdo de fields varia conforme o document_type.

Campos explicados

request_id: ID único da requisição
document_type: Tipo do documento processado (ex: BOLETO, NFE, DOCUMENTO_VEICULAR, CONTRATO, RG, …)
status: Pode ser success, partial_success ou failed
fields: Campos extraídos do documento — as chaves variam por tipo (consulte Tipos de Documento)
processed_at: Data/hora em UTC

Cada campo em fields pode conter:

value: Valor extraído (ou null quando não encontrado)
confidence_score: número entre 0 e 1 indicando a confiança do modelo na extração do valor (presente quando aplicável)
error: Mensagem descrevendo por que o campo não pôde ser extraído (presente quando value é null)

Cada entrada em fields segue o contrato { "value": <valor ou null>, "confidence_score"?: <número>, "error"?: "<mensagem>" }.

Exemplo — BOLETO

{
  "request_id": "abc123",
  "document_type": "BOLETO",
  "status": "partial_success",
  "fields": {
    "digitable_line": { "value": "23793.38128 60082.190009 50000.063305 4 84410000012345", "confidence_score": 0.98 },
    "amount":         { "value": 129.90, "confidence_score": 0.95 },
    "due_date":       { "value": null, "error": "Formato inválido" },
    "issuer_name":    { "value": "CLARO S.A.", "confidence_score": 0.87 },
    "payer_name":     { "value": "JOÃO DA SILVA" }
  },
  "processed_at": "2025-05-15T21:00:00Z"
}

Exemplo — NFE

{
  "request_id": "def456",
  "document_type": "NFE",
  "status": "success",
  "fields": {
    "access_key":   { "value": "35150412345678000123550010000000011000000010", "confidence_score": 0.99 },
    "issuer_cnpj":  { "value": "12345678000199" },
    "issuer_name":  { "value": "EMPRESA XYZ COMERCIO LTDA", "confidence_score": 0.96 },
    "issue_date":   { "value": "2025-05-15" },
    "total_amount": { "value": 199.90, "confidence_score": 0.97 }
  },
  "processed_at": "2025-05-15T21:05:00Z"
}

O envelope (request_id, document_type, status, fields, processed_at) é sempre o mesmo. As chaves dentro de fields dependem do tipo de documento — consulte a página Tipos de Documento para ver os campos de cada tipo.

​Envelope do payload

​Campos explicados

​Exemplo — BOLETO

​Exemplo — NFE

Envelope do payload

Campos explicados

Exemplo — BOLETO

Exemplo — NFE