> 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-aquisicoes/importacao-de-aquisicoes.md).

# Importação de Aquisições

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

* Para cada requisição, a lista deverá conter no **máximo** **1000 registros**.
* O **número do contrato** informado em cada aquisição deve fazer referência a um contrato previamente enviado pelo fluxo de importação de contratos.

## Importação de aquisições (recebíveis)

> \*\*Regras de processamento:\*\*\
> \
> \* \*\*\`numero\_controle\_participante\` repetido no lote:\*\* se o mesmo valor for enviado mais de\
> &#x20; uma vez no lote, todos os recebíveis com esse número serão recusados com \`status: DUPLICADO\`.\
> \
> \* \*\*\`numero\_controle\_participante\` já existente:\*\* se o valor já existir para o emissor, o\
> &#x20; recebível será recusado com \`status: DUPLICADO\`.\
> \
> \* \*\*\`numero\_contrato\`:\*\* se não houver contrato importado correspondente, o recebível será\
> &#x20; recusado com \`status: ERRO\`.\
> \
> \* \*\*\`valor\_liquido\`:\*\* se for nulo ou zero, o recebível será recusado com \`status: ERRO\`.\
> \
> \* \*\*\`cedente\_cnpj\_cpf\`:\*\* se o cedente não tiver sido cadastrado pela API de importação de\
> &#x20; cedentes, o recebível será recusado com \`status: ERRO\`.\
> \
> \* \*\*\`data\_vencimento\`:\*\* se for anterior à data em que o lote for processado, o recebível\
> &#x20; será recusado com \`status: ERRO\`.<br>

```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-receivables":{"post":{"tags":["Integration"],"summary":"Importação de aquisições (recebíveis)","operationId":"importReceivables","description":"**Regras de processamento:**\n\n* **`numero_controle_participante` repetido no lote:** se o mesmo valor for enviado mais de\n  uma vez no lote, todos os recebíveis com esse número serão recusados com `status: DUPLICADO`.\n\n* **`numero_controle_participante` já existente:** se o valor já existir para o emissor, o\n  recebível será recusado com `status: DUPLICADO`.\n\n* **`numero_contrato`:** se não houver contrato importado correspondente, o recebível será\n  recusado com `status: ERRO`.\n\n* **`valor_liquido`:** se for nulo ou zero, o recebível será recusado com `status: ERRO`.\n\n* **`cedente_cnpj_cpf`:** se o cedente não tiver sido cadastrado pela API de importação de\n  cedentes, o recebível será recusado com `status: ERRO`.\n\n* **`data_vencimento`:** se for anterior à data em que o lote for processado, o recebível\n  será recusado com `status: ERRO`.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["recebiveis"],"properties":{"recebiveis":{"type":"array","description":"Lista de recebíveis 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_remessa`.\n","items":{"type":"object","required":["emissor_cnpj","numero_remessa","tipo_recebivel","numero_contrato","numero_recebivel","numero_controle_participante","valor_original","valor_liquido","data_cessao","data_emissao","data_vencimento","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) da remessa de aquisição.\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_remessa":{"type":"string","maxLength":12,"description":"Identificador do lote de aquisição.\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"},"tipo_recebivel":{"type":"string","maxLength":15,"enum":["DUPLICATA","PMT","PRECATORIO","FATURA"],"description":"Tipo do recebível."},"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 ter vínculo com o número de contrato enviado anteriormente na \"Importação dos Contratos\".\n\n**Validação aplicada no processamento:** se não houver contrato importado correspondente,\no recebível será recusado com `status: ERRO`.\n"},"numero_recebivel":{"type":"string","maxLength":255,"description":"**Número do recebível.**\n\n* **Formato:** **Numérico (aceita somente números)**.\n"},"numero_controle_participante":{"type":"string","maxLength":80,"description":"Número de controle do participante do recebível.\n\n* **Formato:** **Texto (aceita letras, números e caracteres especiais)**.\n* **Regra:** Deve ser único. Zeros à esquerda serão ignorados.\n* **Padrão:** Deve seguir o padrão número-parcela (ex: 12345678-1).\n\n**Validações de duplicidade aplicadas no processamento:**\n\n* Se o mesmo valor for enviado mais de uma vez no lote, todos os recebíveis com esse\n  número serão recusados com `status: DUPLICADO`.\n* Se o valor já existir para o emissor, o recebível será recusado com `status: DUPLICADO`.\n"},"valor_original":{"type":"number","format":"decimal","maxLength":13,"description":"Valor original do recebível.\n\n* **Formato:** Numérico no padrão **9,4** (9 dígitos inteiros, 4 decimais).\n* **Sinal:** Deve ser **positivo**.\n"},"valor_liquido":{"type":"number","format":"decimal","maxLength":13,"description":"Valor líquido do recebível (valor de aquisição pelo emissor).\n\n* **Regra:** Deve ser menor ou igual ao valor original.\n* **Formato:** Numérico no padrão **9,4** (9 dígitos inteiros, 4 decimais).\n* **Sinal:** Deve ser **positivo**.\n\n**Validação aplicada no processamento:** se for nulo ou zero, o recebível será recusado\ncom `status: ERRO`.\n"},"data_cessao":{"type":"string","format":"date","maxLength":10,"description":"Data de cessão do recebível.\n\n* **Formato:** Texto (YYYY-MM-DD).\n* **Regra:** Deve ser igual ou posterior à data de emissão.\n"},"data_emissao":{"type":"string","format":"date","maxLength":10,"description":"Data de emissão do recebível.\n\n* **Formato:** Texto (YYYY-MM-DD).\n"},"data_vencimento":{"type":"string","format":"date","maxLength":10,"description":"Data de vencimento do recebível.\n\n* **Regra:** Deve ser igual ou posterior à data de emissão.\n\n**Validação aplicada no processamento:** se for anterior à data em que o lote for\nprocessado, o recebível será recusado com `status: ERRO`.\n"},"numero_banco":{"type":"string","maxLength":50,"description":"Número do banco.\n\n* **Opcionalidade:** **Opcional**, obrigatório quando a cobrança for via Boleto.\n* **Formato:** **Numérico (aceita somente números)**.\n"},"nosso_numero":{"type":"string","maxLength":255,"description":"Nosso número.\n\n* **Opcionalidade:** **Opcional**, obrigatório quando a cobrança for via Boleto.\n* **Formato:** **Texto (aceita letras, números e caracteres especiais)**.\n"},"cedente_nome":{"type":"string","maxLength":255,"description":"Nome do cedente.\n\n* **Formato:** **Texto (aceita apenas letras)**.\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 recebível.\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\n**Validação aplicada no processamento:** se o cedente não tiver sido cadastrado pela API\nde importação de cedentes, o recebível será recusado com `status: ERRO`.\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/devedor do recebível.\n\n* **Formato:** **Texto (aceita apenas letras)**.\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/devedor do recebível.\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})$"},"nome_produto":{"type":"string","maxLength":255,"description":"**Nome do produto de crédito** (exemplo: “Antecipação de Recebíveis”), utilizado em filtros na emissão de relatórios.\n\n* **Opcionalidade:** Opcional.\n* **Formato:** **Texto (aceita letras, números e caracteres especiais)**.\n"},"identificador_produto":{"type":"string","maxLength":50,"description":"**Identificador do produto de crédito** (exemplo: “antecipacao_recebiveis”), utilizado em filtros na emissão de relatórios.\n\n* **Opcionalidade:** Opcional.\n* **Formato:** **Texto (aceita letras, números e caracteres especiais)**.\n"}}},"maxItems":1000}}}}}},"responses":{"200":{"description":"Aquisições importadas 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"]}}}}}}}}}
```
