Estados do fornecedor
A lista de fornecedores de um depósito traz todos os fornecedores que ele convidou e em que ponto cada um está. Uma linha por documento: se você convidou o mesmo fornecedor mais de uma vez, ele continua sendo uma linha só, com o estado mais avançado. Os avisos usam os mesmos nove nomes.
Os nove estados
status | o que significa | o que você faz |
|---|---|---|
invited | o convite foi emitido e ainda não foi usado (vale 30 dias) | esperar, ou reenviar o convite |
invite_expired | o convite venceu sem que ninguém o abrisse | convidar de novo |
awaiting_payment | a pessoa aderiu e o pagamento da certificação ainda não entrou | cobrar |
in_verification | a verificação está em curso | esperar; se a pessoa travou, reenviar o link de verificação |
certified | selo aceso e válido agora | nada — está em dia |
expired | foi certificado e a validade passou | pedir a renovação |
refused | a verificação de identidade foi recusada | ⛔ não reconvide: o desfecho foi negativo |
verification_expired | a pessoa não concluiu a verificação (abandonou ou o prazo passou) | reconvidar — este é o caso comum |
revoked | o certificado foi revogado e deixou de valer | ⛔ não trate como certificado; o fornecedor não está em dia |
refused não é verification_expired
São dois estados porque levam a ações opostas. Quem desistiu se reconvida; quem foi recusado, não. Juntar os dois faria você gastar convite — e cobrança — com quem não pode ser certificado.
Quando um fornecedor sai da lista, e quando volta
- Convite cancelado. Um documento cujos convites foram todos cancelados sai da lista: ali não
houve fornecedor, houve um convite retirado de circulação. O cancelamento não gera aviso. Um convite
novo para o mesmo documento o traz de volta, como
invited. - Fornecimento encerrado e reconvite. O fornecedor cujo fornecimento o depósito encerrou sai da
lista daquele depósito. Um convite novo emitido depois do encerramento o traz de volta como
invited, e daí segue o andamento novo. Se esse convite for cancelado ou vencer sem aceite, ele sai de novo. Nos outros depósitos do seu canal, esse fornecedor aparece igual o tempo todo. - Convite vencido. Emitir um convite para um documento cujo convite anterior venceu sem ser usado
entrega um convite novo (
reused: false, link novo); o vencido sai de circulação. Reenviar um convite vencido não funciona: o reenvio responde409 INVITE_NOT_OPEN— emita um novo.
Os campos que só existem com selo
valid_until, certified_since, verification_url e certificate_number só vêm preenchidos em
certified e expired; nos demais estados — inclusive revoked — são null. verification_url é a página pública do selo — a
mesma que o QR do certificado abre — e pode ser exibida ao lado do selo na tela do seu sistema.
certificate_number é o número impresso no certificado. certified_since é o instante em que o selo
acendeu pela primeira vez, e não se apaga.
A lista não é o selo
O status da lista não é o vocabulário da
consulta de selo. Lá a
pergunta é binária — "este documento tem selo válido agora?" — e a resposta é valid/expired. Aqui
a pergunta é "em que ponto está a certificação?". Objetos diferentes, listas diferentes, de propósito.
O que a lista devolve é o andamento. Nenhum campo diz qual verificação falhou, em que etapa parou, qual checagem reprovou ou qual foi a decisão — veja O que o canal devolve.