Skip to main content
POST
/
suppliers
Create a new supplier
curl --request POST \
  --url https://api.example.com/suppliers \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Fornecedor A",
  "corporateName": "Fornecedor A LTDA",
  "document": "12345678000199",
  "email": "contato@fornecedor.com",
  "phone": "11999999999",
  "active": true
}
'
{
  "id": "e4b6d4e8-8e6d-41da-abdb-8fc358a9e7f1",
  "name": "Distribuidora Tech",
  "document": "12.345.678/0001-90",
  "createdAt": "2024-02-15T10:00:00.000Z"
}

​
Body

​
name
string
required
Nome Fantasia do fornecedor.
​
corporateName
string
Opcional. Razão Social (se PJ).
​
document
string
Opcional. CNPJ ou CPF (aceita com ou sem formatação).
​
email
string
Endereço de e-mail p/ contato ou faturamento.
​
phone
string
Telefone de contato.
​
active
boolean
default:"true"
Habilita ou desabilita o vendor.

​
Response

{
  "id": "e4b6d4e8-8e6d-41da-abdb-8fc358a9e7f1",
  "name": "Distribuidora Tech",
  "document": "12.345.678/0001-90",
  "createdAt": "2024-02-15T10:00:00.000Z"
}

Body

application/json
​
name
string
required

Commercial Name

Example:

"Fornecedor A"

​
corporateName
string

Corporate Name (Razão Social)

Example:

"Fornecedor A LTDA"

​
document
string

Document (CNPJ/CPF)

Example:

"12345678000199"

​
email
string

Email

Example:

"contato@fornecedor.com"

​
phone
string

Phone

Example:

"11999999999"

​
active
boolean
default:true

Active Status

Response

201 - undefined