1. Home
  2. Compras
  3. API V2
  4. Endpoint: Cadastrar produto

Endpoint: Cadastrar produto

Endpoint que permite cadastrar um produto na plataforma da SULTS.

URL: https://api.sults.com.br/api/v2/compras/product/add
Método: POST

Parâmetros

Headers

HeaderValor
Authorization<token_de_acesso>
Content-Typeapplication/json;charset=UTF-8

Body Attributes

Campo categoryId obtido no sistema SULTS em https://suaempresa.sults.com.br/comercial/adm/configuracao/categoria.

Campo supplierId obtido no sistema SULTS em https://suaempresa.sults.com.br/comercial/adm/fornecedor.

Nome AtributoTipoValor
nameStringNome do produto

Requerido
saleableDateStringData em que o produto estará disponível para compra.

Exemplo: 2022-06-27

Requerido
categoryIdIntegerIdentificador da categoria do novo produto
supplierIdIntegerIdentificador do fornecedor do novo produto

Requerido
barcodeIntegerCódigo de barras do produto
referenceCodeStringCódigo do produto cadastrado no sistema do cliente.
shortDescriptionStringDescrição curta do produto
htmlDescriptionStringDescrição completa do produto em formato HTML

Exemplo

fetch("https://api.sults.com.br/api/v2/compras/product/add", {
	method: "POST",
	headers: {
		"Authorization": "<token_de_acesso>"
	},
	body: {
        "name": "Produto XPTO",
        "saleableDate": "2027-07-29",
        "supplierId": 2,
        "categoryId": 3,
        "barcode": 11222333,
        "referenceCode": "1a2B3c",
        "shortDescription": "Produto XPTO",
        "htmlDescription": "<p><b>Detalhes do Produto:</b> Produto XPTO</p>"
})

Resposta

{
  "id": 122
}
Atualizado em 08/07/2026