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

# Importação de Títulos

## Importar faturas para antecipação na plataforma de antecipação de fornecedores 2

> Envia uma lista de até 100 faturas para que sejam ofertadas aos fornecedores para antecipação na plataforma de antecipação de fornecedores.

```json
{"openapi":"3.0.3","info":{"title":"Giro.Tech - Importação de Faturas para Antecipação","version":"1.0.1"},"servers":[{"url":"https://api.integration.giro.tech","description":"Ambiente de Produção"},{"url":"https://staging.integration.giro.tech","description":"Ambiente de Homologação"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Autenticação via token JWT no cabeçalho 'Authorization: <token>'. \n"}}},"paths":{"/api/anticipations/titles":{"post":{"summary":"Importar faturas para antecipação na plataforma de antecipação de fornecedores 2","description":"Envia uma lista de até 100 faturas para que sejam ofertadas aos fornecedores para antecipação na plataforma de antecipação de fornecedores.","operationId":"importAnticipationTitles","tags":["Antecipações"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titles":{"type":"array","description":"Lista de faturas a serem importadas.","maxItems":100,"minItems":1,"items":{"type":"object","properties":{"buyer":{"description":"Informações do Sacado (empresa que pagará a fatura).","type":"object","properties":{"type":{"type":"string","enum":["INDIVIDUAL","CORPORATION"],"description":"Tipo de pessoa (INDIVIDUAL para Pessoa Física, CORPORATION para Pessoa Jurídica).\n"},"identificationNumber":{"type":"string","description":"Número de identificação (CPF para INDIVIDUAL, CNPJ para CORPORATION).\n"},"name":{"type":"string","description":"Nome completo ou Razão Social."}},"required":["type","identificationNumber","name"]},"provider":{"description":"Informações do Fornecedor (empresa que receberá o valor da fatura).","allOf":[{"type":"object","description":"Representa uma parte envolvida (Sacado ou Fornecedor).","properties":{"type":{"type":"string","enum":["INDIVIDUAL","CORPORATION"],"description":"Tipo de pessoa (INDIVIDUAL para Pessoa Física, CORPORATION para Pessoa Jurídica).\n"},"identificationNumber":{"type":"string","description":"Número de identificação (CPF para INDIVIDUAL, CNPJ para CORPORATION).\n"},"name":{"type":"string","description":"Nome completo ou Razão Social."}},"required":["type","identificationNumber","name"]},{"type":"object","description":"Detalhes específicos do Fornecedor.","properties":{"email":{"type":"string","format":"email","description":"Endereço de e-mail do fornecedor para notificações."},"phone":{"type":"string","description":"Número de telefone do fornecedor."},"address":{"type":"object","description":"Endereço do fornecedor.","properties":{"name":{"type":"string","description":"Nome do endereço."},"type":{"type":"string","enum":["RESIDENTIAL","COMMERCIAL","OTHER"],"description":"Tipo de endereço."},"street":{"type":"string","description":"Logradouro."},"number":{"type":"string","description":"Número."},"complement":{"type":"string","description":"Complemento."},"neighborhood":{"type":"string","description":"Bairro."},"cityId":{"type":"string","description":"ID da cidade."},"zipCode":{"type":"string","description":"CEP."}}},"externalId":{"type":"string","description":"Identificador único do fornecedor no sistema de origem."},"canAnticipate":{"type":"boolean","description":"Indica se o fornecedor está habilitado para antecipar faturas."}},"required":["externalId","canAnticipate"]}]},"order":{"description":"Detalhes da fatura/título.","type":"object","properties":{"uid":{"type":"string","description":"Identificador único da fatura no sistema de origem."},"nfNumber":{"type":"string","description":"Número da Nota Fiscal."},"nfSerie":{"type":"string","description":"Série da Nota Fiscal."},"amount":{"type":"integer","description":"Valor total da fatura em centavos (ex: 10000 para R$ 100,00).\nConsiderar usar 'number' com 'format: double' ou string para valores monetários precisos, ou integer representando centavos.\n"},"orderDetail":{"type":"string","description":"Descrição ou detalhes adicionais da fatura/pedido."},"createdDate":{"type":"string","format":"date","description":"Data de criação/emissão da fatura (YYYY-MM-DD)."},"entryDate":{"type":"string","format":"date","description":"Data de entrada da fatura no sistema (YYYY-MM-DD)."},"dueDate":{"type":"string","format":"date","description":"Data de vencimento da fatura (YYYY-MM-DD)."},"invoiceKey":{"type":"string","description":"Chave da Nota Fiscal Eletrônica (NF-e), se aplicável."},"installmentNumber":{"type":"string","description":"Número da parcela, se a fatura for parte de um parcelamento."}},"required":["uid","nfNumber","amount","createdDate","dueDate"]}},"required":["buyer","provider","order"]}}},"required":["titles"]}}}},"responses":{"200":{"description":"Faturas importadas com sucesso."},"400":{"description":"Erro de negócio ou validação. Exemplos:\n- Formato de dados inválido.\n- Fornecedor não habilitado para antecipação.\n- Limite de faturas excedido.\n- CNPJ/CPF inválido.","content":{"application/json":{"schema":{"type":"object","description":"Resposta de erro seguindo RFC7807.","properties":{"type":{"type":"string","format":"uri","description":"URI que identifica o tipo de problema."},"title":{"type":"string","description":"Resumo do problema."},"status":{"type":"integer","description":"Código de status HTTP."},"detail":{"type":"string","description":"Explicação detalhada do problema."},"message":{"type":"string","description":"Mensagem de erro."}},"required":["title","status"]}}}},"401":{"description":"Não autorizado. Token JWT inválido ou ausente.","content":{"application/json":{"schema":{"type":"object","description":"Resposta de erro seguindo RFC7807.","properties":{"type":{"type":"string","format":"uri","description":"URI que identifica o tipo de problema."},"title":{"type":"string","description":"Resumo do problema."},"status":{"type":"integer","description":"Código de status HTTP."},"detail":{"type":"string","description":"Explicação detalhada do problema."},"message":{"type":"string","description":"Mensagem de erro."}},"required":["title","status"]}}}},"500":{"description":"Erro interno no servidor. Tente novamente mais tarde.","content":{"application/json":{"schema":{"type":"object","description":"Resposta de erro seguindo RFC7807.","properties":{"type":{"type":"string","format":"uri","description":"URI que identifica o tipo de problema."},"title":{"type":"string","description":"Resumo do problema."},"status":{"type":"integer","description":"Código de status HTTP."},"detail":{"type":"string","description":"Explicação detalhada do problema."},"message":{"type":"string","description":"Mensagem de erro."}},"required":["title","status"]}}}}}}}}}
```

<figure><img src="https://978140111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF6l1W0qI0y7eF7f0QRDC%2Fuploads%2Fgit-blob-f5d2064d02c970341ca52b2c083eb1f585bc436a%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

{% embed url="<https://giro.tech/central-de-atendimento/>" %}
