Campo de assinatura fora da página

campo_fora_da_pagina

A área informada em signatarios[].campos[] não cabe na página indicada.

O que aconteceu

Você informou onde a assinatura deve entrar, e o retângulo pedido cai fora do papel — ou a página não existe no documento. A criação é recusada em vez de aceita com a coordenada corrigida por conta própria: assinatura desenhada em lugar diferente do que você pediu é pior que uma recusa clara.

Por que costuma acontecer

• A origem é o canto inferior esquerdo da página, e a unidade é o ponto (1/72 de polegada). Sistemas de tela costumam usar o canto superior esquerdo e pixels — se você converteu de lá, o y provavelmente está invertido.
• x + largura passou da largura da página, ou y + altura passou da altura.
• A pagina é 1-based: a primeira página é 1, não 0.
• O documento tem menos páginas do que você supôs — verifique paginas na resposta.

Como resolver

• Use paginas_tamanho da resposta da criação: ela devolve largura e altura de cada página em pontos, para você calcular sem abrir o PDF.
• Convertendo do canto superior esquerdo: y = altura_da_pagina - y_do_topo - altura.
• Confira que x >= 0, y >= 0, largura > 0 e altura > 0.
• Omitir campos é válido e mantém o comportamento padrão: rubrica em cada página e bloco de assinatura na última.

Um campo de 200×40 pt, 90 pt da esquerda e 300 pt do pé da página 1

{
  "nome": "Procuracao.pdf",
  "signatarios": [
    {
      "nome": "Maria de Souza",
      "documento": "11144477735",
      "email": "maria@exemplo.com",
      "papel": "contratante",
      "campos": [
        { "pagina": 1, "x": 90, "y": 300, "largura": 200, "altura": 40 }
      ]
    }
  ]
}

Relacionados

• entrada_invalida — Entrada inválida
• arquivo_nao_e_pdf — O arquivo não é um PDF

Ramifique sempre pelo campo codigo da resposta — ele é estável. Nunca pelo texto da mensagem nem por esta URL.