Plantonizei

Painel da empresa › Antecipações

Pedir antecipação

POST/api/v1/advancesPede sessão

Como funciona

O médico pede a antecipação dos recebíveis escolhidos (receivableIds). Os recebíveis ficam travados no pedido. Grava de onde partiu a ação: o IP e os cabeçalhos opcionais do aparelho (X-Device-Id, X-Device-Platform, X-Device-Maker, X-Device-Model, X-Device-Os, X-Device-Physical, X-Device-Locale, X-Device-Timezone, X-Device-Screen e X-App-Version).

  • A identidade é conferida pelo rosto: mande a selfie com o desafio de vida (frames, framesMs, challenge), como no ponto.
  • Quando a empresa usa assinatura eletrônica, o pedido nasce aguardando a assinatura do termo de antecipação pelo médico e pela empresa, e a resposta traz o signUrl do médico. O gestor só é avisado depois da assinatura. Se o modelo de termo da empresa não serve, nada é travado.
  • Sem assinatura, o pedido nasce pending e o gestor é avisado na hora.
  • Mande o cabeçalho Idempotency-Key: repetir o pedido com a mesma chave não cria outro.

Parâmetros

  • challengeCorpo · stringCódigo do desafio de vida.
  • framesCorpo · string[]Fotos do rosto em JPEG, em base64, até 512 KB cada.
  • framesMsCorpo · integer[]Instante de cada foto, em milissegundos, na mesma ordem de `frames`.
  • diagnosticCorpo · stringO que o detector do aparelho mediu em cada quadro (gesto, giro, olhos, sorriso). Vai só ao log quando a prova de vida é recusada; nunca imagem.
  • receivableIdsCorpo · string[]Identificadores dos recebíveis escolhidos.

Respostas

201 · id, status e, com termo, o signUrl para o médico assinar.

  • idstring · Identificador do registro.
  • signUrlstring · Link para assinar o documento.
  • statusstring · Situação.

Corpo de exemplo

{
  "id": "3f0c2a5e-9b1d-4c7e-8a21-6d0f5b7ca91e",
  "signUrl": "texto",
  "status": "texto"
}