Skip to main content
POST
/
v1
/
cogs_entries
curl --location --request POST 'https://api.stateset.com/v1/cogs_entries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token <token>' \
--data-raw '{
    "period": "2024-Q1",
    "product": "Widget A",
    "quantity_sold": 100,
    "cogs": 5000,
    "average_cost": 50,
    "ending_inventory_quantity": 500,
    "ending_inventory_value": 25000,
    "currency": "USD",
    "unit_selling_price": 75,
    "gross_sales": 7500,
    "cogs_method": "FIFO",
    "sale_date": "2024-03-15"
}'

{
  "id": 123,
  "message": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.stateset.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Body

​
period
string
required
The accounting period for the COGS entry
​
product
string
required
The product associated with the COGS entry
​
quantity_sold
integer
required
The quantity of the product sold
​
cogs
number
required
The Cost of Goods Sold amount
​
average_cost
number
required
The average cost per unit
​
ending_inventory_quantity
number
required
The quantity of inventory remaining at the end of the period
​
ending_inventory_value
number
required
The value of the ending inventory
​
currency
string
required
The currency used for the financial calculations
​
exchange_rate_id
integer
Identifier for the related exchange rate
​
sale_transaction_id
integer
Identifier for the related sale transaction
​
unit_selling_price
number
required
The selling price per unit
​
gross_sales
number
required
The total gross sales amount
​
cogs_method
string
required
The method used to calculate COGS
​
product_category
string
The category of the product
​
sales_channel
string
The channel through which the sale was made
​
customer_segment
string
The segment of the customer who made the purchase
​
sale_date
string
required
The date of the sale
​
is_return
boolean
Indicates whether this entry is for a return
​
return_reason
string
The reason for the return, if applicable
​
cost_center
string
The cost center associated with the COGS entry
​
supplier_id
integer
Identifier for the related supplier

​
Response

​
id
integer
Unique identifier for the newly created COGS entry
​
message
string
A success message confirming the creation of the COGS entry
curl --location --request POST 'https://api.stateset.com/v1/cogs_entries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token <token>' \
--data-raw '{
    "period": "2024-Q1",
    "product": "Widget A",
    "quantity_sold": 100,
    "cogs": 5000,
    "average_cost": 50,
    "ending_inventory_quantity": 500,
    "ending_inventory_value": 25000,
    "currency": "USD",
    "unit_selling_price": 75,
    "gross_sales": 7500,
    "cogs_method": "FIFO",
    "sale_date": "2024-03-15"
}'

import requests
import json

url = "https://api.stateset.com/v1/cogs_entries"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Token <token>"
}
data = {
    "period": "2024-Q1",
    "product": "Widget A",
    "quantity_sold": 100,
    "cogs": 5000,
    "average_cost": 50,
    "ending_inventory_quantity": 500,
    "ending_inventory_value": 25000,
    "currency": "USD",
    "unit_selling_price": 75,
    "gross_sales": 7500,
    "cogs_method": "FIFO",
    "sale_date": "2024-03-15"
}

response = requests.post(url, headers=headers, data=json.dumps(data))
print(response.json())