Create item

post

https://api.getkonvex.com/core/api/items

Available for: Siigo Alegra Quickbooks Sap by design
Recommendation:Before trying to assemble the object to create an item, visit the catalogs endpoint, it contains all the necessary IDs of each software required on this endpoint. Endpoint used to create items in different accounting software, determine the accounting software using the x-software header.

Each query params and headers field, has a label indicating the ERP in which is required or can be used.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

code

string

required

Unique product code, alphanumeric, must be unique, NO spaces allowed, maximum 30 characters.
only for create itemAlegra Siigo

name

string

required

Name of product or service, maximum 100 characters, allows special characters and spaces. ,
only for create itemAlegra Siigo Quickbooks

account_group

int32

required

Required and exclusive for Siigo you can get this code in catalogs information, Inventory Classification ID, it must be created in Siigo Nube and be active.
only for create itemAlegra Siigo

product_type

string

enum

required

Defaults to Product

Identify the product, if it is not sent it takes the value "Prodcut" by default.
only for create itemAlegra Siigo

Allowed:

stock_control

boolean

required

Defaults to false

Inventory control management, If false, the item can be sold without stock, this field is false by default.
only for create itemAlegra Siigo

tax_clasification

string

enum

required

Defaults to taxed

String type field, optional, if not sent by default it takes the "taxed" type.
only for create itemAlegra Siigo

Allowed:

tax_included

boolean

required

Defaults to false

Tax included. Boolean type field, optional, if not sent by default it takes "false".
only for create itemAlegra Siigo

taxes

array of objects

required

Array with tax id objects affecting the product.
only for create itemAlegra Siigo

taxes*

currency_code

string

required

Defaults to COP

String type field, optional, must exist in the accounting software, by default COP.
only for create itemAlegra Siigo

price

int32

required

Defaults to 0

Campo tipo númerico, opcional, máximo maneja 2 decimales, debe ser positivo.
only for create itemAlegra Siigo

unit_label

string

required

Defaults to UND

Unit of measurement for invoice printing.
only for create itemAlegra Siigo

reference

string

required

Campo tipo string, opcional,permite espacios, alfanúmerico de máximo 80 carácteres.
only for create itemAlegra Siigo

description

string

required

Description of the product or service.
only for create itemAlegra Siigo

barcode

string

required

String type field, optional, allows spaces, alphanumeric of maximum 50 characters.
only for create itemAlegra Siigo

brand

string

required

String type field, optional, allows spaces, alphanumeric of maximum 50 characters.
only for create itemAlegra Siigo

model

string

required

String type field, optional, allows spaces, alphanumeric of maximum 50 characters. ,
only for create itemAlegra Siigo

income_account_name

string

required

An identifying name for the object being referenced by value and is derived from the field that holds the common name of that object. This varies by context and specific type of object referenced. For example, references to a Customer object use Customer.DisplayName to populate this field. Optionally returned in responses, implementation dependent.
only for create itemQuickbooks

income_account_id

string

required

The ID for the referenced object as found in the Id field of the object payload. The context is set by the type of reference and is specific to the QuickBooks company file.
only for create itemQuickbooks

inventory_start

string

required

Date of opening balance for the inventory transaction. Required when creating an Item.Type=Inventory. Required for Inventory item types.
only for create itemQuickbooks

inventory_asset_account_name

string

required

inventory_asset_account_id

string

required

he ID for the referenced object as found in the Id field of the object payload. The context is set by the type of reference and is specific to the QuickBooks company file.
only for create itemQuickbooks

expense_account_name

string

required

expense_account_id

string

required

sku

string

required

The stock keeping unit (SKU) for this Item. This is a company-defined identifier for an item or product used in tracking inventory.
only for create itemQuickbooks

type

string

enum

required

Reference to the posting account, that is, the account that records the proceeds from the sale of this item. Must be an account with account type of Sales of Product Income. Query the Account name list resource to determine the appropriate Account object for this reference. Use Account.Id and Account.Name from that object for IncomeAccountRef.value and IncomeAccountRef.name, respectively. For France locales: This is an optional field. This is the sales account id, If not provided it defaults to the default sales account: 706100 and 707100 are the default expense accounts used for Service and Product type of item, respectively. Required for Inventory and Service item types.
only for create item only for create item Quickbooks

Allowed:

amount

int32

required

Current quantity of the Inventory items available for sale. Not used for Service or NonInventory type items.Required for Inventory type items.
only for create item Quickbooks

Headers

x-software

string

enum

required

Software you want to make the request
Alegra Siigo Quickbooks Sap by design

Allowed:

x-connection

string

If you send the x-connection, the connection will already be secured, and there will be no need to send the connection headers for each software.
Optional for: Siigo Alegra Quickbooks Sap by design

x-user

string

required

User of ERP API connection, for quickbooks use reference : quickbooks-id
Alegra Siigo Quickbooks Sap by design

x-apikey

string

required

Apikey or token of ERP API connection, for quickbooks reference use: quickbooks-secret
Alegra Siigo Quickbooks Sap by design

x-testing

boolean

required

Defaults to true

x-testing is used for building the environment. could be sandbox or production ( true: sandbox, false:production)
Quickbooks

x-quickbooks-token

string

required

Quickbooks session token
Quickbooks

x-url

string

Sap by design

Responses

200200

4XX4XX

5XX5XX