Resumo:
POST /operation/close com o número do contrato, o CPF ou CNPJ do tomador e a data. A plataforma acha a execução que espera o fechamento, conclui a etapa e a esteira continua. Repetir a mesma chamada é seguro.A etapa Aguardar fechamento externo faz parte da fase de formalização da esteira e exige o módulo de Formalização. Veja Execuções e Módulos e capacidades.
Como o fechamento funciona
1
A execução para na etapa
Com o crédito aprovado e a formalização em dia, a execução chega em Aguardar fechamento externo e espera. Na tela, ela aparece como “aguardando fechamento externo”.
2
O seu sistema chama a API
Quando o contrato é fechado do seu lado, você envia número do contrato, documento e data.
3
A esteira segue
A etapa conclui aprovada, as etapas seguintes rodam e, ao terminar, a execução dispara o webhook
OPERATION, como qualquer execução.fechamento.referencia, fechamento.documento, fechamento.data (número de série de data, como nas planilhas) e fechamento.data_texto (AAAA-MM-DD).
Fechar a operação
/v1. A organização sai do token: você só encontra execuções da sua organização.
CPF ou CNPJ do tomador, com ou sem máscara, inclusive CNPJ alfanumérico. Até 30 caracteres.
Id da execução (ou da esteira) para escolher qual fechar quando mais de uma casa com os dados. É o id que vem na mensagem do
409 de ambiguidade.30392026g 0000101 casa com 30392026G0000101.
Situação da execução depois do fechamento, por exemplo
APPROVED quando terminou, ou PENDING quando ainda há etapas rodando.Como a execução é encontrada
- Pelo número do contrato e pelo documento. Se a execução já tem número de contrato, ele manda.
- Pelo documento, entre as execuções que esperam o fechamento, quando nenhuma tem aquele número.
409 com os ids na mensagem. Repita a chamada com operationId.
Repetir é seguro
Erros
Depois do fechamento
A execução segue as etapas que vêm depois do fechamento. Ao terminar, o webhookOPERATION chega com o operationResultId e a situação final. Cadastre a URL em Webhooks.
Execuções
Estados da execução, esperas e o webhook
OPERATION.API de Propostas
Do pedido à oferta escolhida.

