---
title: "Cadastrar fornecedores"
method: POST
path: "/companies/{payerTaxId}/payees"
tags: ["Company"]
---

# Cadastrar fornecedores

`POST /companies/{payerTaxId}/payees`

## Request

- Base URL: `https://api.sandbox.empresas.btgpactual.com`
- URL: `https://api.sandbox.empresas.btgpactual.com/companies/{payerTaxId}/payees`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://id.btgpactual.com/oauth2/token` scopes: `empresas.btgpactual.com/scf/companies`

Esta rota serve para cadastrar novos fornecedores para o sacado.

## Path parameters

- `payerTaxId` string, required: CNPJ/CPF

## Request body

- object
  - `payees` CreateCompanyRequestDto[], required
    - `strategy` string: Guid da Estratégia
    - `payee` CompanyDto, required
      - `taxId` string, required: Documento do fornecedor
      - `legalName` string: Razão social do fornecedor
    - `invite` InvitationDto
      - `email` string: E-mail para envio do invite

## Response `202`

Sucesso

- object[]
  - `taxId` string: CNPJ/CPF

## Other responses

- `400`: Erro de validação
- `401`: Não autorizado
- `default`: Erro

---

[API](https://skmtc.dev/btgpactual/apis/folha-de-pagamentos.md) - [All operations](https://skmtc.dev/btgpactual/apis/folha-de-pagamentos/llms.txt) - [OpenAPI document](https://skmtc.dev/btgpactual/apis/folha-de-pagamentos/revisions/2a24d3da114c?raw)
