Painel da empresa › Antecipações
Pedir antecipação
POST/api/v1/advancesPede sessãoComo 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
signUrldo 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
pendinge 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"
}