> 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/criacao-de-fornecedor.md).

# Criação de Fornecedor

## Importar fornecedores

> Envia uma lista de até 100 fornecedores para cadastro ou atualização na plataforma Giro.Tech.

```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/providers":{"post":{"summary":"Importar fornecedores","description":"Envia uma lista de até 100 fornecedores para cadastro ou atualização na plataforma Giro.Tech.","operationId":"importProviders","tags":["Fornecedores"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"providers":{"type":"array","description":"Lista de fornecedores a serem importados.","maxItems":100,"minItems":1,"items":{"type":"object","description":"Dados para importação (cadastro ou atualização) de um fornecedor.","properties":{"type":{"type":"string","enum":["INDIVIDUAL","CORPORATION"],"description":"Tipo de pessoa (INDIVIDUAL para Pessoa Física, CORPORATION para Pessoa Jurídica).","default":"CORPORATION"},"identification":{"type":"string","description":"Número de identificação (CPF para INDIVIDUAL, CNPJ para CORPORATION)."},"name":{"type":"string","description":"Nome completo ou Razão Social."},"externalId":{"type":"string","description":"Identificador único do fornecedor no sistema de origem do cliente."},"canAnticipate":{"type":"boolean","description":"Indica se o fornecedor está habilitado para antecipar faturas.","default":false},"phones":{"type":"array","description":"Lista de telefones do fornecedor.","items":{"type":"object","description":"Telefone do fornecedor.","properties":{"number":{"type":"string","description":"Número do telefone com DDD."}},"required":["number"]},"maxItems":5},"emailAddresses":{"type":"array","description":"Lista de endereços de e-mail do fornecedor.","items":{"type":"object","description":"Endereço de e-mail do fornecedor.","properties":{"email":{"type":"string","format":"email","description":"Endereço de e-mail."}},"required":["email"]},"maxItems":5},"accounts":{"type":"array","description":"Lista de contas bancárias do fornecedor.","items":{"type":"object","description":"Conta bancária do fornecedor para recebimento.","properties":{"bankNumber":{"type":"string","description":"Código do banco (COMPE)."},"agencyNumber":{"type":"string","description":"Número da agência."},"accountNumber":{"type":"string","description":"Número da conta."},"accountDigit":{"type":"string","description":"Dígito verificador da conta."},"type":{"type":"string","enum":["CHECKING_ACCOUNT","SAVINGS_ACCOUNT"],"description":"Tipo da conta (CHECKING_ACCOUNT para Conta Corrente, SAVINGS_ACCOUNT para Conta Poupança)."},"defaultAccount":{"type":"boolean","description":"Indica se esta é a conta padrão para crédito.","default":false}},"required":["bankNumber","agencyNumber","accountNumber","type"]},"maxItems":3}},"required":["name","identification","externalId"]}}},"required":["providers"]}}}},"responses":{"200":{"description":"Fornecedores importados/atualizados com sucesso.\nA resposta pode incluir um resumo do processamento ou status individual (a ser definido)."},"400":{"description":"Erro de negócio ou validação nos dados dos fornecedores. Exemplos:\n- Formato de dados inválido para um ou mais fornecedores.\n- CPF/CNPJ inválido ou já existente com `externalId` diferente.\n- Limite de itens excedido.","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/>" %}
