Criação de CCB e envio para assinatura - V2

Criação da CCB V2 para assinatura na Giro.Tech

post

https://app.staging.gtsign.giro.tech/apihttps://api.gtsign.com.br

/integration/v2/ccb

Realiza a criação da CCB (Versão 2) para assinatura na API da Giro.Tech. Endpoint atualizado com novo formato de payload. ⚠️ Nota:: Esse endpoint utiliza o prefixo /integration ao invés /api.

Autorizações

jwtAuth

AuthorizationstringObrigatório

JWT token fornecido pelo administrador

Corpo

application/json

identificador_externostring · máx: 255Opcional

Identificador externo único do documento. ⚠️ Nota:: O reuso de um identificador já processado resultará recusa, mesmo que os dados do corpo da requisição sejam diferentes.

Example: EXT-123456

Respostas

201

Requisição processada com sucesso. Retorna o UUID do documento criado.

application/json

400

Algum dado informado não pôde ser processado. Revise os dados e tente novamente a requisição.

application/json

post

/integration/v2/ccb

HTTPcURLJavaScriptPython

POST /api/integration/v2/ccb HTTP/1.1
Host: app.staging.gtsign.giro.tech
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1885

{
  "identificador_externo": "EXT-123456",
  "contrato": {
    "numero_ccb": "12345678",
    "data_emprestimo": "2024-05-20",
    "modalidade": "FINANCIAMENTO",
    "tomador": {
      "nome": "João da Silva",
      "documento": "12345678909",
      "tipo_pessoa": "PESSOA_FISICA",
      "endereco": {
        "rua": "Rua das Flores",
        "numero": "123",
        "bairro": "Centro",
        "cep": "01234567",
        "cidade": "São Paulo",
        "estado": "SP",
        "complemento": "Apto 101"
      }
    },
    "vendedor_do_bem": {
      "nome": "Concessionária XYZ",
      "documento": "98765432000199"
    },
    "correspondente_bancario": {
      "nome": "Correspondente A",
      "documento": "12345678000100"
    },
    "emprestimo": {
      "numero_parcelas": 12,
      "data_primeiro_vencimento_parcela": "2024-06-20",
      "data_ultimo_vencimento_parcela": "2025-05-20",
      "valor_emprestimo": 10000,
      "taxa_juros_mensal": 1.5,
      "taxa_juros_anual": 19.56,
      "valor_primeira_parcela": 950,
      "valor_iof": 15,
      "valor_juros": 1400,
      "valor_financiado": 11415,
      "valor_desembolso": 10000,
      "valor_tarifas": 50,
      "custo_efetivo_total_mensal": 1.8,
      "custo_efetivo_total_anual": 22,
      "tarifa_bancaria": 10,
      "saldo_devedor": 11500,
      "tarifa_registro_e_pagamento": 25,
      "tarifa_cobranca": 5
    },
    "pagamento_favorecido": {
      "pix": {
        "chave_pix": "[email protected]",
        "tipo_chave_pix": "EMAIL"
      },
      "conta_bancaria": {
        "codigo_banco": "001",
        "numero_conta": "12345",
        "digito_conta": "X",
        "numero_agencia": "1234"
      }
    },
    "encargos": {
      "multa": 2,
      "juros_remuneratorios": 1
    },
    "seguro": {
      "numero_seguro": "POL-998877",
      "seguradora": "Seguradora ABC",
      "valor_premio": 150
    },
    "garantias": "Alienacao Fiduciaria do veiculo placa ABC-1234"
  },
  "configuracao_assinatura": {
    "nome_documento": "CCB - João da Silva",
    "data_limite": "2024-06-20",
    "notificacao": {
      "politica_notificacao": "NOTIFICAR",
      "intervalo_lembretes_dias": "3"
    },
    "signatarios": [
      {
        "nome": "Maria Oliveira",
        "documento": "98765432100",
        "email": "[email protected]",
        "telefone": "11999998888",
        "papel_assinatura": "PARTE",
        "canal_notificacao": "EMAIL",
        "metodos_assinatura": [
          "TOKEN"
        ],
        "assina_por_representacao": false,
        "qualificacao_legal": "SOCIO_ADMINISTRADOR"
      }
    ]
  }
}

{
  "documentUuid": "550e8400-e29b-41d4-a716-446655440000"
}

Central de Atendimento | Giro.TechGiro.Tech