Pular para o conteúdo principal

Atualizar etapa

POST 

/v1/steps/:step

Atualiza uma etapa da esteira

Request​

Path Parameters

    step stringrequired

Query Parameters

    expand string

    Expande as referências.

    Pode ser um valor único ou uma lista separada por vírgula (csv) de referências retornadas neste endpoint.

    Example: data.loan

Header Parameters

    Idempotency-Key string

    Chave única de idempotência para evitar duplicação de requisições.

    Example: 5f92f01728e009f403d8502e
    base39-external-client-id string

    Chave de identificação do cliente externo. Utilizada para identificar o cliente que está realizando a requisição.

Body

    statusstring

    Status atual da etapa.

    Possible values: [pending, in_progress, done, failed]

    Default value: pending
    Example: pending
    descriptionstring

    Descrição detalhada ou motivo, geralmente usado quando a etapa falha.

    Example: Motivo pelo qual documento do cliente foi considerado inválido.
    tagsstring

    Tags ou etiquetas para categorização ou filtragem adicional.

    Example: document_invalid
    metadataobject

    Conjunto de pares de valores-chave que podem ser anexados a um objeto. Isso pode ser útil para armazenar informações adicionais sobre o objeto em um formato estruturado.

Responses​

Retorna o objeto Step atualizado.

Schema

    idstring

    Identificador exclusivo para o objeto.

    Example: step_5f92f01728e009f403d8502e
    loanstring

    ID do empréstimo ao qual esta etapa está vinculada.

    Example: loan_5f92f01728e009f403d8502e
    slugstring

    Identificador amigável e legível que descreve o propósito da etapa.

    Example: analiseCredito
    statusstring

    Status atual da etapa.

    Possible values: [pending, in_progress, done, failed]

    Default value: pending
    Example: pending
    titlestring

    Título da etapa para exibição em interfaces de usuário.

    Example: Verificação de Crédito
    typestring

    Tipo identificador que categoriza a natureza desta etapa.

    Possible values: [signature, disburse, document_verification, pass, valid_employment, custom_request, unico, attachments_to_request]

    Example: document_verification
    needsstring[]

    Lista de dependências necessários para iniciar esta etapa.

    Example: ["etapaAnterior","outraEtapaAnterior"]
    resultobject

    Objeto que contém o resultado desta etapa, se aplicável.

    Example: {"approved":true}
    descriptionstring

    Descrição detalhada ou motivo, geralmente usado quando a etapa falha.

    Example: Motivo pelo qual documento do cliente foi considerado inválido.
    tagsstring

    Tags ou etiquetas para categorização ou filtragem adicional.

    Example: document_invalid

    methodData

    object

    Objeto que contém dados específicos para o tipo de etapa. Por exemplo, se a etapa for do tipo signature, este objeto conterá os dados necessários para a assinatura do documento.

    anyOf

    Configuração do responsável pela assinatura.

    typestring

    Tipo responsável pela assinatura.

    Possible values: [operator, customer]

    rolestring

    Papel assumido.

    Possible values: [approver, financial, administrator, backoffice]

    Example: approver
    metadataobject

    Conjunto de pares de valores-chave que podem ser anexados a um objeto. Isso pode ser útil para armazenar informações adicionais sobre o objeto em um formato estruturado.

    createdAtdate-time

    Data de criação do objeto

    Example: 2023-08-25T22:38:41.134Z
    updatedAtdate-time

    Data de alteração do objeto

    Example: 2023-08-25T22:38:41.134Z
    deletedboolean

    Identifica se o objeto foi excluído. Se verdadeiro, o objeto foi excluído.

    Default value: false
    Example: false

    createdBy

    object

    clientIdstring

    Identificador do cliente que criou a assinatura.

    Example: client_identifier
    externalClientIdstring

    Chave de identificação do cliente externo. Utilizada para identificar o cliente que está realizando a requisição. Populado pelo campo enviado no header base39-external-client-id.

    appstring

    Nome da aplicação que criou a assinatura.

    Example: backoffice

    updatedBy

    object

    clientIdstring

    Identificador do cliente que criou a assinatura.

    Example: client_identifier
    externalClientIdstring

    Chave de identificação do cliente externo. Utilizada para identificar o cliente que está realizando a requisição. Populado pelo campo enviado no header base39-external-client-id.

    appstring

    Nome da aplicação que criou a assinatura.

    Example: backoffice