Pular para o conteúdo principal

Lifecycle

Máquinas de estado do estoque de recebíveis e da operação de antecipação. Os campos e payloads de cada transição estão na Referência Técnica.

Estoque de recebíveis

Um recebível registrado no estoque entra como IN_STOCK e segue:

StatusSignificado
IN_STOCKDisponível para antecipação.
CONSUMEDAntecipado — virou título de uma operação.
EXPIREDExpirou por TTL (POST /v1/stock/{id}/expire).
CANCELLEDCancelado (POST /v1/stock/{id}/cancel).

Operação

Uma operação é a antecipação efetiva. Criada via estoque (/v1/stock/request-anticipation) ou diretamente (/v1/operations/direct):

StatusSignificado
WAITING_APPROVALAguardando aprovação do Backoffice. Pode ser cancelada.
APPROVED_DIRECTDentro do limite de auto-aprovação. Contrato enviado imediatamente.
CONTRACT_SENT / IN_SIGNATURE / SIGNEDFluxo de assinatura eletrônica do contrato.
WAITING_RELEASE / PROCESSING_PAYMENTFunding e envio do PIX ao cedente.
PAIDPIX creditado ao cedente.
COMPLETEDTodos os títulos da operação foram pagos pelos sacados.
DENIED / CANCELLEDNegada pelo Backoffice / cancelada pelo originador.
Cancelamento

POST /v1/operations/{id}/cancel só funciona em WAITING_APPROVAL. Após aprovada, retorna 409.