# Criação de CCB e envio para assinatura - V2
## Criação da CCB V2 para assinatura na Giro.Tech
> 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\`.
```json
{"openapi":"3.0.0","info":{"title":"GTSign API","version":"1.0.0"},"servers":[{"url":"https://app.staging.gtsign.giro.tech/api","description":"Ambiente de Staging"},{"url":"https://api.gtsign.com.br","description":"Ambiente de Produção"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT token fornecido pelo administrador"}}},"paths":{"/integration/v2/ccb":{"post":{"summary":"Criação da CCB V2 para assinatura na Giro.Tech","description":"Realiza a criação da CCB (Versão 2) para assinatura na API da Giro.Tech.\nEndpoint atualizado com novo formato de payload.\n⚠️ **Nota:**: Esse endpoint utiliza o prefixo `/integration` ao invés `/api`.\n","tags":["CCB"],"requestBody":{"required":true,"description":"Dados para criação da CCB V2","content":{"application/json":{"schema":{"type":"object","required":["contrato","configuracao_assinatura"],"properties":{"identificador_externo":{"type":"string","maxLength":255,"description":"Identificador externo único do documento.\n⚠️ **Nota:**: O reuso de um identificador já processado resultará recusa, mesmo que os dados do corpo da requisição sejam diferentes.\n"},"contrato":{"type":"object","required":["numero_ccb","data_emprestimo","modalidade","tomador","emprestimo"],"properties":{"numero_ccb":{"type":"string","maxLength":255,"description":"Número da CCB."},"data_emprestimo":{"type":"string","format":"date","description":"Data de formalização do empréstimo."},"modalidade":{"type":"string","enum":["EMPRESTIMO","FINANCIAMENTO"],"description":"Modalidade da operação."},"tomador":{"type":"object","required":["nome","documento","tipo_pessoa","endereco"],"properties":{"nome":{"type":"string","maxLength":255,"description":"Nome do tomador."},"documento":{"type":"string","maxLength":14,"description":"CPF ou CNPJ do tomador.\n\n⚠️ **Nota:**: Informar apenas os caracteres alfanuméricos, sem máscara (remova pontos, hifens e outros símbolos).\n"},"tipo_pessoa":{"type":"string","enum":["PESSOA_FISICA","PESSOA_JURIDICA"],"description":"Tipo de pessoa do tomador."},"endereco":{"type":"object","required":["rua","numero","bairro","cep","cidade","estado"],"properties":{"rua":{"type":"string","maxLength":255,"description":"Logradouro."},"numero":{"type":"string","maxLength":10,"description":"Número do endereço."},"bairro":{"type":"string","maxLength":255,"description":"Bairro."},"cep":{"type":"string","maxLength":8,"description":"CEP (apenas números).\n\n⚠️ **Nota:** Informar apenas os caracteres numéricos, sem máscara (remova pontos, hifens e outros símbolos).\n"},"cidade":{"type":"string","maxLength":255,"description":"Cidade."},"estado":{"type":"string","maxLength":2,"description":"Sigla do estado (UF)."},"complemento":{"type":"string","maxLength":255,"description":"Complemento do endereço."}}}}},"vendedor_do_bem":{"type":"object","required":["nome","documento"],"properties":{"nome":{"type":"string","maxLength":255,"description":"Nome do vendedor do bem."},"documento":{"type":"string","maxLength":14,"description":"CNPJ do vendedor.\n\n⚠️ **Nota:** Informar apenas os caracteres alfanuméricos, sem máscara (remova pontos, hifens e outros símbolos).\n"}}},"correspondente_bancario":{"type":"object","required":["nome","documento"],"properties":{"nome":{"type":"string","maxLength":255,"description":"Nome do correspondente bancário."},"documento":{"type":"string","maxLength":14,"description":"CNPJ do correspondente bancário.\n \n⚠️ **Nota:** Informar apenas os caracteres alfanuméricos, sem máscara (remova pontos, hifens e outros símbolos).\n"}}},"emprestimo":{"type":"object","required":["numero_parcelas","data_primeiro_vencimento_parcela","data_ultimo_vencimento_parcela","valor_emprestimo","taxa_juros_mensal","taxa_juros_anual","valor_primeira_parcela","valor_iof","valor_juros","valor_financiado","valor_desembolso","valor_tarifas","custo_efetivo_total_mensal","custo_efetivo_total_anual","tarifa_bancaria","saldo_devedor"],"properties":{"numero_parcelas":{"type":"integer","format":"int64","description":"Número total de parcelas."},"data_primeiro_vencimento_parcela":{"type":"string","format":"date","description":"Data de vencimento da primeira parcela."},"data_ultimo_vencimento_parcela":{"type":"string","format":"date","description":"Data de vencimento da última parcela."},"valor_emprestimo":{"type":"number","format":"double","description":"Valor solicitado do empréstimo. Formato com até 8 casas inteiras e 2 decimais.","maximum":99999999.99,"minimum":0,"exclusiveMinimum":true},"taxa_juros_mensal":{"type":"number","format":"double","description":"Taxa de juros mensal (%). Formato com até 4 casas inteiras e 8 decimais.","maximum":9999.99999999,"minimum":0,"exclusiveMinimum":true},"taxa_juros_anual":{"type":"number","format":"double","description":"Taxa de juros anual (%). Formato com até 4 casas inteiras e 8 decimais.","maximum":9999.99999999,"minimum":0,"exclusiveMinimum":true},"valor_primeira_parcela":{"type":"number","format":"double","description":"Valor da primeira parcela. Formato com até 8 casas inteiras e 2 decimais.","maximum":99999999.99,"minimum":0,"exclusiveMinimum":true},"valor_iof":{"type":"number","format":"double","description":"Valor do IOF. Formato com até 8 casas inteiras e 2 decimais.","maximum":99999999.99,"minimum":0,"exclusiveMinimum":true},"valor_juros":{"type":"number","format":"double","description":"Valor total dos juros. Formato com até 8 casas inteiras e 2 decimais.","maximum":99999999.99,"minimum":0,"exclusiveMinimum":true},"valor_financiado":{"type":"number","format":"double","description":"Valor total financiado. Formato com até 8 casas inteiras e 2 decimais.","maximum":99999999.99,"minimum":0,"exclusiveMinimum":true},"valor_desembolso":{"type":"number","format":"double","description":"Valor líquido a ser desembolsado ao cliente. Formato com até 8 casas inteiras e 2 decimais.","maximum":99999999.99,"minimum":0},"valor_tarifas":{"type":"number","format":"double","description":"Valor total das tarifas. Formato com até 8 casas inteiras e 2 decimais.","maximum":99999999.99,"minimum":0,"exclusiveMinimum":true},"custo_efetivo_total_mensal":{"type":"number","format":"double","description":"Custo Efetivo Total (CET) mensal (%). Formato com até 2 casas inteiras e 8 decimais.","maximum":99.99999999,"minimum":0,"exclusiveMinimum":true},"custo_efetivo_total_anual":{"type":"number","format":"double","description":"Custo Efetivo Total (CET) anual (%). Formato com até 4 casas inteiras e 8 decimais.","maximum":9999.99999999,"minimum":0,"exclusiveMinimum":true},"tarifa_bancaria":{"type":"number","format":"double","description":"Valor da tarifa bancária. Formato com até 8 casas inteiras e 2 decimais.","maximum":99999999.99,"minimum":0,"exclusiveMinimum":true},"saldo_devedor":{"type":"number","format":"double","description":"Saldo devedor total. Formato com até 8 casas inteiras e 2 decimais.","maximum":99999999.99,"minimum":0,"exclusiveMinimum":true},"tarifa_registro_e_pagamento":{"type":"number","format":"double","description":"Tarifa de registro e pagamento. Formato com até 8 casas inteiras e 2 decimais.","maximum":99999999.99,"minimum":0,"exclusiveMinimum":true},"tarifa_cobranca":{"type":"number","format":"double","description":"Tarifa de cobrança. Formato com até 8 casas inteiras e 2 decimais.","maximum":99999999.99,"minimum":0,"exclusiveMinimum":true}}},"pagamento_favorecido":{"type":"object","properties":{"pix":{"type":"object","required":["chave_pix","tipo_chave_pix"],"properties":{"chave_pix":{"type":"string","maxLength":255,"description":"Chave PIX."},"tipo_chave_pix":{"type":"string","enum":["EMAIL","CPF","CNPJ","TELEFONE","CHAVE_ALEATORIA"],"description":"Tipo da chave PIX."}}},"conta_bancaria":{"type":"object","required":["codigo_banco","numero_conta","digito_conta","numero_agencia","documento_favorecido"],"properties":{"codigo_banco":{"type":"string","maxLength":10,"description":"Código do banco (COMPE)."},"numero_conta":{"type":"string","maxLength":20,"description":"Número da conta."},"digito_conta":{"type":"string","maxLength":2,"description":"Dígito verificador da conta."},"numero_agencia":{"type":"string","maxLength":4,"description":"Número da agência (sem dígito)."}}}}},"encargos":{"type":"object","properties":{"multa":{"type":"number","format":"double","description":"Percentual de multa por atraso. Formato com até 2 casas inteiras e 8 decimais.","maximum":99.99999999,"minimum":0,"exclusiveMinimum":true},"juros_remuneratorios":{"type":"number","format":"double","description":"Percentual de juros remuneratórios. Formato com até 2 casas inteiras e 8 decimais.","maximum":99.99999999,"minimum":0,"exclusiveMinimum":true}}},"seguro":{"type":"object","properties":{"numero_seguro":{"type":"string","maxLength":255,"description":"Número da apólice de seguro."},"seguradora":{"type":"string","maxLength":255,"description":"Nome da seguradora."},"valor_premio":{"type":"number","format":"double","description":"Valor do prêmio do seguro. Formato com até 8 casas inteiras e 2 decimais.","maximum":99999999.99,"minimum":0,"exclusiveMinimum":true}}},"garantias":{"type":"string","maxLength":500,"description":"Descrição das garantias associadas."}}},"configuracao_assinatura":{"type":"object","required":["nome_documento","data_limite","signatarios"],"properties":{"nome_documento":{"type":"string","maxLength":255,"description":"Nome do documento a ser gerado."},"data_limite":{"type":"string","format":"date","description":"Data limite para assinatura do documento.\n⚠️ **Nota:**: Deve ser posterior ou igual a data atual.\n"},"notificacao":{"type":"object","properties":{"politica_notificacao":{"type":"string","enum":["NOTIFICAR","NAO_NOTIFICAR"],"description":"Define se o cliente será notificado.","default":"NOTIFICAR"},"intervalo_lembretes_dias":{"type":"string","enum":["3","6","9","12"],"description":"Intervalo em dias para envio de lembretes.","default":"3"}}},"signatarios":{"type":"array","items":{"type":"object","required":["nome","documento","papel_assinatura"],"properties":{"nome":{"type":"string","maxLength":255,"description":"Nome do signatário."},"documento":{"type":"string","maxLength":11,"description":"CPF do signatário.\n \n⚠️ **Nota:** Informar apenas os caracteres alfanuméricos, sem máscara (remova pontos, hifens e outros símbolos).\n"},"email":{"type":"string","maxLength":255,"description":"E-mail do signatário.\n \n⚠️ **Nota:** Esse campo é obrigatório caso `canal_notificacao` seja `EMAIL`.\n"},"telefone":{"type":"string","maxLength":20,"description":"Telefone celular do signatário (com DDD).\n \n⚠️ **Nota:** Esse campo é obrigatório caso `canal_notificacao` seja `WHATSAPP`.\n"},"papel_assinatura":{"type":"string","enum":["PARTE","TESTEMUNHA","CONTRATANTE","CONTRATADA","ADMINISTRADOR","ASSINAR_PARA_ACUSAR_RECEBIMENTO","ASSINAR_PARA_APROVAR","ASSINAR_PARA_HOMOLOGAR","AVALISTA","CEDENTE","CESSIONARIO","DEVEDOR_SOLIDARIO","EMITENTE","ENDOSSANTE","ENDOSSATARIO","FIADOR","GESTOR","INTERVENIENTE","LOCADOR","LOCATARIO","PARTE_COMPRADORA","PARTE_VENDEDORA","PROCURADOR","REPRESENTANTE_LEGAL","RESPONSAVEL_SOLIDARIO","VALIDADOR"],"description":"Papel do signatário no documento."},"canal_notificacao":{"type":"string","enum":["WHATSAPP","EMAIL","WEBHOOK"],"description":"Define o canal por onde o signatário receberá as notificações do processo de assinatura.","default":"EMAIL"},"metodos_assinatura":{"type":"array","items":{"type":"string","enum":["TOKEN","SELFIE","ASSINATURA_MANUSCRITA"]},"description":"Métodos de assinatura permitidos.","default":["TOKEN"]},"assina_por_representacao":{"type":"boolean","description":"Indica se assina representando outra parte (jurídica).","default":false},"qualificacao_legal":{"type":"string","enum":["SOCIO_ADMINISTRADOR","SOCIO_GERENTE","ADMINISTRADOR","ADMINISTRADOR_ESTATUTARIO","ADMINISTRADOR_JUDICIAL","ADMINISTRADOR_DO_FUNDO","SOCIO_UNICO","PRESIDENTE","VICE_PRESIDENTE","DIRETOR","DIRETOR_ESTATUTARIO","DIRETOR_PRESIDENTE","DIRETOR_EXECUTIVO","DIRETOR_FINANCEIRO","DIRETOR_COMERCIAL","DIRETOR_OPERACIONAL","DIRETOR_JURIDICO","MEMBRO_DA_DIRETORIA","CONSELHEIRO_ADMINISTRATIVO","PROCURADOR","MANDATARIO","PROCURADOR_PODERES_GERAIS","PROCURADOR_PODERES_ESPECIFICOS","PROCURADOR_AD_JUDICIA","PROCURADOR_AD_NEGOTIA","PROCURADOR_CONSTITUIDO","PROCURADOR_COM_PODERES_DE_GARANTIA","OUTORGADO_AD_NEGOTIA","AVALISTA","INTERVENIENTE_GARANTIDOR","INTERVENIENTE_DEVEDOR_SOLIDARIO","INTERVENIENTE_HIPOTECANTE","INTERVENIENTE_PENHORANTE","DEPOSITARIO_FIEL","ORDENADOR_DE_DESPESA","REPRESENTANTE_LEGAL_POR_LEI","REPRESENTANTE_LEGAL_DO_SOCIO","REPRESENTANTE_CONVENCIONAL","RESPONSAVEL_LEGAL","DIRIGENTE","GESTOR_NOMEADO","INTERVENTOR","LIQUIDANTE","INVENTARIANTE","TUTOR","CURADOR","PREPOSTO","SINDICO","SUBSINDICO","CONSELHEIRO_FISCAL","TESOUREIRO","PRIMEIRO_SECRETARIO","GESTOR_DO_FUNDO","CUSTODIANTE","SECRETARIO_MUNICIPAL","SECRETARIO_ESTADUAL","REITOR","AGENTE_DE_CONTRATACAO"],"description":"Qualificação legal, se aplicável (ex. Sócio Administrador). Obrigatório caso assina_por_representacao for true."}}},"minItems":1}}}}}}}},"responses":{"201":{"description":"Requisição processada com sucesso. Retorna o UUID do documento criado.","content":{"application/json":{"schema":{"type":"object","properties":{"documentUuid":{"type":"string","description":"UUID do documento criado/processado."}}}}}},"400":{"description":"Algum dado informado não pôde ser processado. Revise os dados e tente novamente a requisição.","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"status":{"type":"integer","format":"int32"},"path":{"type":"string"},"message":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"object":{"type":"string"},"field":{"type":"string"},"message":{"type":"string"}}}}}}}}}}}}}}
```
{% embed url="" %}
