> For the complete documentation index, see [llms.txt](https://docs.giro.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giro.tech/desenvolvedores/api-gtsec/importacao-de-contratos/importacao-do-contrato.md).

# Importação do Contrato

A importação de contratos é uma chamada contendo uma lista de contratos, que deve seguir as seguintes definições:

* Para cada requisição, a lista deverá conter no **máximo** **1000 registros**.

Observação: Para o vínculo do contrato ser feito com o recebível, é necessário enviar o campo `numero_contrato` na importação da aquisição.

## POST /integration/imported-contracts

> Importação de contratos

```json
{"openapi":"3.0.0","info":{"title":"API do GTSec","version":"1.0.0"},"servers":[{"url":"https://integration.staging.gtsec.giro.tech","description":"Ambiente de Staging"},{"url":"https://integration.gtsec.com.br","description":"Ambiente de Produção"}],"security":[{"TokenAuth":[]}],"components":{"securitySchemes":{"TokenAuth":{"type":"apiKey","in":"header","name":"Authorization"}}},"paths":{"/integration/imported-contracts":{"post":{"tags":["Integration"],"summary":"Importação de contratos","operationId":"importContracts","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["contratos"],"properties":{"contratos":{"type":"array","description":"Lista de contratos a importar. Máximo de 1000 por requisição. Se o lote contiver mais\nregistros, particione e envie múltiplas requisições de até 1000 itens cada, todas com o\nmesmo `numero_lote_contrato`.\n","items":{"type":"object","required":["emissor_cnpj","numero_contrato","numero_lote_contrato","tipo_contrato","data_emissao","data_cessao","cedente_nome","cedente_tipo","cedente_cnpj_cpf","sacado_nome","sacado_tipo","sacado_cnpj_cpf"],"properties":{"emissor_cnpj":{"type":"string","maxLength":18,"description":"CNPJ do emissor (Securitizadora/Fundo) do contrato importado.\n\n* **Formato:** Pode ser enviado com ou sem pontuação.\n* **CNPJ numérico:** 14 dígitos (ex.: `55.759.179/0001-57`).\n* **CNPJ alfanumérico:** 12 caracteres alfanuméricos (`A-Z`, `0-9`) + 2 dígitos verificadores numéricos (ex.: `VK80.3CNK/0001-59`).\n* **Normalização:** A API remove pontuação, mantém apenas letras e números e converte letras para maiúsculas.\n* **Validação:** Dígitos verificadores Mod11 (incluindo CNPJ alfanumérico).\n* **Erros:** `Documento CNPJ '{valor}' invalido.`; `A identificacao do emissor '{valor}' e invalida para o emissor autenticado.`\n","pattern":"^(\\d{2}\\.\\d{3}\\.\\d{3}/\\d{4}-\\d{2}|[A-Za-z0-9]{2}\\.[A-Za-z0-9]{3}\\.[A-Za-z0-9]{3}/[A-Za-z0-9]{4}-\\d{2}|\\d{14}|[A-Za-z0-9]{12}\\d{2})$"},"numero_lote_contrato":{"type":"string","maxLength":12,"description":"Identificador do lote do contrato.\n\n* **Formato:** **Numérico (aceita somente números)**.\n* **Regra:** Deve ser único. Sem vínculo com um lote já fechado. Não deve conter zeros à esquerda.\n"},"numero_contrato":{"type":"string","maxLength":50,"description":"Número do contrato.\n\n* **Formato:** **Texto (aceita letras, números e caracteres especiais)**.\n* **Regra:** Deve ser único.\n"},"identificacao_documento":{"type":"string","maxLength":255,"description":"Identificação adicional do documento.\n\n* **Formato:** **Texto (aceita letras, números e caracteres especiais)**.\n* **Regra:** Deve ser único.\n"},"tipo_contrato":{"type":"string","enum":["CCB","CREDIARIO","NOTA_COMERCIAL","NOTA_FISCAL","NOTA_PROMISSORIA","PROCESSO_JUDICIAL","ADESAO_CARTAO"],"description":"Tipo do contrato."},"data_emissao":{"type":"string","format":"date","maxLength":10,"description":"Data de emissão do contrato.\n\n* **Formato:** Texto (YYYY-MM-DD).\n"},"data_cessao":{"type":"string","format":"date","maxLength":10,"description":"Data da cessão do contrato.\n\n* **Formato:** Texto (YYYY-MM-DD).\n* **Regra:** Deve ser igual ou posterior à data de emissão.\n"},"cedente_nome":{"type":"string","maxLength":255,"description":"Nome do cedente.\n\n* **Formato:** **Texto (aceita letras, números e caracteres especiais)**.\n"},"cedente_tipo":{"type":"string","maxLength":2,"enum":["PF","PJ"],"description":"Tipo da identificação do cedente."},"cedente_cnpj_cpf":{"type":"string","maxLength":18,"description":"Identificação do cedente do contrato.\n\n* **Regra:** Deve corresponder ao campo **cedente_tipo** (`PF` para CPF, `PJ` para CNPJ).\n* **Formato:** Pode ser enviado com ou sem pontuação.\n* **CPF (PF):** 11 dígitos numéricos. Não aceita letras.\n* **CNPJ numérico (PJ):** 14 dígitos (ex.: `55.759.179/0001-57`).\n* **CNPJ alfanumérico (PJ):** 12 caracteres alfanuméricos + 2 dígitos verificadores numéricos (ex.: `VK80.3CNK/0001-59`).\n* **Normalização:** A API remove pontuação, mantém apenas letras e números e converte letras para maiúsculas.\n* **Validação:** Dígitos verificadores Mod11.\n* **Erros:** `Documento '{valor}' invalido.`; `A identificação do cedente '{valor}' nao corresponde ao tipo '{cedente_tipo}'.`\n","pattern":"^(\\d{3}\\.\\d{3}\\.\\d{3}-\\d{2}|\\d{2}\\.\\d{3}\\.\\d{3}/\\d{4}-\\d{2}|[A-Za-z0-9]{2}\\.[A-Za-z0-9]{3}\\.[A-Za-z0-9]{3}/[A-Za-z0-9]{4}-\\d{2}|\\d{11}|\\d{14}|[A-Za-z0-9]{12}\\d{2})$"},"sacado_nome":{"type":"string","maxLength":255,"description":"Nome do sacado.\n\n* **Formato:** **Texto (aceita letras, números e caracteres especiais)**.\n"},"sacado_tipo":{"type":"string","maxLength":2,"enum":["PF","PJ"],"description":"Tipo da identificação do sacado."},"sacado_cnpj_cpf":{"type":"string","maxLength":18,"description":"Identificação do sacado do contrato.\n\n* **Regra:** Deve corresponder ao campo **sacado_tipo** (`PF` para CPF, `PJ` para CNPJ).\n* **Formato:** Pode ser enviado com ou sem pontuação.\n* **CPF (PF):** 11 dígitos numéricos. Não aceita letras.\n* **CNPJ numérico (PJ):** 14 dígitos (ex.: `55.759.179/0001-57`).\n* **CNPJ alfanumérico (PJ):** 12 caracteres alfanuméricos + 2 dígitos verificadores numéricos (ex.: `VK80.3CNK/0001-59`).\n* **Normalização:** A API remove pontuação, mantém apenas letras e números e converte letras para maiúsculas.\n* **Validação:** Dígitos verificadores Mod11.\n* **Erros:** `Documento '{valor}' invalido.`; `A identificação do sacado '{valor}' nao corresponde ao tipo '{sacado_tipo}'.`\n","pattern":"^(\\d{3}\\.\\d{3}\\.\\d{3}-\\d{2}|\\d{2}\\.\\d{3}\\.\\d{3}/\\d{4}-\\d{2}|[A-Za-z0-9]{2}\\.[A-Za-z0-9]{3}\\.[A-Za-z0-9]{3}/[A-Za-z0-9]{4}-\\d{2}|\\d{11}|\\d{14}|[A-Za-z0-9]{12}\\d{2})$"}}},"maxItems":1000}}}}}},"responses":{"200":{"description":"Contratos importados com sucesso"},"400":{"description":"Erro na requisição","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Código do erro"},"message":{"type":"string","description":"Mensagem descritiva do erro"},"details":{"type":"array","items":{"type":"string"},"description":"Detalhes adicionais do erro"}},"required":["code","message"]}}}},"500":{"description":"Erro interno do servidor","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Código do erro"},"message":{"type":"string","description":"Mensagem descritiva do erro"},"details":{"type":"array","items":{"type":"string"},"description":"Detalhes adicionais do erro"}},"required":["code","message"]}}}}}}}}}
```
