Criar Fornecedor
Cria um novo fornecedor para a empresa autenticada.
Regras:
- O campo
nameé obrigatório e não pode ser vazio. - Não é possível criar dois fornecedores com o mesmo nome para a mesma empresa.
Depois de criar o fornecedor, use o ID retornado para classificar despesas ao registrar transações.
curl -X POST "https://api-sandbox.contasimples.com/suppliers/v1/suppliers" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-d '{
"name": "Fornecedor Fictício LTDA"
}'
import requests
import json
url = "https://api-sandbox.contasimples.com/suppliers/v1/suppliers"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
data = {
"name": "Fornecedor Fictício LTDA"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
const response = await fetch("https://api-sandbox.contasimples.com/suppliers/v1/suppliers", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
},
body: JSON.stringify({
"name": "Fornecedor Fictício LTDA"
})
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
"encoding/json"
)
func main() {
data := []byte(`{
"name": "Fornecedor Fictício LTDA"
}`)
req, err := http.NewRequest("POST", "https://api-sandbox.contasimples.com/suppliers/v1/suppliers", bytes.NewBuffer(data))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://api-sandbox.contasimples.com/suppliers/v1/suppliers')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
request.body = '{
"name": "Fornecedor Fictício LTDA"
}'
response = http.request(request)
puts response.body
{
"id": 16,
"name": "Fornecedor Fictício LTDA",
"type": {
"id": 1,
"type": "CUSTOM"
}
}
{
"error": "Bad Request",
"message": "Um ou mais parâmetros da requisição são inválidos.",
"code": 400,
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"details": [
"O campo exemplo deve ter um valor entre 5 e 100.",
"datas devem estar no formato YYYY-MM-DD."
]
}
{
"error": "Unauthorized",
"message": "Token de acesso inválido ou expirado.",
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"code": 401
}
{
"error": "Conflict",
"message": "Já existe um fornecedor com o mesmo nome para esta empresa.",
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"code": 409
}
{
"error": "Internal Server Error",
"message": "Ocorreu um erro inesperado ao processar a solicitação.",
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"code": 500
}
POST
/suppliers/v1/suppliers
POST
Base URLstring
Target server for requests. Edit to use your own host.
Bearer Token
Bearer Tokenstring
RequiredToken Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer TOKEN
Token Bearer obtido via OAuth 2.0 Client Credentials. Formato:
Bearer TOKENContent-Typestring
RequiredThe media type of the request body
Options: application/json
namestring
RequiredNome do fornecedor. Deve ser único por empresa.
Request Preview
Response
Response will appear here after sending the request
Authentication
header
Authorizationstring
RequiredBearer token. Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer TOKEN
Body
application/json
Responses
Was this page helpful?